ایجاد یا وارد کردن پروژه

‫Android Studio for Platform (ASfP) به شما کمک می‌کند محیط توسعه خود را برای پروژه منبع باز Android (AOSP) راه‌اندازی کنید. ‫ASfP که براساس «مدل فضای کاری» IntelliJ ساخته شده است، از پیکربندی دستی و الگوهای تیم هم‌رسانی‌پذیر پشتیبانی می‌کند.

راه‌اندازی دستیار راه‌اندازی پروژه

به دو روش می‌توانید «دستیار راه‌اندازی پروژه» را راه‌اندازی کنید:

• از صفحه «خوش آمدید»: روی پروژه جدید یا وارد کردن پروژه ASfP کلیک کنید.
• از یک پروژه باز: در منو اصلی، ASfP > پروژه > پروژه جدید یا وارد کردن پروژه ASfP را انتخاب کنید.

وارد کردن از الگو

اگر تیمتان فایل پیکربندی استاندارد .asfp-project را هم‌رسانی می‌کند، می‌توانید فضای کاری‌تان را مستقیماً از آن الگو مقداردهی اولیه کنید:

1. در جادوگر راه‌اندازی پروژه، وارد کردن از الگو را انتخاب کنید.
2. به فایل .asfp-project یا .asfp-template YAML هم‌رسانی‌شده مرور کنید و آن را انتخاب کنید.
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 را انتخاب کنید. جاوا، 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 مراجعه کنید.