Membangun Android

Ikuti petunjuk ini untuk mulai membuat Android.

Menyiapkan lingkungan

Inisialisasi lingkungan dengan skrip envsetup.sh :

source build/envsetup.sh

atau

. build/envsetup.sh

Lihat skrip di platform/build/envsetup.sh untuk deskripsi perintah terkait, termasuk makan siang untuk memilih target perangkat dan tapas untuk membuat aplikasi yang tidak dibundel, seperti aplikasi TV referensi .

Anda perlu mengeluarkan ulang perintah ini setelah setiap repo sync untuk mengambil perubahan apa pun pada skrip itu. Perhatikan bahwa mengganti source dengan . (satu titik) menyimpan beberapa karakter, dan bentuk singkatnya lebih umum digunakan dalam dokumentasi.

Skrip envsetup.sh mengimpor beberapa perintah yang memungkinkan Anda bekerja dengan kode sumber Android, termasuk perintah yang digunakan dalam latihan ini.

Untuk melihat daftar lengkap perintah yang tersedia, jalankan:

hmm

Memilih target

makan siang

Pilih target mana yang akan dibangun dengan lunch . lunch product_name - build_variant memilih product_name sebagai produk yang akan dibuat, dan build_variant sebagai varian yang akan dibuat, dan menyimpan pilihan tersebut di lingkungan untuk dibaca oleh pemanggilan m berikutnya dan perintah serupa lainnya.

Konfigurasi yang tepat dapat diteruskan sebagai argumen. Misalnya, perintah berikut merujuk ke build lengkap untuk emulator, dengan semua debugging diaktifkan:

lunch aosp_arm-eng

Jika dijalankan tanpa argumen, lunch meminta Anda untuk memilih target dari menu, tetapi perhatikan bahwa menu tidak mencakup semua kemungkinan. Lihat Memilih build perangkat untuk konfigurasi build semua perangkat yang didukung di AOSP, atau bicarakan dengan orang-orang di tim Anda tentang makan siang yang tepat untuk perangkat yang sedang Anda kerjakan.

Semua target build berbentuk BUILD-BUILDTYPE , di mana BUILD adalah nama kode yang mengacu pada kombinasi fitur tertentu. BUILDTYPE adalah salah satu dari berikut ini.

Tipe bangunan Menggunakan
pengguna Akses terbatas; cocok untuk produksi
debug pengguna Seperti pengguna tetapi dengan akses root dan kemampuan debug; lebih disukai untuk debugging
bahasa inggris Konfigurasi pengembangan dengan alat debugging tambahan

Build userdebug harus berperilaku sama dengan build pengguna, dengan kemampuan untuk mengaktifkan debugging tambahan yang biasanya melanggar model keamanan platform. Ini membuat build userdebug bagus untuk pengujian pengguna dengan kemampuan diagnosis yang lebih baik. Saat mengembangkan dengan build userdebug, ikuti panduan userdebug .

Eng build memprioritaskan produktivitas rekayasa untuk insinyur yang bekerja di platform. Eng build mematikan berbagai pengoptimalan yang digunakan untuk memberikan pengalaman pengguna yang baik. Jika tidak, eng build memiliki perilaku yang mirip dengan user dan build userdebug sehingga pengembang perangkat dapat melihat bagaimana kode berperilaku di lingkungan tersebut.

Untuk informasi lebih lanjut tentang membangun dan menjalankan pada perangkat keras yang sebenarnya, lihat Perangkat Berkedip .

tapas

Perintah tapas mengonfigurasi pembuatan aplikasi yang tidak dibundel. Ini memilih aplikasi individual yang akan dibangun oleh sistem build Android. Tidak seperti lunch , tapas tidak meminta pembuatan gambar untuk perangkat.

Jalankan tapas help untuk informasi lebih lanjut tentang perintah.

Membangun kode

Bagian ini adalah ringkasan singkat untuk memastikan bahwa penyiapan telah selesai.

Bangun semuanya dengan m . m dapat menangani tugas paralel dengan argumen -jN . Jika Anda tidak memberikan argumen -j , sistem build secara otomatis memilih jumlah tugas paralel yang dianggap optimal untuk sistem Anda.

m

