البدء بسرعة

للحصول على أفضل تجربة تطوير باستخدام Compose، نزِّل استوديو Android وثبِّته. وتتضمّن العديد من ميزات المحرِّر الذكي، مثل نماذج المشاريع الجديدة وإمكانية معاينة واجهة مستخدم Compose والصور المتحركة على الفور.

الحصول على "استوديو Android"

اتّبِع هذه التعليمات لإنشاء مشروع تطبيق جديد في Compose أو إعداد Compose لمشروع تطبيق حالي أو استيراد نموذج تطبيق مكتوب في Compose.

إنشاء تطبيق جديد يتوافق مع Compose

إذا أردت بدء مشروع جديد يتضمّن دعمًا لـ Compose تلقائيًا، يتضمّن "استوديو Android" نماذج مشاريع متنوّعة لمساعدتك في البدء. لإنشاء مشروع جديد تم إعداد Compose فيه بشكل صحيح، اتّبِع الخطوات التالية:

  1. إذا كنت في نافذة مرحبًا بك في "استوديو Android"، انقر على بدء مشروع جديد في "استوديو Android". إذا كان لديك مشروع مفتوح في "استوديو Android"، انقر على ملف > جديد > مشروع جديد من شريط القوائم.
  2. في نافذة اختيار نموذج مشروع (Select a Project Template)، اختَر نشاط فارغ (Empty Activity) وانقر على التالي (Next).
  3. في نافذة ضبط مشروعك (Configure your project)، اتّبِع الخطوات التالية:
    1. اضبط الاسم واسم الحزمة وموقع الحفظ كالمعتاد. يُرجى العِلم أنّ Kotlin هو الخيار الوحيد المتاح في القائمة المنسدلة اللغة لأنّ Jetpack Compose لا يعمل إلا مع الفئات المكتوبة بلغة Kotlin.
    2. في القائمة المنسدلة الحدّ الأدنى لمستوى واجهة برمجة التطبيقات، اختَر المستوى 21 أو أعلى.
  4. انقر على إنهاء.

أنت الآن جاهز لبدء تطوير تطبيق باستخدام Jetpack Compose. لمساعدتك في البدء والتعرّف على ما يمكنك فعله باستخدام مجموعة الأدوات، يمكنك تجربة دليل Jetpack Compose التعليمي.

إعداد تبعيات Compose وبرنامج التجميع

يُرجى الاطّلاع على إعداد اعتماديات Compose وبرنامج التجميع.

تجربة نماذج تطبيقات Jetpack Compose

أسرع طريقة لتجربة إمكانات Jetpack Compose هي تجربة نماذج تطبيقات Jetpack Compose المستضافة على GitHub. لاستيراد مشروع نموذج تطبيق من "استوديو Android"، اتّبِع الخطوات التالية:

  1. إذا كنت في نافذة مرحبًا بك في "استوديو Android"، اختَر استيراد عيّنة تعليمات برمجية لنظام Android. إذا كان لديك مشروع مفتوح في "استوديو Android"، اختَر ملف > جديد > استيراد نموذج من شريط القوائم.
  2. في شريط البحث بالقرب من أعلى معالج تصفُّح النماذج، اكتب "إنشاء".
  3. اختَر أحد نماذج تطبيقات Jetpack Compose من نتائج البحث وانقر على التالي.
  4. يمكنك تغيير اسم التطبيق وموقع المشروع أو الاحتفاظ بالقيم التلقائية.
  5. انقر على إنهاء.

ينزّل استوديو Android نموذج التطبيق إلى المسار الذي حدّدته ويفتح المشروع. يمكنك بعد ذلك فحص MainActivity.kt في كل مثال للاطّلاع على واجهات برمجة تطبيقات Jetpack Compose، مثل تأثير التلاشي التدريجي والمكوّنات المخصّصة واستخدام أسلوب الخط وعرض الألوان الفاتحة والداكنة في المعاينة داخل بيئة التطوير المتكاملة (IDE).

لاستخدام Jetpack Compose لنظام التشغيل Wear OS، يُرجى الاطّلاع على إعداد Jetpack Compose على Wear OS.