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

После того как вы включите оплату и создадите ключ 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 в новый или существующий проект, выполните следующие действия:

  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

    Важно! Начиная с версии 0.3.0 URL GitHub для доступа к Google Places Swift изменился. Если вы обновляете версию 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. Удалите пакет GooglePlaces из каталога верхнего уровня проекта Xcode.

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

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

  1. Скачайте следующие двоичные файлы и файлы ресурсов SDK:
  2. Если вы устанавливаете Places Swift SDK для iOS, установите следующие файлы:
  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 (Фреймворки, библиотеки и встроенный контент). Убедитесь, что выбран вариант Не встраивать.
    • 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. Выберите проект, а не конкретную цель, и откройте вкладку Build Settings (Настройки сборки). В разделе Linking - General (Связывание – Общие) -> Other Linker Flags (Другие флаги компоновщика) добавьте -ObjC в Debug (Отладка) и Release (Выпуск). Если эти настройки не видны, измените фильтр на панели Build Settings (Настройки сборки) с Basic (Базовые) на All (Все).

Шаг 3. Добавьте в приложение ключ API

Укажите свой ключ API вместо YOUR_API_KEY в следующих примерах.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

Чтобы добавить ключ 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. Чтобы проверить, включен ли файл манифеста конфиденциальности, и посмотреть его содержимое, создайте архив приложения и сгенерируйте отчет о конфиденциальности из архива.

Дальнейшие действия