Получить SDK драйвера

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

Прежде чем начать

Driver SDK для iOS требует, чтобы ваше приложение соответствовало следующим критериям:

  • Имейте навигационный SDK.
  • Включите Maps SDK для iOS в своей Google Cloud Console и получите ключ API.

Проверьте минимальные системные требования

Ознакомьтесь с примечаниями к выпуску, чтобы узнать минимальные требования для используемой вами версии Driver SDK. См. Примечания к выпуску .

  • Мобильное устройство должно работать под управлением iOS 14 или более поздней версии.
  • Apple Xcode версии 15 или новее.

Получите доступ к своему Google Workspace

Если вы являетесь клиентом Google Workspace, выполните следующие действия:

  1. Создайте группу рабочей области. Дополнительные сведения см. в разделе Группа рабочих пространств .

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

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

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

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

Войдите с помощью Cloud SDK

Для локальной разработки войдите в систему с помощью Cloud SDK. Подробности см. в разделе «Установка интерфейса командной строки gcloud» .

В следующих примерах показано, как войти в систему с помощью Cloud SDK.

gcloud

gcloud auth login

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

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

Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования учетной записи службы для аутентификации в API и службах Google. Подробную информацию см. в разделе «Учетная запись службы» на странице «Методы аутентификации в Google».

  • Если ваш процесс выполняется в среде Google Cloud, используйте автоматическое определение учетных данных. Дополнительные сведения см. в разделе автоматическое определение учетных данных .

  • В противном случае сохраните файл ключей сервисного аккаунта в безопасном месте в файловой системе хоста и установите соответствующую переменную среды GOOGLE_APPLICATION_CREDENTIALS. Дополнительную информацию см. в разделе GOOGLE_APPLICATION_CREDENTIALS .

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

Получить SDK драйвера

Установите и настройте Driver SDK.

Какао-стручки

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

    sudo gem install cocoapods
    

    Более подробную информацию можно найти в руководстве по началу работы с CocoaPods .

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

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

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

      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. Сохраните подфайл : откройте терминал и перейдите в папку с подфайлом:

      cd <path-to-project>
      
  3. Запустите команду установки модуля : эта команда установит API, указанные в подфайле, вместе со всеми зависимостями, которые они могут иметь.

    pod install
    
  4. Откройте свой проект в Xcode : закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл .xcworkspace.

Менеджер пакетов Swift

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

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

  1. Откройте project или workspace Xcode, затем выберите «Файл» > «Добавить зависимости пакета» .
  2. Введите https://github.com/googlemaps/ios-driver-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  3. Чтобы установить конкретную version , установите в поле «Правило зависимости» один из вариантов на основе версии. Для новых проектов рекомендуем указывать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет».
  4. В окне «Выбор продуктов пакета» убедитесь, что GoogleRidesharingDriver будет добавлен к назначенной вами main цели. После завершения нажмите «Добавить пакет».
  5. Чтобы проверить установку, перейдите на панель General целевой системы. В разделе «Платформы», «Библиотеки» и «Встроенный контент» вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

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

  1. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

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

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

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

Ручная установка

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

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

  • Загрузите XCFramework — двоичный пакет, который вы используете для установки Driver SDK. Вы можете использовать этот пакет на нескольких платформах, включая машины, использующие процессор Apple.

  • Установите навигационный SDK .

Выполните следующие шаги, чтобы вручную установить Driver SDK:

  1. Загрузите двоичный файл SDK и ресурсы:

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

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

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

  5. Чтобы установить Driver SDK, перетащите файл GoogleRidesharingDriver.xcframework в свой проект в разделе «Платформы, библиотеки и встроенный контент» . При появлении запроса выберите Копировать элементы .

  6. Перетащите загруженный файл GoogleRidesharingDriver.bundle в каталог верхнего уровня вашего проекта Xcode. При появлении запроса выберите Копировать элементы .

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

  8. Откройте вкладку «Фазы сборки» и в разделе «Связывание двоичных файлов с библиотеками » добавьте следующие платформы и библиотеки, если они еще не присутствуют:

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

    Если эти настройки не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .

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

Apple требует предоставить информацию о конфиденциальности для приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.

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

Что дальше

Настройка проекта Google Cloud Console

