Носить ОС 5.1

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

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

Подготовьте поддерживаемое устройство к тестированию

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

• Google Pixel Watch 3 (Bluetooth/Wi-Fi)
• Google Pixel Watch 2 (Bluetooth/Wi-Fi)

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

• В приложении «Настройки» выберите «Система» > «Обновления системы» .
• После включения параметров разработчика запишите определенный образ программного обеспечения на устройства, поддерживающие USB-подключение для передачи данных (проводное). Например, вы можете прошить заводской образ или полный 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 :

   

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:

• Частные пространства не поддерживаются в 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.

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

Примечательные особенности, которые стоит изучить, включают следующее:

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

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

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

Дата выпуска	4 марта 2025 г.
Строить	БП1А.250305.019.W3 на устройствах AP4A.241205.004.F4 на эмуляторе
Поддержка эмулятора	x86 (64-разрядная версия), ARM (v8-A)

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

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

• Эмулятор не всегда позволяет пользователю добавить учетную запись во время настройки после сброса устройства.
• При нажатии на уведомление приложение, отправившее уведомление, не открывается, пока пользователь не прокрутит экран.
• Служба Wear Health Services иногда не может начать тренировку.
• Если вы получаете доступ к библиотекам androidx.wear.tiles или androidx.wear:wear-phone-interactions в приложении, ориентированном на уровень API 35, может возникнуть исключение SecurityException . Чтобы решить эту проблему, обновите каждую библиотеку до последней версии.