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

Swift Package Manager

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

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

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

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

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

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

1. В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) для удаления следующего фреймворка:

   • GoogleRidesharingConsumer.xcframework

2. В корневом каталоге вашего проекта Xcode удалите пакет GoogleRidesharingConsumer .

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

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

   sudo gem install cocoapods
   

   Для получения более подробной информации обратитесь к руководству по началу работы с CocoaPods .

2. Создайте файл Podfile для потребительского 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.

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

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

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

• Загрузите 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 и 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. Выберите свой проект, а не конкретную целевую платформу, и откройте вкладку «Настройки сборки ». В разделе «Другие флаги компоновщика» добавьте -ObjC как для отладочной, так и для релизной версии.

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