این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

از 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 ببینید.

سازگاری

Compose for Wear OS روی ساعت‌هایی کار می‌کند که از Wear OS 3.0 (سطح API 30) و ساعت‌هایی که از Wear OS 2.0 (سطح API 25 و بالاتر) استفاده می‌کنند، کار می‌کند. استفاده از نسخه 1.0 Compose for Wear OS نیازمند استفاده از نسخه 1.2 کتابخانه‌های androidx.compose و Kotlin 1.7.0 است.

سطوح

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 است، به صورت زیر عمل کنید:

اگر در پنجره خوش آمدید به Android Studio هستید، روی Start a new Android Studio کلیک کنید. اگر قبلاً یک پروژه Android Studio باز دارید، File > New > Import Sample را از نوار منو انتخاب کنید.
عبارت Compose for Wear را جستجو کنید و Compose for Wear OS Starter را انتخاب کنید.
در پنجره Configure your project ، موارد زیر را انجام دهید:
1. نام برنامه را تنظیم کنید.
2. مکان پروژه را برای نمونه خود انتخاب کنید.
روی Finish کلیک کنید.
بررسی کنید که فایل build.gradle پروژه به درستی پیکربندی شده است، همانطور که در فایل های ویژگی های Gradle توضیح داده شده است.

اکنون آماده شروع توسعه یک برنامه با استفاده از Compose for Wear OS هستید.

وابستگی های جعبه ابزار Jetpack Compose

برای استفاده از Jetpack Compose با Wear OS، باید وابستگی‌های جعبه ابزار Jetpack Compose را در فایل build.gradle برنامه خود قرار دهید، همانطور که در قطعه زیر نشان داده شده است:

کاتلین

dependencies {

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

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

    // Compose for Wear OS Dependencies
    implementation("androidx.wear.compose:compose-material:1.3.1")

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

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.3.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.3.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.0.3")
}

چه تفاوتی داره

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

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

Wear OS Dependency (androidx.wear.*)	مقایسه	وابستگی به موبایل (androidx.*)
androidx.wear.compose:compose-material	*بجای*	androidx.compose.material:material
androidx.wear.compose:compose-navigation	*بجای*	androidx.navigation:navigation-compose
androidx.wear.compose:compose-foundation	*بعلاوه*	androidx.compose.foundation:foundation

در اینجا یک نمونه فایل build.gradle آورده شده است:

// Example project in app/build.gradle file
dependencies {
    // Standard Compose dependencies...

    // Wear specific Compose Dependencies
    implementation "androidx.wear.compose:compose-material:$rootProject.wearVersion"
    implementation "androidx.wear.compose:compose-foundation:$rootProject.wearVersion"

    // For navigation within your app...
    implementation "androidx.wear.compose:compose-navigation:$rootProject.wearVersion"

    // Other dependencies...
}

بازخورد

Compose for Wear OS را امتحان کنید و از ردیاب مشکل برای ارائه پیشنهاد و بازخورد استفاده کنید.

به کانال #compose-wear در Kotlin Slack بپیوندید تا با جامعه توسعه دهندگان ارتباط برقرار کنید و تجربه خود را با ما در میان بگذارید.

{% کلمه به کلمه %} {% آخر کلمه %}

توصیه شده برای شما

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

{% کلمه به کلمه %} {% آخر کلمه %}