Настроить проект Xcode

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

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

Шаг 1: Установите необходимое программное обеспечение.

Для создания проекта с использованием Navigation SDK для iOS необходимо загрузить и установить:

  • Версия Xcode 26.0 или более поздняя

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

Swift Package Manager

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

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

  1. Откройте свой project или workspace Xcode, затем перейдите в меню Файл > Добавить зависимости пакета .
  2. Введите в качестве URL-адреса https://github.com/googlemaps/ios-navigation-sdk , нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  3. Чтобы установить конкретную version , установите в поле « Правило зависимости» один из вариантов, основанных на версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет».

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

  1. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator и проверьте пакет и его версию.

Чтобы удалить установленный вручную SDK навигации для iOS, выполните следующие действия:
  1. В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) для удаления следующего фреймворка:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. В корневом каталоге вашего проекта Xcode удалите пакет GoogleMaps .

Ручная установка

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

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

  1. Загрузите следующие исполняемые файлы SDK и файлы ресурсов:
  2. Запустите Xcode и откройте существующий проект или создайте новый. Если вы новичок в iOS, создайте новый проект и выберите шаблон iOS App .
  3. Удалите из проекта все существующие ссылки на карты, навигацию и места.
  4. Перетащите следующие XCFrameworks в свой проект в разделы Frameworks, Libraries и Embedded Content , чтобы установить SDK для карт и навигации (при появлении запроса выберите «Копировать элементы», если необходимо ):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Перетащите GoogleMaps.bundle из папки GoogleMapsResources, которую вы скачали, в корневую директорию вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы при необходимости» .
  6. Перетащите файл GoogleNavigation.bundle из загруженного вами пакета GoogleNavigationResources в корневой каталог вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы в папку целевой группы» .
  7. Выберите свой проект в навигаторе проектов и укажите целевую платформу для вашего приложения.
  8. Откройте вкладку « Этапы сборки» и в разделе «Связывание двоичных файлов с библиотеками» добавьте следующие фреймворки и библиотеки:
    • 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. В целевом объекте вашего приложения выберите вкладку «Возможности» , включите «Фоновые режимы » и активируйте следующие режимы:
    • Аудио, AirPlay и «картинка в картинке»
    • Обновления местоположения
  10. Выберите свой проект, а не конкретную целевую платформу, и откройте вкладку «Параметры сборки» . В разделе «Другие флаги компоновщика» добавьте ‑ObjC для режимов отладки и выпуска . Если эти параметры не отображаются, измените фильтр на панели параметров сборки с «Основные» на «Все» .
  11. Откройте Info.plist и добавьте следующие пары ключ-значение:
    • Ключ: NSLocationWhenInUseUsageDescription ( Privacy - Location When In Use Usage Description )
      Примечание: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».
    • Ключ: NSLocationAlwaysAndWhenInUseUsageDescription ( Конфиденциальность - Описание использования местоположения «Всегда и при использовании »)
      Примечание: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».

CocoaPods

SDK для навигации в iOS доступен в виде модуля CocoaPods . CocoaPods — это менеджер зависимостей с открытым исходным кодом для проектов Cocoa на Swift и Objective-C.

Если у вас еще нет инструмента CocoaPods, установите его на macOS, выполнив следующую команду в терминале. Подробности см. в руководстве по началу работы с CocoaPods .

sudo gem install cocoapods

Создайте Podfile для SDK навигации для iOS и используйте его для установки API и его зависимостей:

  1. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. Если вы новичок в разработке под iOS:
    1. Создать новый проект.
    2. Выберите шаблон iOS > Приложение .
    3. На экране параметров проекта:
      1. Введите название проекта .
      2. Запишите значение поля «Идентификатор пакета» . Вы можете использовать это значение для ограничения доступа к вашему API-ключу ниже.
      3. Установите для проекта интерфейс «Раскадровка» .
      4. Выберите язык программирования Swift или Objective-C .
  2. Создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
  3. Отредактируйте Podfile и добавьте ваши зависимости вместе с их версиями . Вот пример, включающий зависимость, необходимую для Navigation SDK для iOS: # Справочник по установке Cocoapods #
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.8.0'
end
    Регулярно запускайте команду pod outdated , чтобы обнаруживать более новые версии. При необходимости обновите до последней версии .
  4. Сохраните файл Podfile .

  5. Откройте терминал и перейдите в директорию, содержащую Podfile :

    cd <path-to-project>

  6. Выполните команду pod install . Это установит API, указанные в Podfile , а также все необходимые зависимости.

    pod install

  7. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента для открытия проекта необходимо использовать файл .xcworkspace .

Для обновления API существующего проекта выполните следующие действия:

  1. Откройте терминал и перейдите в каталог проекта, содержащий Podfile .
  2. Выполните команду pod update . Это обновит все API, указанные в Podfile , до последней версии.

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

В следующих примерах показано, как добавить ключ API в ваш проект в Xcode:

Быстрый

Добавьте свой 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 Privacy Manifest.

Компания Apple требует предоставления информации о конфиденциальности приложений в App Store. Для получения обновлений и дополнительной информации посетите страницу «Информация о конфиденциальности в Apple App Store» .

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

Если вы являетесь клиентом службы мобильности

Если вы являетесь клиентом Mobility Services, ознакомьтесь с информацией о выставлении счетов в документации Mobility. Дополнительную информацию о регистрации транзакций см. в разделе «Настройка выставления счетов» . Чтобы узнать, как добавить идентификаторы транзакций в вашу реализацию Navigation SDK, см. раздел «Связывание использования сервиса с транзакциями Mobility» .

Что дальше?

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