Perangkat Virtual Android (AVD) adalah konfigurasi yang menetapkan karakteristik ponsel dan tablet Android, Wear OS, Android TV, atau perangkat Automotive OS yang ingin Anda simulasikan dalam Android Emulator. AVD Manager adalah antarmuka yang dapat diluncurkan dari Android Studio untuk membantu Anda membuat dan mengelola AVD.
Untuk membuka AVD Manager, lakukan salah satu langkah berikut:
- Pilih Tools > AVD Manager.
- Klik AVD Manager
di toolbar.
Tentang AVD
AVD berisi profil hardware, image sistem, area penyimpanan, skin, dan properti lainnya.
Sebaiknya, buat AVD untuk setiap image sistem yang dapat didukung
aplikasi berdasarkan
setelan <uses-sdk>
dalam manifes Anda.
Profil hardware
Profil hardware menetapkan karakteristik perangkat sebagaimana didistribusikan dari pabrik. AVD Manager telah dilengkapi profil hardware tertentu, seperti perangkat Pixel, dan Anda dapat menetapkan atau menyesuaikan profil hardware tersebut sesuai kebutuhan.
Ingat bahwa hanya beberapa profil hardware yang menyatakan menyertakan Play Store. Ini berarti beberapa profil tersebut sepenuhnya mematuhi CTS dan dapat menggunakan image sistem yang menyertakan aplikasi Play Store.
Image sistem
Image sistem berlabel Google API menyertakan akses ke layanan Google Play. Image sistem berlabel logo Google Play di kolom Play Store menyertakan aplikasi Google Play Store dan akses ke layanan Google Play, termasuk tab Google Play dalam dialog Extended controls yang menyediakan tombol praktis untuk mengupdate layanan Google Play di perangkat tersebut.
Untuk memastikan keamanan aplikasi dan pengalaman yang konsisten pada perangkat fisik, image sistem yang menyertakan Google Play Store telah ditandatangani dengan kunci rilis, yang berarti Anda tidak memperoleh hak istimewa (root) yang ditingkatkan untuk image tersebut. Jika memerlukan hak istimewa (root) yang ditingkatkan untuk membantu pemecahan masalah aplikasi, Anda dapat menggunakan image sistem Proyek Open Source Android (AOSP) yang tidak menyertakan layanan atau aplikasi Google.
Area penyimpanan
AVD memiliki area penyimpanan khusus pada mesin pengembangan Anda. AVD menyimpan data pengguna perangkat, seperti aplikasi terinstal dan setelan, serta kartu SD yang diemulasikan. Jika perlu, Anda dapat menggunakan AVD Manager untuk menghapus data pengguna, sehingga perangkat memiliki data seperti baru.
Skin
Skin emulator menentukan tampilan perangkat. AVD Manager menyediakan beberapa skin yang telah ditetapkan sebelumnya. Anda juga dapat menentukannya sendiri, atau menggunakan skin yang disediakan oleh pihak ketiga.
Fitur aplikasi dan AVD
Pastikan definisi AVD menyertakan fitur perangkat yang diandalkan aplikasi Anda. Baca Properti Profil Hardware dan Properti AVD untuk informasi daftar fitur yang dapat ditentukan dalam AVD.
Membuat AVD
Tips: Jika ingin meluncurkan aplikasi ke emulator, lakukan dengan menjalankan aplikasi dari Android Studio, lalu pada dialog Select Deployment Target yang muncul, klik Create New Virtual Device.
Untuk membuat AVD baru:
- Buka AVD Manager dengan mengklik Tools > AVD Manager.
- Klik Create Virtual Device, di
bagian bawah dialog AVD Manager.
Halaman Select Hardware akan muncul.
Ingat bahwa hanya beberapa profil hardware yang menyatakan menyertakan Play Store. Ini menunjukkan bahwa beberapa profil tersebut sepenuhnya mematuhi CTS dan dapat menggunakan image sistem yang menyertakan aplikasi Play Store.
- Pilih profil hardware, lalu klik Next.
- Pilih image sistem untuk API level tertentu, lalu klik Next.
- Ubah AVD properties sesuai kebutuhan,
lalu klik Finish.
Klik Show Advanced Settings untuk menampilkan setelan lainnya, seperti skin.
Jika tidak melihat profil hardware yang diinginkan, Anda dapat membuat atau mengimpor profil hardware.
Halaman System Image akan muncul.

