Как получить 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…

    Например, при регистрации назовите группу google-maps-platform-sdk-users@workspacedomain.com.

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

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

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

Как войти в аккаунт с помощью Cloud SDK

Для локальной разработки войдите в Cloud SDK. Подробнее о том, как установить gcloud CLI…

Ниже показано, как войти в систему с помощью Cloud SDK.

gcloud

gcloud auth login

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

Настройте хосты автоматизации

Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования сервисного аккаунта для аутентификации в API и сервисах Google. Подробные сведения приведены в разделе о сервисных аккаунтах на странице "Способы аутентификации в 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. Podfile используется для установки API и его зависимостей.

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

    2. Отредактируйте Podfile и добавьте зависимости. Вот пример, включающий зависимости:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Ниже приведен пример, в котором в качестве зависимостей включены альфа- и бета-версии пакетов 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.

Swift Package Manager

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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. Выберите проект, а не конкретную цель, и откройте вкладку Build Settings (Настройки сборки). В разделе Other Linker Flags (Другие флаги компоновщика) добавьте -ObjC для отладки и выпуска.

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

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

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

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

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

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