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

Выберите платформу: Android iOS JavaScript

Примечание: Функции Places SDK для iOS, доступные в вашем приложении, определяются комбинацией номера версии SDK, указанного в конфигурации приложения, и API, включённых в вашем ключе API. Подробнее см. в разделе «Выбор версии SDK» .

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

На какую версию ссылаться?

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

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

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

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

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

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

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

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

Установка

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

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

ВАЖНО: Эти инструкции предполагают использование XCODE 15 или более поздней версии, но должны быть похожими для предыдущих версий XCODE.

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

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

   Если вы обновляете Google Places Swift с устаревшего URL-адреса GitHub

   Важно: URL-адрес GitHub для доступа к Google Places Swift изменился, начиная с версии 0.3.0. Если вы обновляете версию GooglePlacesSwift, доступ к которой осуществлялся по старому URL-адресу https://github.com/googlemaps/ios-places-swift-sdk , удалите его из раздела зависимостей пакетов Xcode.

5. Чтобы проверить установку, перейдите на панель «Общие» вашей целевой платформы. В разделе «Фреймворки», «Библиотеки» и «Встроенный контент» вы увидите установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проектов», чтобы проверить пакет и его версию.

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

1. В Xcode перейдите в «Файл > Пакеты > Обновить до последних версий пакетов».

   Если вы обновляете Google Places Swift с устаревшего URL-адреса GitHub

   Важно: URL-адрес GitHub для доступа к Google Places Swift изменился, начиная с версии 0.3.0. Если вы обновляете версию GooglePlacesSwift, доступ к которой осуществлялся по старому URL-адресу https://github.com/googlemaps/ios-places-swift-sdk , удалите его из раздела зависимостей пакетов Xcode.

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

Важно: Иногда артефакты не могут быть устранены или могут возникнуть ошибки, в этом случае выберите «Файл > Пакеты > Сбросить кэш пакетов».

CocoaPods

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.4.0'
  pod 'GooglePlacesSwift', '10.4.0'
end

Техническое обслуживание и модернизация

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

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

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

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

Важно: Иногда артефакты не могут быть устранены или могут возникнуть ошибки, в этом случае выберите «Файл > Пакеты > Сбросить кэш пакетов».

Кокоаподы

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

   cd <path-to-project>

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

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

Ссылку на последние исходные файлы можно получить в разделе Установка SDK.

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