В этом разделе описывается, как проверить соответствие вашей системы минимальным требованиям, настроить рабочую группу и получить Driver SDK.
Прежде чем начать
Driver SDK для iOS требует, чтобы ваше приложение соответствовало следующим критериям:
- Иметь Navigation SDK.
- Включите Maps SDK для iOS в консоли Google Cloud и получите ключ API.
Проверьте минимальные системные требования.
Минимальные требования для используемой вами версии Driver SDK указаны в примечаниях к выпуску. См. примечания к выпуску .
- Мобильное устройство должно работать под управлением iOS 14 или более поздней версии.
- Apple Xcode версии 15 или более поздней.
Получите доступ к своему рабочему пространству Google
Если вы являетесь клиентом Google Workspace, выполните следующие действия:
Создайте группу в рабочей области. Подробнее см. в разделе Группа в рабочей области .
Например, при регистрации лучше всего назвать свою группу
[email protected]
.Предоставьте имя Google, чтобы добавить вашу рабочую группу в список разрешенных, предоставляющий доступ к нужным репозиториям CocoaPods.
Убедитесь, что адреса электронной почты пользователей и учетных записей служб, к которым требуется доступ, включены в этот список.
Если ваша организация не может создавать группы Workspace, отправьте в Google список адресов электронной почты пользователей и учетных записей служб, которым необходим доступ к этим артефактам.
Войти с помощью Cloud SDK
Для локальной разработки войдите в систему, используя Cloud SDK. Подробнее см. в разделе Установка интерфейса командной строки gcloud .
В следующих примерах показано, как войти в систему с помощью Cloud SDK.
gcloud
gcloud auth login
Вам необходимо использовать адрес электронной почты, принадлежащий участнику Workspace Group.
Настройте хосты автоматизации
Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования учётной записи службы для аутентификации в API и сервисах Google. Подробнее см. в разделе «Учётная запись службы» на странице «Методы аутентификации в Google».
Если ваш процесс выполняется в среде Google Cloud, используйте автоматическое определение учётных данных. Подробнее см. в разделе «Автоматическое определение учётных данных» .
В противном случае сохраните файл ключа учётной записи службы в безопасном месте в файловой системе хоста и соответствующим образом настройте переменную среды GOOGLE_APPLICATION_CREDENTIALS. Подробнее см. в разделе GOOGLE_APPLICATION_CREDENTIALS .
Адрес электронной почты учетной записи службы, связанный с учетными данными, должен быть членом группы Workspace.
Получить Driver SDK
Установите и настройте Driver SDK.
CocoaPods
Установите инструмент CocoaPods : Откройте окно терминала и выполните следующую команду.
sudo gem install cocoapods
Более подробную информацию см. в руководстве по началу работы с CocoaPods .
Создайте Podfile для Driver SDK : Podfile используется для установки API и его зависимостей.
Создайте файл
Podfile
в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.Отредактируйте Podfile и добавьте необходимые зависимости. Вот пример, включающий зависимости:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Вот пример, который включает модули Alpha и Beta для Driver SDK в качестве зависимостей:
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Сохраните Podfile : Откройте терминал и перейдите в папку с Podfile:
cd <path-to-project>
Выполните команду pod install : эта команда установит API, указанные в Podfile, вместе со всеми их зависимостями.
pod install
Откройте проект в Xcode : закройте Xcode и дважды щёлкните по файлу .xcworkspace вашего проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл .xcworkspace.
Менеджер пакетов Swift
Driver SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Driver SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте
project
илиworkspace
Xcode, затем перейдите в Файл > Добавить зависимости пакета . - Введите https://github.com/googlemaps/ios-driver-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
- Чтобы установить определённую
version
, выберите в поле « Правило зависимости» один из вариантов, основанных на версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать параметр «Точная версия». После завершения нажмите «Добавить пакет».
Чтобы обновить package
для существующего проекта, выполните следующие действия:
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator, чтобы проверить пакет и его версию.
Чтобы удалить существующий Driver SDK, установленный вручную, выполните следующие действия:
В настройках проекта Xcode найдите раздел «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус
(-)
, чтобы удалить следующий фреймворк:-
GoogleRidesharingDriver.xcframework
-
Из каталога верхнего уровня вашего проекта Xcode удалите пакет
GoogleRidesharingDriver
.
Ручная установка
В этом руководстве показано, как вручную добавить XCFramework, содержащий Driver SDK, в ваш проект и настроить параметры сборки в Xcode.
Прежде чем следовать этому руководству, выполните следующие действия:
Загрузите XCFramework — двоичный пакет для установки Driver SDK. Этот пакет можно использовать на различных платформах, включая устройства с процессорами Apple Silicon.
Установите навигационный SDK .
Чтобы вручную установить Driver SDK, выполните следующие действия:
Загрузите двоичный файл SDK и ресурсы:
Распакуйте заархивированные файлы, чтобы получить доступ к XCFramework и ресурсам.
Запустите Xcode и откройте существующий проект или создайте новый. Если вы новичок в iOS, создайте новый проект и выберите шаблон «Приложение iOS».
Если ваша проектная группа не содержит группу Frameworks, создайте ее.
Чтобы установить Driver SDK, перетащите файл
GoogleRidesharingDriver.xcframework
в раздел «Фреймворки», «Библиотеки» и «Встроенный контент» вашего проекта. При появлении запроса выберите «Копировать элементы» .Перетащите загруженный файл
GoogleRidesharingDriver.bundle
в корневой каталог вашего проекта Xcode. При появлении запроса выберите «Копировать элементы» .Выберите свой проект в Навигаторе проектов и укажите цель вашего приложения.
Откройте вкладку «Фазы сборки» и в разделе «Связать двоичный файл с библиотеками» добавьте следующие фреймворки и библиотеки, если они еще отсутствуют:
-
Accelerate.framework
-
AudioToolbox.framework
-
AVFoundation.framework
-
CoreData.framework
-
CoreGraphics.framework
-
CoreLocation.framework
-
CoreTelephony.framework
-
CoreText.framework
-
GLKit.framework
-
ImageIO.framework
-
libc++.tbd
-
libxml2.tbd
-
libz.tbd
-
LocalAuthentication.framework
-
OpenGLES.framework
-
QuartzCore.framework
-
SystemConfiguration.framework
-
UIKit.framework
-
WebKit.framework
-
Выберите свой проект, а не конкретную целевую версию, и откройте вкладку «Параметры сборки» . В разделе «Другие флаги компоновщика» добавьте
-ObjC
для отладки и выпуска.Если эти настройки не видны, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .
Проверьте файл манифеста конфиденциальности Apple
Apple требует предоставления сведений о конфиденциальности приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.
Файл манифеста конфиденциальности Apple входит в комплект ресурсов SDK. Чтобы убедиться в наличии файла манифеста конфиденциальности и изучить его содержимое, создайте архив приложения и сгенерируйте отчёт о конфиденциальности на основе архива.
Что дальше?
Настройте проект консоли Google Cloud