Codelab developer Android

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:

1. Untuk memberi Anda sedikit gambaran tentang seperti apa alur kerja developer bagi engineer Android yang bekerja di platform (sistem operasi).
2. 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

1. Instal paket yang diperlukan di workstation Anda.
2. Saat masih berada di terminal, instal Repo dan dapatkan kredensial ke semua repositori Git.

Melakukan inisialisasi dan menyinkronkan kode

1. Buka direktori utama Anda:

   cd ~
   

2. Buat subdirektori yang berfungsi secara lokal di dalamnya:

   mkdir aosp
   

3. Buka direktori:

   cd aosp
   

4. Lakukan inisialisasi cabang utama kode sumber repositori AOSP (default):

   repo init -u https://android.googlesource.com/platform/manifest
   

5. Masukkan atau terima kredensial Git Anda (nama, alamat email).

6. 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.

TIPS: Untuk meningkatkan ruang kosong, hapus direktori cabang dan mulai pembuatan direktori baru, seperti ini: rm -rf aosp2.

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.

1. Siapkan lingkungan Anda untuk membangun perangkat Android dengan menjalankan perintah berikut dari root checkout kode sumber Anda:

   source build/envsetup.sh
   

2. Teruskan target build ke perintah makan siang, seperti ini:

   lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
   

3. 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.

1. 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.

2. Luncurkan Cuttlefish:

   launch_cvd --daemon
   

3. 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.

1. Dari root checkout Anda (direktori aosp/), buka project Git frameworks/native:

   cd frameworks/native
   

2. Mulai project sementara dengan perintah ini:

   repo start <some-name> .
   

3. Edit SurfaceFlinger.cpp untuk menyertakan update dari daftar perubahan di lokasi berikut:

   aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
   

4. Temukan baris ini:

   void SurfaceFlinger::updateColorMatrixLocked() {
   

5. 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});
   

6. Bangun kode:

   m
   

7. 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:

1. Jalankan:

   atest DevCodelabTest
   

2. Pengujian akan gagal. Untuk memperbaikinya, temukan kode sumber pengujian yang gagal:

   atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
   

3. Lalu lihat di sini

   platform_testing/tests/example/devcodelab
   

4. 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
   

5. Lalu edit

   platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
   

   untuk mengganti

   Assert.assertTrue(false)
   

   dengan

   Assert.assertTrue(true)
   

6. 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.

Penting: Pastikan Anda login ke Gerrit untuk melihat dan merespons perubahan.

1. 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
   

2. Untuk pesan commit Anda, masukkan kode berikut:

   Android codelab change
   Test: manual atest
   

3. 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.