الإعداد لتطوير البرامج باستخدام AOSP (الإصدار 9.0 أو الإصدارات الأحدث)

قبل تنزيل وإنشاء أحدث فرع إصدار (android17-release) من مصدر Android، تأكَّد من أنّ جهازك يستوفي المتطلبات اللازمة وأنّ البرامج المطلوبة مثبّتة بشكل صحيح. عليك أيضًا الإلمام بالمصطلحات التالية:

Git

Git هو نظام مجاني ومفتوح المصدر للتحكّم في الإصدارات الموزّعة. يستخدم Android نظام Git للعمليات المحلية، مثل إنشاء الفروع وعمليات الإرسال وعمليات المقارنة والتعديلات. لمزيد من المعلومات عن Git، يُرجى الرجوع إلى مستندات Git.

Repo

Repo هو برنامج تضمين Python حول Git يسهّل إجراء عمليات معقّدة على مستودعات Git متعددة. لا يحلّ Repo محلّ Git في جميع عمليات التحكّم في الإصدارات، بل يسهّل فقط إجراء عمليات Git المعقّدة. يستخدم Repo ملفات البيان لتجميع مشاريع Git في مشروع Android الرئيسي.

ملف البيان

ملف البيان هو ملف XML يحدّد مكان وضع مشاريع Git المختلفة في مصدر Android ضِمن شجرة مصدر AOSP.

استيفاء متطلبات الجهاز

يجب أن يستوفي جهاز محطة العمل المخصّصة للتطوير متطلبات الجهاز التالية أو أن يكون أفضل منها:

• نظام x86‏ 64 بت

• مساحة خالية على القرص لا تقل عن 400 غيغابايت لاستخراج الرمز البرمجي وإنشائه (250 غيغابايت لاستخراج الرمز البرمجي + 150 غيغابايت للإنشاء)

• ذاكرة وصول عشوائي (RAM) بسعة 64 غيغابايت على الأقل تستخدم Google أجهزة ذات 72 نواة وذاكرة وصول عشوائي بسعة 64 غيغابايت لإنشاء Android. باستخدام إعدادات الجهاز هذه، يستغرق إنشاء إصدار كامل من Android حوالي 40 دقيقة، بينما يستغرق إنشاء إصدار جزئي من Android بضع دقائق فقط. في المقابل، يستغرق إنشاء إصدار كامل باستخدام جهاز ذي 6 نوى وذاكرة وصول عشوائي بسعة 64 غيغابايت حوالي 6 ساعات.

استيفاء متطلبات نظام التشغيل

يجب أن تعمل محطة العمل المخصّصة للتطوير بأي توزيعة Linux‏ 64 بت مع مكتبة GNU C‏ (glibc) الإصدار 2.17 أو إصدار أحدث.

تثبيت الحِزم المطلوبة

لإنشاء الإصدار Android 11 أو إصدار أحدث، عليك استخدام Ubuntu 18.04 أو إصدار أحدث. لتثبيت الحِزم المطلوبة لنظام التشغيل Ubuntu 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. يأتي أحدث فرع إصدار من Android مع إصدارات مجمّعة مسبقًا من OpenJDK وMake وPython 3، لذا لا يلزم اتّخاذ خطوات تثبيت إضافية. يوضّح القسم التالي كيفية تثبيت Repo.

تثبيت Repo

اتّبِع الخطوات التالية لتثبيت Repo:

1. نزِّل معلومات الحزمة الحالية:

   sudo apt-get update

2. شغِّل الأمر التالي لتثبيت مشغّل Repo:

   sudo apt-get install repo

   يوفّر مشغّل Repo نصًا برمجيًا بلغة Python يبدأ عملية استخراج وينزّل أداة Repo الكاملة.

   إذا نجحت العملية، انتقِل إلى الخطوة 4.

3. (اختياري) ثبِّت 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.

4. تأكَّد من إصدار مشغّل Repo:

   repo version

   يجب أن تشير النتيجة إلى الإصدار 2.4 أو إصدار أحدث، مثلاً:

   repo launcher version 2.45

ضبط دليل إخراج بديل

يتم تخزين ناتج كل عملية إنشاء في الدليل الفرعي out/ من شجرة المصدر المطابقة تلقائيًا. يمكنك إلغاء هذا الدليل من خلال تصدير متغيّر البيئة OUT_DIR. على سبيل المثال، إذا أردت تخزين الناتج على محرك أقراص مختلف، يمكنك توجيه OUT_DIR إلى هذا المحرك:

export OUT_DIR=my_other_drive

ما هي الخطوات التالية؟

• لتنزيل رمز المصدر، انتقِل إلى مقالة تنزيل مصدر Android.
• لمزيد من المعلومات عن Git، يُرجى الاطّلاع على مستندات Git.
• لمزيد من مستندات Repo، يُرجى الاطّلاع على ملف Repo README.
• للاطّلاع على قائمة بجميع أوامر Repo، يُرجى الرجوع إلى مرجع أوامر Repo.