اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
الإعداد لتطوير البرامج باستخدام AOSP (الإصدار 9.0 أو الإصدارات الأحدث)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل تنزيل أحدث إصدار من Android
(android16-release) من مصدر Android وإنشاءه، تأكَّد
من أنّ جهازك يستوفي المتطلبات اللازمة ومن أنّه تم تثبيت البرنامج
المطلوب بشكل صحيح. يجب أيضًا أن تكون على دراية بالمصطلحات التالية:
Git
Git هو نظام تحكم في الإصدارات موزّع ومفتوح المصدر.
يستخدم Android Git لإجراء عمليات محلية، مثل إنشاء الفروع وعمليات الإضافة ومقارنة الملفات
والتعديلات. للحصول على مساعدة في تعلُّم Git، يُرجى الرجوع إلى مستندات Git.
Repo
Repo هو حزمة Python حول Git تعمل على تبسيط تنفيذ
العمليات المعقدة في مستودعات Git المتعددة. لا يحلّ Repo محلّ Git
في جميع عمليات التحكّم في الإصدارات، بل يسهّل فقط
تنفيذ عمليات Git المعقّدة. يستخدم Repo ملفات البيان لتجميع مشاريع Git في
المشروع الفائق لنظام التشغيل Android.
ملف البيان
ملف البيان هو ملف XML يحدِّد مكان وضع مشاريع Git المختلفة في
مصدر Android ضمن شجرة مصدر AOSP.
متطلبات أجهزة Meet
يجب أن تستوفي محطة عمل التطوير متطلبات الأجهزة التالية أو تتجاوزها:
نظام x86 64 بت
مساحة خالية على القرص لا تقل عن 400 غيغابايت لفحص الرمز البرمجي وإنشاءه
(250 غيغابايت لفحص الرمز البرمجي + 150 غيغابايت لإنشاءه)
ذاكرة وصول عشوائي (RAM) بسعة 64 غيغابايت على الأقل تستخدم Google أجهزة تتضمّن 72 نواة وذاكرة وصول عشوائي (RAM) بسعة 64 غيغابايت لإنشاء نظام التشغيل Android. باستخدام إعدادات الأجهزة هذه، يستغرق ملف الإصدار الكامل من Android
حوالي 40 دقيقة، بينما يستغرق ملف الإصدار المتزايد من Android بضع دقائق فقط. في المقابل، يستغرق الإصدار الكامل باستخدام جهاز مزوّد بـ 6 نوى وذاكرة وصول عشوائي بسعة 64 غيغابايت مدة 6 ساعات تقريبًا.
استيفاء متطلبات نظام التشغيل
يجب أن تعمل محطة عمل التطوير على أي إصدار من توزيعات Linux بسعة 64 بت مع مكتبة GNU C
Library (glibc) 2.17 أو إصدار أحدث.
تثبيت الحِزم المطلوبة
لإنشاء نظام التشغيل Android 11 أو إصدار أحدث، يجب استخدام الإصدار 18.04 من Ubuntu أو إصدار أحدث. لتثبيت
الحِزم المطلوبة لنظام التشغيل Ubuntu 18.04 أو الإصدارات الأحدث، شغِّل الأمر التالي:
من بين الحِزم المثبَّتة، يُثبِّت هذا الأمر Git، الذي يُستخدَم لتنزيل مصدر AOSP.
تثبيت البرامج المطلوبة
قبل أن تتمكّن من العمل مع AOSP، يجب تثبيت OpenJDK وMake
وPython 3 وRepo. يتضمّن أحدث إصدار من Android إصدارات مُعدّة مسبقًا
من OpenJDK وMake وPython 3، لذا لا يلزم تنفيذ خطوات تثبيت إضافية. يوضّح القسم التالي كيفية تثبيت Repo.
تعمل الأوامر الثلاث الأولى على إعداد ملف مؤقت وتنزيل Repo إلى الملف، وتحقق مما إذا كان المفتاح المقدَّم يتطابق مع المفتاح المطلوب. إذا كانت هذه الأوامر
ناجحة، سيؤدي الأمر الأخير إلى تثبيت مشغّل Repo.
تأكَّد من إصدار مشغّل Repo:
repoversion
من المفترض أن يشير الإخراج إلى الإصدار 2.4 أو إصدار أحدث، على سبيل المثال:
repo launcher version 2.45
ضبط دليل إخراج بديل
يتم تلقائيًا تخزين الناتج من كل عملية إنشاء في الدليل الفرعي out/ من
شجرة المصدر المطابقة. يمكنك إلغاء هذا الدليل من خلال تصدير متغيّر البيئة
OUT_DIR. على سبيل المثال، إذا كنت تريد تخزين الإخراج
على محرك أقراص مختلف، يمكنك توجيه OUT_DIR إلى هذا المحرك:
للحصول على قائمة بجميع أوامر Repo، يُرجى الرجوع إلى
مرجع أوامر Repo.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Set up for AOSP development (9.0 or later)\n\nBefore you download and build the Android latest release branch\n(android16-release) of the Android source, ensure\nthat your hardware meets the necessary requirements and that required software\nis properly installed. You should also be familiar with the following terms:\n\n*Git*\n: Git is a free and open source distributed version control system.\n Android uses Git for local operations such as branching, commits, diffs,\n and edits. For help learning Git, refer to the [Git documentation](https://git-scm.com/doc).\n\n*Repo*\n: Repo is a Python wrapper around Git that simplifies performing\n complex operations across multiple Git repositories. Repo doesn't replace Git\n for all version control operations, it only makes complex Git operations easier\n to accomplish. Repo uses manifest files to aggregate Git projects into the\n Android superproject.\n\n*Manifest file*\n: A manifest file is an XML file specifying where the various Git projects in\n the Android source are placed within an AOSP source tree.\n| **Note:** All commands in this documentation are preceded by a dollar sign ($) to differentiate them from output or entries within files. To copy a command to the clipboard, click the **Copy code sample** icon in the top right of each command box.\n| **Note:** If you want to build Android 2.3 - 8.0, refer to [Set up for AOSP development (2.3 - 8.0)](/docs/setup/start/older-versions).\n\nMeet hardware requirements\n--------------------------\n\nYour development workstation should meet or exceed these hardware\nrequirements:\n\n- A 64-bit x86 system.\n\n | **Note:** You can compile AOSP versions previous to 2.3.x on 32-bit systems.\n- At least 400 GB of free disk space to check out and build the code\n (250 GB to check out + 150 GB to build).\n\n | **Note:** If you're checking out a mirror, you need more space because the full Android Open Source Project (AOSP) mirrors contain all Git repositories that have ever been used.\n- A minimum of 64 GB of RAM. Google uses 72-core machines with 64 GB\n of RAM to build Android. With this hardware configuration, it takes\n approximately 40 minutes for a full build of Android and only a few minutes for incremental build of Android. By contrast, it takes approximately 6 hours for a\n full build with a 6-core machine with 64 GB of RAM.\n\nMeet operating system requirements\n----------------------------------\n\nYour development workstation must run any 64-bit Linux distribution with GNU C\nLibrary (glibc) 2.17 or later.\n| **Warning:** Android OS development on macOS isn't supported as of June 22, 2021 (Android 11). For information on configuring your development workstation for macOS, refer to [Set Up for AOSP development (2.3 - 8.0)](/docs/setup/start/older-versions).\n\nInstall required packages\n-------------------------\n\nTo build Android 11 or higher, you must use Ubuntu 18.04 or later. To install\nrequired packages for Ubuntu 18.04 or later, run the following command: \n\n 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\n\nAmong the packages installed, this command installs Git, which is used to\ndownload the AOSP source.\n| **Note:** This command works for Ubuntu 18.04 or later. For package installation for earlier versions of Ubuntu, see [Setup for Android development (AOSP 2.3 - 8)](/docs/setup/start/older-versions).\n\nInstall required software\n-------------------------\n\nBefore you can work with AOSP, you must have installations of OpenJDK, Make,\nPython 3, and Repo. The latest release branch of Android comes with prebuilt\nversions of OpenJDK, Make, and Python 3, so additional installation steps aren't\nrequired. The following section explains how to install Repo.\n\n### Install Repo\n\nFollow these steps to install Repo:\n\n1. Download the current package information:\n\n sudo apt-get update\n\n2. Run the following command to install the Repo launcher:\n\n sudo apt-get install repo\n\n The Repo launcher provides a Python script that initializes a checkout\n and downloads the full Repo tool.\n\n If successful, skip to step 4.\n3. (optional) Manually install Repo using the following series of commands:\n\n export REPO=$(mktemp /tmp/repo.XXXXXXXXX)\n curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo\n gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65\n curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo\n\n The first three commands set up a temp file, download Repo to the file, and\n verify that the key provided matches the required key. If these commands are\n successful, the final command installs the Repo launcher.\n4. Verify the Repo launcher version:\n\n repo version\n\n The output should indicate a version of 2.4 or higher, for example:\n\n `repo launcher version 2.45`\n\nSet an alternative output directory\n-----------------------------------\n\nBy default, the output of each build is stored in the `out/` subdirectory of\nthe matching source tree. You can override this directory by exporting the\n`OUT_DIR` environment variable. For example, if you want to store your output\non a different drive, you can point `OUT_DIR` to that drive: \n\n export OUT_DIR=\u003cvar translate=\"no\"\u003emy_other_drive\u003c/var\u003e\n\nWhat's next?\n------------\n\n- To download the source code, continue to [Download the Android source](/docs/setup/download).\n- For help learning Git, see the [Git documentation](https://git-scm.com/doc).\n- For additional Repo documentation, see the [Repo README](https://gerrit.googlesource.com/git-repo/+/refs/heads/main/README.md).\n- For a list of all Repo commands, refer to the [Repo command reference](/docs/setup/reference/repo)."]]