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

Менеджер пакетов 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:
   • GooglePlaces
   • GooglePlacesResources
2. Если вы устанавливаете Places Swift SDK для iOS, установите следующие файлы:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
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.4.0'
     pod 'GooglePlacesSwift', '10.4.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 , до последней версии.

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"];