الإعداد لتطوير AOSP (الإصدار 9.0 أو إصدار أحدث)

قبل تنزيل وإنشاء فرع main لمصدر Android، تأكَّد من أن جهازك يلبي المتطلبات اللازمة وأن البرامج المطلوبة بشكل صحيح. يجب أيضًا أن تكون على دراية بالمصطلحات التالية:

Git

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

Repo

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

ملف البيان

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

ملاحظة: جميع الأوامر في هذه الوثائق مسبوقة بعلامة الدولار ($) إلى لتمييزها عن الإخراج أو الإدخالات داخل الملفات. لنسخ أمر إلى إلى الحافظة، انقر على رمز نسخ نموذج الرمز في أعلى يسار كل أمر.

ملاحظة: إذا أردت إنشاء الإصدارات من Android 2.3 إلى 8.0، يمكنك الرجوع إلى الإعداد لتطوير AOSP (من 2.3 إلى 8.0)

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

يجب أن تتوافق محطة عمل التطوير لديك مع هذه الأجهزة أو تتجاوزها المتطلبات:

• نظام تشغيل 64 بت × 86

  ملاحظة: يمكنك تجميع إصدارات AOSP السابقة إلى 2.3.x على أنظمة 32 بت.

• توفُّر مساحة خالية على القرص لا تقل عن 400 غيغابايت لفحص الرمز وإنشاء الرمز (سعة 250 غيغابايت للفحص بالإضافة إلى 150 غيغابايت للإنشاء).

  ملاحظة: إذا كنت تبحث عن مرآة، فأنت بحاجة إلى مساحة إضافية لأن تحتوي النسخ المطابقة "للمشروع المفتوح المصدر لنظام Android" (AOSP) على جميع مستودعات Git سبق أن تم استخدامها.

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

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

يجب أن تعمل محطة التطوير لديك على تشغيل أي توزيع Linux 64 بت مع GNU C Library (glibc) 2.17 أو أحدث.

تحذير: لن تتوفّر إمكانية تطوير نظام التشغيل Android على نظام التشغيل macOS اعتبارًا من 22 حزيران (يونيو) 2021. (نظام التشغيل Android 11). للحصول على معلومات حول ضبط محطة عمل التطوير لنظام التشغيل macOS، راجِع الإعداد لتطوير AOSP (من 2.3 إلى 8.0)

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

لإنشاء نظام التشغيل Android 11 أو إصدار أحدث، عليك استخدام الإصدار 18.04 من نظام التشغيل Ubuntu أو إصدار أحدث. للتثبيت الحزم المطلوبة لنظام التشغيل 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

من بين الحزم المثبتة، يقوم هذا الأمر بتثبيت جيت، والذي يُستخدم تنزيل مصدر AOSP.

ملاحظة: يعمل هذا الأمر على نظام التشغيل Ubuntu 18.04 أو الإصدارات الأحدث. لتركيب الحزمة للإصدارات السابقة من نظام التشغيل Ubuntu، راجع الإعداد لتطوير Android (الإصدار 2.3 - 8 من AOSP)

تثبيت البرنامج المطلوب

قبل أن تتمكّن من العمل باستخدام AOSP، يجب أن يكون لديك عدد من عمليات تثبيت OpenJDK، وMake، وPython 3، وRepo. يشمل الفرع الرئيسي لنظام Android (AOSP) مع إصدارات مُنشأة مسبقًا من 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، يُرجى الرجوع إلى مرجع طلب Reo.