Команда Google Maps Platform регулярно обновляет SDK, добавляя новые функции, исправления ошибок и улучшения производительности. На этой странице приведены рекомендации по управлению зависимостями от мобильных SDK.
На какую версию ссылаться?
Для критически важных приложений создайте ссылку на последнюю точечную версию основной версии, которую вы используете (X.*), и ежегодно выполняйте обновление до новой основной версии.
По мере выпуска новых версий вашего приложения в течение года вы можете начать использовать более новые точечные версии Maps SDK для iOS. Это не потребует обновлений в вашем приложении, так как новые точечные версии обратно совместимы.
Преимущества:
- Если вы обнаружите проблемы в Maps SDK для iOS, исправления будут предоставляться с обратной совместимостью в течение 12 месяцев после первоначального выпуска основной версии в соответствии с политикой поддержки мобильных устройств . Вам не нужно будет срочно переходить на несовместимую версию SDK, чтобы воспользоваться исправлениями.
- Последние улучшения и функции легко внедрить, если ваше приложение уже создано на основе последней версии.
- Ежегодные добавочные обновления новейшей основной версии SDK могут потребовать меньше усилий по адаптации, переписыванию и тестированию вашего приложения, чем обработка несовместимых с предыдущими версиями изменений, внесенных в несколько выпусков основных версий.
Для некритических приложений дайте ссылку на любую исправленную версию. Когда вы получите уведомление об устаревании этой фиксированной версии, у вас будет 12 месяцев, чтобы сделать обновленный код приложения доступным для ваших пользователей.
Преимущества:
- Менее частые работы по техническому обслуживанию.
- Новые версии вашего приложения продолжают поддерживать устройства пользователей с более старыми мобильными операционными системами дольше (пока вам не потребуется перейти на новую версию SDK).
Владельцы проектов с отслеживаемыми адресами электронной почты получают проактивные уведомления об изменениях, влияющих на каждый из их проектов. Будьте в курсе основных обновлений, прекращений поддержки и других изменений.
Установка
Всегда указывайте номер версии в своих зависимостях вместо использования оптимистического оператора ( ~>
), поскольку это может привести к непредсказуемым и неповторимым сборкам. Maps SDK для iOS придерживается семантического управления версиями , а новые выпуски основных версий содержат критические изменения.
Использование CocoaPods
Пример зависимости Podfile с использованием синтаксиса Podfile :
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '7.4.0' end
Использование Карфагена
Пример зависимости Cartfile с использованием синтаксиса Cartfile :
binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
Техническое обслуживание и обновление
Чтобы строить с последними улучшениями, регулярно проверяйте наличие новых версий и обновляйте спецификации версий. Если вы обновляетесь до новой основной версии, проверьте в примечаниях к выпуску изменения, несовместимые с предыдущими версиями, и узнайте, как обновить код.
Использование какаподов
Откройте терминал и перейдите в каталог, содержащий
Podfile
:cd <path-to-project>
- Запустите
pod outdated
, чтобы узнать, доступна ли более новая версия Maps SDK для iOS. - Если найдена более новая версия SDK, обновите свой
Podfile
этой новой версией. См. Указание версий пода , чтобы узнать, как установить конкретную версию в вашемPodfile
. - Запустите
pod update
. - Внесите необходимые изменения в результате обновления. См. примечания к выпуску для списка изменений в каждом выпуске.
- Очистите и перестройте проект, выбрав « Продукт» > «Очистить» , а затем « Продукт» > «Сборка» .
Использование Карфагена
Откройте терминал и перейдите в каталог, содержащий
Podfile
:cd <path-to-project>
- Запустите
carthage outdated
, чтобы узнать, доступна ли более новая версия Maps SDK для iOS. - Если найдена более новая версия SDK, обновите свой
Cartfile
этой новой версией. См. Требования к версии, чтобы узнать, как установить конкретную версию вCartfile
. - Запустите
carthage update
. - Внесите необходимые изменения в результате обновления. См. примечания к выпуску для списка изменений в каждом выпуске.
- Очистите и перестройте проект, выбрав « Продукт» > «Очистить» , а затем « Продукт» > «Сборка» .
Руководство по эксплуатации
Получите ссылку на последние исходные файлы в разделе Установка SDK.
Помимо опроса новых версий, владельцы проектов Google Cloud получают электронные письма об обратно несовместимых изменениях, которые могут повлиять на их проекты. Чтобы получать проактивные уведомления об обратно несовместимых изменениях, назначьте роль владельца с отслеживаемым адресом электронной почты для каждого из ваших проектов.