Tutorial ini memungkinkan Anda mencoba pengembangan sistem operasi Android untuk pertama kalinya.
Menyiapkan pengembangan Android
Sebelum mendownload dan mem-build cabang manifes android-latest-release dari
source Android, pastikan hardware Anda memenuhi
persyaratan yang diperlukan dan software yang diperlukan telah diinstal
dengan benar. Anda juga harus memahami istilah berikut:
- Git
- Git adalah sistem kontrol versi terdistribusi open source dan gratis. Android menggunakan Git untuk operasi lokal seperti percabangan, commit, diff, dan pengeditan. Untuk mendapatkan bantuan dalam mempelajari Git, lihat dokumentasi Git.
- Repo
- Repo adalah wrapper Python di sekitar Git yang menyederhanakan pelaksanaan operasi kompleks di beberapa repositori Git. Repo tidak menggantikan Git untuk semua operasi kontrol versi; Repo hanya mempermudah operasi Git yang kompleks untuk diselesaikan. Repo menggunakan file manifes untuk menggabungkan project Git ke dalam superproject Android.
- file manifes
- File manifes adalah file XML yang menentukan tempat berbagai project Git di sumber Android ditempatkan dalam hierarki sumber AOSP.
Memenuhi persyaratan hardware
Workstation pengembangan Anda harus memenuhi atau melampaui persyaratan hardware berikut:
Sistem x86 64-bit.
Kapasitas disk kosong minimal 400 GB untuk memeriksa dan mem-build kode (250 GB untuk memeriksa + 150 GB untuk mem-build).
RAM minimum 64 GB. Google menggunakan mesin 72 core dengan RAM 64 GB untuk mem-build Android. Dengan konfigurasi hardware ini, diperlukan waktu sekitar 40 menit untuk build Android lengkap dan hanya beberapa menit untuk build Android inkremental. Sebaliknya, diperlukan waktu sekitar 6 jam untuk build penuh dengan mesin 6 core dengan RAM 64 GB.
Memenuhi persyaratan sistem operasi
Workstation pengembangan Anda harus menjalankan distribusi Linux 64-bit apa pun dengan GNU C Library (glibc) 2.17 atau yang lebih baru.
Menginstal paket yang diperlukan
Untuk menginstal paket yang diperlukan untuk Ubuntu 18.04 atau yang lebih baru, jalankan perintah berikut:
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 fontconfigMenginstal software yang diperlukan
Sebelum dapat menggunakan AOSP, Anda harus menginstal OpenJDK, Make, Python 3, dan Repo. Cabang rilis terbaru Android dilengkapi dengan versi bawaan OpenJDK, Make, dan Python 3, sehingga langkah penginstalan tambahan tidak diperlukan. Bagian berikut menjelaskan cara menginstal Repo.
Menginstal Repo
Ikuti langkah-langkah berikut untuk menginstal Repo:
Download informasi paket saat ini:
sudo apt-get updateJalankan perintah berikut untuk menginstal peluncur Repo:
sudo apt-get install repoPeluncur Repo menyediakan skrip Python yang melakukan inisialisasi checkout dan mendownload alat Repo lengkap.
Jika berhasil, lanjutkan ke langkah 4.
Opsional: Instal Repo secara manual menggunakan rangkaian perintah berikut:
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/repoTiga perintah pertama menyiapkan file sementara, mendownload Repo ke file, dan memverifikasi bahwa kunci yang diberikan cocok dengan kunci yang diperlukan. Jika perintah ini berhasil, perintah terakhir akan menginstal peluncur Repo.
Verifikasi versi peluncur Repo:
repo versionOutput akan menunjukkan versi 2.4 atau yang lebih tinggi, misalnya:
repo launcher version 2.45
Mendownload sumber Android
Sumber Android terletak di kumpulan repositori Git yang dihosting oleh Google. Setiap repositori Git menyertakan seluruh histori sumber Android, termasuk perubahan pada sumber dan waktu perubahan dilakukan. Untuk mendownload source code Android:
Buka direktori utama Anda:
cd ~Buat subdirektori kerja lokal di dalamnya:
mkdir aospBuka direktori:
cd aospLakukan inisialisasi cabang rilis terbaru kode sumber repositori AOSP (
android-latest-release):repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifestMasukkan atau setujui kredensial Git Anda (nama, alamat email).
Sinkronkan kode sumber:
repo sync -c -j8Jika Anda mengalami masalah selama download, lihat Memecahkan masalah dan memperbaiki masalah sinkronisasi.
Membangun kode
Untuk mem-build kode:
Dari dalam direktori kerja, jalankan skrip
envsetup.shuntuk menyiapkan lingkungan build:source build/envsetup.shTentukan jenis perangkat target yang akan di-build dengan perintah
lunch. Target adalah permutasi perangkat, seperti model atau faktor bentuk tertentu. Tentukan target ini:lunch aosp_cf_x86_64_only_phone-aosp_current-userdebugAnda akan melihat sinopsis target dan lingkungan build Anda:
============================================ 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 ============================================Bangun target:
m
Build pertama akan memerlukan waktu berjam-jam. Build berikutnya memerlukan waktu yang jauh lebih singkat. Output build Anda akan muncul di $OUT_DIR.
Meluncurkan Cuttlefish
Cuttlefish adalah Android Emulator yang digunakan untuk menguji build Anda.
Jalankan perintah berikut untuk mendownload, membangun, dan menginstal paket Debian host:
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 rebootMemulai ulang akan memicu penginstalan modul kernel tambahan dan menerapkan aturan
udev.Setelah workstation dimulai ulang, buka direktori
aosp, siapkan lingkungan build, dan luncurkan Cuttlefish:cd ~/aospsource build/envsetup.shlunch aosp_cf_x86_64_only_phone-aosp_current-userdebuglaunch_cvd --daemonHubungkan ke perangkat Cuttlefish dengan membuka
https://localhost:8443di browser web Anda. Perangkat virtual Android Anda akan ditampilkan.
Membuat perubahan
Perbarui kode sumber dengan mengikuti contoh daftar perubahan ini.
Dari root checkout (direktori
aosp/), buka project Gitframeworks/native:cd frameworks/nativeMulai cabang sementara dengan perintah ini:
repo start BRANCH_NAME .Gunakan editor Anda untuk mengedit
SurfaceFlinger.cppdi lokasi berikut:aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cppTemukan baris ini:
void SurfaceFlinger::updateColorMatrixLocked() {Tambahkan baris ini di awal
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});Bangun kode:
mUpdate build di perangkat:
adb rootadb remount -Radb rootadb syncadb rebootPastikan Anda melihat perubahan warna pada perangkat yang dipilih.
Memperbaiki pengujian
Bagian codelab ini menggunakan contoh pengujian yang ada di hierarki sumber dan gagal. Untuk menjalankan, men-debug, dan memperbaiki pengujian, ikuti petunjuk berikut:
Jalankan:
atest DevCodelabTestPengujian gagal.
Periksa stack trace pengujian yang gagal:
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)Baris terakhir pelacakan tumpukan menunjukkan pengujian yang gagal (
testHelloWorld). Pengujian ini berada dalam file bernamaDevCodelabTest.java.Untuk menentukan lokasi pengujian yang akan diperbaiki, tambahkan
WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ke baris terakhir stack trace hingga dan termasuk nama file pengujian. Jadi,android.test.example.devcodelab.DevCodelabTestmenjadiWORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.Edit
platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javadan gantiAssert.assertTrue(false)denganAssert.assertTrue(true).Jalankan pengujian lagi untuk memastikan Anda telah memperbaiki masalah:
atest DevCodelabTest
Mengupload kode Anda untuk ditinjau
Repo menyederhanakan penggunaan Git dengan menggabungkan perintah seperti git clone agar berfungsi
di berbagai repositori (atau project) Git sekaligus. Untuk peninjauan kode project Anda di Git, gunakan sistem peninjauan kode berbasis web Gerrit.
Dengan asumsi Anda membuat perubahan dalam project
frameworks/native, jalankan perintah ini untuk mengupload perubahan:cd frameworks/nativerepo start BRANCH_NAME .git add .git commitUntuk pesan commit, masukkan teks berikut:
Android BRANCH_NAME change Test: manual atestUpload perubahan Anda:
repo uploadJika berhasil, Anda akan melihat pesan yang mirip dengan ini:
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
Melihat perubahan Anda di Gerrit
Untuk melihat perubahan Anda di Gerrit, buka link yang ditampilkan di terminal. Link-nya mirip dengan yang berikut ini:
https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432
Kembalikan perubahan Anda
Biasanya, setelah pengujian dan setelah peninjauan serta persetujuan, Anda mengirimkan perubahan di Gerrit dan menggabungkannya ke dalam repositori. Sebagai gantinya, untuk tujuan codelab ini, kembalikan pekerjaan Anda:
Di Gerrit, klik Abandon.
Hentikan cabang sementara terkait di direktori project
frameworks/native(atau subdirektorinya):repo abandon BRANCH_NAME .Kembalikan perubahan yang Anda buat pada file pengujian. Karena Anda tidak menjalankan
repo start,git commit, danrepo uploadpada perubahan pengujian, Anda dapat mereset file itu sendiri. Dengan asumsi Anda berada di direktoriaosp/platform_testing, gunakan perintah berikut untuk mereset file:git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javagit checkout .
Selesai sudah codelab untuk pengembangan platform Android.
Dapatkan bantuan
Jika Anda mengalami error selama codelab ini, laporkan menggunakan link Issue Tracker di bagian bawah halaman mana pun. Kirim pertanyaan ke grup android-building.
Ketik ps -A | grep crosvm untuk melihat apakah crosvm sudah berjalan. Jika crosvm
sedang berjalan, ketik proses stop_cvd || true atau kill crosvm dengan PID proses.