Compose для Wear OS аналогичен Compose для мобильных устройств. Однако есть некоторые ключевые различия. Это руководство расскажет вам о сходствах и различиях.
Compose for Wear OS является частью Android Jetpack и, как и другие используемые вами библиотеки Wear Jetpack, помогает быстрее писать более качественный код. Это наш рекомендуемый подход к созданию пользовательских интерфейсов для приложений Wear OS .
Если вы не знакомы с использованием набора инструментов Jetpack Compose, ознакомьтесь с маршрутом Compose . Многие принципы разработки мобильного Compose применимы и к Compose для Wear OS. См. раздел «Почему Compose» для получения дополнительной информации об общих преимуществах декларативной инфраструктуры пользовательского интерфейса. Дополнительные сведения о Compose для Wear OS см. в разделе Compose for Wear OS Pathway и репозитории примеров Wear OS на GitHub.
Материальный дизайн в Jetpack Compose на Wear OS
Jetpack Compose на Wear OS предлагает реализацию Material 2.5 , которая помогает создавать более привлекательные приложения. Компоненты Material Design в Wear OS построены на основе Wear Material Theming . Эта тематика — систематический способ персонализировать Material Design и лучше отразить бренд вашего продукта.
Совместимость
Compose for Wear OS работает на часах, поддерживающих Wear OS 3.0 (уровень API 30), и часах, использующих Wear OS 2.0 (уровень API 25 и выше). Для использования версии 1.4 Compose for Wear OS требуется версия 1.7 библиотек androidx.compose и Kotlin 1.9.0. Вы можете использовать сопоставление спецификации и карту совместимости Compose с Kotlin, чтобы проверить совместимость Compose.
Поверхности
Compose for Wear OS упрощает создание приложений для Wear OS. Для получения дополнительной информации см. Приложения . Используйте наши встроенные компоненты для создания пользовательского интерфейса, соответствующего рекомендациям Wear OS. Дополнительную информацию о компонентах см. в нашем руководстве по проектированию .
Настройка
Использование Jetpack Compose с Wear OS аналогично использованию Jetpack Compose для любого другого проекта Android. Основное отличие состоит в том, что Jetpack Compose for Wear добавляет библиотеки, специфичные для Wear, которые упрощают создание пользовательских интерфейсов, адаптированных для часов. В некоторых случаях эти компоненты имеют то же имя, что и их неизнашиваемые аналоги, например androidx.wear.compose.material.Button и androidx.compose.material.Button .
Создайте новое приложение в Android Studio.
Чтобы создать новый проект, включающий Jetpack Compose, выполните следующие действия:
- Если вы находитесь в окне «Добро пожаловать в Android Studio» , нажмите « Начать новый проект Android Studio» . Если у вас уже открыт проект Android Studio, выберите «Файл» > «Создать» > «Импортировать образец» в строке меню.
- Найдите «Создать для Wear» и выберите «Создать для Wear OS Starter».
- В окне «Настроить проект» выполните следующие действия:
- Установите имя приложения .
- Выберите местоположение проекта для вашего образца.
- Нажмите «Готово» .
- Убедитесь, что файл
build.gradleпроекта настроен правильно, как описано в разделе Файлы свойств Gradle .
Теперь вы готовы приступить к разработке приложения с использованием Compose for Wear OS.
Зависимости набора инструментов Jetpack Compose
Чтобы использовать Jetpack Compose с Wear OS, вам необходимо включить зависимости набора инструментов Jetpack Compose в файл build.gradle вашего приложения. Большинство изменений зависимостей, связанных с Wear OS, находятся на верхних архитектурных уровнях и на следующем изображении окружены красной рамкой.
Это означает, что многие из зависимостей, которые вы уже используете с Jetpack Compose, не изменяются при настройке Wear OS. Например, зависимости пользовательского интерфейса, среды выполнения, компилятора и анимации остаются прежними.
Однако в Wear OS есть свои версии библиотек material , foundation и navigation , поэтому убедитесь, что вы используете правильные библиотеки.
По возможности используйте версию API WearComposeMaterial . Хотя технически возможно использовать мобильную версию Compose Material, она не оптимизирована под уникальные требования Wear OS. Кроме того, смешивание Compose Material с Compose Material для Wear OS может привести к неожиданному поведению. Например, поскольку каждая библиотека имеет свой собственный класс MaterialTheme , существует вероятность того, что цвета, типографика или формы будут несовместимы, если используются обе версии.
В следующей таблице показаны различия в зависимостях между Wear OS и Mobile:
| Зависимость от операционной системы Wear (androidx.wear.*) | Сравнение | Мобильная зависимость (андроидx.*) |
| androidx.wear.compose:compose-material | вместо | androidx.compose.material:материал |
| androidx.wear.compose:compose-navigation | вместо | androidx.navigation:navigation-compose |
| androidx.wear.compose:compose-foundation | в дополнение к | androidx.compose.foundation:основание |
В следующем фрагменте показан пример файла build.gradle , который включает эти зависимости:
Котлин
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.10.01") // General compose dependencies implementation(composeBom) implementation("androidx.activity:activity-compose:1.9.3") implementation("androidx.compose.ui:ui-tooling-preview:1.7.5") // Other compose dependencies // Compose for Wear OS Dependencies implementation("androidx.wear.compose:compose-material:1.4.0") // Foundation is additive, so you can use the mobile version in your Wear OS app. implementation("androidx.wear.compose:compose-foundation:1.4.0") // Wear OS preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // 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.4.0") // 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.0.3") }
Обратная связь
Попробуйте Compose для Wear OS и используйте систему отслеживания проблем , чтобы предлагать предложения и отзывы.
Присоединяйтесь к каналу #compose-wear на Kotlin Slack, чтобы связаться с сообществом разработчиков и поделиться с нами своим опытом.
{% дословно %}Рекомендуется для вас
- Примечание: текст ссылки отображается, когда JavaScript отключен.
- Ресурсы в Compose
- Material Design 3 в Compose
- Начните работу с Jetpack Compose
Compose для Wear OS аналогичен Compose для мобильных устройств. Однако есть некоторые ключевые различия. Это руководство расскажет вам о сходствах и различиях.
Compose for Wear OS является частью Android Jetpack и, как и другие используемые вами библиотеки Wear Jetpack, помогает быстрее писать более качественный код. Это наш рекомендуемый подход к созданию пользовательских интерфейсов для приложений Wear OS .
Если вы не знакомы с использованием набора инструментов Jetpack Compose, ознакомьтесь с маршрутом Compose . Многие принципы разработки мобильного Compose применимы и к Compose для Wear OS. См. раздел «Почему Compose» для получения дополнительной информации об общих преимуществах декларативной инфраструктуры пользовательского интерфейса. Дополнительные сведения о Compose для Wear OS см. в разделе Compose for Wear OS Pathway и репозитории примеров Wear OS на GitHub.
Материальный дизайн в Jetpack Compose на Wear OS
Jetpack Compose на Wear OS предлагает реализацию Material 2.5 , которая помогает создавать более привлекательные приложения. Компоненты Material Design в Wear OS построены на основе Wear Material Theming . Эта тематика — систематический способ персонализировать Material Design и лучше отразить бренд вашего продукта.
Совместимость
Compose for Wear OS работает на часах, поддерживающих Wear OS 3.0 (уровень API 30), и часах, использующих Wear OS 2.0 (уровень API 25 и выше). Для использования версии 1.4 Compose for Wear OS требуется версия 1.7 библиотек androidx.compose и Kotlin 1.9.0. Вы можете использовать сопоставление спецификации и карту совместимости Compose с Kotlin, чтобы проверить совместимость Compose.
Поверхности
Compose for Wear OS упрощает создание приложений для Wear OS. Для получения дополнительной информации см. Приложения . Используйте наши встроенные компоненты для создания пользовательского интерфейса, соответствующего рекомендациям Wear OS. Дополнительную информацию о компонентах см. в нашем руководстве по проектированию .
Настройка
Использование Jetpack Compose с Wear OS аналогично использованию Jetpack Compose для любого другого проекта Android. Основное отличие состоит в том, что Jetpack Compose for Wear добавляет библиотеки, специфичные для Wear, которые упрощают создание пользовательских интерфейсов, адаптированных для часов. В некоторых случаях эти компоненты имеют то же имя, что и их неизнашиваемые аналоги, например androidx.wear.compose.material.Button и androidx.compose.material.Button .
Создайте новое приложение в Android Studio.
Чтобы создать новый проект, включающий Jetpack Compose, выполните следующие действия:
- Если вы находитесь в окне «Добро пожаловать в Android Studio» , нажмите « Начать новый проект Android Studio» . Если у вас уже открыт проект Android Studio, выберите «Файл» > «Создать» > «Импортировать образец» в строке меню.
- Найдите «Создать для Wear» и выберите «Создать для Wear OS Starter».
- В окне «Настроить проект» выполните следующие действия:
- Установите имя приложения .
- Выберите местоположение проекта для вашего образца.
- Нажмите «Готово» .
- Убедитесь, что файл
build.gradleпроекта настроен правильно, как описано в разделе Файлы свойств Gradle .
Теперь вы готовы приступить к разработке приложения с использованием Compose for Wear OS.
Зависимости набора инструментов Jetpack Compose
Чтобы использовать Jetpack Compose с Wear OS, вам необходимо включить зависимости набора инструментов Jetpack Compose в файл build.gradle вашего приложения. Большинство изменений зависимостей, связанных с Wear OS, находятся на верхних архитектурных уровнях и на следующем изображении окружены красной рамкой.
Это означает, что многие из зависимостей, которые вы уже используете с Jetpack Compose, не изменяются при настройке Wear OS. Например, зависимости пользовательского интерфейса, среды выполнения, компилятора и анимации остаются прежними.
Однако в Wear OS есть свои версии библиотек material , foundation и navigation , поэтому убедитесь, что вы используете правильные библиотеки.
По возможности используйте версию API WearComposeMaterial . Хотя технически возможно использовать мобильную версию Compose Material, она не оптимизирована под уникальные требования Wear OS. Кроме того, смешивание Compose Material с Compose Material для Wear OS может привести к неожиданному поведению. Например, поскольку каждая библиотека имеет свой собственный класс MaterialTheme , существует вероятность того, что цвета, типографика или формы будут несовместимы, если используются обе версии.
В следующей таблице показаны различия в зависимостях между Wear OS и Mobile:
| Зависимость от операционной системы Wear (androidx.wear.*) | Сравнение | Мобильная зависимость (андроидx.*) |
| androidx.wear.compose:compose-material | вместо | androidx.compose.material:материал |
| androidx.wear.compose:compose-navigation | вместо | androidx.navigation:navigation-compose |
| androidx.wear.compose:compose-foundation | в дополнение к | androidx.compose.foundation:основание |
В следующем фрагменте показан пример файла build.gradle , который включает эти зависимости:
Котлин
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.10.01") // General compose dependencies implementation(composeBom) implementation("androidx.activity:activity-compose:1.9.3") implementation("androidx.compose.ui:ui-tooling-preview:1.7.5") // Other compose dependencies // Compose for Wear OS Dependencies implementation("androidx.wear.compose:compose-material:1.4.0") // Foundation is additive, so you can use the mobile version in your Wear OS app. implementation("androidx.wear.compose:compose-foundation:1.4.0") // Wear OS preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // 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.4.0") // 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.0.3") }
Обратная связь
Попробуйте Compose для Wear OS и используйте систему отслеживания проблем , чтобы предлагать предложения и отзывы.
Присоединяйтесь к каналу #compose-wear на Kotlin Slack, чтобы связаться с сообществом разработчиков и поделиться с нами своим опытом.
{% дословно %}Рекомендуется для вас
- Примечание: текст ссылки отображается, когда JavaScript отключен.
- Ресурсы в Compose
- Material Design 3 в Compose
- Начните работу с Jetpack Compose
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-19 UTC.