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

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

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

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

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

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

التوافق

واجهات

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

الإعداد

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

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

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

1. إذا كنت في نافذة Welcome to استوديو Android ، انقر على Start a new استوديو Android project. إذا كان لديك مشروع مفتوح في "استوديو Android"، انقر على ملف (File) > جديد (New) > استيراد نموذج (Import Sample) من شريط القوائم.
2. ابحث عن Compose for Wear واختَر Compose for Wear OS Starter.
3. في نافذة Configure your project ، نفِّذ ما يلي:
   1. اضبط اسم التطبيق (Application name).
   2. اختَر موقع المشروع (Project location) للنموذج.
4. انقر على إنهاء (Finish).
5. تأكَّد من ضبط ملف build.gradle الخاص بالمشروع بشكلٍ صحيح، كما هو موضّح في ملفات خصائص Gradle.

أنت الآن مستعد لبدء تطوير تطبيق باستخدام مكتبة Compose لنظام التشغيل 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 لنظام التشغيل Wear OS إلى سلوك غير متوقّع. على سبيل المثال، بما أنّ كل مكتبة تتضمّن فئة MaterialTheme خاصة بها، من المحتمل أن تكون الألوان أو الطباعة أو الأشكال غير متّسقة إذا تم استخدام كلا الإصدارَين.

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

dependencies {

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

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

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

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

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

}