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

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

Чтобы отслеживать поездки по запросу в потребительских приложениях iOS, используйте Consumer SDK. Дополнительные сведения и общие сведения о следующих поездках см. в разделе «Слежение за поездкой в ​​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.

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

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

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

  1. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

Чтобы удалить существующий 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.

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

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

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

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

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

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

  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

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

Чтобы отслеживать поездки по запросу в потребительских приложениях iOS, используйте Consumer SDK. Дополнительные сведения и общие сведения о следующих поездках см. в разделе «Слежение за поездкой в ​​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.

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

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

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

  1. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

Чтобы удалить существующий 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.

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

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

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

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

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

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

  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

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

Чтобы отслеживать поездки по запросу в потребительских приложениях iOS, используйте Consumer SDK. Дополнительные сведения и общие сведения о следующих поездках см. в разделе «Слежение за поездкой в ​​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.

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

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

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

  1. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
  2. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

Чтобы удалить существующий 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.

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

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

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

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

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

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

  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