В этом разделе описывается, как проверить, соответствует ли ваша система минимальным требованиям, настроить рабочую группу и получить Driver SDK.
Прежде чем начать
Driver SDK для iOS требует, чтобы ваше приложение соответствовало следующим критериям:
- Иметь навигационный SDK.
- Включите Maps SDK для iOS в консоли Google Cloud и получите ключ API.
Проверьте минимальные системные требования
Проверьте примечания к выпуску на предмет минимальных требований для используемой вами версии Driver SDK. См. примечания к выпуску .
- Мобильное устройство должно работать под управлением iOS 14 или более поздней версии.
- Apple Xcode версии 15 или более поздней.
Получите доступ к своему рабочему пространству Google
Если вы являетесь клиентом Google Workspace, выполните следующие действия:
Создайте группу Workspace. Для получения дополнительной информации см. Workspace Group .
Например, при регистрации лучше всего назвать свою группу
google-maps-platform-sdk-users@workspacedomain.com
.Предоставьте имя Google, чтобы добавить вашу группу Workspace в список разрешенных, который предоставляет доступ к правильным репозиториям CocoaPods.
Убедитесь, что адреса электронной почты пользователей и учетных записей служб, к которым требуется доступ, включены в этот список.
Если ваша организация не может создавать группы Workspace, отправьте в Google список адресов электронной почты пользователей и учетных записей служб, которым необходим доступ к этим артефактам.
Войдите с помощью Cloud SDK
Для локальной разработки войдите с помощью Cloud SDK. Подробности см. в разделе Установка gcloud CLI .
В следующих примерах показано, как войти в систему с помощью Cloud SDK.
gcloud
gcloud auth login
Вам необходимо использовать адрес электронной почты, принадлежащий участнику Workspace Group.
Настройте хосты автоматизации
Для систем сборки или непрерывной интеграции настройте хосты автоматизации на основе предоставленного списка методов использования учетной записи службы для аутентификации в API и службах Google. Подробности см. в разделе учетной записи службы на странице Методы аутентификации на Google.
Если ваш процесс выполняется внутри среды Google Cloud, используйте автоматическое определение учетных данных. Для получения дополнительной информации см. автоматическое определение учетных данных .
В противном случае сохраните файл ключа учетной записи службы в безопасном месте в файловой системе хоста и соответствующим образом установите переменную среды GOOGLE_APPLICATION_CREDENTIALS. Для получения более подробной информации см. GOOGLE_APPLICATION_CREDENTIALS .
Адрес электронной почты учетной записи службы, связанный с учетными данными, должен быть членом группы Workspace.
Получить драйвер SDK
Установите и настройте Driver SDK.
CocoaPods
Установите инструмент CocoaPods : Откройте окно терминала и выполните следующую команду.
sudo gem install cocoapods
Более подробную информацию можно найти в руководстве по началу работы с CocoaPods .
Создайте Podfile для Driver 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
Driver SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Driver SDK.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте
project
илиworkspace
Xcode, затем перейдите в Файл > Добавить зависимости пакета . - Введите https://github.com/googlemaps/ios-driver-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
- Чтобы установить определенную
version
, установите поле Dependency Rule на один из вариантов на основе версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать параметр "Exact Version". После завершения нажмите "Add Package".
Чтобы обновить package
для существующего проекта, выполните следующие действия:
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator, чтобы проверить пакет и его версию.
Чтобы удалить существующий Driver SDK, установленный вручную, выполните следующие действия:
В настройках конфигурации проекта Xcode найдите Frameworks, Libraries, and Embedded Content . Используйте знак минус
(-)
, чтобы удалить следующий фреймворк:-
GoogleRidesharingDriver.xcframework
-
Из каталога верхнего уровня вашего проекта Xcode удалите пакет
GoogleRidesharingDriver
.
Ручная установка
В этом руководстве показано, как вручную добавить XCFramework, содержащий Driver SDK, в ваш проект и настроить параметры сборки в Xcode.
Прежде чем следовать этому руководству, выполните следующие действия:
Загрузите XCFramework, бинарный пакет, который вы используете для установки Driver SDK. Вы можете использовать этот пакет на нескольких платформах, включая машины с Apple Silicon
Установите навигационный SDK .
Чтобы вручную установить Driver SDK, выполните следующие действия:
Загрузите двоичный файл SDK и ресурсы:
Распакуйте заархивированные файлы, чтобы получить доступ к XCFramework и ресурсам.
Запустите Xcode и откройте существующий или создайте новый проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон iOS App.
Если в вашей группе проектов нет группы Frameworks, создайте ее.
Чтобы установить Driver SDK, перетащите файл
GoogleRidesharingDriver.xcframework
в свой проект в разделе Frameworks, Libraries, and 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
-
Выберите свой проект, а не конкретную цель, и откройте вкладку Build Settings . В разделе Other Linker Flags добавьте
-ObjC
для отладки и выпуска.Если эти настройки не видны, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .
Проверьте файл манифеста конфиденциальности Apple
Apple требует сведения о конфиденциальности приложений для приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.
Файл манифеста конфиденциальности Apple включен в пакет ресурсов для SDK. Чтобы убедиться, что файл манифеста конфиденциальности включен, и проверить его содержимое, создайте архив вашего приложения и сгенерируйте отчет о конфиденциальности из архива.
Что дальше?
Настройте проект консоли Google Cloud