قبل از دانلود و ساخت شاخه main
سورس اندروید، مطمئن شوید که سخت افزار شما الزامات لازم را دارد و نرم افزار مورد نیاز به درستی نصب شده است. همچنین باید با اصطلاحات زیر آشنا باشید:
- Git
- Git یک سیستم کنترل نسخه توزیع شده رایگان و متن باز است. اندروید از Git برای عملیات محلی مانند شاخهبندی، commits، diffs و ویرایشها استفاده میکند. برای کمک به یادگیری Git، به مستندات Git مراجعه کنید.
- مخزن
- Repo یک پوشش پایتون در اطراف Git است که انجام عملیات پیچیده را در چندین مخزن Git ساده می کند. Repo جایگزین Git برای همه عملیات کنترل نسخه نمی شود، فقط انجام عملیات پیچیده Git را آسان تر می کند. Repo از فایل های مانیفست برای جمع آوری پروژه های Git در ابرپروژه اندروید استفاده می کند.
- فایل مانیفست
- فایل مانیفست یک فایل XML است که مشخص میکند پروژههای مختلف Git در منبع Android کجا در درخت منبع AOSP قرار میگیرند.
نیازهای سخت افزاری را برآورده کنید
Your development workstation should meet or exceed these hardware requirements:
یک سیستم 64 بیتی x86.
حداقل 400 گیگابایت فضای دیسک رایگان برای بررسی و ساخت کد (250 گیگابایت برای بررسی + 150 گیگابایت برای ساخت).
حداقل 64 گیگابایت رم. Google uses 72-core machines with 64 GB of RAM to build Android. با این پیکربندی سخت افزاری، تقریباً 40 دقیقه برای ساخت کامل اندروید و تنها چند دقیقه برای ساخت تدریجی اندروید طول می کشد. در مقابل، برای ساخت کامل با یک دستگاه 6 هسته ای با 64 گیگابایت رم تقریباً 6 ساعت طول می کشد.
نیازهای سیستم عامل را برآورده کنید
ایستگاه کاری توسعه شما باید هر توزیع لینوکس 64 بیتی را با کتابخانه GNU C (glibc) 2.17 یا بالاتر اجرا کند.
بسته های مورد نیاز را نصب کنید
برای ساخت اندروید 11 یا بالاتر، باید از اوبونتو 18.04 یا بالاتر استفاده کنید. برای نصب بسته های مورد نیاز برای اوبونتو 18.04 یا جدیدتر، دستور زیر را اجرا کنید:
sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig
در بین بسته های نصب شده، این دستور Git را نصب می کند که برای دانلود سورس AOSP استفاده می شود.
نرم افزار مورد نیاز را نصب کنید
قبل از اینکه بتوانید با AOSP کار کنید، باید OpenJDK، Make، Python 3 و Repo را نصب کنید. شاخه اصلی AOSP اندروید دارای نسخه های از پیش ساخته شده OpenJDK، Make و Python 3 است، بنابراین نیازی به مراحل نصب اضافی نیست. قسمت زیر نحوه نصب Repo را توضیح می دهد.
Repo را نصب کنید
برای نصب Repo مراحل زیر را دنبال کنید:
اطلاعات بسته فعلی را دانلود کنید:
sudo apt-get update
برای نصب لانچر Repo دستور زیر را اجرا کنید:
sudo apt-get install repo
راهانداز Repo یک اسکریپت پایتون را ارائه میکند که یک پرداخت را اولیه میکند و ابزار کامل Repo را دانلود میکند.
در صورت موفقیت، به مرحله 4 بروید.
(اختیاری) با استفاده از سری دستورات زیر Repo را به صورت دستی نصب کنید:
export REPO=$(mktemp /tmp/repo.XXXXXXXXX) curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65 curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
سه دستور اول یک فایل موقت را تنظیم می کنند، Repo را در فایل دانلود می کنند و بررسی می کنند که کلید ارائه شده با کلید مورد نیاز مطابقت دارد. در صورت موفقیت آمیز بودن این دستورات، دستور نهایی لانچر Repo را نصب می کند.
نسخه لانچر Repo را تأیید کنید:
repo version
خروجی باید نسخه 2.4 یا بالاتر را نشان دهد، به عنوان مثال:
repo launcher version 2.45
یک فهرست خروجی جایگزین تنظیم کنید
بهطور پیشفرض، خروجی هر بیلد در فهرست out/
درخت منبع منطبق ذخیره میشود. با صادر کردن متغیر محیطی OUT_DIR
می توانید این دایرکتوری را لغو کنید. به عنوان مثال ، اگر می خواهید خروجی خود را در یک درایو متفاوت ذخیره کنید ، می توانید به آن درایو OUT_DIR
اشاره کنید:
export OUT_DIR=my_other_drive
بعدش چی؟
- برای دانلود کد منبع، به دانلود سورس اندروید ادامه دهید.
- برای کمک به یادگیری GIT ، به مستندات GIT مراجعه کنید.
- برای اسناد اضافی Repo، Repo README را ببینید.
- برای فهرستی از تمام دستورات Repo، به مرجع دستور Repo مراجعه کنید.