После того как вы включите оплату и создадите ключ API, вы сможете настроить проект Xcode, который будете использовать для разработки приложения.
Для каждого выпуска доступны примечания к выпуску.
Шаг 1. Установите необходимое ПО
Чтобы создать проект с помощью Places SDK для iOS, вам потребуется:
- Xcode версии 26.0 или более поздней.
Шаг 2. Создайте проект Xcode и установите Places SDK для iOS
Swift Package Manager
Places SDK для iOS можно установить с помощью Swift Package Manager. Перед добавлением SDK убедитесь, что вы удалили все существующие зависимости Places SDK для iOS.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
-
Откройте файл
projectилиworkspaceв Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов). - Введите URL https://github.com/googlemaps/ios-places-sdk, нажмите Ввод, чтобы получить пакет, и нажмите "Добавить пакет".
-
Чтобы установить определенную версию
version, выберите в поле Правило зависимости один из вариантов, основанных на версии. Для новых проектов рекомендуется указывать последнюю версию и использовать вариант "Точная версия". Нажмите "Добавить пакет". - В окне Выбор продуктов пакета убедитесь, что
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. - Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) вы увидите установленные пакеты. Вы также можете проверить пакет и его версию в разделе Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта).
Чтобы изменить package для существующего проекта, выполните следующие действия:
-
В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
Если вы обновляете Google Places Swift с устаревшего URL GitHub
Важно! Начиная с версии 0.3.0 URL GitHub для доступа к Google Places Swift изменился. Если вы обновляете версию GooglePlacesSwift, доступ к которой был получен по старому URL (
https://github.com/googlemaps/ios-places-swift-sdk), удалите ее из раздела зависимостей пакета Xcode. - Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.
Чтобы удалить Places SDK для iOS, установленный вручную, выполните следующие действия:
-
В настройках конфигурации проекта Xcode найдите раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Нажмите на знак минуса (-), чтобы удалить следующие фреймворки:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Удалите пакет
GooglePlacesиз каталога верхнего уровня проекта Xcode.
Установка вручную
В этом руководстве рассказывается, как вручную добавить в проект XCFrameworks, содержащие Places SDK для iOS и Places Swift SDK для iOS, и настроить параметры сборки в Xcode. XCFramework – это двоичный пакет, который можно использовать на нескольких платформах, включая компьютеры с процессорами Apple. Вы можете добавить Places SDK для iOS, Places Swift SDK для iOS или оба SDK.
- Скачайте следующие двоичные файлы и файлы ресурсов SDK:
- Если вы устанавливаете Places Swift SDK для iOS, установите следующие файлы:
- Извлеките файлы, чтобы получить доступ к XCFramework и ресурсам.
- Запустите Xcode, после чего откройте существующий проект или создайте новый. Если вы только начинаете разрабатывать приложения для iOS, создайте проект и выберите шаблон приложения для iOS.
- Удалите все комплекты пакеты Google Maps предыдущих версий из своего проекта.
-
Откройте вкладку Общие. Перетащите следующий XCFramework в проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Убедитесь, что выбран вариант Не встраивать.
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Скопируйте файл
GooglePlaces.bundleиз папки GooglePlacesResources, которую вы скачали, в каталог верхнего уровня проекта Xcode. При появлении запроса выберите Скопировать объекты в папку целевой группы.
Если вы устанавливаете Places Swift SDK, скопируйтеGooglePlacesSwift.bundleиз скачанного файла GooglePlacesSwiftResources в каталог верхнего уровня проекта Xcode. При появлении запроса выберите Скопировать объекты в папку целевой группы. - Выберите проект в навигаторе проектов и укажите цель приложения.
-
Откройте вкладку Build Phases (Этапы сборки). В разделе Link Binary with Libraries (Связать двоичный файл с библиотеками) добавьте следующие фреймворки и библиотеки:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Выберите проект, а не конкретную цель, и откройте вкладку Build Settings (Настройки сборки). В разделе Linking - General (Связывание – Общие) -> Other Linker Flags (Другие флаги компоновщика) добавьте
-ObjCв Debug (Отладка) и Release (Выпуск). Если эти настройки не видны, измените фильтр на панели Build Settings (Настройки сборки) с Basic (Базовые) на All (Все).
Шаг 3. Добавьте в приложение ключ API
Укажите свой ключ API вместо YOUR_API_KEY в следующих примерах.
Чтобы добавить ключ 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"];
Шаг 4 (необязательно). Проверьте файл манифеста конфиденциальности Apple
Apple требует, чтобы разработчики приложений в магазине приложений предоставляли информацию о конфиденциальности. Чтобы узнать больше, посетите страницу Apple App Store, посвященную конфиденциальности.
Файл манифеста конфиденциальности Apple включен в пакет ресурсов SDK. Чтобы проверить, включен ли файл манифеста конфиденциальности, и посмотреть его содержимое, создайте архив приложения и сгенерируйте отчет о конфиденциальности из архива.
Дальнейшие действия
- Начните писать код. Рекомендуем начать с создания приложения, которое определяет текущее местоположение пользователя.
- После настройки проекта вы можете изучить примеры приложений.
- Используйте проверку приложений, чтобы защитить ключ API.