يتيح لك هذا الدليل التعليمي تجربة تطوير نظام التشغيل Android لأول مرة.
الإعداد لتطوير تطبيقات Android
قبل تنزيل فرع بيان android-latest-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. باستخدام إعدادات الأجهزة هذه، يستغرق الأمر حوالي 40 دقيقة لإنشاء إصدار كامل من Android وبضع دقائق فقط لإنشاء إصدار تزايدي من Android. في المقابل، يستغرق إنشاء الإصدار الكامل حوالي 6 ساعات على جهاز يتضمّن 6 نوى وذاكرة وصول عشوائي بسعة 64 غيغابايت.
استيفاء متطلبات نظام التشغيل
يجب أن تعمل محطة عمل التطوير على أي توزيعة Linux 64 بت مع مكتبة GNU C (glibc) الإصدار 2.17 أو إصدار أحدث.
تثبيت الحزم المطلوبة
لتثبيت الحزم المطلوبة لنظام التشغيل 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، يجب أن تكون لديك عمليات تثبيت لـ OpenJDK وMake وPython 3 وRepo. يأتي أحدث فرع لإصدار Android مزوّدًا بإصدارات مُنشأة مسبقًا من OpenJDK وMake وPython 3، لذا لا يلزم اتخاذ خطوات تثبيت إضافية. يوضّح القسم التالي كيفية تثبيت Repo.
تثبيت Repo
اتّبِع الخطوات التالية لتثبيت Repo:
نزِّل معلومات الحزمة الحالية:
sudo apt-get updateنفِّذ الأمر التالي لتثبيت مشغّل Repo:
sudo apt-get install repoيوفّر مشغّل Repo نصًا برمجيًا بلغة Python يبدأ عملية الدفع وينزّل أداة Repo الكاملة.
إذا نجحت العملية، انتقِل إلى الخطوة 4.
اختياري: ثبِّت Repo يدويًا باستخدام سلسلة الأوامر التالية:
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repogpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65curl -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
تنزيل رمز المصدر لنظام التشغيل Android
يتوفّر مصدر Android في مجموعة من مستودعات Git التي تستضيفها Google. يتضمّن كل مستودع Git السجلّ الكامل لمصدر Android، بما في ذلك التغييرات التي تم إجراؤها على المصدر ووقت إجرائها. لتنزيل رمز المصدر لنظام التشغيل Android:
انتقِل إلى الدليل الرئيسي:
cd ~أنشئ دليلاً فرعيًا للعمل المحلي داخله:
mkdir aospانتقِل إلى الدليل:
cd aospابدأ فرع الإصدار الأخير من الرمز المصدر لمستودع AOSP (
android-latest-release):repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifestأدخِل بيانات اعتماد Git (الاسم وعنوان البريد الإلكتروني) أو اقبلها.
مزامنة الرمز المصدر:
repo sync -c -j8إذا واجهت أي مشاكل أثناء التنزيل، يُرجى الرجوع إلى تحديد مشاكل المزامنة وحلّها.
إنشاء الرمز البرمجي
لإنشاء الرمز:
من داخل دليل العمل، حدِّد مصدر النص البرمجي
envsetup.shلإعداد بيئة الإصدار:source build/envsetup.shحدِّد نوع جهاز مستهدَف لإنشائه باستخدام الأمر
lunch. الهدف هو تبديل للجهاز، مثل طراز معيّن أو شكل معيّن. تحديد هذا الهدف:lunch aosp_cf_x86_64_only_phone-aosp_current-userdebugمن المفترض أن يظهر لك ملخّص عن بيئة الإصدار والهدف:
============================================ PLATFORM_VERSION_CODENAME=Baklava PLATFORM_VERSION=Baklava TARGET_PRODUCT=aosp_cf_x86_64_only_phone TARGET_BUILD_VARIANT=userdebug TARGET_ARCH=x86_64 TARGET_ARCH_VARIANT=silvermont HOST_OS=linux HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete HOST_CROSS_OS=windows BUILD_ID=BP1A.250305.020 OUT_DIR=out ============================================إنشاء الهدف:
m
يُرجى توقُّع أن يستغرق الإصدار الأول ساعات. تستغرق عمليات الإنشاء اللاحقة وقتًا أقل بكثير. يظهر ناتج الإصدار في $OUT_DIR.
تشغيل Cuttlefish
Cuttlefish هو Android Emulator يُستخدم لاختبار إصداراتك.
نفِّذ الأوامر التالية لتنزيل حزم Debian المضيفة وإنشائها وتثبيتها:
sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curlgit clone https://github.com/google/android-cuttlefishcd android-cuttlefishtools/buildutils/build_packages.shsudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.debsudo usermod -aG kvm,cvdnetwork,render $USERsudo rebootتؤدي إعادة التشغيل إلى تثبيت وحدات نواة إضافية وتطبيق قواعد
udev.بعد إعادة تشغيل محطة العمل، انتقِل إلى دليل
aosp، واضبط بيئة الإصدار، وشغِّل Cuttlefish:cd ~/aospsource build/envsetup.shlunch aosp_cf_x86_64_only_phone-aosp_current-userdebuglaunch_cvd --daemonاتصِل بجهاز Cuttlefish من خلال الانتقال إلى
https://localhost:8443في متصفّح الويب. يتم عرض جهازك الافتراضي الذي يعمل بنظام التشغيل Android.
تغيير
عدِّل الرمز المصدر باتّباع قائمة التغييرات في هذا المثال.
من جذر عملية الدفع (دليل
aosp/)، انتقِل إلى مشروع Gitframeworks/native:cd frameworks/nativeابدأ فرعًا مؤقتًا باستخدام هذا الأمر:
repo start BRANCH_NAME .استخدِم المحرِّر لتعديل
SurfaceFlinger.cppفي الموقع التالي:aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cppابحث عن السطر التالي:
void SurfaceFlinger::updateColorMatrixLocked() {أضِف هذا السطر في بداية
updateColorMatrixLocked():mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f}, vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});إنشاء الرمز البرمجي:
mتحديث الإصدار على الجهاز:
adb rootadb remount -Radb rootadb syncadb rebootتأكَّد من ظهور تغيير في اللون على الجهاز الذي اخترته.
إصلاح اختبار
يستخدم هذا الجزء من الدرس التطبيقي حول الترميز مثالاً على اختبار في شجرة المصدر ويتعذّر إجراؤه. لتشغيل الاختبار وتصحيح الأخطاء وإصلاحها، اتّبِع التعليمات التالية:
التشغيل:
atest DevCodelabTestتعذّر الاختبار.
افحص تتبُّع تسلسل استدعاء الدوال البرمجية للاختبار الذي تعذّر إجراؤه:
STACKTRACE: java.lang.AssertionError at org.junit.Assert.fail(Assert.java:87) at org.junit.Assert.assertTrue(Assert.java:42) at org.junit.Assert.assertTrue(Assert.java:53) at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)يعرض السطر الأخير من تتبع تسلسل استدعاء الدوال البرمجية الاختبار الذي يتعذّر إجراؤه (
testHelloWorld). هذا الاختبار موجود في ملف باسمDevCodelabTest.java.لتحديد موقع الاختبار الذي يجب إصلاحه، أضِف
WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/إلى السطر الأخير من تتبُّع تسلسل استدعاء الدوال البرمجية حتى اسم ملف الاختبار بما في ذلك الاسم. وبالتالي، يصبحandroid.test.example.devcodelab.DevCodelabTestWORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.عدِّل
platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javaواستبدِل "Assert.assertTrue(false)" بـ "Assert.assertTrue(true)".شغِّل الاختبار مرة أخرى للتأكّد من حلّ المشكلة:
atest DevCodelabTest
تحميل الرمز البرمجي للمراجعة
تسهّل أداة Repo استخدام Git من خلال تجميع أوامر مثل git clone للعمل
على مستودعات (أو مشاريع) Git متعددة في آنٍ واحد. لمراجعة الرموز البرمجية لمشاريعك في Git، استخدِم نظام مراجعة الرموز البرمجية المستند إلى الويب Gerrit.
بافتراض أنّك أجريت التغييرات في مشروع
frameworks/native، نفِّذ هذه الأوامر لتحميل التغييرات:cd frameworks/nativerepo start BRANCH_NAME .git add .git commitبالنسبة إلى رسالة الإرسال، أدخِل ما يلي:
Android BRANCH_NAME change Test: manual atestتحميل التغيير:
repo uploadإذا نجحت، ستظهر لك رسالة تشبه هذه الرسالة:
Upload project frameworks/native/ to remote branch android17-release: branch BRANCH_NAME ( 1 commit, Wed Aug 7 09:32:33 2019 -0700): ff46b36d Android BRANCH_NAME change to https://android-review.googlesource.com/ (y/N)? y remote: Processing changes: refs: 1, new: 1, done remote: remote: SUCCESS remote: remote: https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 Android BRANCH_NAME change [NEW] remote: To https://android-review.googlesource.com/platform/frameworks/native * [new branch] BRANCH_NAME -> refs/for/android17-release
عرض التغيير في Gerrit
لعرض التغيير في Gerrit، انتقِل إلى رابط الناتج في الوحدة الطرفية. يشبه الرابط ما يلي:
https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432
التراجع عن التغيير
عادةً، بعد الاختبار وعند المراجعة والموافقة، يمكنك إرسال التغيير في Gerrit ودمجه في المستودع. بدلاً من ذلك، لأغراض هذا الدرس التطبيقي حول الترميز، يمكنك التراجع عن عملك:
في Gerrit، انقر على تجاهُل (Abandon).
تجاهُل الفرع المؤقت المرتبط في دليل مشروع
frameworks/native(أو أدلته الفرعية):repo abandon BRANCH_NAME .تراجَع عن التغييرات التي أجريتها على ملف الاختبار. بما أنّك لم تُشغِّل
repo startوgit commitوrepo uploadعلى التغيير الاختباري، يمكنك إعادة ضبط الملف نفسه. لنفترض أنّك في دليلaosp/platform_testing، استخدِم الأوامر التالية لإعادة ضبط الملف:git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javagit checkout .
بهذا نكون قد انتهينا من الدرس التطبيقي حول الترميز لتطوير نظام Android الأساسي.
الحصول على مساعدة
إذا واجهت أخطاء أثناء هذا الدرس التطبيقي حول الترميز، يُرجى الإبلاغ عنها باستخدام رابط Issue Tracker في أسفل أي صفحة. يمكنك إرسال الأسئلة إلى مجموعة android-building.
اكتب ps -A | grep crosvm لمعرفة ما إذا كان crosvm قيد التشغيل حاليًا. إذا كان crosvm
قيد التشغيل، اكتب stop_cvd || true أو kill crosvm مع معرّف العملية (PID).