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

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

Чтобы отслеживать поездки по требованию в ваших потребительских приложениях iOS, используйте Consumer SDK. Для получения дополнительной информации и введения в отслеживание поездок см. раздел Отслеживание поездки в iOS .

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

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

1. Проверьте минимальные системные требования .
2. Получите Consumer SDK .
3. Проверьте файл Манифеста конфиденциальности Apple .
4. Настройте проект Google Cloud Console .
5. Получите токены аутентификации .
6. Инициализируйте Consumer 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 , установите поле Dependency Rule на один из вариантов на основе версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать параметр "Exact Version". После завершения нажмите "Add Package".

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

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

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

   sudo gem install cocoapods
   

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

2. Создайте Podfile для Consumer SDK : Podfile используется для установки API и его зависимостей.

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

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

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

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

      cd <path-to-project>
      

3. Выполните команду pod install : эта команда устанавливает API, указанные в Podfile, вместе со всеми их зависимостями.

   pod install
   

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

   Примечание: Периодически запускайте pod outdated , чтобы обнаружить, когда есть более новая версия SDK. Для получения дополнительной информации см. Consumer SDK Versions в Consumer SDK Release Notes .

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

В этом руководстве показано, как вручную добавить 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 App.

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

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

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

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. Выберите свой проект, а не конкретную цель, и откройте вкладку Build Settings . В разделе Other Linker Flags добавьте -ObjC для отладки и выпуска.

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

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

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

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

Что дальше?

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