Seperti yang dijelaskan di atas, Anda dapat membuat modul tertentu alih-alih gambar perangkat lengkap dengan mencantumkan namanya di baris perintah m Anda. Selain itu, m menyediakan beberapa pseudotarget untuk tujuan khusus. Beberapa contohnya adalah:

  • droid - m droid adalah build normal. Target ini ada di sini karena target default memerlukan nama.
  • all - m all membangun semua yang dilakukan m droid , ditambah semua yang tidak memiliki tag droid . Server build menjalankan ini untuk memastikan bahwa semua yang ada di hierarki dan memiliki file Android.mk dibangun.
  • m - Menjalankan build dari atas pohon. Ini berguna karena Anda dapat menjalankan make dari dalam subdirektori. Jika Anda memiliki set variabel lingkungan TOP , ia menggunakannya. Jika tidak, ia akan mencari pohon dari direktori saat ini, mencoba menemukan bagian atas pohon. Anda dapat membangun seluruh pohon kode sumber dengan menjalankan m tanpa argumen atau membangun target tertentu dengan menentukan namanya.
  • mma - Membangun semua modul di direktori saat ini, dan dependensinya.
  • mmma - Membangun semua modul di direktori yang disediakan, dan dependensinya.
  • croot - cd ke atas pohon.
  • clean - m clean menghapus semua file keluaran dan perantara untuk konfigurasi ini. Ini sama dengan rm -rf out/ .

Jalankan m help untuk melihat apa yang disediakan oleh pseudotargets m lainnya.

Menjalankan build

Anda dapat menjalankan build di emulator atau mem-flash-nya di perangkat. Karena Anda telah memilih target build dengan lunch , kemungkinan tidak akan berjalan pada target yang berbeda dari target build.

Flashing dengan fastboot

Untuk mem-flash perangkat, gunakan fastboot , yang harus disertakan di jalur Anda setelah proses build. Lihat Mem-flash perangkat untuk petunjuk.

Meniru perangkat Android

Emulator ditambahkan ke jalur Anda secara otomatis oleh proses pembuatan. Untuk menjalankan emulator, ketik:

emulator

Memahami membangun sidik jari

Untuk melacak dan melaporkan masalah yang terkait dengan build Android tertentu, penting untuk memahami sidik jari build. Sidik jari build adalah string unik yang dapat dibaca manusia yang berisi informasi pabrikan yang dikeluarkan untuk setiap build. Lihat deskripsi FINGERPRINT dalam bagian Build Parameters pada Android Compatibility Definition Document (CDD) untuk sintaks yang tepat.

Sidik jari build mewakili implementasi dan revisi Android tertentu. Kunci unik ini memungkinkan pengembang aplikasi dan orang lain untuk melaporkan masalah dengan versi firmware tertentu. Lihat Melaporkan Bug untuk proses pelaporan masalah Android.

Sidik jari build merangkum semua detail implementasi Android:

  • API: Android dan asli, serta perilaku API lunak
  • API Inti dan beberapa perilaku UI sistem
  • Kompatibilitas dan persyaratan keamanan yang ditentukan dalam CDD
  • Spesifikasi produk dan pengaturan fitur penggunaan yang digunakan oleh aplikasi untuk menargetkan perangkat yang memenuhi persyaratan yang diharapkan
  • Implementasi komponen perangkat keras dan perangkat lunak

Lihat CDD untuk rincian lengkap dan Menambahkan Perangkat Baru untuk instruksi tentang membuat perangkat Android yang sama sekali baru.

Memecahkan masalah kesalahan build umum

Versi Java yang salah

Jika Anda mencoba membuat versi Android yang tidak sesuai dengan versi Java Anda, make batalkan dengan pesan seperti:

************************************************************
You are attempting to build with the incorrect version
of java.

Your version is: WRONG_VERSION.
The correct version is: RIGHT_VERSION.

Please follow the machine setup instructions at
    https://source.android.com/source/initializing.html
************************************************************

Berikut kemungkinan penyebab dan solusinya:

  • Kegagalan untuk menginstal JDK yang benar sebagaimana ditentukan dalam persyaratan JDK . Pastikan Anda telah mengikuti langkah-langkah di Menyiapkan lingkungan dan Memilih target .
  • JDK lain yang sebelumnya diinstal muncul di jalur Anda. Tambahkan JDK yang benar ke awal jalur Anda atau hapus JDK yang bermasalah.

Tidak ada izin USB

Secara default pada sebagian besar sistem Linux, pengguna yang tidak memiliki hak tidak dapat mengakses port USB. Jika Anda melihat kesalahan izin ditolak, ikuti petunjuk di Mengonfigurasi akses USB .

Jika ADB sudah berjalan dan tidak dapat terhubung ke perangkat setelah mengatur aturan tersebut, Anda dapat mematikannya dengan adb kill-server . Perintah itu menyebabkan ADB memulai ulang dengan konfigurasi baru.