Чтобы отслеживать поездки по запросу в потребительских приложениях iOS, используйте Consumer SDK. Дополнительные сведения и общие сведения о отслеживании поездок с помощью совместного использования поездок см. в разделе «Слежение за поездкой в iOS» .
Чтобы настроить Consumer SDK для вашего потребительского приложения iOS, выполните следующие действия:
- Проверьте минимальные системные требования .
- Получите потребительский SDK .
- Проверьте файл манифеста конфиденциальности Apple .
- Настройте проект Google Cloud Console .
- Получите токены аутентификации .
- Инициализируйте потребительский SDK .
Проверьте минимальные системные требования
Ознакомьтесь с примечаниями к выпуску, чтобы узнать минимальные требования для используемой вами версии Consumer SDK. См. Примечания к выпуску .
- Мобильное устройство должно работать под управлением iOS 14 или более поздней версии.
- Apple Xcode версии 15 или новее.
Получите потребительский SDK
Вы устанавливаете и настраиваете Consumer SDK с помощью CocoaPods.
Менеджер пакетов Swift
Consumer SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Consumer SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте
project
илиworkspace
Xcode, затем выберите «Файл» > «Добавить зависимости пакета» . - Введите https://github.com/googlemaps/ios-consumer-sdk в качестве URL-адреса, нажмите Enter , чтобы получить пакет, и нажмите «Добавить пакет».
- Чтобы установить конкретную
version
, установите в поле «Правило зависимости» один из вариантов, зависящих от версии. Для новых проектов рекомендуем указывать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет». - В окне «Выбор пакетных продуктов» убедитесь, что
GoogleRidesharingConsumer
будет добавлен к назначенной вамиmain
цели. После завершения нажмите «Добавить пакет». - Чтобы проверить установку, перейдите на панель
General
» целевой системы. В разделе «Платформы», «Библиотеки» и «Встроенный контент» вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.
Чтобы обновить package
для существующего проекта, выполните следующие действия:
Если вы выполняете обновление с версии более ранней, чем 9.0.0, после обновления необходимо удалить следующие зависимости:
GoogleMapsBase
,GoogleMapsCore
иGoogleMapsM4B
. Не удаляйте зависимость дляGoogleMaps
. Дополнительную информацию см. в примечаниях к выпуску версии 9.0.0 .В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
-
GoogleMapsBase
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsCore
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsM4B
(только для обновлений с версий ранее 9.0.0)
-
- В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта» , чтобы проверить пакет и его версию.
Чтобы удалить существующие зависимости Consumer SDK, добавленные с помощью CocoaPods
, выполните следующие действия:
- Закройте рабочую область Xcode. Откройте терминал и выполните следующую команду:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
- Удалите
Podfile
,Podfile.resolved
иworkspace
Xcode, если вы не используете их ни для чего, кроме CocoaPods.
Чтобы удалить существующий Consumer SDK, установленный вручную, выполните следующие действия:
В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус
(-)
, чтобы удалить следующую структуру:-
GoogleRidesharingConsumer.xcframework
-
Из каталога верхнего уровня вашего проекта Xcode удалите пакет
GoogleRidesharingConsumer
.
Используйте CocoaPods
Установите инструмент CocoaPods : откройте окно терминала и выполните следующую команду:
sudo gem install cocoapods
Более подробную информацию можно найти в руководстве по началу работы с CocoaPods .
Создайте подфайл для потребительского SDK . Вы используете подфайл для установки API и его зависимостей.
Создайте файл с именем
Podfile
в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.Отредактируйте подфайл и добавьте свои зависимости. Вот пример, который включает зависимости:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
Сохраните подфайл : откройте терминал и перейдите в папку с подфайлом:
cd <path-to-project>
Запустите команду установки модуля : эта команда устанавливает API, указанные в подфайле, а также все зависимости, которые они могут иметь.
pod install
Откройте свой проект в Xcode : закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл .xcworkspace.
Ручная установка
В этом руководстве показано, как вручную добавить XCFramework, содержащий Consumer SDK, в ваш проект и настроить параметры сборки в Xcode.
Прежде чем следовать этому руководству, сделайте следующее:
Загрузите XCFramework — двоичный пакет, который вы используете для установки Consumer SDK. Вы можете использовать этот пакет на нескольких платформах, включая машины, использующие набор микросхем M1.
Установите Maps SDK .
Загрузите двоичный файл SDK и ресурсы:
Распакуйте заархивированные файлы, чтобы получить доступ к XCFramework и ресурсам.
Запустите Xcode и либо откройте, либо создайте проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон приложения iOS.
Если в вашей группе проектов нет группы Frameworks, создайте ее.
Перетащите загруженный файл
gRPCCertificates.bundle
в каталог верхнего уровня вашего проекта Xcode. При появлении запроса выберите Копировать элементы .Чтобы установить Consumer SDK, перетащите файл
GoogleRidesharingConsumer.xcframework
в свой проект в разделе Frameworks, Libraries и Embedded Content . При появлении запроса выберите Копировать элементы .Перетащите загруженный файл
GoogleRidesharingConsumer.bundle
в каталог верхнего уровня вашего проекта Xcode. При появлении запроса выберите Копировать элементы .Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
Откройте вкладку «Фазы сборки» и в разделе «Связывание двоичных файлов с библиотеками» добавьте следующие платформы и библиотеки, если они еще не присутствуют:
-
Accelerate.framework
-
CoreData.framework
-
CoreGraphics.framework
-
CoreImage.framework
-
CoreLocation.framework
-
CoreTelephony.framework
-
CoreText.framework
-
GLKit.framework
-
ImageIO.framework
-
libc++.tbd
-
libz.tbd
-
Metal.framework
-
OpenGLES.framework
-
QuartzCore.framework
-
SystemConfiguration.framework
-
UIKit.framework
-
Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте
-ObjC
как для отладки, так и для выпуска.Если эти настройки не отображаются, измените фильтр на панели «Настройки сборки» с «Базовый» на «Все» .
Проверьте файл манифеста конфиденциальности Apple.
Apple требует предоставить информацию о конфиденциальности для приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.
Файл манифеста конфиденциальности Apple включен в пакет ресурсов для SDK. Чтобы убедиться, что файл манифеста конфиденциальности включен, и проверить его содержимое, создайте архив своего приложения и создайте отчет о конфиденциальности из архива.