Как настроить проект 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. Введите URL https://github.com/googlemaps/ios-navigation-sdk, нажмите Ввод, чтобы добавить пакет, и нажмите "Добавить пакет".
  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. Перетащите следующие XCFrameworks в проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент), чтобы установить Maps SDK и Navigation SDK. При появлении запроса выберите Copy items if needed (Копировать объекты, если необходимо):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Перетащите файл GoogleMaps.bundle из скачанного архива GoogleMapsResources в каталог верхнего уровня проекта Xcode. В окне подтверждения убедитесь, что установлен флажок Copy items if needed (При необходимости скопировать объекты).
  6. Перетащите GoogleNavigation.bundle из скачанного пакета GoogleNavigationResources в каталог верхнего уровня проекта Xcode. Когда появится запрос, убедитесь, что выбран вариант Копировать объекты в папку целевой группы.
  7. Выберите проект в Project Navigator, а затем укажите цель приложения.
  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. Выберите проект, а не определенную цель, и откройте вкладку Настройки сборки. В разделе Other Linker Flags (Другие флаги компоновщика) добавьте ‑ObjC для debug (отладка) и release (выпуск). Если эти настройки не видны, измените фильтр на панели Настройки сборки с Основные на Все.
  11. Откройте файл Info.plist и добавьте следующие пары "ключ-значение":
    • Ключ: NSLocationWhenInUseUsageDescription (Конфиденциальность – описание использования геоданных при работе приложения)
      Значение: "Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации".
    • Ключ: 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 требует, чтобы разработчики приложений в App Store предоставляли информацию о конфиденциальности. Чтобы узнать больше, посетите страницу сведений о конфиденциальности в Apple App Store.

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

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

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

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

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