Как получить Consumer SDK для iOS

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

Чтобы отслеживать поездки по запросу в приложениях для iOS, используйте Consumer SDK. Подробнее о том, как отслеживать поездку на устройстве iOS…

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

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

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

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

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

• На мобильном устройстве должна быть установлена iOS 16 или более поздней версии.
• Apple Xcode версии 26 или более поздней.

Как получить Consumer SDK

Установите и настройте Consumer SDK с помощью CocoaPods.

Swift Package Manager

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

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

1. Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
2. Введите URL https://github.com/googlemaps/ios-consumer-sdk, нажмите Ввод, чтобы получить пакет, и нажмите "Добавить пакет".
3. Чтобы установить определенную версию version, задайте для поля Правило зависимости одно из значений, связанных с версией. Для новых проектов рекомендуется указывать последнюю версию и выбирать вариант "Точная версия". Затем нажмите "Добавить пакет".
4. В окне Выбор продуктов пакета убедитесь, что GoogleRidesharingConsumer будет добавлен в целевой объект main. Затем нажмите "Добавить пакет".
5. Чтобы проверить установку, перейдите на панель General (Общие). Установленные пакеты должны появиться в разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Вы также можете проверить пакет и его версию в разделе Package Dependencies (Зависимости пакета) в Project Navigator (Навигаторе проекта).

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

1. В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
2. Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.

Важно! Иногда артефакты не удается разрешить или могут возникать ошибки. В этом случае выберите "File (Файл) > Packages (Пакеты) > Reset Package Cache (Сбросить кеш пакетов)".

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

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

   • GoogleRidesharingConsumer.xcframework

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

Через 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" в примечаниях к выпуску Consumer SDK.

Установка вручную

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

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

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

• Скачайте XCFramework – двоичный пакет, который используется для установки Consumer SDK. Этот пакет можно использовать на нескольких платформах, включая компьютеры с чипсетом M1.

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

1. Скачайте исполняемый файл SDK и ресурсы:

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

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

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

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

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

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

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

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

9. Откройте вкладку Build Phases (Этапы сборки) и в разделе Link Binary with Libraries (Связать двоичный файл с библиотеками) добавьте следующие фреймворки и библиотеки, если они ещё не добавлены:

   • 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 для отладки и выпуска.

    Если вы не видите эти настройки, измените фильтр на панели Build Settings (Настройки сборки) с Basic (Основные) на All (Все).

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

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

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

Дальнейшие действия

Как настроить проект в консоли Google Cloud