از Jetpack Compose در Wear OS استفاده کنید

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 در Wear OS پیاده‌سازی Material 2.5 را ارائه می‌دهد که به شما کمک می‌کند تجربه‌های جذاب‌تری از برنامه طراحی کنید. اجزای طراحی مواد در Wear OS بر روی Wear Material Theming ساخته شده اند. این قالب یک روش سیستماتیک برای سفارشی کردن طراحی متریال و بازتاب بهتر برند محصول شما است.

سازگاری

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 می‌توانید از نقشه‌برداری 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.material.Button و androidx.compose.material.Button نام یکسانی دارند.

یک برنامه جدید در Android Studio ایجاد کنید

برای ایجاد یک پروژه جدید که شامل Jetpack Compose است، به صورت زیر عمل کنید:

1. اگر در پنجره خوش آمدید به Android Studio هستید، روی Start a new Android Studio کلیک کنید. اگر قبلاً یک پروژه Android Studio باز دارید، File > New > Import Sample را از نوار منو انتخاب کنید.
2. عبارت Compose for Wear را جستجو کنید و Compose for Wear OS Starter را انتخاب کنید.
3. در پنجره Configure your project ، موارد زیر را انجام دهید:
   1. نام برنامه را تنظیم کنید.
   2. مکان پروژه را برای نمونه خود انتخاب کنید.
4. روی Finish کلیک کنید.
5. بررسی کنید که فایل 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 دارد، بنابراین بررسی کنید که از کتابخانه‌های مناسب استفاده می‌کنید.

در صورت امکان از نسخه WearComposeMaterial APIها استفاده کنید. در حالی که از نظر فنی استفاده از نسخه موبایل Compose Material امکان پذیر است، اما برای نیازهای منحصر به فرد Wear OS بهینه نشده است. علاوه بر این، مخلوط کردن Compose Material با Compose Material برای Wear OS می‌تواند منجر به رفتار غیرمنتظره شود. به عنوان مثال، از آنجایی که هر کتابخانه دارای کلاس MaterialTheme مخصوص به خود است، در صورت استفاده از هر دو نسخه، احتمال ناهماهنگی رنگ‌ها، تایپوگرافی یا اشکال وجود دارد.

جدول زیر تفاوت های وابستگی بین Wear OS و Mobile را نشان می دهد:

قطعه زیر نمونه ای از فایل 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.6")
    // 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")
}