Команда платформы Google Maps регулярно обновляет SDK, добавляя новые функции, исправляя ошибки и улучшая производительность. На этой странице представлены инструкции по управлению зависимостями от мобильных SDK.
На какую версию дать ссылку?
Для критически важных приложений установите ссылку на последний выпуск основной версии, которую вы используете (X.*), и ежегодно обновляйтесь до новой основной версии.
По мере выпуска новых версий вашего приложения в течение года вы можете начать использовать более новые версии Maps SDK для iOS. Это не потребует обновлений вашего приложения, поскольку новые версии dot обратно совместимы.
Преимущества:
- Если вы обнаружите проблемы в Maps SDK для iOS, исправления будут предоставлены с обратной совместимостью в течение 12 месяцев после первоначального выпуска основной версии в соответствии с политикой поддержки мобильных устройств . Вам не нужно будет срочно обновляться до несовместимой версии SDK, чтобы воспользоваться исправлениями.
- Последние улучшения и функции легко внедрить, если ваше приложение уже создано на основе последней версии.
- Ежегодные дополнительные обновления новейшей основной версии SDK могут потребовать меньше работы по адаптации, переписыванию и тестированию вашего приложения, чем обработка обратно несовместимых изменений, внесенных в несколько выпусков основных версий.
Для некритичных приложений дайте ссылку на любую фиксированную версию. Когда вы получите уведомление об устаревании этой исправленной версии, у вас будет 12 месяцев, чтобы сделать обновленный код приложения доступным для ваших пользователей.
Преимущества:
- Менее частые работы по техническому обслуживанию.
- Новые версии вашего приложения будут дольше поддерживать устройства пользователей под управлением старых мобильных операционных систем (пока вам не потребуется перейти на новую версию SDK).
Владельцы проектов с отслеживаемыми адресами электронной почты получают упреждающие уведомления об изменениях, влияющих на каждый из их проектов. Будьте в курсе основных обновлений, прекращений поддержки и других изменений.
Установка
Менеджер пакетов Swift
Maps SDK для iOS можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Maps SDK для iOS.
Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:
- Откройте
project
илиworkspace
Xcode, затем выберите «Файл» > «Добавить зависимости пакета» . - Введите https://github.com/googlemaps/ios-maps-sdk в качестве URL-адреса, нажмите Enter, чтобы загрузить пакет, и нажмите «Добавить пакет».
- Чтобы установить конкретную
version
, установите в поле «Правило зависимости» один из вариантов на основе версии. Для новых проектов рекомендуем указывать последнюю версию и использовать опцию «Точная версия». После завершения нажмите «Добавить пакет». - В окне «Выбор продуктов пакета» убедитесь, что
GoogleMaps
(для версий более ранних, чем 9.0.0, убедитесь, чтоGoogleMaps
,GoogleMapsBase
иGoogleMapsCore
) будут добавлены к назначенной вамиmain
цели. После завершения нажмите «Добавить пакет». - Чтобы проверить установку, перейдите на панель
General
» целевой системы. В разделе «Платформы», «Библиотеки» и «Встроенный контент» вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.
Чтобы обновить package
для существующего проекта, выполните следующие действия:
Если вы выполняете обновление с версии более ранней, чем 9.0.0, после обновления необходимо удалить следующие зависимости:
GoogleMapsBase
,GoogleMapsCore
иGoogleMapsM4B
. Не удаляйте зависимость дляGoogleMaps
. Дополнительную информацию см. в примечаниях к выпуску версии 9.0.0 .В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
-
GoogleMapsBase
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsCore
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsM4B
(только для обновлений с версий ранее 9.0.0)
-
- В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта» , чтобы проверить пакет и его версию.
Чтобы удалить существующие зависимости Maps SDK для iOS, добавленные с помощью CocoaPods
, выполните следующие действия:
- Закройте рабочую область Xcode. Откройте терминал и выполните следующую команду:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
- Удалите
Podfile
,Podfile.resolved
иworkspace
Xcode, если вы не используете их ни для чего, кроме CocoaPods.
Какао-стручки
Всегда указывайте номер версии в своих зависимостях вместо использования оптимистического оператора ( ~>
), поскольку это может привести к непредсказуемым и неповторимым сборкам. Maps SDK для iOS придерживается семантического управления версиями , а новые основные версии включают критические изменения.
Пример зависимости Podfile с использованием синтаксиса Podfile :
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.0' end
Обслуживание и обновление
Чтобы использовать последние улучшения, регулярно проверяйте наличие новых версий и обновляйте спецификации версий. Если вы обновляетесь до новой основной версии, проверьте примечания к выпуску на предмет обратно несовместимых изменений и инструкций по обновлению кода.
Менеджер пакетов Swift
Чтобы обновить package
для существующего проекта, выполните следующие действия:
Если вы выполняете обновление с версии более ранней, чем 9.0.0, после обновления необходимо удалить следующие зависимости:
GoogleMapsBase
,GoogleMapsCore
иGoogleMapsM4B
. Не удаляйте зависимость дляGoogleMaps
. Дополнительную информацию см. в примечаниях к выпуску версии 9.0.0 .В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
-
GoogleMapsBase
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsCore
(только для обновлений с версий ранее 9.0.0) -
GoogleMapsM4B
(только для обновлений с версий ранее 9.0.0)
-
- В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
- Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта» , чтобы проверить пакет и его версию.
Какао-стручки
Откройте терминал и перейдите в каталог, содержащий
Podfile
:cd <path-to-project>
- Запустите
pod outdated
чтобы узнать, доступна ли новая версия Maps SDK для iOS. - Если найдена более новая версия SDK, обновите свой
Podfile
этой новой версией. См. раздел «Указание версий модуля» , чтобы узнать, как установить конкретную версию в вашемPodfile
. - Запустите
pod update
. - Внесите необходимые изменения в результате обновления. Список изменений в каждом выпуске см. в примечаниях к выпуску .
- Очистите и пересоберите проект, выбрав «Продукт» > «Очистить» , а затем «Продукт» > «Сборка».
Ручная установка
Получите ссылку на последние исходные файлы в разделе «Установка SDK».
Помимо опроса о новых версиях, владельцы проектов Google Cloud получают электронные письма об обратно несовместимых изменениях, которые могут повлиять на их проекты. Чтобы получать упреждающие уведомления об обратно несовместимых изменениях, назначьте роль владельца с отслеживаемым адресом электронной почты для каждого из ваших проектов.