استخدام 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. راجِع مقالة مزايا Compose للحصول على مزيد من المعلومات حول المزايا العامة لإطار عمل واجهة مستخدم تعريفية. لمزيد من المعلومات حول Compose for Wear OS، يمكنك الاطّلاع على مسار Compose for Wear OS ومستودع نماذج Wear OS على GitHub.

android skills add --skill wear-compose-m3

‫التصميم المتعدد الأبعاد في Jetpack Compose على Wear OS

توفّر Jetpack Compose على Wear OS عملية تنفيذ Material 3، ما يساعدك في تصميم تجارب أكثر جاذبية للتطبيقات، تستند مكوّنات التصميم المتعدد الأبعاد على Wear OS إلى تخصيص التصميم المتعدد الأبعاد في Wear. هذه السمة هي طريقة منهجية لتخصيص التصميم المتعدد الأبعاد وعكس العلامة التجارية لمنتجك بشكل أفضل.

التوافق

واجهات

تسهّل Compose for Wear OS إنشاء التطبيقات على Wear OS. لمزيد من المعلومات، اطّلِع على التطبيقات. استخدِم المكوّنات المضمّنة لإنشاء تجارب مستخدم تتوافق مع إرشادات Wear OS. لمزيد من المعلومات حول المكوّنات، يُرجى الاطّلاع على إرشادات التصميم.

الإعداد

إنّ استخدام Jetpack Compose مع Wear OS يشبه استخدامها في أي مشروع Android آخر. الفرق الرئيسي هو أنّ Jetpack Compose لنظام التشغيل Wear يضيف مكتبات خاصة بنظام التشغيل Wear تسهّل إنشاء واجهات مستخدم مخصّصة للساعات. في بعض الحالات، تتشارك هذه المكوّنات الاسم نفسه مع نظيراتها غير المخصّصة للأجهزة القابلة للارتداء، مثل androidx.wear.compose.material3.Button وandroidx.compose.material3.Button

إنشاء تطبيق جديد في "استوديو Android"

لإنشاء مشروع جديد يتضمّن Jetpack Compose، اتّبِع الخطوات التالية:

1. إذا كنت في نافذة مرحبًا بك في "استوديو Android"، انقر على بدء مشروع جديد في "استوديو Android". إذا كان لديك مشروع مفتوح في "استوديو Android"، اختَر ملف (File) > جديد (New) > استيراد نموذج (Import Sample) من شريط القوائم.
2. ابحث عن Compose for Wear واختَر Compose for Wear OS Starter.
3. في نافذة إعداد مشروعك، اتّبِع الخطوات التالية:
   1. اضبط اسم التطبيق.
   2. اختَر موقع المشروع للعيّنة.
4. انقر على إنهاء.
5. تأكَّد من إعداد ملف build.gradle الخاص بالمشروع بشكل صحيح، كما هو موضّح في ملفات Gradle.

أصبحت الآن جاهزًا لبدء تطوير تطبيق باستخدام Compose for Wear OS.

تبعيات مجموعة أدوات Jetpack Compose

لاستخدام Jetpack Compose مع Wear OS، عليك تضمين ملحقات مجموعة أدوات Jetpack Compose في ملف build.gradle الخاص بتطبيقك. معظم التغييرات في التبعيات المرتبطة بنظام التشغيل Wear OS تقع في الطبقات المعمارية العليا، والموضّحة بمربّع أحمر في الصورة التالية.

<img 'foundation',="" 'material',="" 'runtime'.="" 'ui',="" 2="" 4="" a="" alt="" and="" are="" bottom,="" box""="" by="" contain="" from="" rectangles="" rectangles.="" red="" src="/static/wear/images/components/ComposeDependencies.png" surrounded="" the="" to="" top="" />

وهذا يعني أنّ العديد من التبعيات التي تستخدمها حاليًا مع Jetpack Compose لن تتغيّر عند استهداف Wear OS. على سبيل المثال، تظلّ التبعيات الخاصة بواجهة المستخدم ووقت التشغيل والمترجم والرسوم المتحركة كما هي.

ومع ذلك، يتضمّن Wear OS إصدارات خاصة به من مكتبات material وmaterial3 وfoundation وnavigation، لذا تأكَّد من استخدام المكتبات المناسبة.

استخدِم إصدار WearComposeMaterial من واجهات برمجة التطبيقات حيثما أمكن ذلك. على الرغم من أنّه يمكن من الناحية الفنية استخدام إصدار Compose Material المتوافق مع الأجهزة الجوّالة، إلا أنّه غير محسَّن لتلبية المتطلبات الفريدة لنظام التشغيل Wear OS. بالإضافة إلى ذلك، قد يؤدي دمج Compose Material مع Compose Material for Wear OS إلى حدوث سلوك غير متوقّع. على سبيل المثال، بما أنّ كل مكتبة تتضمّن فئة MaterialTheme خاصة بها، من المحتمل أن تكون الألوان أو الطباعة أو الأشكال غير متسقة إذا تم استخدام كلا الإصدارين.

يوضّح الجدول التالي الاختلافات في التبعيات بين Wear OS وMobile:

يعرض المقتطف التالي مثالاً على ملف build.gradle يتضمّن هذه التبعيات:

dependencies {

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

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

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.6.2")

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

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.6.2")

    // 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.6.2")

    // 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")

}