Driver SDK для версий iOS

Команда платформы Google Maps регулярно обновляет SDK, добавляя новые функции, исправляя ошибки и улучшая производительность. На этой странице представлены инструкции по управлению зависимостями от мобильных SDK.

  • Для критически важных приложений установите ссылку на последний выпуск основной версии, которую вы используете (X.*), и ежегодно обновляйтесь до новой основной версии.

    По мере выпуска новых версий вашего приложения в течение года вы можете начать использовать более новые версии Driver SDK для iOS. Это не потребует обновлений вашего приложения, поскольку новые версии dot обратно совместимы.

    Преимущества:

    • Если вы обнаружите проблемы в Driver SDK для iOS, исправления будут предоставляться с обратной совместимостью в течение 12 месяцев после первоначального выпуска основной версии в соответствии с политикой поддержки мобильных устройств . Вам не нужно будет срочно обновляться до несовместимой версии SDK, чтобы воспользоваться исправлениями.
    • Последние улучшения и функции легко внедрить, если ваше приложение уже создано на основе последней версии.
    • Ежегодные дополнительные обновления новейшей основной версии SDK могут потребовать меньше работы по адаптации, переписыванию и тестированию вашего приложения, чем обработка обратно несовместимых изменений, внесенных в несколько выпусков основных версий.

  • Для некритичных приложений дайте ссылку на любую фиксированную версию. Когда вы получите уведомление об устаревании этой исправленной версии, у вас будет 12 месяцев, чтобы сделать обновленный код приложения доступным для ваших пользователей.

    Преимущества:

    • Менее частые работы по техническому обслуживанию.
    • Новые версии вашего приложения будут дольше поддерживать устройства пользователей под управлением старых мобильных операционных систем (пока вам не потребуется перейти на новую версию SDK).

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

Монтаж

Всегда указывайте номер версии в своих зависимостях вместо использования оптимистического оператора ( ~> ), поскольку это может привести к непредсказуемым и неповторимым сборкам. Driver SDK для iOS придерживается семантического управления версиями , а новые основные версии включают критические изменения.

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

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

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

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

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

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

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

  1. Закройте рабочую область Xcode. Откройте терминал и выполните следующую команду:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. Удалите Podfile , Podfile.resolved и workspace Xcode, если вы не используете их ни для чего, кроме CocoaPods.

Какао-стручки

Пример зависимости Podfile с использованием синтаксиса Podfile :

      source "https://github.com/CocoaPods/Specs.git"

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

Обслуживание и обновление

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

Какао-стручки

  1. Откройте терминал и перейдите в каталог, содержащий Podfile :

    cd <path-to-project>
  2. Запустите pod outdated , чтобы узнать, доступна ли новая версия Driver SDK для iOS.
  3. Если найдена более новая версия SDK, обновите свой Podfile этой новой версией. См. раздел «Указание версий модуля» , чтобы узнать, как установить конкретную версию в вашем Podfile .
  4. Запустите pod update .
  5. Внесите необходимые изменения в результате обновления. Список изменений в каждом выпуске см. в примечаниях к выпуску .
  6. Очистите и пересоберите проект, выбрав «Продукт» > «Очистить» , а затем «Продукт» > «Сборка».

Руководство

Получите ссылку на последние исходные файлы в разделе «Установка SDK».

Помимо опроса о новых версиях, владельцы проектов Google Cloud получают электронные письма об обратно несовместимых изменениях, которые могут повлиять на их проекты. Чтобы получать упреждающие уведомления об обратно несовместимых изменениях, назначьте роль владельца с отслеживаемым адресом электронной почты для каждого из ваших проектов.