Как использовать Jetpack Compose в Wear OS

Compose для Wear OS похож на Compose для мобильных устройств. Однако между ними есть несколько ключевых различий. В этом руководстве описаны сходства и различия между ними.

Compose для Wear OS – это часть Android Jetpack. Как и другие библиотеки Wear Jetpack, она помогает быстрее писать более качественный код. Это рекомендуемый подход к созданию пользовательских интерфейсов для приложений Wear OS.

Если вы не знакомы с набором инструментов Jetpack Compose, изучите руководство по Compose. Многие принципы разработки для мобильного Compose применимы к Compose для Wear OS. Подробнее о преимуществах декларативного фреймворка пользовательского интерфейса… Чтобы узнать больше о Compose для Wear OS, ознакомьтесь с курсом по Compose для Wear OS и хранилищем примеров для Wear OS на GitHub.

android skills add wear-compose-m3

Material Design в Jetpack Compose на Wear OS

Jetpack Compose для Wear OS предлагает реализацию Material 3, которая помогает создавать более привлекательные приложения. Компоненты Material Design в Wear OS созданы на основе тематического оформления Material Design для Wear. Это систематический способ настройки Material Design, позволяющий лучше отразить бренд вашего продукта.

Совместимость

Платформы

Compose для Wear OS упрощает создание приложений для Wear OS. Подробнее о приложениях… Используйте встроенные компоненты, чтобы создавать интерфейсы, соответствующие рекомендациям Wear OS. Подробную информацию о компонентах можно найти в руководстве по дизайну.

Настройка

Использование Jetpack Compose с Wear OS похоже на использование Jetpack Compose для любого другого проекта для Android. Основное отличие заключается в том, что Jetpack Compose для Wear OS добавляет библиотеки, предназначенные для часов, которые упрощают создание пользовательских интерфейсов, адаптированных для часов. В некоторых случаях эти компоненты имеют те же названия, что и их аналоги для других устройств, например androidx.wear.compose.material3.Button и androidx.compose.material3.Button.

Создайте приложение в Android Studio

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

1. Если вы находитесь в окне Welcome to Android Studio (Добро пожаловать в Android Studio), нажмите Start a new Android Studio project (Создать проект Android Studio). Если у вас уже открыт проект Android Studio, выберите в строке меню File > New > Import Sample (Файл > Создать > Импортировать пример).
2. Найдите Compose for Wear и выберите Compose for Wear OS Starter.
3. В окне Configure your project (Настройка проекта) выполните следующие действия:
   1. Укажите название приложения.
   2. Выберите местоположение проекта для вашего образца.
4. Нажмите Готово.
5. Убедитесь, что файл build.gradle проекта настроен правильно, как описано в файлах свойств Gradle.

Теперь вы готовы к разработке приложения с помощью Compose для Wear OS.

Зависимости набора инструментов Jetpack Compose

Чтобы использовать Jetpack Compose с Wear OS, вам нужно включить зависимости набора инструментов Jetpack Compose в файл build.gradle вашего приложения. Большинство изменений зависимостей, связанных с Wear OS, находятся на верхних архитектурных уровнях, выделенных красным на изображении ниже.

Это означает, что многие зависимости, которые вы уже используете с Jetpack Compose, не меняются при таргетинге на Wear OS. Например, зависимости пользовательского интерфейса, среды выполнения, компилятора и анимации остаются прежними.

Однако в Wear OS есть собственные версии библиотек material, material3, foundation и navigation, поэтому убедитесь, что вы используете правильные библиотеки.

По возможности используйте версию API WearComposeMaterial. Хотя технически возможно использовать мобильную версию Compose Material, она не оптимизирована для уникальных требований Wear OS. Кроме того, совместное использование Compose Material и Compose Material для Wear OS может привести к непредвиденному поведению. Например, поскольку у каждой библиотеки есть собственный класс MaterialTheme, при использовании обеих версий могут возникнуть несоответствия в цветах, шрифтах или формах.

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

Ниже приведен пример файла build.gradle с этими зависимостями.

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.09.00")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.13.0")
    implementation("androidx.compose.ui:ui-tooling-preview:1.12.1")
    // Other compose dependencies

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.7.1")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.7.1")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.7.1")

    // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).
    // Uncomment the line below and update the version number.
    // implementation("androidx.wear.compose:compose-navigation:1.7.1")

    // Testing
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
    androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3")
    debugImplementation("androidx.compose.ui:ui-tooling:1.4.1")

}