Получите потребительский SDK iOS

Выберите платформу: Android iOS JavaScript

Чтобы отслеживать поездки по запросу в потребительских приложениях iOS, используйте Consumer SDK. Дополнительные сведения и общие сведения о отслеживании поездок с помощью совместного использования поездок см. в разделе «Слежение за поездкой в ​​iOS» .

Примеры см. в примерах приложений для iOS или в комбинированных примерах .

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

1. Проверьте минимальные системные требования .
2. Получите потребительский SDK .
3. Проверьте файл манифеста конфиденциальности Apple .
4. Настройте проект Google Cloud Console .
5. Получите токены аутентификации .
6. Инициализируйте потребительский SDK .

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

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

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

Получите потребительский SDK

Вы устанавливаете и настраиваете Consumer SDK с помощью CocoaPods.

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

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

Важно: Эти инструкции предполагают использование Xcode 15 или более поздней версии, но они должны быть аналогичны предыдущим версиям Xcode.

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

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

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

1. Если вы выполняете обновление с версии более ранней, чем 9.0.0, после обновления необходимо удалить следующие зависимости: GoogleMapsBase , GoogleMapsCore и GoogleMapsM4B . Не удаляйте зависимость для GoogleMaps . Дополнительную информацию см. в примечаниях к выпуску версии 9.0.0 .

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

   • GoogleMapsBase (только для обновлений с версий ранее 9.0.0)
   • GoogleMapsCore (только для обновлений с версий ранее 9.0.0)
   • GoogleMapsM4B (только для обновлений с версий ранее 9.0.0)
2. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
3. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта» , чтобы проверить пакет и его версию.

Важно: иногда артефакты не удается устранить или могут возникнуть ошибки. В этом случае выберите «Файл» > «Пакеты» > «Сбросить кэш пакетов».

Чтобы удалить существующие зависимости Consumer SDK, добавленные с помощью CocoaPods , выполните следующие действия:

1. Закройте рабочую область Xcode. Откройте терминал и выполните следующую команду:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Удалите Podfile , Podfile.resolved и workspace Xcode, если вы не используете их ни для чего, кроме CocoaPods.

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

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

   • GoogleRidesharingConsumer.xcframework

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

Используйте CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

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

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      

   3. Сохраните подфайл : откройте терминал и перейдите в папку с подфайлом:

      cd <path-to-project>
      

3. Запустите команду установки модуля : эта команда устанавливает API, указанные в подфайле, а также все зависимости, которые они могут иметь.

   pod install
   

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

   Примечание. Периодически запускайте pod outdated чтобы обнаружить появление более новой версии SDK. Дополнительные сведения см. в разделе Версии Consumer SDK в примечаниях к выпуску Consumer SDK .

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

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

Внимание : рекомендуется по возможности использовать Cocoapods для установки Consumer SDK.

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

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

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

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

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

6. Чтобы установить Consumer SDK, перетащите файл GoogleRidesharingConsumer.xcframework в свой проект в разделе Frameworks, Libraries и Embedded Content . При появлении запроса выберите Копировать элементы .

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

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

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

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте -ObjC как для отладки, так и для выпуска.

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

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

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

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

Что дальше

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