Wear ОS 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
• Google Pixel Watch 2
• Google Pixel Watch

Ваше устройство должно получить обновление программного обеспечения «по воздуху» (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.

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

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

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

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

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

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

• Эмулятор не всегда позволяет пользователю добавить учетную запись во время настройки после сброса настроек устройства.
• При нажатии на уведомление приложение, отправившее уведомление, не открывается, пока пользователь не прокрутит экран.
• Иногда Wear Health Services не может начать выполнение упражнения.
• При доступе к библиотекам 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 или более поздней.