,

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

Прежде чем начать

Driver SDK для iOS требует, чтобы ваше приложение соответствовало следующим критериям:

  • Имейте навигационный SDK.
  • Включите Maps SDK для iOS в своей Google Cloud Console и получите ключ API.

Проверьте минимальные системные требования

Ознакомьтесь с примечаниями к выпуску, чтобы узнать минимальные требования для используемой вами версии Driver SDK. См. Примечания к выпуску .

  • Мобильное устройство должно работать под управлением iOS 14 или более поздней версии.
  • Apple Xcode версии 15 или новее.

Получите доступ к своему Google Workspace

Если вы являетесь клиентом Google Workspace, выполните следующие действия:

  1. Создайте группу рабочей области. Дополнительные сведения см. в разделе Группа рабочих пространств .

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

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

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

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

Войдите с помощью Cloud SDK

Для локальной разработки войдите в систему с помощью Cloud SDK. Подробности см. в разделе «Установка интерфейса командной строки gcloud» .

В следующих примерах показано, как войти в систему с помощью Cloud SDK.

gcloud

gcloud auth login

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

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

Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования учетной записи службы для аутентификации в API и службах Google. Подробную информацию см. в разделе «Учетная запись службы» на странице «Методы аутентификации в Google».

  • Если ваш процесс выполняется в среде Google Cloud, используйте автоматическое определение учетных данных. Дополнительные сведения см. в разделе автоматическое определение учетных данных .

  • В противном случае сохраните файл ключей сервисного аккаунта в безопасном месте в файловой системе хоста и установите соответствующую переменную среды GOOGLE_APPLICATION_CREDENTIALS. Дополнительную информацию см. в разделе GOOGLE_APPLICATION_CREDENTIALS .

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

Получить SDK драйвера

Установите и настройте Driver SDK.

Какао-стручки

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

    sudo gem install cocoapods
    

    Более подробную информацию можно найти в руководстве по началу работы с CocoaPods .

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

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

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

      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. Сохраните подфайл : откройте терминал и перейдите в папку с подфайлом:

      cd <path-to-project>
      
  3. Запустите команду установки модуля : эта команда установит API, указанные в подфайле, вместе со всеми зависимостями, которые они могут иметь.

    pod install
    
  4. Откройте свой проект в Xcode : закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл .xcworkspace.

Менеджер пакетов Swift

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

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

  1. Откройте project или workspace Xcode, затем выберите «Файл» > «Добавить зависимости пакета» .
  2. Введите https://github.com/googlemaps/ios-driver-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  3. Чтобы установить конкретную version , установите в поле «Правило зависимости» один из вариантов, зависящих от версии. Для новых проектов рекомендуем указывать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет».
  4. В окне «Выбор продуктов пакета» убедитесь, что GoogleRidesharingDriver будет добавлен к назначенной вами main цели. После завершения нажмите «Добавить пакет».
  5. Чтобы проверить установку, перейдите на панель General целевой системы. В разделе «Платформы», «Библиотеки» и «Встроенный контент» вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

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

  1. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

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

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

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

Ручная установка

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

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

  • Загрузите XCFramework — двоичный пакет, который вы используете для установки Driver SDK. Вы можете использовать этот пакет на нескольких платформах, включая машины, использующие процессор Apple.

  • Установите навигационный SDK .

Выполните следующие шаги, чтобы вручную установить Driver SDK:

  1. Загрузите двоичный файл SDK и ресурсы:

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

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

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

  5. Чтобы установить Driver SDK, перетащите файл GoogleRidesharingDriver.xcframework в свой проект в разделе «Платформы, библиотеки и встроенный контент» . При появлении запроса выберите Копировать элементы .

  6. Перетащите загруженный файл GoogleRidesharingDriver.bundle в каталог верхнего уровня вашего проекта Xcode. При появлении запроса выберите Копировать элементы .

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

  8. Откройте вкладку «Фазы сборки» и в разделе «Связывание двоичных файлов с библиотеками » добавьте следующие платформы и библиотеки, если они еще не присутствуют:

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

    Если эти настройки не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .

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

Apple требует предоставить информацию о конфиденциальности для приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.

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

Что дальше

Настройка проекта Google Cloud Console