البدء بسرعة

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

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

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

android create empty-activity --name=MyApp

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

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

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

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

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

اطّلِع على إعداد تبعيات Compose وCompiler.

تجربة تطبيقات نموذجية باستخدام Jetpack Compose

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

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

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

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