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

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

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

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

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

• Xcode версии 15.0 или новее

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

Менеджер пакетов Swift

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

Важно: Эти инструкции предполагают использование Xcode 15 или более поздней версии, но они должны быть аналогичны предыдущим версиям Xcode.

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

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

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

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

Важно: иногда артефакты не удается устранить или могут возникнуть ошибки. В этом случае выберите «Файл» > «Пакеты» > «Сбросить кэш пакетов».

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

1. В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
   • 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 и файлы ресурсов:
   • GoogleКарты
   • GoogleMapsРесурсы
   • GoogleНавигация
   • GoogleНавигационныеРесурсы
2. Запустите Xcode и либо откройте существующий проект, либо создайте новый проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон приложения iOS .
3. Удалите из проекта все существующие ссылки на карты, навигацию и места.
   Важно! Places SDK для iOS не входит в состав Navigation SDK для iOS и должен устанавливаться отдельно. Это справедливо для версии 5.0 Places SDK для iOS. Google рекомендует загрузить и установить одни и те же версии Places SDK для iOS и Navigation SDK для iOS. См. раздел Установка Places SDK для iOS .
4. Перетащите следующие файлы XCFrameworks в свой проект в разделе «Платформы, библиотеки и встроенный контент» , чтобы установить SDK «Карты» и «Навигация» (при появлении запроса выберите «Копировать элементы, если необходимо »):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Перетащите GoogleMaps.bundle из загруженного вами GoogleMapsResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы при необходимости» .
6. Перетащите GoogleNavigation.bundle из загруженного вами GoogleNavigationResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы в папку целевой группы» .
7. Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
8. Откройте вкладку «Фазы сборки» и в разделе «Связывание двоичных файлов с библиотеками » добавьте следующие платформы и библиотеки:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.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
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. В целевом приложении выберите вкладку « Возможности» , включите «Фоновые режимы» и включите следующие режимы:
   • Аудио, AirPlay и картинка в картинке
   • Обновления местоположения
10. Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте ‑ObjC как для отладки , так и для выпуска . Если эти настройки не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .
11. Откройте Info.plist и добавьте следующие пары ключ-значение:
    • Ключ: NSLocationWhenInUseUsageDescription ( Конфиденциальность — местоположение при использовании, описание использования )
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».
    • Ключ: NSLocationAlwaysAndWhenInUseUsageDescription ( Конфиденциальность — описание местоположения всегда и при использовании ).
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».

Какао-стручки

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

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

sudo gem install cocoapods

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

1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. Если вы новичок в разработке для iOS:
   1. Создайте новый проект.
   2. Выберите iOS > Шаблон приложения .
   3. На экране опций проекта:
      1. Введите название проекта .
      2. Запишите значение поля идентификатора пакета . Вы можете использовать это значение, чтобы ограничить свой ключ API ниже.
      3. Установите для интерфейса проекта значение Storyboard .
      4. Установите язык Swift или Objective-C .
2. Создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
3. Отредактируйте Podfile и добавьте свои зависимости вместе с их версиями . Вот пример, который включает в себя зависимость, необходимую для навигационного SDK для iOS: # Справочник по установке Cocoapods #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '9.2.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")

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

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

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

Что дальше

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

• Учебники
  • Навигация по маршруту
  • Слушайте навигационные события
• Примеры кода и Codelab