با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Compose for Wear OS مشابه Compose for mobile است. با این حال، برخی از تفاوت های کلیدی وجود دارد. این راهنما شما را از طریق شباهت ها و تفاوت ها راهنمایی می کند.
Compose for Wear OS بخشی از Android Jetpack است و مانند سایر کتابخانه‌های Wear Jetpack که استفاده می‌کنید، به شما کمک می‌کند کدهای بهتری را سریع‌تر بنویسید. این رویکرد پیشنهادی ما برای ایجاد رابط کاربری برای برنامه‌های Wear OS است.
اگر با استفاده از جعبه ابزار Jetpack Compose آشنا نیستید، مسیر Compose را بررسی کنید. بسیاری از اصول توسعه برای Compose موبایل برای Compose for Wear OS اعمال می‌شود. برای اطلاعات بیشتر در مورد مزایای کلی چارچوب UI اظهاری، به چرا نوشتن مراجعه کنید. برای کسب اطلاعات بیشتر درباره Compose for Wear OS، Compose for Wear OS Pathway و مخزن نمونه Wear OS را در GitHub ببینید.
طراحی متریال در Jetpack Compose در سیستم عامل Wear
Jetpack Compose on Wear OS پیاده سازی ازMaterial 3 ، که به شما کمک می کند برنامه جذاب تری طراحی کنیدتجربیات اجزای طراحی مواد در Wear OS بر روی Wear Material Theming ساخته شده اند. این قالب یک روش سیستماتیک برای سفارشی کردن طراحی متریال و بازتاب بهتر برند محصول شما است.
سازگاری
Compose for Wear OS روی ساعت‌هایی کار می‌کند که از Wear OS 3.0 (سطح API 30) و ساعت‌هایی که از Wear OS 2.0 (سطح API 25 و بالاتر) استفاده می‌کنند، کار می‌کند. استفاده از نسخه 1.5 Compose for Wear OS نیازمند استفاده از نسخه 1.8 کتابخانه‌های androidx.compose و Kotlin 1.9.0 است. برای بررسی سازگاری Compose می‌توانید از نقشه‌برداری BOM و نقشه سازگاری Compose to Kotlin استفاده کنید.
سطوح
Compose for Wear OS ساخت برنامه‌ها در Wear OS را آسان‌تر می‌کند. برای اطلاعات بیشتر به برنامه ها مراجعه کنید. از مؤلفه‌های داخلی ما برای ایجاد تجربه‌های کاربری مطابق با دستورالعمل‌های Wear OS استفاده کنید. برای اطلاعات بیشتر در مورد اجزاء، به راهنمای طراحی ما مراجعه کنید.
راه اندازی
استفاده از Jetpack Compose با Wear OS مشابه استفاده از Jetpack Compose برای هر پروژه اندروید دیگری است. تفاوت اصلی این است که Jetpack Compose for Wear کتابخانه های مخصوص Wear را اضافه می کند که ایجاد رابط های کاربری متناسب با ساعت را آسان تر می کند. در برخی موارد، این اجزا با همتایان غیرسایشی خود نامی مشابه دارند، مانندandroidx.wear.compose.material3.Button و androidx.compose.material3.Button .
یک برنامه جدید در Android Studio ایجاد کنید
برای ایجاد یک پروژه جدید که شامل Jetpack Compose است، به صورت زیر عمل کنید:
اگر در پنجره خوش آمدید به Android Studio هستید، روی Start a new Android Studio کلیک کنید. اگر قبلاً یک پروژه Android Studio باز دارید، File > New > Import Sample را از نوار منو انتخاب کنید.
عبارت Compose for Wear را جستجو کنید و Compose for Wear OS Starter را انتخاب کنید.
در پنجره Configure your project ، موارد زیر را انجام دهید:
نام برنامه را تنظیم کنید.
مکان پروژه را برای نمونه خود انتخاب کنید.
روی Finish کلیک کنید.
بررسی کنید که فایل 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 و material3 ، foundation و navigation دارد، بنابراین بررسی کنید که از کتابخانه‌های مناسب استفاده می‌کنید.
در صورت امکان از نسخه WearComposeMaterial APIها استفاده کنید. در حالی که از نظر فنی استفاده از نسخه موبایل Compose Material امکان پذیر است، اما برای نیازهای منحصر به فرد Wear OS بهینه نشده است. علاوه بر این، مخلوط کردن Compose Material با Compose Material برای Wear OS می‌تواند منجر به رفتار غیرمنتظره شود. به عنوان مثال، از آنجایی که هر کتابخانه دارای کلاس MaterialTheme مخصوص به خود است، در صورت استفاده از هر دو نسخه، احتمال ناهماهنگی رنگ‌ها، تایپوگرافی یا اشکال وجود دارد.
جدول زیر تفاوت های وابستگی بین Wear OS و Mobile را نشان می دهد:
قطعه زیر نمونه ای از فایل build.gradle را نشان می دهد که شامل این وابستگی ها است:
کاتلین
dependencies{valcomposeBom=platform("androidx.compose:compose-bom:2025.08.00")// General compose dependenciesimplementation(composeBom)implementation("androidx.activity:activity-compose:1.10.1")implementation("androidx.compose.ui:ui-tooling-preview:1.9.0")// Other compose dependencies// Compose for Wear OS dependenciesimplementation("androidx.wear.compose:compose-material3:")// Foundation is additive, so you can use the mobile version in your Wear OS app.implementation("androidx.wear.compose:compose-foundation:")// Wear OS preview annotationsimplementation("androidx.wear.compose:compose-ui-tooling:")// 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:")// TestingtestImplementation("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")}
بازخورد
Compose for Wear OS را امتحان کنید و از ردیاب مشکل برای ارائه پیشنهاد و بازخورد استفاده کنید.
به کانال #compose-wear در Kotlin Slack بپیوندید تا با جامعه توسعه دهندگان ارتباط برقرار کنید و تجربه خود را با ما در میان بگذارید.
{% کلمه به کلمه %} {% آخر کلمه %}
برای شما توصیه می شود
توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Compose for Wear OS Material version 2.5 3\n\n*** ** * ** ***\n\n[Compose for Wear OS](/jetpack/androidx/releases/wear-compose) is similar to\nCompose for mobile. However, there are some key differences. This guide\nwalks you through the similarities and differences.\n\nCompose for Wear OS is part of Android Jetpack, and like the other Wear Jetpack\nlibraries you use, it helps you write better code faster. This is our\nrecommended approach for building user interfaces for [Wear OS apps](/training/wearables/user-interfaces#apps).\n\nIf you are unfamiliar with using the Jetpack Compose toolkit, check out the\n[Compose pathway](/courses/pathways/compose). Many of the development principles for mobile Compose\napply to Compose for Wear OS. See [Why Compose](/jetpack/compose/why-adopt) for more information on the\ngeneral advantages of a declarative UI framework. To learn more about Compose\nfor Wear OS, see the [Compose for Wear OS Pathway](/courses/pathways/wear-compose) and the [Wear OS samples\nrepository](https://github.com/android/wear-os-samples/tree/main/ComposeStarter#readme) on GitHub.\n\nMaterial Design in Jetpack Compose on Wear OS\n\nJetpack Compose on Wear OS offers an implementation of\n\n[Material 3](/design/ui/wear/guides/get-started), which helps you design more engaging app\n\nexperiences. The\n[Material Design components](/design/ui/wear/guides/components/buttons) on\nWear OS are built on top of\n[Wear Material Theming](/design/ui/wear/guides/styles/theme). This theming\nis a systematic way to customize Material Design and better reflect your\nproduct's brand.\n\nCompatibility Compose for Wear OS works on watches that support Wear OS 3.0 (API Level 30) and watches that use Wear OS 2.0 (API level 25 and above). Using [version 1.5](/jetpack/androidx/releases/wear-compose) of Compose for Wear OS requires using version 1.8 of [androidx.compose](/jetpack/androidx/releases/compose) libraries and Kotlin 1.9.0. You can use the [BOM mapping](/develop/ui/compose/bom/bom-mapping) and [Compose to Kotlin compatibility map](/jetpack/androidx/releases/compose-kotlin) to check Compose compatibility.\n\nSurfaces\n\nCompose for Wear OS makes building apps on Wear OS easier. For more information\nsee [Apps](/training/wearables/apps#building-an-app). Use our built-in\ncomponents to create user experiences that conform to Wear OS guidelines.\nFor more information about components, see our\n[design guidance](/design/ui/wear/guides/components/buttons).\n\nSetting up\n\nUsing Jetpack Compose with Wear OS is similar to using Jetpack Compose for\nany other Android project. The main difference is that Jetpack Compose for Wear\nadds Wear-specific libraries that make it easier to create user interfaces\ntailored to watches.\nIn some cases those components share the same name as\ntheir non-wear counterparts, such as\n\n[`androidx.wear.compose.material3.Button`](/reference/kotlin/androidx/wear/compose/material3/package-summary#Button(kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Function0,kotlin.String,kotlin.Boolean,androidx.compose.ui.graphics.Shape,androidx.wear.compose.material3.ButtonColors,androidx.compose.foundation.BorderStroke,androidx.compose.foundation.layout.PaddingValues,androidx.compose.foundation.interaction.MutableInteractionSource,androidx.wear.compose.material3.SurfaceTransformation,kotlin.Function1)) and\n[`androidx.compose.material3.Button`](/reference/kotlin/androidx/compose/material3/package-summary#Button(kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Boolean,androidx.compose.ui.graphics.Shape,androidx.compose.material3.ButtonColors,androidx.compose.material3.ButtonElevation,androidx.compose.foundation.BorderStroke,androidx.compose.foundation.layout.PaddingValues,androidx.compose.foundation.interaction.MutableInteractionSource,kotlin.Function1)).\n\n\nCreate a new app in Android Studio\n\nTo create a new project that includes Jetpack Compose, proceed as follows:\n\n1. If you're in the **Welcome to Android Studio** window, click **Start a new\n Android Studio project** . If you already have an Android Studio project open, select **File \\\u003e New \\\u003e Import Sample** from the menu bar.\n2. Search for **Compose for Wear** and select **Compose for Wear OS Starter.**\n3. In the **Configure your project** window, do the following:\n 1. Set the **Application name**.\n 2. Choose the **Project location** for your sample.\n4. Click **Finish**.\n5. Verify that the project's `build.gradle` file is configured correctly, as described in [Gradle properties files](/studio/build#properties-files).\n\nNow you're ready to start developing an app using Compose for Wear OS.\n\nJetpack Compose toolkit dependencies\n\nTo use Jetpack Compose with Wear OS, you'll need to include Jetpack Compose\ntoolkit dependencies in your app's `build.gradle` file. Most of the dependency\nchanges related to Wear OS are in the\n[top architectural layers](/jetpack/compose/layering), surrounded by a red box\nin the following image.\n\nThat means many of the dependencies you already use with Jetpack Compose don't\nchange when targeting Wear OS. For example, the UI, runtime, compiler, and\nanimation dependencies remain the same.\n\nHowever, Wear OS has its own versions of `material` and `material3`, `foundation`, and\n`navigation` libraries, so check that you're using the proper libraries.\n\nUse the\n[`WearComposeMaterial`](/reference/kotlin/androidx/wear/compose/material/package-summary)\nversion of APIs where possible. While it's technically possible to use the\nmobile version of Compose Material, it is not optimized for the unique\nrequirements of Wear OS. In addition, mixing Compose Material with Compose\nMaterial for Wear OS can result in unexpected behavior. For example, because\neach library has its own `MaterialTheme` class, there's the possibility of\ncolors, typography, or shapes being inconsistent if both versions are used.\n\nThe following table outlines the dependency differences between Wear OS and\nMobile:\n\n|----------------------------------------------------------------------------------------------------------------|----------------------|----------------------------------------|\n| **Wear OS Dependency** (androidx.wear.\\*) | **Comparison** | **Mobile Dependency** (androidx.\\*) |\n| [androidx.wear.compose:compose-material3](/reference/kotlin/androidx/wear/compose/material/package-summary) | ***instead of*** | androidx.compose.material:material3 |\n| [androidx.wear.compose:compose-navigation](/reference/kotlin/androidx/wear/compose/navigation/package-summary) | ***instead of*** | androidx.navigation:navigation-compose |\n| [androidx.wear.compose:compose-foundation](/reference/kotlin/androidx/wear/compose/foundation/package-summary) | ***in addition to*** | androidx.compose.foundation:foundation |\n\n| **Note:** Other non-mobile material dependencies can be used, such as material ripple and material icons extended.\n\nThe following snippet shows an example `build.gradle` file that includes these\ndependencies: \n\nKotlin \n\n```kotlin\ndependencies {\n\n val composeBom = platform(\"androidx.compose:compose-bom:2025.08.00\")\n\n // General compose dependencies\n implementation(composeBom)\n implementation(\"androidx.activity:activity-compose:1.10.1\")\n implementation(\"androidx.compose.ui:ui-tooling-preview:1.9.0\")\n // Other compose dependencies\n\n // Compose for Wear OS dependencies\n implementation(\"androidx.wear.compose:compose-material3:\")\n\n // Foundation is additive, so you can use the mobile version in your Wear OS app.\n implementation(\"androidx.wear.compose:compose-foundation:\")\n\n // Wear OS preview annotations\n implementation(\"androidx.wear.compose:compose-ui-tooling:\")\n\n // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).\n // Uncomment the line below and update the version number.\n // implementation(\"androidx.wear.compose:compose-navigation:\")\n\n // Testing\n testImplementation(\"junit:junit:4.13.2\")\n androidTestImplementation(\"androidx.test.ext:junit:1.1.3\")\n androidTestImplementation(\"androidx.test.espresso:espresso-core:3.4.0\")\n androidTestImplementation(\"androidx.compose.ui:ui-test-junit4:1.0.3\")\n debugImplementation(\"androidx.compose.ui:ui-tooling:1.4.1\")\n \n}\n```\n\nFeedback\n\nTry out Compose for Wear OS and use the\n[issue tracker](https://issuetracker.google.com/issues/new?component=1077552&template=1598429&pli=1) to provide suggestion and feedback.\n\nJoin the\n[#compose-wear channel](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up)\non Kotlin Slack to connect with developer community and let us know your\nexperience.\n\nRecommended for you\n\n- Note: link text is displayed when JavaScript is off\n- [Resources in Compose](/develop/ui/compose/resources)\n- [Material Design 3 in Compose](/develop/ui/compose/designsystems/material3)\n- [Get Started with Jetpack Compose](/develop/ui/compose/documentation)"]]
