Носить ОС 5.1

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

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

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

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

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

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

  1. Загрузите и установите последнюю версию Android Studio Meerkat, если вы еще этого не сделали.
  2. В Android Studio нажмите «Инструменты» > «Менеджер SDK» .

  3. На вкладке «Платформы SDK» разверните раздел Android 15.0 («VanillaIceCream») и выберите либо Wear OS 5.1 — Preview ARM 64 v8a System Image , либо Wear OS 5.1 — Preview Intel x86_64 Atom System Image :

    «Образы сборок эмулятора появляются в группе образов сборок для 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 .

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

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

  • Дата выхода: 19 ноября 2024 г.
  • Идентификатор сборки: AP4A.241205.004.F1

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

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

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