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

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

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

Шаг 1. Установите необходимое ПО

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

  • Xcode версии 26.0 или более поздней.

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

Swift Package Manager

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

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

  1. Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
  2. Введите https://github.com/googlemaps/ios-navigation-sdk в качестве URL, нажмите Ввод, чтобы получить пакет, и нажмите "Добавить пакет".
  3. Чтобы установить определенную версию version, задайте для поля Правило зависимости одно из значений, связанных с версией. Для новых проектов рекомендуется указывать последнюю версию и выбирать вариант "Точная версия". Нажмите "Добавить пакет".
  4. В окне Выбор продуктов пакета убедитесь, что GoogleNavigation будет добавлен в целевой объект main. Затем нажмите "Добавить пакет".
  5. Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) вы увидите установленные пакеты. Вы также можете проверить пакет и его версию в разделе Package Dependencies (Зависимости пакета) в Project Navigator (Навигаторе проекта).

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

  1. В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
  2. Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.

Чтобы удалить Navigation SDK для iOS, установленный вручную, выполните следующие действия:
  1. В настройках конфигурации проекта Xcode найдите раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Нажмите на знак минуса(-), чтобы удалить следующий фреймворк:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. Удалите пакет GoogleMaps из каталога верхнего уровня проекта Xcode.

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

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

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

  1. Скачайте следующие исполняемые файлы SDK и файлы ресурсов:
  2. Запустите Xcode, после чего откройте существующий проект или создайте новый. Если вы раньше не работали с iOS, создайте проект и выберите шаблон приложения для iOS.
  3. Удалите из проекта все ссылки на Maps, Navigation и Places.
  4. Чтобы установить Maps SDK и Navigation SDK, перетащите следующие XCFrameworks в проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). При появлении запроса выберите Copy items if needed (Копировать элементы при необходимости).
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Перетащите файл GoogleMaps.bundle из скачанной папки GoogleMapsResources в каталог верхнего уровня проекта Xcode. Убедитесь, что установлен флажок Copy items if needed (При необходимости скопировать объекты).
  6. Перетащите GoogleNavigation.bundle из скачанного пакета GoogleNavigationResources в каталог верхнего уровня проекта Xcode. Убедитесь, что установлен флажок Скопировать объекты в папку целевой группы.
  7. Выберите проект в навигаторе проектов и укажите цель приложения.
  8. Откройте вкладку Build Phases (Этапы сборки) и в разделе Link Binary with Libraries (Связать двоичный файл с библиотеками) добавьте следующие фреймворки и библиотеки:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. В целевом объекте приложения выберите вкладку Capabilities (Возможности), включите Background Modes (Фоновые режимы) и активируйте следующие режимы:
    • Аудио, AirPlay и режим "Картинка в картинке"
    • Уведомления о местоположении
  10. Выберите проект, а не конкретную цель, и откройте вкладку Build Settings (Настройки сборки). В разделе Other Linker Flags (Другие флаги компоновщика) добавьте ‑ObjC для debug (отладка) и release (выпуск). Если эти настройки не видны, измените фильтр на панели Build Settings (Настройки сборки) с Basic (Базовые) на All (Все).
  11. Откройте файл Info.plist и добавьте следующие пары "ключ-значение":
    • Ключ: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Значение: "Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации".
    • Ключ: NSLocationAlwaysAndWhenInUseUsageDescription (Конфиденциальность – описание использования геоданных всегда и во время работы приложения)
      Значение: "Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации".

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

Ниже показано, как добавить ключ API в проект в Xcode.

Swift

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

  1. Добавьте следующие операторы импорта: 
    import GoogleMaps
import GoogleNavigation
  2. Добавьте в метод application(_:didFinishLaunchingWithOptions:) следующий код: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  1. Добавьте следующие операторы импорта: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. Добавьте в метод application:didFinishLaunchingWithOptions: следующий код: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

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

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

Если вы клиент Mobility Services

Если вы клиент Mobility Services, ознакомьтесь с информацией о платежах в документации по Mobility. Подробнее о настройке платежных данных… Чтобы узнать, как добавить идентификаторы транзакций в реализацию Navigation SDK, прочитайте статью Как связать использование сервиса с транзакциями Mobility.

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

Теперь, когда у вас есть ключ API и проект Xcode, вы можете создавать и запускать приложения. В Navigation SDK для iOS есть руководства, которые помогут вам начать работу. Подробная информация приведена в следующих статьях: