יצירה או ייבוא של פרויקט

‫Android Studio for Platform ‏ (ASfP) עוזר להגדיר את סביבת הפיתוח עבור פרויקט הקוד הפתוח של Android ‏ (AOSP). ‫ASfP מבוסס על מודל סביבת העבודה של IntelliJ, והוא תומך בהגדרה ידנית ובתבניות צוות שניתנות לשיתוף.

הפעלת אשף הגדרת הפרויקט

יש שתי דרכים להפעיל את אשף הגדרת הפרויקט:

• ממסך הפתיחה: לוחצים על New Project (פרויקט חדש) או על Import ASfP Project (ייבוא פרויקט ASfP).
• מתוך פרויקט פתוח: בתפריט הראשי, בוחרים באפשרות ASfP > Project > New Project (פרויקט חדש) או Import ASfP Project (ייבוא פרויקט ASfP).

ייבוא מתבנית

אם הצוות שלכם משתף קובץ תצורה רגיל של .asfp-project, אתם יכולים לאתחל את סביבת העבודה ישירות מהתבנית הזו:

1. באשף להגדרת הפרויקט, בוחרים באפשרות ייבוא מתבנית.
2. מדפדפים אל קובץ ה-YAML המשותף .asfp-project או .asfp-template ובוחרים אותו.
3. אחרי שהאשף מאכלס את הגדרות הפרויקט מהתבנית, מאמתים את הנתיב של ה-Repo checkout המקומי ולוחצים על Finish (סיום).

הגדרה ידנית

כדי ליצור הגדרת פרויקט חדשה מאפס:

1. באשף להגדרת פרויקטים, בוחרים להגדיר את הפרויקט באופן ידני וממלאים את פרטי הפרויקט:

   • Repo checkout (Module paths): מציינים את הנתיב המוחלט לשורש של ה-checkout המקומי של מקור 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 Partial Compile (SOONG_PARTIAL_COMPILE) כדי לבצע בנייה מצטברת מהירה יותר.

2. לוחצים על סיום. ‫ASfP יוצר את מבנה הפרויקט, יוצר את קובץ התצורה .asfp-project בתיקיית השורש של הפרויקט ומריץ את הסנכרון הראשוני.

שיתוף או התאמה אישית של הגדרות הפרויקט

אחרי ההגדרה הראשונית, אפשר להתאים אישית את הפרויקט בכל שלב על ידי עריכת הקובץ .asfp-project (ASfP > Project > Open Config):

• הוספה או החרגה של ספריות ומודולים של Soong.
• הפעלת שפות נוספות (cpp, ‏ rust).
• הגדרת משתני סביבה ודגלים מותאמים אישית של Soong.

כדי לייצא את ההגדרה שלכם לחברי הצוות, לוחצים לחיצה ימנית על הכרטיסייה .asfp-project ובוחרים באפשרות ייצוא לתבנית.

מידע נוסף על פרמטרים של .asfp-project, מצבי סנכרון ופעולות של Android.bp בעורך זמין במאמר סקירה כללית של פרויקטים ותהליכי עבודה של Soong.