Как настроить проект Xcode

Swift Package Manager

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

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

1. Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
2. Введите URL https://github.com/googlemaps/ios-places-sdk, нажмите Ввод, чтобы добавить пакет, и нажмите "Добавить пакет".
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. Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) должны быть перечислены установленные пакеты. Вы также можете посмотреть раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигаторе проекта), чтобы проверить пакет и его версию.

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

1. В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).

   Если вы обновляете 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. Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.

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

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

Установка вручную

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

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

10. Выберите проект, а не определенную цель, и откройте вкладку Настройки сборки. В разделе Linking - General -> Other Linker Flags (Компоновка – Общие – Другие флаги компоновщика) добавьте -ObjC в пункты Debug (Отладка) и Release (Релиз). Если эти настройки не видны, измените фильтр на панели Настройки сборки с Основные на Все.

GooglePlacesSwift

Чтобы добавить ключ API в AppDelegate.swift, выполните указанные ниже действия:

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

  import GooglePlacesSwift

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

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

Чтобы добавить ключ 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"];