البدء بسرعة

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

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

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

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

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

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

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

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

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

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

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

  1. إذا كنتم في نافذة Welcome to Android Studio (مرحبًا بكم في "استوديو Android")، انقروا على Import an Android code sample (استيراد عينة تعليمات برمجية لنظام Android). إذا كان لديكم مشروع مفتوح في "استوديو Android"، انقروا على ملف > جديد > استيراد نموذج من شريط القوائم.
  2. في شريط البحث بالقرب من أعلى معالج Browse Samples (تصفُّح النماذج)، اكتبوا "compose".
  3. اختاروا أحد التطبيقات النموذجية في Jetpack Compose من نتائج البحث، ثم انقروا على التالي.
  4. غيِّروا اسم التطبيق وموقع المشروع أو احتفظوا بالقيم التلقائية.
  5. انقروا على إنهاء.

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

لاستخدام Jetpack Compose على Wear OS، اطّلِعوا على إعداد Jetpack Compose على Wear OS.