استخدام Jetpack Compose على نظام التشغيل Wear OS

رمز Compose ومعاينة لخلفية شاشة الساعة في "استوديو Android"
الشكل 1: ‫Jetpack Compose لنظام التشغيل Wear OS

‫Compose for Wear OS يشبه Compose للأجهزة الجوّالة. ومع ذلك، هناك بعض الاختلافات الرئيسية. يقدّم لك هذا الدليل أوجه التشابه والاختلاف بينهما.

‫Compose لنظام التشغيل Wear OS هو جزء من Android Jetpack، ومثل مكتبات Wear Jetpack الأخرى التي تستخدمها، يساعدك في كتابة رموز برمجية أفضل بشكل أسرع. هذه هي الطريقة التي ننصح بها لإنشاء واجهات مستخدم لتطبيقات Wear OS.

إذا لم تكن على دراية باستخدام مجموعة أدوات Jetpack Compose، يمكنك الاطّلاع على مسار Compose. تنطبق العديد من مبادئ تطوير Compose للأجهزة الجوّالة على Compose لنظام التشغيل Wear OS. يمكنك الاطّلاع على مزايا Compose لمزيد من المعلومات حول المزايا العامة لإطار عمل واجهة المستخدم التعريفية. لمزيد من المعلومات حول Compose for Wear OS، يمكنك الاطّلاع على مسار Compose for Wear OS ومستودع نماذج Wear OS على GitHub.

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

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

التوافق

تعمل Compose for Wear OS على الساعات التي تتوافق مع Wear OS 3.0 (المستوى 30 من واجهة برمجة التطبيقات) والساعات التي تستخدم Wear OS 2.0 (المستوى 25 من واجهة برمجة التطبيقات والإصدارات الأحدث). يتطلّب استخدام الإصدار 1.5 من Compose for Wear OS استخدام الإصدار 1.8 من مكتبات androidx.compose وKotlin 1.9.0. يمكنك استخدام تحديد BOM وخريطة توافق Compose مع Kotlin للتحقّق من توافق Compose.

واجهات

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

الإعداد

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

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

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

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

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

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

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

4 مستطيلات من الأعلى إلى الأسفل، تحتوي المستطيلات على "Material" و"Foundation" و"UI" و"Runtime". المستطيلان العلويان محاطان بمربع أحمر
الشكل 2. تغييرات في التبعيات لنظام التشغيل Wear OS في بنية Compose

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

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

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

يوضّح الجدول التالي الاختلافات في التبعيات بين Wear OS والأجهزة الجوّالة:

اعتمادية Wear OS
(androidx.wear.*) 		المقارنة اعتمادية الجهاز الجوّال
(androidx.*)
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 يتضمّن هذه التبعيات:

Kotlin

dependencies {

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

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

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

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

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

}

الملاحظات

جرِّب Compose for Wear OS واستخدِم أداة تتبُّع المشاكل لتقديم الاقتراحات والملاحظات.

انضم إلى قناة ‎#compose-wear على Kotlin Slack للتواصل مع منتدى المطوّرين وإطلاعنا على تجربتك.