این آموزش گامبهگام به شما امکان میدهد توسعه سیستمعامل 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، این مراحل را دنبال کنید:
اطلاعات بسته فعلی را بارگیری کنید:
sudo apt-get updateفرمان زیر را برای نصب راهانداز Repo اجرا کنید:
sudo apt-get install repoراهانداز Repo یک اسکریپت Python ارائه میدهد که یک تسویهحساب را مقداردهی اولیه میکند و ابزار کامل Repo را بارگیری میکند.
اگر موفقیتآمیز بود، به مرحله ۴ بروید.
اختیاری: 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برونداد باید نسخه ۲.۴ یا بالاتر را نشان دهد، برای مثال:
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 است که برای آزمایش کردن ساختهای شما استفاده میشود.
فرمانهای زیر را برای بارگیری، ساخت، و نصب بستههای 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با رفتن به
https://localhost:8443در مرورگر وب، به دستگاه Cuttlefish متصل شوید. دستگاه مجازی 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بررسی کنید که رنگ دستگاه انتخابیتان تغییر کرده باشد.
اصلاح آزمایش
این بخش از codelab از آزمایشی نمونه استفاده میکند که در درخت منبع است و ناموفق است. برای اجرا، اشکالزدایی، و رفع مشکل آزمایش، این دستورالعملها را دنبال کنید:
اجرا:
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.DevCodelabTestبهWORKING_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 clone برای کار کردن در چندین مخزن (یا پروژه) Git بهطور همزمان، استفاده از Git را ساده میکند. برای بازبینی کد پروژههایتان در Git، از سیستم بازبینی کد مبتنی بر وب Gerrit استفاده کنید.
با فرض اینکه تغییرات را در پروژه
frameworks/nativeایجاد کردهاید، این فرمانها را برای بارگذاری تغییرات اجرا کنید:cd frameworks/nativerepo start BRANCH_NAME .git add .git commitبرای پیام 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 ارسال میکنید و آن را در مخزن ادغام میکنید. درعوض، برای اهداف این codelab، کارتان را برگردانید:
در Gerrit، روی رها کردن کلیک کنید.
شاخه موقت مرتبط را در فهرست راهنمای پروژه
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 .
این codelab برای توسعه پلاتفرم Android تکمیل میشود.
دریافت راهنمایی
اگر درطول این codelab با خطایی مواجه شدید، آن را بااستفاده از پیوند Issue Tracker در پایین هر صفحه گزارش کنید. سؤالات را به گروه android-building ارسال کنید.
ps -A | grep crosvm را تایپ کنید تا ببینید crosvm ازقبل درحال اجرا است یا نه. اگر crosvm
درحال اجرا است، stop_cvd || true یا kill crosvm را با شناسه پردازش (PID) تایپ کنید.