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 on Wear OS پیاده سازی ازMaterial 3 ، که به شما کمک می کند برنامه جذاب تری طراحی کنیدتجربیات اجزای طراحی مواد در Wear OS بر روی Wear Material Theming ساخته شده اند. این قالب یک روش سیستماتیک برای سفارشی کردن طراحی متریال و بازتاب بهتر برند محصول شما است.
Compose for Wear OS ساخت برنامه‌ها در Wear OS را آسان‌تر می‌کند. برای اطلاعات بیشتر به برنامه ها مراجعه کنید. از مؤلفه‌های داخلی ما برای ایجاد تجربه‌های کاربری مطابق با دستورالعمل‌های Wear OS استفاده کنید. برای اطلاعات بیشتر در مورد اجزاء، به راهنمای طراحی ما مراجعه کنید.
استفاده از Jetpack Compose با Wear OS مشابه استفاده از Jetpack Compose برای هر پروژه اندروید دیگری است. تفاوت اصلی این است که Jetpack Compose for Wear کتابخانه های مخصوص Wear را اضافه می کند که ایجاد رابط های کاربری متناسب با ساعت را آسان تر می کند. در برخی موارد، این اجزا با همتایان غیرسایشی خود نامی مشابه دارند، مانند برای ایجاد یک پروژه جدید که شامل Jetpack Compose است، به صورت زیر عمل کنید: اکنون آماده شروع توسعه یک برنامه با استفاده از Compose for Wear OS هستید. برای استفاده از Jetpack Compose با Wear OS، باید وابستگی های جعبه ابزار Jetpack Compose را در فایل این بدان معناست که بسیاری از وابستگی‌هایی که قبلاً با Jetpack Compose استفاده می‌کنید، هنگام هدف قرار دادن Wear OS تغییر نمی‌کنند. به عنوان مثال، وابستگی های رابط کاربری، زمان اجرا، کامپایلر و انیمیشن یکسان باقی می مانند. با این حال، Wear OS نسخه‌های خاص خود را از کتابخانه‌های در صورت امکان از نسخه جدول زیر تفاوت های وابستگی بین Wear OS و Mobile را نشان می دهد: (androidx.wear.*) (androidx.*) قطعه زیر نمونه ای از فایل Compose for Wear OS را امتحان کنید و از ردیاب مشکل برای ارائه پیشنهاد و بازخورد استفاده کنید. به کانال #compose-wear در Kotlin Slack بپیوندید تا با جامعه توسعه دهندگان ارتباط برقرار کنید و تجربه خود را با ما در میان بگذارید. محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند. تاریخ آخرین بهروزرسانی 2025-10-08 بهوقت ساعت هماهنگ جهانی.androidx.wear.compose.material3.Button و androidx.compose.material3.Button .build.gradle پروژه به درستی پیکربندی شده است، همانطور که در فایل های ویژگی های Gradle توضیح داده شده است.build.gradle برنامه خود قرار دهید. بیشتر تغییرات وابستگی مربوط به Wear OS در لایه‌های معماری بالایی هستند که توسط یک کادر قرمز در تصویر زیر احاطه شده‌اند. material و material3 ، foundation و navigation دارد، بنابراین بررسی کنید که از کتابخانه‌های مناسب استفاده می‌کنید.WearComposeMaterial APIها استفاده کنید. در حالی که از نظر فنی استفاده از نسخه موبایل Compose Material امکان پذیر است، اما برای نیازهای منحصر به فرد Wear OS بهینه نشده است. علاوه بر این، مخلوط کردن Compose Material با Compose Material برای Wear OS می‌تواند منجر به رفتار غیرمنتظره شود. به عنوان مثال، از آنجایی که هر کتابخانه دارای کلاس MaterialTheme مخصوص به خود است، در صورت استفاده از هر دو نسخه، احتمال ناهماهنگی رنگ‌ها، تایپوگرافی یا اشکال وجود دارد. Wear OS Dependency مقایسه وابستگی به موبایل androidx.wear.compose:compose-material3 به جای androidx.compose.material:material3 androidx.wear.compose:compose-navigation به جای androidx.navigation:navigation-compose androidx.wear.compose:compose-foundation علاوه بر androidx.compose.foundation:foundation build.gradle را نشان می دهد که شامل این وابستگی ها است: dependencies {
val composeBom = platform("androidx.compose:compose-bom:2025.09.01")
// General compose dependencies
implementation(composeBom)
implementation("androidx.activity:activity-compose:1.11.0")
implementation("androidx.compose.ui:ui-tooling-preview:1.9.3")
// Other compose dependencies
// Compose for Wear OS dependencies
implementation("androidx.wear.compose:compose-material3:1.5.3")
// Foundation is additive, so you can use the mobile version in your Wear OS app.
implementation("androidx.wear.compose:compose-foundation:1.5.3")
// Wear OS preview annotations
implementation("androidx.wear.compose:compose-ui-tooling:1.5.3")
// 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.5.3")
// 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")
}
{% کلمه به کلمه %}