Настроить проект Xcode

После включения биллинга и создания ключа API вы готовы настроить проект Xcode, который вы используете для разработки своего приложения.

Примечания к выпуску доступны для каждого выпуска.

Шаг 1: Установите необходимое программное обеспечение

Чтобы создать проект с использованием Places SDK для iOS, вам необходимо:

  • Xcode версии 16.0 или более поздней

Шаг 2: Создайте проект Xcode и установите Places SDK для iOS

Менеджер пакетов Swift

Places SDK для iOS можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Places SDK для iOS.

Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:

  1. Откройте project или workspace Xcode, затем перейдите в Файл > Добавить зависимости пакета .
  2. Введите https://github.com/googlemaps/ios-places-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  3. Чтобы установить определённую version , выберите в поле « Правило зависимости» один из вариантов, основанных на версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать параметр «Точная версия». После завершения нажмите «Добавить пакет».
  4. В окне «Выбрать пакетные продукты» убедитесь, что GooglePlaces , GooglePlacesSwift или оба будут добавлены в выбранную основную цель. После этого нажмите «Добавить пакет» .

    Если вы обновляете Google Places Swift с устаревшего URL-адреса GitHub

    Важно: URL-адрес GitHub для доступа к Google Places Swift изменился, начиная с версии 0.3.0. Если вы обновляете версию GooglePlacesSwift, доступ к которой осуществлялся по старому URL-адресу https://github.com/googlemaps/ios-places-swift-sdk , удалите его из раздела зависимостей пакетов Xcode.

  5. Чтобы проверить установку, перейдите на панель «Общие» вашей целевой платформы. В разделе «Фреймворки», «Библиотеки» и «Встроенный контент» вы увидите установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проектов», чтобы проверить пакет и его версию.

Чтобы обновить package для существующего проекта, выполните следующие действия:

  1. В Xcode перейдите в «Файл > Пакеты > Обновить до последних версий пакетов».

    Если вы обновляете Google Places Swift с устаревшего URL-адреса GitHub

    Важно: URL-адрес GitHub для доступа к Google Places Swift изменился, начиная с версии 0.3.0. Если вы обновляете версию GooglePlacesSwift, доступ к которой осуществлялся по старому URL-адресу https://github.com/googlemaps/ios-places-swift-sdk , удалите его из раздела зависимостей пакетов Xcode.

  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator, чтобы проверить пакет и его версию.

Чтобы удалить существующий Places SDK для iOS, установленный вручную, выполните следующие действия:

  1. В настройках проекта Xcode найдите раздел «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) , чтобы удалить следующие фреймворки:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. Из каталога верхнего уровня вашего проекта Xcode удалите пакет GooglePlaces .

Ручная установка

В этом руководстве показано, как вручную добавить XCFrameworks, содержащий Places SDK для iOS и Places Swift SDK для iOS, в свой проект и настроить параметры сборки в Xcode. XCFramework — это двоичный пакет, который можно использовать на нескольких платформах, включая устройства на базе Apple Silicon . Вы можете добавить Places SDK для iOS, Places Swift SDK для iOS или оба.

  1. Загрузите следующие двоичные файлы и файлы ресурсов SDK:
  2. Если вы устанавливаете Places Swift SDK для iOS, установите следующие файлы:
  3. Извлеките файлы для доступа к XCFramework и ресурсам.
  4. Запустите Xcode и откройте существующий проект или создайте новый. Если вы новичок в разработке для iOS, создайте новый проект и выберите шаблон iOS App .
  5. Удалите из вашего проекта все пакеты карт из предыдущих выпусков.
  6. Откройте вкладку «Общие» . Перетащите следующий XCFramework в свой проект в раздел «Фреймворки», «Библиотеки» и «Встроенное содержимое» . Убедитесь, что выбран параметр «Не встраивать» :
    • GooglePlaces.xcframework
    Если вы устанавливаете Places Swift SDK, перетащите следующий XCFramework в свой проект в раздел «Фреймворки», «Библиотеки» и «Встроенный контент» . Убедитесь, что выбран параметр «Не встраивать» :
    • GooglePlacesSwift.xcframework
  7. Скопируйте файл GooglePlaces.bundle из скачанного вами пакета GooglePlacesResources в корневой каталог вашего проекта Xcode. При появлении запроса выберите «Копировать элементы в папку целевой группы» .

    Если вы устанавливаете Places Swift SDK, скопируйте файл GooglePlacesSwift.bundle из скачанного вами пакета GooglePlacesSwiftResources в корневой каталог вашего проекта Xcode. При появлении запроса обязательно выберите «Копировать элементы в папку целевой группы» .
  8. Выберите свой проект в Навигаторе проектов и укажите цель вашего приложения.
  9. Откройте вкладку «Фазы сборки» . В разделе «Связать двоичный файл с библиотеками» добавьте следующие фреймворки и библиотеки:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework

  10. Выберите свой проект, а не конкретную цель, и откройте вкладку «Параметры сборки ». В разделе « Связывание» -> «Общие» -> «Другие флаги компоновщика» добавьте -ObjC к параметрам «Отладка» и «Выпуск». Если эти параметры не отображаются, измените фильтр в панели «Параметры сборки» с «Базовый» на «Все» .