Tab Recommended mencantumkan image sistem yang direkomendasikan. Tab lainnya berisi daftar yang lebih lengkap. Panel sebelah kanan menunjukkan image sistem yang dipilih. Image x86 berjalan paling cepat dalam emulator.
Jika melihat Download di sebelah image sistem, Anda harus mengkliknya untuk mendownload image sistem. Anda harus terhubung ke Internet untuk mendownloadnya.
Penting untuk mengetahui API level perangkat target karena aplikasi
tidak akan dapat berjalan
pada image sistem dengan API level yang lebih rendah dari yang disyaratkan oleh
aplikasi, seperti yang ditetapkan
dalam atribut
minSdkVersion
file manifes aplikasi. Untuk informasi
selengkapnya tentang hubungan antara API level sistem dan
minSdkVersion
, baca Pembuatan Versi Aplikasi Anda.
Jika aplikasi Anda mendeklarasikan
elemen <uses-library>
dalam file manifes, aplikasi memerlukan image sistem tempat menyimpan library
eksternal tersebut. Jika Anda ingin menjalankan aplikasi pada emulator, buat AVD yang
menyertakan library yang diperlukan. Untuk melakukannya, Anda mungkin perlu menggunakan komponen add-on untuk
platform AVD; misalnya, add-on Google API yang berisi library Google Maps.
Halaman Verify Configuration akan muncul.

