توسعه 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 قرار دارند.

رعایت کردن الزامات سخت‌افزاری

ایستگاه کاری توسعه شما باید این الزامات سخت‌افزاری را برآورده کند یا فراتر از آن‌ها باشد:

  • سیستم x86‏ ۶۴ بیتی.

  • حداقل ۴۰۰ گیگابایت فضای دیسک آزاد برای بررسی و ساخت کد (۲۵۰ گیگابایت برای بررسی + ۱۵۰ گیگابایت برای ساخت).

  • حداقل ۶۴ گیگابایت RAM. Google برای ساخت Android از دستگاه‌های ۷۲ هسته‌ای با ۶۴ گیگابایت RAM استفاده می‌کند. با این پیکربندی سخت‌افزاری، ساخت کامل Android حدود ۴۰ دقیقه و ساخت افزایشی Android فقط چند دقیقه طول می‌کشد. درمقابل، ساخت کامل با دستگاه ۶ هسته‌ای با ۶۴ گیگابایت حافظه دسترسی تصادفی تقریباً ۶ ساعت طول می‌کشد.

رعایت کردن الزامات سیستم‌عامل

ایستگاه کاری توسعه شما باید هر توزیع لینوکس ۶۴ بیتی با GNU C Library (glibc) نسخه ۲.۱۷ یا بالاتر را اجرا کند.

نصب بسته‌های لازم

برای نصب بسته‌های موردنیاز برای 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 را بارگیری می‌کند.

    اگر موفقیت‌آمیز بود، به مرحله ۴ بروید.

  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

    برونداد باید نسخه ۲.۴ یا بالاتر را نشان دهد، برای مثال:

    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 است که برای آزمایش کردن ساخت‌های شما استفاده می‌شود.

  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. با رفتن به https://localhost:8443 در مرورگر وب، به دستگاه Cuttlefish متصل شوید. دستگاه مجازی 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. بررسی کنید که رنگ دستگاه انتخابی‌تان تغییر کرده باشد.

اصلاح آزمایش

این بخش از codelab از آزمایشی نمونه استفاده می‌کند که در درخت منبع است و ناموفق است. برای اجرا، اشکال‌زدایی، و رفع مشکل آزمایش، این دستورالعمل‌ها را دنبال کنید:

  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 clone برای کار کردن در چندین مخزن (یا پروژه) Git به‌طور هم‌زمان، استفاده از Git را ساده می‌کند. برای بازبینی کد پروژه‌هایتان در Git، از سیستم بازبینی کد مبتنی بر وب Gerrit استفاده کنید.

  1. با فرض اینکه تغییرات را در پروژه frameworks/native ایجاد کرده‌اید، این فرمان‌ها را برای بارگذاری تغییرات اجرا کنید:

    cd frameworks/native
    repo start BRANCH_NAME .
    git add .
    git commit
  2. برای پیام commit، عبارت زیر را وارد کنید:

    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 ارسال می‌کنید و آن را در مخزن ادغام می‌کنید. درعوض، برای اهداف این codelab، کارتان را برگردانید:

  1. در Gerrit، روی رها کردن کلیک کنید.

  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 .

این codelab برای توسعه پلاتفرم Android تکمیل می‌شود.

دریافت راهنمایی

اگر درطول این codelab با خطایی مواجه شدید، آن را بااستفاده از پیوند Issue Tracker در پایین هر صفحه گزارش کنید. سؤالات را به گروه android-building ارسال کنید.

ps -A | grep crosvm را تایپ کنید تا ببینید crosvm ازقبل درحال اجرا است یا نه. اگر crosvm درحال اجرا است، stop_cvd || true یا kill crosvm را با شناسه پردازش (PID) تایپ کنید.