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

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

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

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

Для создания проекта с использованием Places SDK для iOS вам потребуется:

  • Версия Xcode 26.0 или более поздняя

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

Swift Package Manager

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

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

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

    Если вы обновляете Google Places Swift, используя устаревший URL-адрес GitHub,

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

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

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

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

    Если вы обновляете Google Places Swift, используя устаревший URL-адрес GitHub,

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

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

Чтобы удалить установленный вручную SDK Places для 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 в свой проект в раздел Frameworks, Libraries и Embedded Content . Убедитесь, что выбран параметр Do Not Embed :
    • 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

SDK Places для iOS и SDK Places Swift для 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.6.0'
  pod 'GooglePlacesSwift', '10.6.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 Privacy Manifest включен в пакет ресурсов SDK. Чтобы убедиться в наличии файла Privacy Manifest и проверить его содержимое, создайте архив вашего приложения и сгенерируйте отчет о конфиденциальности из архива.

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