الزامات

قبل از دانلود و ساخت سورس اندروید، مطمئن شوید که سیستم شما شرایط زیر را برآورده می‌کند، سپس برای دستورالعمل‌های نصب بر اساس سیستم عامل، به ایجاد محیط ساخت مراجعه کنید.

الزامات سخت افزاری

ایستگاه کاری توسعه شما باید این الزامات سخت افزاری را برآورده کند یا از آن فراتر رود:

• یک محیط 64 بیتی برای Android 2.3.x (Gingerbread) و نسخه های بالاتر از جمله شاخه اصلی مورد نیاز است. شما می توانید نسخه های قدیمی تر را در سیستم های 32 بیتی کامپایل کنید.
• حداقل 250 گیگابایت فضای دیسک رایگان برای بررسی کد و 150 گیگابایت اضافی برای ساخت آن. اگر چندین ساخت را انجام دهید، به فضای بیشتری نیاز دارید.
  توجه: اگر در حال بررسی یک آینه هستید، به فضای بیشتری نیاز دارید زیرا آینه‌های کامل پروژه منبع باز Android (AOSP) حاوی تمام مخازن Git هستند که تا کنون استفاده شده‌اند.
• حداقل 16 گیگابایت رم مورد نیاز است، اما گوگل 64 گیگابایت را توصیه می کند.

از ژوئن 2021، Google از ماشین‌های 72 هسته‌ای با 64 گیگابایت رم به صورت داخلی استفاده می‌کند که برای ساخت کامل حدود 40 دقیقه زمان می‌برد (و فقط چند دقیقه برای ساخت‌های افزایشی، بسته به اینکه دقیقاً کدام فایل‌ها اصلاح شده‌اند). در مقابل، یک دستگاه 6 هسته ای با مقدار رم مشابه 3 ساعت طول می کشد.

الزامات نرم افزاری

شاخه master AOSP به طور سنتی بر روی نسخه‌های پشتیبانی طولانی مدت اوبونتو (LTS) توسعه و آزمایش می‌شود، اما ممکن است از توزیع‌های دیگری استفاده شود. برای مشاهده بسته های مورد نیاز اضافی و دستورات نصب آنها به ایجاد محیط ساخت مراجعه کنید.

ایستگاه کاری شما باید دارای نرم افزاری باشد که در زیر ذکر شده است. این الزامات برای شاخه master AOSP اعمال می شود. برای نسخه های اندروید 8.0 (Oreo یا O) تا 5.0 (Lollipop یا L)، استفاده از Dockerfile ارائه شده را برای سهولت نصب همه بسته های مورد نیاز در نظر بگیرید. برای روش دستی، به پشتیبانی از نسخه‌های قدیمی مراجعه کنید.

سیستم عامل

اگر در حال توسعه در برابر شاخه master AOSP هستید، از اوبونتو 18.04 (Bionic Beaver) استفاده کنید.

هشدار: ساخت بر روی Windows یا MacOS (از 22 ژوئن 2021) پشتیبانی نمی‌شود.

JDK

شاخه master Android در AOSP با نسخه از پیش ساخته شده OpenJDK ارائه می شود، بنابراین نیازی به نصب اضافی نیست.

نسخه‌های قدیمی‌تر اندروید نیاز به نصب جداگانه JDK دارند. در اوبونتو، از OpenJDK استفاده کنید.

بسته های کلیدی

شاخه اصلی AOSP دارای نسخه از پیش ساخته شده Make است، بنابراین نیازی به نصب اضافی نیست. Git به طور مشابه به عنوان بخشی از فرآیند ایجاد محیط ساخت نصب شده است.

مطمئن شوید که سیستم شما دارای پایتون 3 است.

هشدار: پشتیبانی Python 2 در تاریخ 1 ژانویه 2020 غروب شد، همانطور که در Sunsetting Python 2 توضیح داده شده است. همه توزیع‌های اصلی لینوکس پشتیبانی از بسته Python 2 را منسوخ می‌کنند. گوگل اکیداً توصیه می کند که تمام اسکریپت های خود را به پایتون 3 منتقل کنید.

توجه: AOSP با نسخه‌های خودش از بسته‌های Python 2 و Python 3 ارسال می‌شود، و می‌توانید از نسخه (مانند SEPolicy ) که در درخت منبع موجود است استفاده کنید. Google در حال انتقال همه اسکریپت‌های موجود در درخت منبع اندروید به پایتون 3 است و ممکن است کپی تعبیه‌شده پایتون 2 منسوخ شده باشد.

برای جزئیات بیشتر، به انتقال کد Python 2 به Python 3 و توصیه هایی در مورد غروب کد Python 2 خود مراجعه کنید.

باینری های دستگاه

پیش‌نمایش‌ها، تصاویر کارخانه، درایورها، به‌روزرسانی‌های هوایی (OTA) و سایر حباب‌ها را در زیر دانلود کنید. برای جزئیات، به دریافت باینری های اختصاصی مراجعه کنید.

• پیش نمایش باینری ها (بلاب ها) برای توسعه شاخه master AOSP
• تصاویر کارخانه برای دستگاه های پشتیبانی شده که شاخه های انتشار برچسب AOSP را اجرا می کنند
• فایل‌های پشتیبانی سخت‌افزار باینری برای دستگاه‌هایی که دارای شاخه‌های انتشار برچسب AOSP هستند

ساخت زنجیره ابزار

اندروید 8.0 و بالاتر فقط از Clang/LLVM برای ساخت پلتفرم اندروید پشتیبانی می کند. برای طرح سوالات و دریافت کمک به گروه android-llvm بپیوندید . مشکلات NDK/کامپایلر را در NDK GitHub گزارش کنید.

برای کیت توسعه بومی (NDK) و هسته‌های قدیمی، GCC 4.9 موجود در شاخه master AOSP (تحت prebuilts/ ) نیز ممکن است استفاده شود.