В этом разделе рассказывается, как проверить, соответствует ли ваша система минимальным требованиям, настроить группу Workspace и получить Driver SDK.
Подготовка
Приложение, в которое интегрирован Driver SDK для iOS, должно соответствовать следующим требованиям:
- Navigation SDK.
- Включите Maps SDK для iOS в консоли Google Cloud и получите ключ API.
Проверьте минимальные системные требования
Ознакомьтесь с примечаниями к выпуску, чтобы узнать минимальные требования для используемой вами версии Driver SDK. Ознакомьтесь с примечаниями к выпуску.
- На мобильном устройстве должна быть установлена ОС iOS 16 или более поздней версии.
- Apple Xcode версии 26 или более поздней.
Как получить доступ к Google Workspace
Если вы клиент Google Workspace, выполните следующие действия:
Создайте группу Workspace. Подробнее о группах Workspace…
Например, на этапе регистрации рекомендуем назвать группу
google-maps-platform-sdk-users@workspacedomain.com.Укажите название, чтобы добавить группу Workspace в белый список, который предоставляет доступ к нужным репозиториям CocoaPods.
Убедитесь, что в списке указаны адреса электронной почты пользователей и сервисных аккаунтов, которым требуется доступ.
Если в вашей организации нельзя создавать группы Workspace, отправьте в Google список адресов электронной почты пользователей и сервисных аккаунтов, которым нужен доступ к этим объектам.
Как войти в аккаунт с помощью Cloud SDK
Для локальной разработки войдите в Cloud SDK. Подробнее о том, как установить gcloud CLI…
Ниже приведены примеры входа с помощью Cloud SDK.
gcloud
gcloud auth login
Используйте адрес электронной почты, который входит в группу Workspace.
Как настроить хосты автоматизации
Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования сервисного аккаунта для аутентификации в API и сервисах Google. Подробнее о сервисных аккаунтах…
Если процесс выполняется в среде Google Cloud, используйте автоматическое обнаружение учетных данных. Подробнее об автоматическом обнаружении учетных данных…
В противном случае сохраните файл ключа сервисного аккаунта в безопасном месте в файловой системе хоста и задайте соответствующее значение переменной среды GOOGLE_APPLICATION_CREDENTIALS. Подробнее GOOGLE_APPLICATION_CREDENTIALS…
Адрес электронной почты сервисного аккаунта, связанный с учетными данными, должен быть участником группы Workspace.
Как получить Driver SDK
Установите и настройте Driver SDK.
CocoaPods
Установите инструмент CocoaPods. Откройте окно терминала и выполните следующую команду:
sudo gem install cocoapodsПодробнее о том, как начать работу с CocoaPods…
Создайте файл Podfile для Driver SDK. Он используется для установки 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 Package Manager
Driver SDK можно установить с помощью Swift Package Manager. Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Driver SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
-
Откройте файл
projectилиworkspaceв Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов). - Введите URL https://github.com/googlemaps/ios-driver-sdk, нажмите Ввод, чтобы добавить пакет, и нажмите "Добавить пакет".
-
Чтобы установить определенный
version, в поле Правило зависимости выберите один из вариантов на основе версии. Для новых проектов рекомендуется указывать последнюю версию и выбирать вариант "Точная версия". Когда все будет готово, нажмите "Добавить пакет". -
В окне Выбор продуктов пакета убедитесь, что
GoogleRidesharingDriverбудет добавлен в целевой объектmain. Когда все будет готово, нажмите "Добавить пакет". - Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) должны быть перечислены установленные пакеты. Также вы можете посмотреть раздел "Зависимости пакетов" в навигаторе проекта, чтобы проверить пакет и его версию.
Чтобы изменить package для существующего проекта, выполните следующие действия:
- В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
- Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.
Чтобы удалить установленный вручную пакет Driver SDK, выполните следующие действия:
В настройках конфигурации проекта Xcode найдите раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Нажмите на знак минуса
(-), чтобы удалить следующий фреймворк:GoogleRidesharingDriver.xcframework
Удалите пакет
GoogleRidesharingDriverиз каталога верхнего уровня проекта Xcode.
Установка вручную
В этом руководстве рассказывается, как вручную добавить в проект XCFramework с Driver SDK и настроить параметры сборки в Xcode.
Прежде чем следовать инструкциям в этом руководстве, сделайте следующее:
Скачайте XCFramework – двоичный пакет, который используется для установки Driver SDK. Этот пакет можно использовать на разных платформах, в том числе на компьютерах с чипом Apple.
Установите Navigation SDK.
Чтобы установить Driver SDK вручную, выполните следующие действия:
Скачайте исполняемый файл SDK и ресурсы:
Распакуйте ZIP-архивы, чтобы получить доступ к XCFramework и ресурсам.
Запустите Xcode и откройте существующий проект или создайте новый. Если вы впервые работаете с iOS, создайте новый проект и выберите шаблон приложения для iOS.
Если в группе проекта нет группы Frameworks, создайте ее.
Чтобы установить Driver SDK, перетащите файл
GoogleRidesharingDriver.xcframeworkв проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Если появится запрос, выберите Копировать объекты.Перетащите скачанный файл
GoogleRidesharingDriver.bundleв каталог верхнего уровня проекта Xcode. Если появится запрос, выберите Копировать объекты.Выберите проект в навигаторе проектов и укажите цель приложения.
Откройте вкладку Build Phases (Этапы сборки) и в разделе Link Binary with Libraries (Связать двоичный файл с библиотеками) добавьте следующие фреймворки и библиотеки, если они ещё не добавлены:
Accelerate.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
Выберите проект, а не определенную цель, и откройте вкладку Настройки сборки. В разделе Other Linker Flags (Другие флаги компоновщика) добавьте флаг
-ObjCдля отладочной и рабочей версии.Если эти настройки не видны, измените фильтр на панели Настройки сборки с Основные на Все.
Как проверить файл манифеста конфиденциальности Apple
Apple требует, чтобы разработчики приложений, размещенных в App Store, предоставляли информацию о конфиденциальности. Чтобы узнать больше, посетите страницу сведений о конфиденциальности в Apple App Store.
Файл манифеста конфиденциальности Apple включен в пакет ресурсов SDK. Чтобы убедиться, что файл манифеста конфиденциальности включен, и проверить его содержимое, создайте архив приложения и сгенерируйте отчет о конфиденциальности из архива.
Дальнейшие действия
Как настроить проект в консоли Google Cloud