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

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

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

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

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

• Xcode версии 15.0 или новее

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

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

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

Важно: Эти инструкции предполагают использование Xcode 15 или более поздней версии, но они должны быть аналогичны предыдущим версиям Xcode.

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

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

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

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

5. Чтобы проверить установку, перейдите на панель «Общие» целевой системы. В разделе «Платформы», «Библиотеки» и «Встроенный контент » вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию. Xcode показывает версию GitHub, которая соответствует версии GooglePlaces (например, 9.2.0), но не соответствует версии GooglePlacesSwift (например, 0.3.0).

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

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

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

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

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

Важно: иногда артефакты не удается устранить или могут возникнуть ошибки. В этом случае выберите «Файл» > «Пакеты» > «Сбросить кэш пакетов».

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

1. В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующие платформы:
   • 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 и файлы ресурсов:
   • GoogleМеста
   • GooglePlacesРесурсы
2. Если вы устанавливаете Places Swift SDK для iOS (предварительная версия), установите следующие файлы:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Извлеките файлы, чтобы получить доступ к XCFramework и ресурсам.
4. Запустите Xcode и либо откройте существующий проект, либо создайте новый проект. Если вы новичок в разработке iOS, создайте новый проект и выберите шаблон приложения iOS .
5. Удалите из проекта все пакеты Карт из предыдущих выпусков.
6. Откройте вкладку «Общие» . Перетащите следующий XCFramework в свой проект в разделе «Платформы, библиотеки и встроенный контент» . Обязательно выберите «Не вставлять» :
   • GooglePlaces.xcframework
   Если вы устанавливаете Places Swift SDK для iOS (предварительная версия), перетащите следующий XCFramework в свой проект в разделе «Платформы, библиотеки и встроенный контент» . Обязательно выберите «Не вставлять» :
   • GooglePlacesSwift.xcframework
7. Скопируйте файл GooglePlaces.bundle из загруженного вами GooglePlacesResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса обязательно выберите «Копировать элементы в папку целевой группы» .
   
   Если вы устанавливаете Places Swift SDK для iOS (предварительная версия), скопируйте GooglePlacesSwift.bundle из GooglePlacesSwiftResources, который вы скачали, в каталог верхнего уровня вашего проекта Xcode. При появлении запроса обязательно выберите «Копировать элементы в папку целевой группы» .
8. Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
9. Откройте вкладку «Фазы сборки» . В Link Binary with Libraries добавьте следующие платформы и библиотеки:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

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

Какао-стручки

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 .
2. Создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
3. Отредактируйте Podfile и добавьте свои зависимости вместе с их версиями . Ниже приведен пример, в котором указывается целевое имя вашего приложения и имена модулей GooglePlaces и GooglePlacesSwift :

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.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.

Быстрый

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

• Добавьте следующий оператор импорта:

  import GooglePlaces

• Добавьте в свой application(_:didFinishLaunchingWithOptions:) следующее, заменив YOUR_API_KEY своим ключом API:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Цель-C

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

• Добавьте следующий оператор импорта:

  @import GooglePlaces;

• Добавьте в свое application:didFinishLaunchingWithOptions: заменив YOUR_API_KEY своим ключом API:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

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

• Добавьте следующий оператор импорта:

  import GooglePlacesSwift

• Добавьте в свой application(_:didFinishLaunchingWithOptions:) следующее, заменив YOUR_API_KEY своим ключом API:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Шаг 4 (необязательно). Проверьте файл манифеста конфиденциальности Apple.

Примечание. Нижеследующее актуально при развертывании приложения в интернет-магазине.

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

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

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

• Начните писать код. Рекомендуемой отправной точкой является внедрение начального приложения, которое получает информацию о текущем местоположении пользователя .
• После настройки проекта вы можете изучить примеры приложений .
• Используйте проверку приложений, чтобы защитить свой ключ API .