Ikuti petunjuk di halaman ini untuk membangun Android.
Menyiapkan lingkungan build
Dari dalam direktori kerja, dapatkan skrip envsetup.sh
untuk menyiapkan lingkungan build Anda:
source build/envsetup.sh
Skrip ini mengimpor beberapa perintah yang memungkinkan Anda menggunakan kode sumber
Android, termasuk perintah yang digunakan di halaman ini. Untuk melihat sumber
skrip, lihat
platform/build/envsetup.sh
.
Untuk melihat bantuan bawaan, ketik hmm
.
Pilih target
Sebelum membangun Android, Anda harus mengidentifikasi target yang akan di-build. Target mencerminkan platform target yang sedang Anda bangun. Untuk mengidentifikasi target yang akan di-build, gunakan perintah lunch
, diikuti dengan string yang mewakili target. Contoh:
lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
Melihat target saat ini
Untuk melihat setelan makan siang saat ini, jalankan:
$ echo "$TARGET_PRODUCT-$TARGET_RELEASE-$TARGET_BUILD_VARIANT"
String yang mewakili target memiliki format berikut:
lunch product_name-release-build_variant
Komponen string ini adalah:
product_name adalah nama produk yang ingin Anda build, seperti
aosp_cf_x86_64_phone
atauaosp_husky
. product_name tertentu dapat mengikuti format Anda sendiri untuk perangkat, tetapi format yang digunakan Google untuk perangkatnya memiliki komponen berikut:aosp
merujuk pada Platform Open Source Android.- (opsional)
cf
disertakan saat target dimaksudkan untuk dijalankan dalam emulator Sotong. - Arsitektur dan hardware (nama kode), seperti
x86_64_phone
atauhusky
yang merupakan nama kode untuk Pixel 8 pro. Untuk mengetahui daftar nama kode perangkat Google, lihat Namakode perangkat.
release disetel ke
trunk_staging
.Bagian build_variant dari string dapat berupa salah satu dari tiga nilai dalam tabel berikut:
build_variant Deskripsi user
Varian build ini memberikan akses keamanan terbatas dan cocok untuk produksi. userdebug
Varian build ini membantu developer perangkat memahami performa dan kecanggihan rilis dalam pengembangan. Saat mengembangkan dengan build userdebug
, ikuti Panduan untuk userdebug.eng Varian build ini memiliki waktu build yang lebih cepat dan paling cocok untuk pengembangan sehari-hari jika Anda tidak mementingkan performa dan daya.
Jika Anda menjalankan lunch
tanpa argumen, daftar target umum disediakan.
Anda juga dapat membuat string target sendiri dengan menyusun elemen
string target menggunakan informasi di halaman ini dan nama kode
yang mewakili hardware Google tertentu di
Nama kode perangkat.
Membangun kode
Jalankan perintah berikut untuk membangun target Anda. Bergantung pada spesifikasi workstation Anda, build pertama dapat memerlukan waktu kurang dari satu jam hingga beberapa jam. Build berikutnya memerlukan waktu yang jauh lebih sedikit.
$ m
Output pertama yang akan Anda lihat adalah sinopsis lingkungan build dan target Anda:
============================================
PLATFORM_VERSION_CODENAME=VanillaIceCream
PLATFORM_VERSION=VanillaIceCream
PRODUCT_INCLUDE_TAGS=com.android.mainline
TARGET_PRODUCT=aosp_arm
TARGET_BUILD_VARIANT=eng
TARGET_ARCH=arm
TARGET_ARCH_VARIANT=armv7-a-neon
TARGET_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.5.13-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=AOSP.MAIN
OUT_DIR=out
============================================
Output build Anda muncul di $OUT_DIR
. Jika Anda
mem-build target yang berbeda, setiap build target akan muncul di
$OUT_DIR
.
Perintah m
dibuat dari bagian atas hierarki, sehingga Anda dapat menjalankan m
dari dalam
subdirektori. Jika Anda sudah menetapkan variabel lingkungan TOP
, perintah m
akan menggunakannya. Jika TOP
tidak ditetapkan, perintah m
akan mencari hierarki dari
direktori saat ini, dan mencoba menemukan bagian atas hierarki.
Perintah m
dapat menangani tugas paralel dengan argumen -jN
. Jika Anda tidak
memberikan argumen -j
, sistem build akan otomatis memilih jumlah tugas
paralel yang dianggap optimal untuk sistem Anda.
Anda dapat membuat modul spesifik, bukan image perangkat lengkap, dengan mencantumkan
nama modul di command line m
. Selain itu, perintah m
menyediakan
beberapa target semu, yang disebut sasaran. Misalnya, m nothing
tidak mem-build
apa pun, tetapi mengurai dan memvalidasi struktur build. Untuk daftar sasaran yang valid, ketik m help
.
Memecahkan masalah error build (8.0 atau yang lebih lama)
Jika Anda mem-build AOSP 8 atau yang lebih lama, m
dapat dibatalkan saat mengalami
masalah dengan versi Java Anda. Misalnya, Anda mungkin mendapatkan pesan ini:
************************************************************
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 ini kemungkinan penyebab dan solusinya:
- Anda gagal menginstal JDK yang benar seperti yang ditentukan di bagian JDK pada Menyiapkan Pengembangan AOSP (2.3 - 8.0) .
- Ada JDK lain yang sebelumnya diinstal yang muncul di jalur Anda. Tambahkan JDK yang benar ke awal jalur atau hapus JDK yang bermasalah.