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

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

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

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

  • Требуется SDK для навигации.
  • Включите SDK для iOS в консоли Google Cloud и получите ключ API.

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

Для получения информации о минимальных требованиях к используемой вами версии Driver SDK ознакомьтесь с примечаниями к выпуску. См. примечания к выпуску .

  • На мобильном устройстве должна быть установлена ​​операционная система iOS 16 или более поздней версии.
  • Версия Apple Xcode 26 или более поздняя.

Получите доступ к своему рабочему пространству Google.

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

  1. Создайте группу рабочих областей. Дополнительную информацию см. в разделе «Группа рабочих областей» .

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

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

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

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

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

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

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

gcloud

gcloud auth login

Необходимо использовать адрес электронной почты, входящий в состав группы Workspace Group.

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

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

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

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

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

Загрузите комплект разработчика драйверов (Driver SDK).

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

CocoaPods

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

    sudo gem install cocoapods
    

    Для получения более подробной информации обратитесь к руководству по началу работы с CocoaPods .

  2. Создайте файл Podfile для SDK драйвера : вы используете Podfile для установки 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.

Swift Package Manager

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

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

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

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

  1. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator и проверьте пакет и его версию.

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

  1. В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) для удаления следующего фреймворка:

    • GoogleRidesharingDriver.xcframework
  2. В корневом каталоге вашего проекта Xcode удалите пакет GoogleRidesharingDriver .

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

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

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

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

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

Для ручной установки комплекта разработчика драйверов выполните следующие действия:

  1. Загрузите исполняемый файл SDK и ресурсы:

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

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

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

  5. Для установки Driver SDK перетащите файл GoogleRidesharingDriver.xcframework в свой проект в папку Frameworks, Libraries и Embedded Content . При появлении запроса выберите Copy items .

  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 Privacy Manifest включен в пакет ресурсов SDK. Чтобы убедиться в наличии файла Privacy Manifest и проверить его содержимое, создайте архив вашего приложения и сгенерируйте отчет о конфиденциальности из архива.

Что дальше?

Настройка проекта в консоли Google Cloud