Anda dapat membantu mengembangkan sistem operasi yang paling banyak diinstal dalam sejarah Bumi. Ya, Anda berada di sini untuk memulai perjalanan menjadi engineer platform Android.
Meskipun jalur itu menantang, tim Android berusaha untuk menyederhanakan perjalanan Anda, setiap rilis. Selain itu, tim melakukan peningkatan setiap hari melalui kerja langsung di Project Open Source Android (AOSP).
Jadi duduklah, nyalakan terminal, dan mari kita buat sejarah.
Sasaran
Misi codelab ini ada dua:
- Untuk memberi Anda sedikit gambaran tentang seperti apa alur kerja developer bagi engineer Android yang bekerja di platform (sistem operasi).
- Dorong Anda untuk memberikan masukan seputar alat, dokumentasi, dan alur kerja developer Android.
Prasyarat
Daftar persyaratan untuk codelab ini berasal dari daftar persyaratan untuk pengembangan platform umum (AOSP). Untuk mengikuti codelab ini, siapkan hal berikut:
- Workstation Linux fisik yang memenuhi semua persyaratan publik.
- Repo dan konfigurasi Git yang diperlukan untuk mengedit codebase Android.
Lingkungan
Biasanya, pengguna membangun dan mengembangkan aplikasi secara langsung di workstation. Karena Anda mungkin
bekerja di berbagai terminal, dan banyak perintah yang digunakan bersifat spesifik per terminal,
Anda harus menjalankannya kembali di setiap sesi terminal. Secara khusus,
hal ini mencakup perintah source build/envsetup.sh
dan lunch
.
Menyiapkan workstation
- Instal paket yang diperlukan di workstation Anda.
- Saat masih berada di terminal, instal Repo dan dapatkan kredensial ke semua repositori Git.
Melakukan inisialisasi dan menyinkronkan kode
Buka direktori utama Anda:
cd ~
Buat subdirektori yang berfungsi secara lokal di dalamnya:
mkdir aosp
Buka direktori:
cd aosp
Lakukan inisialisasi cabang utama kode sumber repositori AOSP (default):
repo init -u https://android.googlesource.com/platform/manifest
Masukkan atau terima kredensial Git Anda (nama, alamat email).
Sinkronkan kode sumber:
repo sync -j8
Sinkronisasi awal dapat memerlukan waktu satu jam atau lebih.
Setiap checkout repo direpresentasikan oleh file manifes. Anda dapat memiliki lebih dari 1 checkout repo sekaligus, asalkan ada di direktori yang berbeda. Namun, perhatikan bahwa setiap checkout dan build berjumlah sekitar 300 GB (dan terus bertambah), jadi batasi hingga 2 checkout repo, atau perkaya sistem Anda dengan drive sekunder.
Membangun kode
Untuk membangun Android, Anda harus memilih jenis perangkat target
untuk di-build dengan perintah lunch
. Target adalah permutasi perangkat,
seperti model atau faktor bentuk tertentu.
aosp_cf_x86_64_phone-userdebug
target perangkat memungkinkan Anda
mem-build perangkat Android virtual Cuttlefish untuk
pengujian tanpa perangkat fisik.
Untuk mem-build dan mengupdate perangkat fisik, pilih target lain dan ikuti petunjuk untuk mem-flash perangkat.
Siapkan lingkungan Anda untuk membangun perangkat Android dengan menjalankan perintah berikut dari root checkout kode sumber Anda:
source build/envsetup.sh
Teruskan target build ke perintah makan siang, seperti ini:
lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
Bangun kode dari mana saja di checkout dengan:
m
Build pertama diperkirakan memerlukan waktu berjam-jam. Build berikutnya memerlukan waktu yang jauh lebih sedikit.
Luncurkan Cuttlefish
Cuttlefish adalah emulator Android yang digunakan untuk menguji build Anda.
Jika belum pernah menginstal Cuttlefish, Anda harus menginstal dependensi Cuttlefish yang diperlukan. Di jendela terminal, jalankan perintah berikut untuk mendownload, membangun, dan menginstal paket Debian host:
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
for dir in base frontend; do pushd $dir # Install build dependencies sudo mk-build-deps -i dpkg-buildpackage -uc -us popd done
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot
Reboot akan memicu penginstalan modul kernel tambahan dan menerapkan aturan
udev
.Luncurkan Cuttlefish:
launch_cvd --daemon
Hubungkan ke perangkat Cuttlefish dengan membuka
https://localhost:8443
di browser web Anda. Anda akan disambut dengan streaming video dari perangkat berbasis Android yang baru saja Anda buat.
Membuat perubahan
Perbarui kode sumber dengan mengikuti contoh daftar perubahan ini.
Dari root checkout Anda (direktori
aosp/
), buka project Gitframeworks/native
:cd frameworks/native
Mulai project sementara dengan perintah ini:
repo start <some-name> .
Edit
SurfaceFlinger.cpp
untuk menyertakan update dari daftar perubahan di lokasi berikut:aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
Temukan baris ini:
void SurfaceFlinger::updateColorMatrixLocked() {
Tambahkan dua baris berikut 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:
m
Update build di perangkat:
adb root
adb remount
adb sync
adb reboot
Pastikan Anda melihat perubahan warna di perangkat yang dipilih, seperti yang ditunjukkan pada Gambar 1.
Gambar 1. Tampilan layar setelah perubahan warna berhasil
Menguji kode Anda
Bagian codelab ini menggunakan contoh pengujian yang ada di hierarki sumber dan gagal. Perintah ini menggunakan Atest untuk menjalankan pengujian secara lokal dan menguji kode.
Untuk menggunakan pengujian, ikuti petunjuk berikut:
Jalankan:
atest DevCodelabTest
Pengujian akan gagal. Untuk memperbaikinya, temukan kode sumber pengujian yang gagal:
atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
Lalu lihat di sini
platform_testing/tests/example/devcodelab
Untuk mengedit file, ambil nama pengujian di
android.test.example.devcodelab.DevCodelabTest
dan ganti.
dengan/
, untuk mendapatkan hasil ini:src/android/test/example/devcodelab/DevCodelabTest.java
Lalu edit
platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
untuk mengganti
Assert.assertTrue(false)
dengan
Assert.assertTrue(true)
Jalankan pengujian lagi untuk memverifikasi bahwa masalah telah diperbaiki:
atest DevCodelabTest
Upload kode Anda untuk ditinjau
Repo menyederhanakan penggunaan Git dengan memaketkan perintah seperti git clone
agar dapat berfungsi
di berbagai repositori (atau project) Git sekaligus.
Lihat Alat Kontrol Sumber untuk mengetahui ringkasan Git dan Repo, dengan link ke dokumentasi lengkap tentang cara menggunakan kode sumber Android. Lihat Repositori AOSP untuk mengetahui daftar lengkap project Git dan setiap project (jalur) untuk cabang yang terkait dengan setiap project.
Untuk peninjauan kode project di Git, Anda akan menggunakan sistem peninjauan kode berbasis web Gerrit.
Dengan asumsi Anda telah membuat perubahan dalam project
frameworks/native
, jalankan perintah ini untuk menguploadnya:cd frameworks/native
repo start codelab .
git add .
git commit
Untuk pesan commit Anda, masukkan kode berikut:
Android codelab change Test: manual atest
Upload perubahan Anda:
repo upload
Jika berhasil, Anda akan melihat pesan yang menyerupai ini:
Upload project frameworks/native/ to remote branch main:
branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
ff46b36d android codelab 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 codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
* [new branch] codelab -> refs/for/main
Melihat perubahan Anda di Gerrit
Buka link yang dicetak di terminal, yang terlihat seperti ini:
https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432
Tindakan ini menyelesaikan codelab awal untuk pengembangan platform Android. Lihat Mengirimkan patch untuk mengetahui langkah selanjutnya, dan untuk detail selengkapnya tentang mengembangkan Android, lihat informasi lainnya di situs ini.
Kembalikan perubahan Anda
Biasanya, pasca-pengujian dan setelah peninjauan serta persetujuan, Anda mengirimkan perubahan Anda di Gerrit dan menggabungkannya ke dalam repositori.
Sebagai gantinya, untuk tujuan codelab ini, kembalikan daftar perubahan dengan mengklik Abandon di Gerrit.
Kemudian, tinggalkan cabang sementara terkait di direktori project frameworks/native
(atau subdirektorinya):
repo abandon codelab .
Jangan lupa untuk mengembalikan perubahan yang Anda buat ke file pengujian. Karena Anda tidak melakukan
repo start
, git commit
, dan repo upload
perubahan, Anda dapat mereset
file itu sendiri. Dengan asumsi bahwa Anda berada di aosp/platform_testing directory
, gunakan
cara berikut untuk mereset file:
git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .
Pada tahap ini, Anda sudah selesai! Bagus!
Mendapatkan bantuan
Jika Anda menemukan error selama codelab ini, laporkan menggunakan link Issue Tracker di bagian bawah halaman mana pun. Kirim pertanyaan ke grup android-building.