Wear ОS 5.1

Wear OS 5.1 доступна на некоторых устройствах и в официальном эмуляторе Android Studio. Убедитесь, что ваше приложение работает должным образом после обновления целевой версии SDK .

Wear OS 5.1 основана на Android 15 (уровень API 35), поэтому вам необходимо протестировать свои приложения, которые уже ориентированы на уровень API 34, для Wear OS 5.

Подготовьте поддерживаемое устройство для тестирования.

Wear OS 5.1 может работать на следующих устройствах:

  • Google Pixel Watch 3
  • Google Pixel Watch 2
  • Google Pixel Watch

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

Подготовьте эмулятор к тестированию.

Для запуска Wear OS 5.1 в официальном эмуляторе необходимо сначала загрузить и установить образ системы, работающий на эмуляторе. Затем необходимо создать виртуальное устройство, на котором будет запущен этот образ системы.

Загрузите и установите образ системы.

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

  1. Загрузите и установите последнюю версию Android Studio Ladybug Feature Drop или более позднюю, если вы еще этого не сделали.
  2. В Android Studio перейдите в меню Инструменты > Менеджер SDK .
  3. На вкладке «Платформы SDK» выберите «Показать сведения о пакете» и разверните раздел Android 15.0 («VanillaIceCream») , содержащий артефакты для уровня API 35-ext15. Затем выберите либо образ системы Wear OS 5.1 ARM 64 v8a , либо образ системы Wear OS 5.1 Intel x86_64 Atom .

    «Образцы сборки эмулятора находятся в группе образов сборки для Android API 35»

  4. Нажмите ОК . Когда появится окно «Подтверждение изменения» , снова нажмите ОК .

  5. Дождитесь, пока Android Studio загрузит и установит образ системы, а затем нажмите «Готово» .

Создайте виртуальное устройство

Для создания виртуального устройства, на котором будет запускаться этот образ системы в официальном эмуляторе, выполните следующие шаги:

  1. В Android Studio откройте Диспетчер устройств, выбрав Инструменты > Диспетчер устройств . Откроется панель Диспетчер устройств .
  2. На панели инструментов в разделе «Диспетчер устройств» нажмите «Добавить новое устройство». > Создать виртуальное устройство .
  3. В панели «Форм-фактор» выберите Wear OS и укажите аппаратный профиль. Нажмите «Далее» .
  4. Выберите образ системы Wear OS 5.1 для использования. Уровень API образа системы должен быть равен 35 .
  5. Нажмите «Далее» , а затем « Готово» .

Протестируйте свое приложение на эмуляторе.

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

  1. Перейдите на панель инструментов Android Studio и выберите виртуальное устройство.
  2. Нажмите « Запустить» .
  3. Установите приложение на виртуальное устройство и пройдите по различным пользовательским интерфейсам, которые использует ваше приложение.

Изменения, затрагивающие все приложения.

При тестировании вашего приложения на Wear OS 5.1 проверьте, как оно обрабатывает изменения в поведении системы, затрагивающие все приложения в Android 15 , который использует тот же уровень API, что и Wear OS 5.1.

В Wear OS 5.1 ряд изменений в поведении не вступает в силу:

Обновите целевую версию SDK вашего приложения.

Вы можете улучшить совместимость своего приложения с Wear OS 5.1, обновив целевую версию SDK до уровня API 35. (Это тот же уровень API, который используется в Android 15. )

Для этого откройте файл build.gradle или build.gradle.kts на уровне модуля и обновите его значениями для Wear OS 5.1.

Способ форматирования значений в файле сборки зависит от версии используемого плагина Android Gradle (AGP).

AGP 7.0.0 или выше

Если вы используете AGP 7.0.0 или выше, обновите файл build.gradle или build.gradle.kts вашего приложения, указав следующие значения для Wear OS 5.1:

Классный

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Котлин

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 или ниже

Если вы используете AGP 4.2.0 или более раннюю версию, обновите файл build.gradle или build.gradle.kts вашего приложения, указав следующие значения для Wear OS 5.1:

Классный

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Котлин

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

Изменения, затрагивающие только приложения, ориентированные на API уровня 35.

После обновления целевой версии SDK до уровня API 35, обработайте изменения для приложений, ориентированных на Android 15 , который использует тот же уровень API, что и Wear OS 5.1.

Ознакомьтесь с новыми функциями

В Wear OS 5.1 представлен ряд функций, призванных улучшить работу с приложениями Wear OS.

К числу наиболее примечательных особенностей, заслуживающих внимания, относятся следующие:

  • Поддержка менеджера учетных данных: API менеджера учетных данных предоставляет унифицированное решение для аутентификации, поддерживающее потоки входа в систему с использованием паролей, ключей доступа и федеративной идентификации (например, вход через Google ). Учетные данные пользователя хранятся в поставщике учетных данных, который синхронизирует информацию об учетной записи между устройствами.
  • Воспроизведение через динамик часов: На устройствах, поддерживающих воспроизведение мультимедиа через динамик часов, пользователи могут выбрать этот динамик в качестве предпочтительного способа вывода мультимедиа, если ваше приложение интегрировано с Wear Output Switcher .

Примечания к выпуску

Последняя версия образа системы Wear OS 5.1, доступная на поддерживаемых устройствах и в эмуляторе, обладает следующими характеристиками:

Дата выпуска

18 марта 2025 года для Google Pixel Watch 3 LTE, Google Pixel Watch 2 LTE и Google Pixel Watch (как с Bluetooth/Wi-Fi, так и с LTE).

4 марта 2025 года для Google Pixel Watch 3 Bluetooth/Wi-Fi и Google Pixel Watch 2 Bluetooth/Wi-Fi

Строить

BP1A.250305.019.W3 на Google Pixel Watch 3 и Google Pixel Watch 2

BP1A.250305.019.W2 на Google Pixel Watch

AP4A.241205.004.F4 на эмуляторе

Поддержка эмулятора x86 (64-бит), ARM (v8-A)

Известные проблемы

В образе системы, содержащем Wear OS 5.1, обнаружены следующие известные проблемы:

  • Эмулятор не всегда позволяет пользователю добавить учетную запись во время процесса настройки после сброса устройства.
  • При нажатии на уведомление приложение, отправившее его, не открывается до тех пор, пока пользователь не прокрутит экран.
  • Иногда служба здравоохранения Уира не начинает выполнение упражнений.
  • При обращении к библиотекам androidx.wear.tiles или androidx.wear:wear-phone-interactions в приложении, ориентированном на API уровня 35, может возникнуть исключение SecurityException . Для решения этой проблемы обновите библиотеку androidx.wear.tiles до версии 1.5.0-alpha05 или более поздней, либо androidx.wear:wear-phone-interactions до версии 1.1.0 или более поздней.