CocoaPods

Places SDK для iOS и Places Swift SDK для iOS доступны в виде модулей CocoaPod , GooglePlaces и GooglePlacesSwift .

CocoaPods — это менеджер зависимостей с открытым исходным кодом для проектов Cocoa на Swift и Objective-C. Если у вас ещё нет CocoaPods, установите его в macOS, выполнив следующую команду в терминале. Подробнее см. в руководстве по началу работы с CocoaPods .

sudo gem install cocoapods

Создайте Podfile для установки SDK и их зависимостей:

  1. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. Если вы новичок в разработке для iOS, создайте новый проект и выберите шаблон iOS App .
  2. Создайте файл Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
  3. Отредактируйте Podfile и добавьте зависимости вместе с их версиями . Вот пример, в котором указано имя целевого приложения и имена модулей GooglePlaces и GooglePlacesSwift :
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '10.1.0'
end
     Обязательно регулярно запускайте pod outdated , чтобы определить наличие новой версии и всегда иметь самую последнюю версию.
  4. Сохраните Podfile .

  5. Откройте терминал и перейдите в каталог, содержащий Podfile :

    cd <path-to-project>

  6. Выполните команду pod install . Это установит API, указанные в Podfile , вместе со всеми их зависимостями.

    pod install

  7. Закройте Xcode и дважды щёлкните по файлу .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента для открытия проекта необходимо использовать файл .xcworkspace .

Чтобы обновить API для существующего проекта, выполните следующие действия:

  1. Откройте терминал и перейдите в каталог проекта, содержащий Podfile .
  2. Выполните команду pod update . Это обновит все API, указанные в Podfile , до последней версии.

Шаг 3: Добавьте ключ API в свое приложение

В следующих примерах замените YOUR_API_KEY на ваш ключ API.

GooglePlacesSwift

Добавьте свой ключ API в AppDelegate.swift следующим образом:

  • Добавьте следующий оператор импорта: 
    import GooglePlacesSwift
  • Добавьте следующее в метод application(_:didFinishLaunchingWithOptions:) , заменив YOUR_API_KEY вашим ключом API: 
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Быстрый

Добавьте свой ключ API в AppDelegate.swift следующим образом:

  • Добавьте следующий оператор импорта: 
    import GooglePlaces
  • Добавьте следующее в метод application(_:didFinishLaunchingWithOptions:) , заменив YOUR_API_KEY вашим ключом API: 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Добавьте свой ключ API в AppDelegate.m следующим образом:

  • Добавьте следующий оператор импорта: 
    @import GooglePlaces;
  • Добавьте следующее в application:didFinishLaunchingWithOptions: заменив YOUR_API_KEY вашим ключом API: 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Шаг 4 (необязательно): проверьте файл Apple Privacy Manifest

Apple требует предоставления сведений о конфиденциальности приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.

Файл манифеста конфиденциальности Apple входит в комплект ресурсов SDK. Чтобы убедиться в наличии файла манифеста конфиденциальности и изучить его содержимое, создайте архив приложения и сгенерируйте отчёт о конфиденциальности на основе архива.

Следующие шаги