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

Версии Driver SDK для iOS

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

С какой версией связать?

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

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

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

Наши преимущества:
- Реже требуется техническое обслуживание.
- Новые версии вашего приложения будут дольше работать на устройствах с более старыми мобильными ОС – пока не потребуется перейти на новую версию SDK.

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

Установка

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

CocoaPods

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

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

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

Swift Package Manager

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

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

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

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

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

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

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

Cocoapods

Откройте терминал и перейдите в каталог, содержащий Podfile:
```
cd <path-to-project>
```
Выполните команду pod outdated, чтобы проверить, доступна ли более новая версия Driver SDK для iOS.
Если доступна более новая версия SDK, обновите Podfile. Чтобы узнать, как задать определенную версию в файле Podfile, прочитайте статью Specifying pod versions (Как указать версию Pod).
Выполните команду pod update.
Внесите необходимые изменения. Список изменений в каждом выпуске можно найти в примечаниях к выпуску.
Очистите и заново соберите проект, выбрав Product (Продукт) > Clean (Очистить), а затем Product (Продукт) > Build (Собрать).

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

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

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