После включения выставления счетов и создания ключа API вы готовы настроить проект Xcode, который вы используете для разработки своего приложения.
Примечания к выпуску доступны для каждого выпуска.
Шаг 1. Установите необходимое программное обеспечение
Чтобы создать проект с использованием Navigation SDK для iOS, необходимо скачать и установить:
- Xcode версии 15.0 или новее
Шаг 2. Создайте проект Xcode и установите навигационный SDK.
Менеджер пакетов Swift
Навигационный SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Navigation SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте
project
илиworkspace
Xcode, затем выберите «Файл» > «Добавить зависимости пакета» . - Введите https://github.com/googlemaps/ios-navigation-sdk в качестве URL-адреса, нажмите Enter , чтобы получить пакет, и нажмите «Добавить пакет».
- Чтобы установить конкретную
version
, установите в поле «Правило зависимости» один из вариантов на основе версии. Для новых проектов рекомендуем указывать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет».
Чтобы обновить package
для существующего проекта, выполните следующие действия:
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.
- В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
-
GoogleMaps.xcframework
-
GoogleNavigation.xcframework
-
- Из каталога верхнего уровня вашего проекта Xcode удалите пакет
GoogleMaps
.
Ручная установка
В этом руководстве показано, как вручную добавить XCFrameworks, содержащий навигационный SDK для iOS и Maps SDK для iOS, в ваш проект и настроить параметры сборки в Xcode. XCFramework — это двоичный пакет, который можно использовать на нескольких платформах, включая машины с набором микросхем M1.
Выполните следующие действия, чтобы установить XCFrameworks для Navigation SDK для iOS и Maps SDK для iOS:
- Загрузите следующие двоичные файлы SDK и файлы ресурсов:
- Запустите Xcode и либо откройте существующий проект, либо создайте новый проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон приложения iOS .
- Удалите из проекта все существующие ссылки на карты, навигацию и места.
- Перетащите следующие файлы XCFrameworks в свой проект в разделе «Платформы, библиотеки и встроенный контент» , чтобы установить SDK «Карты» и «Навигация» (при появлении запроса выберите «Копировать элементы, если необходимо »):
-
GoogleMaps.xcframework
-
GoogleNavigation.xcframework
-
- Перетащите
GoogleMaps.bundle
из загруженного вами GoogleMapsResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы при необходимости» . - Перетащите
GoogleNavigation.bundle
из загруженного вами GoogleNavigationResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы в папку целевой группы» . - Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
- Откройте вкладку «Фазы сборки» и в разделе «Связывание двоичных файлов с библиотеками » добавьте следующие платформы и библиотеки:
-
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
-
- В целевом приложении выберите вкладку « Возможности» , включите «Фоновые режимы» и включите следующие режимы:
- Аудио, AirPlay и картинка в картинке
- Обновления местоположения
- Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте
‑ObjC
как для отладки , так и для выпуска . Если эти настройки не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» . - Откройте
Info.plist
и добавьте следующие пары ключ-значение:- Ключ:
NSLocationWhenInUseUsageDescription
( Конфиденциальность — расположение при использовании описания использования )
Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации». - Ключ:
NSLocationAlwaysAndWhenInUseUsageDescription
( Конфиденциальность — местоположение всегда и при использовании описания использования )
Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».
- Ключ:
Какао-стручки
Навигационный SDK для iOS доступен в виде модуля CocoaPods . CocoaPods — это менеджер зависимостей с открытым исходным кодом для проектов Cocoa Swift и Objective-C.
Если у вас еще нет инструмента CocoaPods, установите его в macOS, выполнив следующую команду из терминала. Подробности см. в руководстве по началу работы с CocoaPods .
sudo gem install cocoapods
Создайте Podfile
для навигационного SDK для iOS и используйте его для установки API и его зависимостей:
- Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. Если вы новичок в разработке для iOS:
- Создайте новый проект.
- Выберите iOS > Шаблон приложения .
- На экране опций проекта:
- Введите название проекта .
- Запишите значение поля идентификатора пакета . Вы можете использовать это значение, чтобы ограничить свой ключ API ниже.
- Установите для интерфейса проекта значение Storyboard .
- Установите язык Swift или Objective-C .
- Создайте файл с именем
Podfile
в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта. - Отредактируйте
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
для обнаружения новых версий. При необходимости обновитесь до последней версии . - Сохраните
Podfile
. Откройте терминал и перейдите в каталог, содержащий
Podfile
:cd <path-to-project>
Запустите команду
pod install
. При этом будут установлены API, указанные вPodfile
, вместе со всеми зависимостями.pod install
Закройте Xcode, а затем откройте (дважды щелкните) файл
.xcworkspace
вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл.xcworkspace
для открытия проекта.
Чтобы обновить API для существующего проекта, выполните следующие действия:
- Откройте терминал и перейдите в каталог проекта, содержащий
Podfile
. - Запустите команду
pod update
. При этом все API, указанные вPodfile
обновляются до последней версии.
Шаг 3. Добавьте ключ API в проект.
В следующих примерах показано, как добавить ключ API в ваш проект в Xcode:
Быстрый
Добавьте свой ключ API в свой AppDelegate.swift
следующим образом:
- Добавьте следующие операторы импорта:
import GoogleMaps import GoogleNavigation
- Добавьте в свой
application(_:didFinishLaunchingWithOptions:)
следующее:GMSServices.provideAPIKey("YOUR_API_KEY")
Цель-C
Добавьте свой ключ API в свой AppDelegate.m
следующим образом:
- Добавьте следующие операторы импорта:
@import GoogleMaps; @import GoogleNavigation;
- Добавьте в свое
application:didFinishLaunchingWithOptions:
::[GMSServices provideAPIKey:@"YOUR_API_KEY"];
Шаг 4 (необязательно). Проверьте файл манифеста конфиденциальности Apple.
Apple требует предоставить информацию о конфиденциальности для приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.
Файл манифеста конфиденциальности Apple включен в пакет ресурсов для SDK. Чтобы убедиться, что файл манифеста конфиденциальности включен, и проверить его содержимое, создайте архив своего приложения и создайте отчет о конфиденциальности из архива.
Если вы являетесь клиентом мобильных услуг
Если вы являетесь клиентом мобильных услуг, узнайте о выставлении счетов в документации по мобильности. Дополнительную информацию о записи транзакций см. в разделе Настройка выставления счетов . Чтобы узнать, как добавить идентификаторы транзакций в реализацию Navigation SDK, см. раздел «Связывание использования службы с транзакциями мобильности» .
Что дальше
Теперь, когда у вас есть ключ API и проект Xcode, вы можете создавать и запускать приложения. Navigation SDK для iOS предоставляет учебные пособия, которые помогут вам начать работу. Более подробную информацию см.: