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

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

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

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

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

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

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

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

Получите доступ к своему рабочему пространству 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