AVD baru akan muncul di halaman Your Virtual Devices atau dialog Select Deployment Target.
Untuk membuat AVD yang dimulai dengan salinan:
- Dari halaman Your Virtual Devices pada AVD Manager, klik kanan salah satu AVD, lalu pilih Duplicate.
- Klik Change atau Previous jika Anda perlu membuat perubahan pada halaman System Image dan Select Hardware.
- Buat perubahan, lalu klik Finish.
Atau, klik Menu
,
lalu pilih Duplicate.
Halaman Verify Configuration akan muncul.
AVD akan muncul di halaman Your Virtual Devices.
Membuat profil hardware
AVD Manager menyediakan profil hardware yang telah ditetapkan sebelumnya untuk perangkat umum sehingga Anda dapat dengan mudah menambahkannya ke penentuan AVD. Jika perlu menetapkan perangkat yang berbeda, Anda dapat membuat profil hardware baru. Anda dapat menentukan profil hardware baru dari awal, atau menyalin profil hardware untuk memulai. Profil hardware bawaan tidak dapat diedit.
Untuk membuat profil hardware baru dari awal:
- Di halaman Select Hardware, klik New Hardware Profile.
- Di halaman Configure Hardware Profile, ubah properti profil hardware sesuai kebutuhan.
- Klik Finish.
Profil hardware baru akan muncul di halaman Select Hardware. Secara opsional, Anda dapat membuat AVD yang menggunakan profil hardware tersebut dengan mengklik Next. Atau, klik Cancel untuk kembali ke halaman Your Virtual Devices atau dialog Select Deployment Target.
Untuk membuat profil hardware yang dimulai dengan salinan:
- Di halaman Select Hardware, pilih salah satu profil hardware, lalu klik Clone Device.
- Di halaman Configure Hardware Profile, ubah properti profil hardware sesuai kebutuhan.
- Klik Finish.
Atau klik kanan profil hardware, lalu pilih Clone.
Profil hardware baru akan muncul di halaman Select Hardware. Secara opsional, Anda dapat membuat AVD yang menggunakan profil hardware tersebut dengan mengklik Next. Atau, klik Cancel untuk kembali ke halaman Your Virtual Devices atau dialog Select Deployment Target.
Mengedit AVD yang ada
Dari halaman Your Virtual Devices, Anda dapat menjalankan operasi berikut pada AVD yang ada:
- Untuk mengedit AVD, klik Edit this AVD
, lalu buat perubahan.
- Untuk menghapus AVD, klik kanan AVD, lalu pilih
Delete. Atau, klik Menu
, lalu pilih Delete.
- Untuk menampilkan file
.ini
dan.img
AVD terkait, klik kanan salah satu AVD, lalu pilih Show on Disk. Atau, klik Menu, lalu pilih Show on Disk.
- Untuk menampilkan detail konfigurasi AVD yang dapat Anda
sertakan dalam laporan bug kepada tim Android Studio, klik kanan AVD, lalu
pilih View Details. Atau, klik Menu
, lalu pilih View Details.
Mengedit profil hardware yang ada
Dari halaman Select Hardware, Anda dapat menjalankan operasi berikut pada profil hardware yang ada:
- Untuk mengedit profil hardware, pilih profil, lalu klik Edit Device. Atau, klik kanan salah satu profil hardware, lalu pilih Edit. Selanjutnya, buat perubahan.
- Untuk menghapus profil hardware, klik kanan, lalu pilih Delete.
Anda tidak dapat mengedit atau menghapus profil hardware yang telah ditetapkan sebelumnya.
Menjalankan dan menghentikan emulator, serta menghapus data
Dari halaman Your Virtual Devices, Anda dapat menjalankan operasi berikut pada emulator:
- Untuk menjalankan emulator yang menggunakan AVD, klik dua kali AVD tersebut. Atau, klik Launch
.
- Untuk menghentikan emulator yang berjalan, klik-kanan AVD, lalu pilih
Stop. Atau, klik Menu
, lalu pilih Stop.
- Untuk menghapus data emulator dan mengembalikannya ke keadaan yang sama seperti saat
pertama ditetapkan, klik kanan AVD, lalu pilih
Wipe Data. Atau, klik Menu
, lalu pilih Wipe Data.
Mengimpor dan mengekspor profil hardware
Dari halaman Select Hardware, Anda dapat mengimpor dan mengekspor profil hardware:
- Untuk mengimpor profil hardware, klik Import Hardware Profiles lalu pilih file XML yang berisi definisi pada komputer Anda.
- Untuk mengekspor profil hardware, klik kanan, lalu pilih Export. Tentukan lokasi tempat Anda ingin menyimpan file XML yang berisi definisi.
Properti profil hardware
Anda dapat menentukan properti profil hardware berikut di halaman Configure Hardware Profile. Properti konfigurasi AVD akan mengganti properti profil hardware, dan properti emulator yang Anda setel saat emulator berjalan akan mengganti keduanya.
Profil hardware yang telah ditetapkan sebelumnya dan disertakan dengan AVD Manager tidak dapat diedit. Namun, Anda dapat menyalin dan mengedit salinannya.
Properti Profil Hardware | Deskripsi |
---|---|
Device Name | Nama profil hardware. Nama dapat berisi huruf besar atau kecil, angka dari 0 sampai 9, titik (.), garis bawah (_), tanda kurung ( () ), dan spasi. Nama file yang menyimpan profil hardware diambil dari nama profil hardware. |
Device Type | Pilih salah satu opsi berikut:
|
Screen Size | Ukuran fisik layar, dalam inci, diukur pada panjang diagonal. Jika ukurannya lebih besar dari layar komputer Anda, ukuran akan dikurangi saat diluncurkan. |
Screen Resolution | Masukkan lebar dan tinggi dalam piksel untuk menetapkan jumlah total piksel pada layar simulasi. |
Round | Pilih opsi ini jika perangkat memiliki layar bulat, seperti perangkat Wear OS tertentu. |
Memory: RAM | Masukkan ukuran RAM untuk perangkat dan pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte). |
Input: Has Hardware Buttons (Back/Home/Menu) | Pilih opsi ini jika perangkat Anda memiliki tombol navigasi hardware. Batalkan pilihan jika tombol tersebut hanya diimplementasikan dalam software. Jika Anda memilih opsi ini, tombol tidak akan muncul di layar. Anda dapat menggunakan panel samping emulator untuk "menekan" tombol, pada kasus mana pun. |
Input: Has Hardware Keyboard | Pilih opsi ini jika perangkat Anda memiliki keyboard fisik. Batalkan pilihan jika tidak. Jika Anda memilih opsi ini, keyboard tidak akan muncul di layar. Anda juga dapat menggunakan keyboard komputer untuk mengirim penekanan tombol ke emulator, pada kasus mana pun. |
Navigation Style | Pilih salah satu opsi berikut:
Opsi ini adalah untuk kontrol hardware yang sebenarnya pada perangkat itu sendiri. Namun, peristiwa yang dikirim ke perangkat oleh pengontrol eksternal sama. |
Supported Device States | Pilih salah satu atau kedua opsi:
Jika memilih keduanya, Anda dapat beralih mode orientasi di emulator. Anda harus memilih setidaknya satu pilihan untuk melanjutkan. |
Cameras | Untuk mengaktifkan kamera, pilih salah satu atau kedua opsi:
Nantinya, Anda dapat menggunakan webcam atau foto yang disediakan oleh emulator untuk melakukan simulasi pengambilan foto dengan kamera. |
Sensors: Accelerometer | Pilih jika perangkat memiliki hardware yang membantu perangkat menentukan orientasinya. |
Sensors: Gyroscope | Pilih jika perangkat memiliki hardware yang mendeteksi rotasi atau putaran. Jika digabungkan dengan akselerometer, perangkat dapat memberikan deteksi orientasi yang lebih lancar dan mendukung sistem orientasi enam sumbu. |
Sensors: GPS | Pilih jika perangkat memiliki hardware yang mendukung sistem navigasi berbasis satelit Sistem Pemosisi Global (Global Positioning System). |
Sensors: Proximity Sensor | Pilih jika perangkat memiliki hardware untuk mendeteksi saat perangkat berada dekat dengan wajah selama panggilan telepon guna menonaktifkan masukan dari layar. |
Skin Default | Pilih skin yang mengontrol tampilan perangkat saat ditampilkan di emulator. Ingat bahwa penetapan ukuran layar yang terlalu besar untuk resolusi dapat menyebabkan layar terpotong, sehingga Anda tidak dapat melihat seluruh layar. Baca Membuat skin emulator untuk informasi selengkapnya. |
Properti AVD
Anda dapat menetapkan properti berikut untuk konfigurasi AVD di halaman Verify Configuration. Konfigurasi AVD menetapkan interaksi antara komputer pengembangan dan emulator, serta properti yang ingin diganti di profil hardware.
Properti konfigurasi AVD akan mengganti properti profil hardware. Properti emulator yang Anda setel saat emulator berjalan akan mengganti keduanya.
Properti AVD | Deskripsi |
---|---|
AVD Name | Nama AVD. Nama dapat berisi huruf besar atau kecil, angka dari 0 sampai 9, titik (.), garis bawah (_), tanda kurung ( () ), tanda hubung (-), dan spasi. Nama file yang menyimpan konfigurasi AVD berasal dari nama AVD. |
AVD ID (Advanced) | Nama file AVD berasal dari ID, dan Anda dapat menggunakan ID untuk merujuk ke AVD dari command line. |
Profil Hardware | Klik Change untuk memilih profil hardware lain di halaman Select Hardware. |
Image Sistem | Klik Change untuk memilih image sistem lain di halaman System Image. Koneksi internet harus aktif untuk mendownload image baru. |
Startup Orientation | Pilih satu opsi untuk orientasi emulator awal:
Opsi hanya diaktifkan jika dipilih dalam profil hardware. Saat menjalankan AVD di emulator, Anda dapat mengubah orientasi jika potret dan lanskap didukung di profil hardware. |
Camera (Advanced) | Untuk mengaktifkan kamera, pilih salah satu atau kedua opsi:
Setelan Emulated menghasilkan gambar buatan software, sedangkan setelan Webcam menggunakan webcam komputer pengembangan untuk mengambil gambar. Opsi ini hanya tersedia jika dipilih dalam profil hardware; opsi ini tidak tersedia untuk Wear OS dan Android TV. |
Network: Speed (Advanced) | Pilih protokol jaringan untuk menentukan kecepatan transfer data:
|
Network: Latency (Advanced) | Pilih protokol jaringan untuk menyetel berapa banyak waktu (jeda) yang diperlukan protokol untuk mentransfer paket data dari satu titik ke titik yang lain. |
Emulated Performance: Graphics | Pilih bagaimana grafis tersebut dirender pada emulator:
|
Emulated Performance: Boot option (Advanced) |
|
Emulated Performance: Multi-Core CPU (Advanced) | Pilih jumlah inti prosesor di komputer yang ingin digunakan untuk emulator. Menggunakan lebih banyak inti prosesor akan mempercepat emulator. |
Memory and Storage: RAM | Jumlah RAM pada perangkat. Nilai ini disetel oleh produsen hardware, tetapi Anda dapat menggantinya, jika perlu, misalnya agar operasi emulator lebih cepat. Peningkatan pada ukurannya akan mengonsumsi lebih banyak resource pada komputer. Masukkan ukuran RAM dan pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte). |
Memori dan Penyimpanan: Heap VM | Ukuran heap VM. Nilai ini disetel oleh produsen hardware, tetapi Anda dapat menggantinya, jika perlu. Masukkan ukuran heap dan pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte). Untuk informasi selengkapnya tentang VM Android, baca Pengelolaan Memori untuk Mesin Virtual yang Berbeda. |
Memory and Storage: Internal Storage | Jumlah ruang memori yang tidak dapat dilepas yang tersedia di perangkat. Nilai ini disetel oleh produsen hardware, tetapi Anda dapat menggantinya, jika perlu. Masukkan ukuran dan pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte). |
Memori dan Penyimpanan: Kartu SD | Jumlah ruang memori yang dapat dilepas yang tersedia untuk menyimpan data di perangkat. Untuk menggunakan kartu SD virtual yang dikelola Android Studio, pilih Studio managed, masukkan ukurannya, lalu pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte). Nilai minimum yang disarankan untuk menggunakan kamera adalah 100 MB. Untuk mengelola ruang dalam file, pilih External file, lalu klik ... untuk menetapkan file dan lokasi. Untuk informasi selengkapnya, baca mksdcard dan direktori data AVD. |
Device Frame: Enable Device Frame | Pilih untuk mengaktifkan frame di sekitar jendela emulator yang meniru tampilan perangkat sesungguhnya. |
Definisi Skin Khusus (Lanjutan) | Pilih skin yang mengontrol tampilan perangkat saat ditampilkan di emulator. Ingat bahwa penetapan ukuran layar yang terlalu besar untuk skin dapat menyebabkan layar terpotong, sehingga Anda tidak dapat melihat keseluruhan layar. Baca Membuat skin emulator untuk informasi selengkapnya. |
Keyboard: Enable Keyboard Input (Advanced) | Pilih opsi ini jika Anda ingin menggunakan keyboard hardware untuk berinteraksi dengan emulator. Fungsi ini dinonaktifkan untuk Wear OS dan Android TV. |
Membuat skin emulator
Skin emulator Android adalah kumpulan file yang menentukan elemen kontrol dan visual tampilan emulator. Jika definisi skin yang tersedia dalam setelan AVD tidak memenuhi kebutuhan, Anda dapat membuat definisi skin khusus sendiri, lalu menerapkannya ke AVD.
Setiap skin emulator berisi:
- File
hardware.ini
- File layout untuk orientasi yang didukung (lanskap, potret) dan konfigurasi fisik
- File image untuk elemen tampilan, seperti latar belakang, kunci dan tombol
Untuk membuat dan menggunakan skin khusus:
- Buat direktori baru tempat Anda akan menyimpan file konfigurasi files.
- Tentukan tampilan visual skin dalam file teks yang bernama
layout
. File ini menentukan berbagai karakteristik skin, seperti ukuran dan aset image untuk tombol tertentu. Contoh:parts { device { display { width 320 height 480 x 0 y 0 } }
portrait { background { image background_port.png } buttons { power { image button_vertical.png x 1229 y 616 } } } ...
}
- Tambahkan file bitmap dari image perangkat dalam direktori yang sama.
- Tentukan konfigurasi perangkat spesifik hardware tambahan dalam
file
hardware.ini
untuk setelan perangkat, sepertihw.keyboard
danhw.lcd.density
. - Arsipkan file dalam folder skin dan pilih file arsip sebagai skin khusus.
Untuk informasi yang lebih mendetail tentang membuat skin emulator, baca Spesifikasi File Skin Android Emulator dalam kode sumber alat.