Как получить Driver SDK

В этом разделе рассказывается, как проверить, соответствует ли ваша система минимальным требованиям, настроить группу 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, выполните следующие действия:

1. Создайте группу Workspace. Подробнее о группах Workspace…

   Например, на этапе регистрации рекомендуем назвать группу [e-mail].

2. Укажите название, чтобы добавить группу Workspace в белый список, который предоставляет доступ к нужным репозиториям CocoaPods.

3. Убедитесь, что в списке указаны адреса электронной почты пользователей и сервисных аккаунтов, которым требуется доступ.

Если в вашей организации нельзя создавать группы Workspace, отправьте в Google список адресов электронной почты пользователей и сервисных аккаунтов, которым нужен доступ к этим объектам.

Примечание. Группы Workspace – это не то же самое, что группы Google, адреса которых заканчиваются на @googlegroups.com. Поддерживаются только группы Workspace.

Как войти в аккаунт с помощью 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

1. Установите инструмент CocoaPods. Откройте окно терминала и выполните следующую команду:

   sudo gem install cocoapods
   

   Подробнее о том, как начать работу с CocoaPods…

2. Создайте файл Podfile для Driver SDK. Он используется для установки API и его зависимостей.

   1. Создайте файл с названием Podfile в каталоге своего проекта. В этом файле определены зависимости проекта.

   2. Измените 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
      

   3. Сохраните файл Podfile. Откройте терминал и перейдите в папку с файлом Podfile:

      cd <path-to-project>
      

3. Выполните команду pod install. Она установит API, указанные в Podfile, а также все их зависимости.

   pod install
   

4. Откройте проект в Xcode . Закройте Xcode и откройте (нажмите дважды) файл XCWORKSPACE проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл XCWORKSPACE.

   Примечание. Периодически запускайте pod outdated, чтобы узнавать о новых версиях SDK. Подробнее о версиях Driver SDK для iOS…

Swift Package Manager

Driver SDK можно установить с помощью Swift Package Manager. Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Driver SDK.

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

1. Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
2. Введите URL https://github.com/googlemaps/ios-driver-sdk, нажмите Ввод, чтобы добавить пакет, и нажмите "Добавить пакет".
3. Чтобы установить определенный version, в поле Правило зависимости выберите один из вариантов на основе версии. Для новых проектов рекомендуется указывать последнюю версию и выбирать вариант "Точная версия". Когда все будет готово, нажмите "Добавить пакет".
4. В окне Выбор продуктов пакета убедитесь, что GoogleRidesharingDriver будет добавлен в целевой объект main. Когда все будет готово, нажмите "Добавить пакет".
5. Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) должны быть перечислены установленные пакеты. Также вы можете посмотреть раздел "Зависимости пакетов" в навигаторе проекта, чтобы проверить пакет и его версию.

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

1. В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
2. Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.

Важно! Иногда артефакты не удается разрешить или могут возникать ошибки. В этом случае выберите "File (Файл) > Packages (Пакеты) > Reset Package Cache (Сбросить кеш пакетов)".

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

1. В настройках конфигурации проекта Xcode найдите раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Нажмите на знак минуса(-), чтобы удалить следующий фреймворк:

   • GoogleRidesharingDriver.xcframework

2. Удалите пакет GoogleRidesharingDriver из каталога верхнего уровня проекта Xcode.

Установка вручную

В этом руководстве рассказывается, как вручную добавить в проект XCFramework с Driver SDK и настроить параметры сборки в Xcode.

Внимание! По возможности используйте Cocoapods для установки Driver SDK.

Прежде чем следовать инструкциям в этом руководстве, сделайте следующее:

• Скачайте XCFramework – двоичный пакет, который используется для установки Driver SDK. Этот пакет можно использовать на разных платформах, в том числе на компьютерах с чипом Apple.

• Установите Navigation SDK.

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

1. Скачайте исполняемый файл SDK и ресурсы:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. Распакуйте ZIP-архивы, чтобы получить доступ к XCFramework и ресурсам.

3. Запустите Xcode и откройте существующий проект или создайте новый. Если вы впервые работаете с iOS, создайте новый проект и выберите шаблон приложения для iOS.

4. Если в группе проекта нет группы Frameworks, создайте ее.

5. Чтобы установить Driver SDK, перетащите файл GoogleRidesharingDriver.xcframework в проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Если появится запрос, выберите Копировать объекты.

6. Перетащите скачанный файл GoogleRidesharingDriver.bundle в каталог верхнего уровня проекта Xcode. Если появится запрос, выберите Копировать объекты.

7. Выберите проект в навигаторе проектов и укажите цель приложения.

8. Откройте вкладку Build Phases (Этапы сборки) и в разделе Link Binary with Libraries (Связать двоичный файл с библиотеками) добавьте следующие фреймворки и библиотеки, если они ещё не добавлены:

   • 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

9. Выберите проект, а не определенную цель, и откройте вкладку Настройки сборки. В разделе Other Linker Flags (Другие флаги компоновщика) добавьте флаг -ObjC для отладочной и рабочей версии.

   Если эти настройки не видны, измените фильтр на панели Настройки сборки с Основные на Все.

Как проверить файл манифеста конфиденциальности Apple

Apple требует, чтобы разработчики приложений, размещенных в App Store, предоставляли информацию о конфиденциальности. Чтобы узнать больше, посетите страницу сведений о конфиденциальности в Apple App Store.

Файл манифеста конфиденциальности Apple включен в пакет ресурсов SDK. Чтобы убедиться, что файл манифеста конфиденциальности включен, и проверить его содержимое, создайте архив приложения и сгенерируйте отчет о конфиденциальности из архива.

Дальнейшие действия

Как настроить проект в консоли Google Cloud