تجربة تطوير تطبيقات Android

يتيح لك هذا الدليل التعليمي تجربة تطوير نظام التشغيل 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:

  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
    

تنزيل رمز المصدر لنظام التشغيل Android

يتوفّر مصدر Android في مجموعة من مستودعات Git التي تستضيفها Google. يتضمّن كل مستودع Git السجلّ الكامل لمصدر Android، بما في ذلك التغييرات التي تم إجراؤها على المصدر ووقت إجرائها. لتنزيل رمز المصدر لنظام التشغيل Android:

  1. انتقِل إلى الدليل الرئيسي:

    cd ~
  2. أنشئ دليلاً فرعيًا للعمل المحلي داخله:

    mkdir aosp
  3. انتقِل إلى الدليل:

    cd aosp
  4. ابدأ فرع الإصدار الأخير من الرمز المصدر لمستودع AOSP (android-latest-release):

    repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest
  5. أدخِل بيانات اعتماد Git (الاسم وعنوان البريد الإلكتروني) أو اقبلها.

  6. مزامنة الرمز المصدر:

    repo sync -c -j8

    إذا واجهت أي مشاكل أثناء التنزيل، يُرجى الرجوع إلى تحديد مشاكل المزامنة وحلّها.

إنشاء الرمز البرمجي

لإنشاء الرمز:

  1. من داخل دليل العمل، حدِّد مصدر النص البرمجي envsetup.sh لإعداد بيئة الإصدار:

    source build/envsetup.sh
  2. حدِّد نوع جهاز مستهدَف لإنشائه باستخدام الأمر 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
    ============================================
    
  3. إنشاء الهدف:

    m

يُرجى توقُّع أن يستغرق الإصدار الأول ساعات. تستغرق عمليات الإنشاء اللاحقة وقتًا أقل بكثير. يظهر ناتج الإصدار في $OUT_DIR.

تشغيل Cuttlefish

Cuttlefish هو Android Emulator يُستخدم لاختبار إصداراتك.

  1. نفِّذ الأوامر التالية لتنزيل حزم Debian المضيفة وإنشائها وتثبيتها:

    sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    tools/buildutils/build_packages.sh
    sudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.deb
    sudo usermod -aG kvm,cvdnetwork,render $USER
    sudo reboot

    تؤدي إعادة التشغيل إلى تثبيت وحدات نواة إضافية وتطبيق قواعد udev.

  2. بعد إعادة تشغيل محطة العمل، انتقِل إلى دليل aosp، واضبط بيئة الإصدار، وشغِّل Cuttlefish:

    cd ~/aosp
    source build/envsetup.sh
    lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug
    launch_cvd --daemon
  3. اتصِل بجهاز Cuttlefish من خلال الانتقال إلى https://localhost:8443 في متصفّح الويب. يتم عرض جهازك الافتراضي الذي يعمل بنظام التشغيل Android.

تغيير

عدِّل الرمز المصدر باتّباع قائمة التغييرات في هذا المثال.

  1. من جذر عملية الدفع (دليل aosp/)، انتقِل إلى مشروع Git‏ frameworks/native:

    cd frameworks/native
  2. ابدأ فرعًا مؤقتًا باستخدام هذا الأمر:

    repo start BRANCH_NAME .
  3. استخدِم المحرِّر لتعديل SurfaceFlinger.cpp في الموقع التالي:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    
  4. ابحث عن السطر التالي:

    void SurfaceFlinger::updateColorMatrixLocked() {
    
  5. أضِف هذا السطر في بداية 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});
    
  6. إنشاء الرمز البرمجي:

    m
  7. تحديث الإصدار على الجهاز:

    adb root
    adb remount -R
    adb root
    adb sync
    adb reboot
  8. تأكَّد من ظهور تغيير في اللون على الجهاز الذي اخترته.

إصلاح اختبار

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

  1. التشغيل:

    atest DevCodelabTest

    تعذّر الاختبار.

  2. افحص تتبُّع تسلسل استدعاء الدوال البرمجية للاختبار الذي تعذّر إجراؤه:

    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.

  3. لتحديد موقع الاختبار الذي يجب إصلاحه، أضِف WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ إلى السطر الأخير من تتبُّع تسلسل استدعاء الدوال البرمجية حتى اسم ملف الاختبار بما في ذلك الاسم. وبالتالي، يصبح android.test.example.devcodelab.DevCodelabTest WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.

  4. عدِّل platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java واستبدِل "Assert.assertTrue(false)" بـ "Assert.assertTrue(true)".

  5. شغِّل الاختبار مرة أخرى للتأكّد من حلّ المشكلة:

    atest DevCodelabTest

تحميل الرمز البرمجي للمراجعة

تسهّل أداة Repo استخدام Git من خلال تجميع أوامر مثل git clone للعمل على مستودعات (أو مشاريع) Git متعددة في آنٍ واحد. لمراجعة الرموز البرمجية لمشاريعك في Git، استخدِم نظام مراجعة الرموز البرمجية المستند إلى الويب Gerrit.

  1. بافتراض أنّك أجريت التغييرات في مشروع frameworks/native، نفِّذ هذه الأوامر لتحميل التغييرات:

    cd frameworks/native
    repo start BRANCH_NAME .
    git add .
    git commit
  2. بالنسبة إلى رسالة الإرسال، أدخِل ما يلي:

    Android BRANCH_NAME change
    Test: manual atest
    
  3. تحميل التغيير:

    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 ودمجه في المستودع. بدلاً من ذلك، لأغراض هذا الدرس التطبيقي حول الترميز، يمكنك التراجع عن عملك:

  1. في Gerrit، انقر على تجاهُل (Abandon).

  2. تجاهُل الفرع المؤقت المرتبط في دليل مشروع frameworks/native (أو أدلته الفرعية):

    repo abandon BRANCH_NAME .
  3. تراجَع عن التغييرات التي أجريتها على ملف الاختبار. بما أنّك لم تُشغِّل repo start وgit commit وrepo upload على التغيير الاختباري، يمكنك إعادة ضبط الملف نفسه. لنفترض أنّك في دليل aosp/platform_testing، استخدِم الأوامر التالية لإعادة ضبط الملف:

    git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
    git checkout .

بهذا نكون قد انتهينا من الدرس التطبيقي حول الترميز لتطوير نظام Android الأساسي.

الحصول على مساعدة

إذا واجهت أخطاء أثناء هذا الدرس التطبيقي حول الترميز، يُرجى الإبلاغ عنها باستخدام رابط Issue Tracker في أسفل أي صفحة. يمكنك إرسال الأسئلة إلى مجموعة android-building.

اكتب ps -A | grep crosvm لمعرفة ما إذا كان crosvm قيد التشغيل حاليًا. إذا كان crosvm قيد التشغيل، اكتب stop_cvd || true أو kill crosvm مع معرّف العملية (PID).