إنشاء مشروع أو استيراده

يساعدك استوديو Android للنظام الأساسي (ASfP) في إعداد بيئة التطوير الخاصة بك لمشروع مفتوح المصدر لنظام Android (AOSP). يستند ASfP إلى نموذج مساحة عمل IntelliJ، ويتيح إعدادات يدوية ونماذج قابلة للمشاركة مع الفريق.

تشغيل معالج إعداد المشروع

يمكنك تشغيل معالج إعداد المشروع بطريقتَين:

• من شاشة الترحيب: انقر على مشروع جديد أو استيراد مشروع ASfP.
• من مشروع مفتوح: في القائمة الرئيسية، اختَر ASfP > المشروع > مشروع جديد أو استيراد مشروع ASfP.

الاستيراد من نموذج

إذا كان فريقك يشارك ملف إعداد .asfp-project عاديًا، يمكنك تهيئة مساحة العمل مباشرةً من هذا النموذج باتّباع الخطوات التالية:

1. في معالج إعداد المشروع، اختَر الاستيراد من نموذج.
2. استعرض ملف YAML المشترك .asfp-project أو .asfp-template واختَره.
3. بعد أن يملأ المعالج إعدادات المشروع من النموذج، تحقَّق من مسار استخراج المستودع المحلي، ثم انقر على إنهاء.

الضبط يدويًا

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

1. في معالج إعداد المشروع، اختَر إعداد المشروع يدويًا واملأ تفاصيل المشروع:

   • استخراج المستودع (مسارات الوحدات): حدِّد المسار المطلق إلى جذر عملية استخراج مصدر AOSP المحلي (على سبيل المثال، /path/to/aosp).
   • هدف الغداء: أدخِل هدف الغداء الذي تستخدمه في عملية الإنشاء (على سبيل المثال، aosp_cf_x86_64_phone-aosp_current-userdebug).
   • اسم المشروع: أدخِل اسمًا وصفيًا لمشروعك.
   • الأدلة والوحدات: أدرِج الأدلة الأولية أو وحدات Soong التي تريد تضمينها في مشروعك (بالنسبة إلى جذر المستودع، مثل frameworks/base أو packages/apps/Settings).
   • اللغات: إذا كان سير عملك يتضمّن رمزًا برمجيًا لمنصة C أو C++ أو Rust، اختَر C أو C++‎ أو Rust. يتم تضمين Java وKotlin وAndroid.bp تلقائيًا.
   • متغيّرات البيئة وخيارات الإنشاء: في حقل متغيّرات البيئة ضمن المعالج، أضِف أي متغيّرات بيئة مخصّصة مثل SOONG_ALLOW_MISSING_DEPENDENCIES=true، ويمكنك اختياريًا وضع علامة في مربّع الاختيار الترجمة الجزئية باستخدام Soong (SOONG_PARTIAL_COMPILE) لإجراء عمليات إنشاء تدريجية أسرع.

2. انقر على إنهاء. تنشئ ASfP بنية المشروع، وتُنشئ ملف الإعداد .asfp-project في جذر مشروعك، وتنفِّذ المزامنة الأولية.

مشاركة إعدادات مشروعك أو تخصيصها

بعد الإعداد الأوّلي، يمكنك تخصيص مشروعك في أي وقت من خلال تعديل ملف .asfp-project (ASfP > المشروع > فتح الإعدادات):

• إضافة أدلة ووحدات Soong أو استبعادها
• فعِّل لغات إضافية (cpp وrust).
• ضبط علامات Soong المخصّصة ومتغيّرات البيئة

لتصدير إعداداتك إلى أعضاء الفريق، انقر بزر الماوس الأيمن على علامة التبويب .asfp-project واختر تصدير إلى نموذج.

لمزيد من المعلومات حول مَعلمات .asfp-project وأوضاع المزامنة وإجراءات Android.bp داخل المحرّر، يمكنك الاطّلاع على نظرة عامة على المشاريع وسير عمل Soong.