В этом разделе описывается, как проверить соответствие вашей системы минимальным требованиям, настроить рабочую группу и получить комплект разработчика драйверов (Driver SDK).
Прежде чем начать
Для работы Driver SDK для iOS ваше приложение должно соответствовать следующим критериям:
- Требуется SDK для навигации.
- Включите SDK для iOS в консоли Google Cloud и получите ключ API.
Проверьте минимальные системные требования
Для получения информации о минимальных требованиях к используемой вами версии Driver SDK ознакомьтесь с примечаниями к выпуску. См. примечания к выпуску .
- На мобильном устройстве должна быть установлена операционная система iOS 14 или более поздней версии.
- Версия Apple Xcode 15 или более поздняя.
Получите доступ к своему рабочему пространству Google.
Если вы являетесь пользователем Google Workspace, выполните следующие действия:
Создайте группу рабочих областей. Дополнительную информацию см. в разделе «Группа рабочих областей» .
Например, в качестве рекомендации, при адаптации новых сотрудников, назовите свою группу
google-maps-platform-sdk-users@workspacedomain.com.Укажите имя группе рабочих пространств Google, чтобы добавить ее в список разрешенных, предоставляющий доступ к нужным репозиториям CocoaPods.
Убедитесь, что адреса электронной почты пользователей и учетных записей служб, которым необходим доступ, включены в этот список.
Если ваша организация не может создавать группы рабочих пространств, отправьте 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
Установите инструмент CocoaPods : откройте окно терминала и выполните следующую команду.
sudo gem install cocoapodsДля получения более подробной информации обратитесь к руководству по началу работы с CocoaPods .
Создайте файл Podfile для драйвера SDK : вы используете Podfile для установки API и его зависимостей.
Создайте файл с именем
Podfileв каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.Отредактируйте 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Сохраните файл Podfile : Откройте терминал и перейдите в папку с файлом Podfile:
cd <path-to-project>
Выполните команду `pod install` : Эта команда установит API, указанные в Podfile, а также все их зависимости.
pod installОткройте свой проект в Xcode : закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. Чтобы открыть проект позже, используйте файл .xcworkspace.
Swift Package Manager
Пакет Driver SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Driver SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте свой
projectилиworkspaceXcode, затем перейдите в меню Файл > Добавить зависимости пакета . - Введите в качестве URL-адреса https://github.com/googlemaps/ios-driver-sdk , нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
- Чтобы установить конкретную
version, установите в поле « Правило зависимости» один из вариантов, основанных на версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет».
Чтобы обновить package для существующего проекта, выполните следующие действия:
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator и проверьте пакет и его версию.
Чтобы удалить установленный вручную драйвер SDK, выполните следующие действия:
В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус
(-)для удаления следующего фреймворка:-
GoogleRidesharingDriver.xcframework
-
В корневом каталоге вашего проекта Xcode удалите пакет
GoogleRidesharingDriver.
Ручная установка
В этом руководстве показано, как вручную добавить XCFramework, содержащий Driver SDK, в ваш проект и настроить параметры сборки в Xcode.
Прежде чем следовать этому руководству, выполните следующие действия:
Загрузите XCFramework — бинарный пакет, используемый для установки Driver SDK. Этот пакет можно использовать на различных платформах, включая компьютеры с процессорами Apple Silicon.
Установите Navigation SDK .
Для ручной установки комплекта разработчика драйверов выполните следующие действия:
Загрузите исполняемый файл SDK и ресурсы:
Распакуйте заархивированные файлы, чтобы получить доступ к XCFramework и ресурсам.
Запустите Xcode и откройте существующий или создайте новый проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон iOS App.
Если в вашей группе проектов нет группы Frameworks, создайте её.
Для установки Driver SDK перетащите файл
GoogleRidesharingDriver.xcframeworkв свой проект в папку Frameworks, Libraries и Embedded Content . При появлении запроса выберите Copy items .Перетащите загруженный файл
GoogleRidesharingDriver.bundleв корневую директорию вашего проекта Xcode. Если появится запрос, выберите «Копировать элементы» .Выберите свой проект в навигаторе проектов и укажите целевую платформу для вашего приложения.
Откройте вкладку «Этапы сборки» и в поле «Связать двоичный файл с библиотеками» добавьте следующие фреймворки и библиотеки, если они еще не добавлены:
-
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
-
Выберите свой проект, а не конкретную целевую платформу, и откройте вкладку «Настройки сборки ». В разделе «Другие флаги компоновщика» добавьте
-ObjCкак для отладочной, так и для релизной версии.Если эти параметры не отображаются, измените фильтр на панели параметров сборки с «Основные» на «Все» .
Проверить файл манифеста конфиденциальности Apple
Компания Apple требует предоставления информации о конфиденциальности приложений в App Store. Для получения обновлений и дополнительной информации посетите страницу «Информация о конфиденциальности в Apple App Store» .
Файл Apple Privacy Manifest включен в пакет ресурсов SDK. Чтобы убедиться в наличии файла Privacy Manifest и проверить его содержимое, создайте архив вашего приложения и сгенерируйте отчет о конфиденциальности из архива.
Что дальше?
Настройка проекта в консоли Google Cloud