Membuat dan mengelola perangkat virtual

Android Virtual Device (AVD) adalah konfigurasi yang mendefinisikan karakteristik ponsel Android, tablet, Wear OS, Android TV, atau perangkat Automotive OS yang ingin Anda simulasikan dalam Android Emulator. AVD Manager adalah antarmuka yang dapat Anda luncurkan dari Android Studio yang membantu Anda membuat dan mengelola AVD.

Untuk membuka AVD Manager, lakukan salah satu langkah berikut ini:

Pilih Tools > AVD Manager.
Klik AVD Manager di toolbar.

Tentang AVD

Sebuah AVD berisi profil hardware, image sistem, tempat penyimpanan, skin, dan properti lainnya.

Sebaiknya buat AVD untuk setiap image sistem yang berpotensi didukung aplikasi Anda berdasarkan setelan <uses-sdk> di manifes Anda.

Profil hardware

Profil hardware mendefinisikan karakteristik perangkat saat didistribusikan dari pabrik. AVD Manager telah disertai profil hardware bawaan, seperti perangkat Pixel, dan Anda dapat menetapkan atau menyesuaikan profil hardware yang diperlukan.

Perhatikan, hanya beberapa profil hardware yang akan ditunjukkan untuk menyertakan Play Store. Hal ini menunjukkan bahwa profil ini sepenuhnya sesuai dengan 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 pada dialog Extended controls yang menyediakan tombol praktis untuk mengupdate layanan Google Play di perangkat.

Untuk memastikan keamanan aplikasi dan pengalaman yang konsisten pada perangkat fisik, image sistem bersama Google Play Store yang disertakan telah ditandatangani dengan kunci rilis, yang berarti Anda tidak bisa mendapatkan hak istimewa (root) yang ditingkatkan dengan image tersebut. Jika memerlukan hak istimewa (root) yang ditingkatkan untuk membantu pemecahan masalah aplikasi, Anda dapat menggunakan image sistem Android Open Source Project (AOSP) yang tidak menyertakan layanan atau aplikasi Google.

Area penyimpanan

AVD memiliki tempat penyimpanan khusus pada mesin pengembangan Anda. AVD menyimpan data pengguna perangkat, seperti aplikasi yang diinstal dan setelan, serta kartu SD yang diemulasikan. Jika perlu, Anda dapat menggunakan AVD Manager untuk menghapus data pengguna, sehingga perangkat memiliki data yang sama seperti baru.

Skin

Skin emulator menentukan tampilan perangkat. AVD Manager menyediakan beberapa skin yang telah ditentukan sebelumnya. Anda juga dapat menentukannya sendiri, atau menggunakan skin yang disediakan oleh pihak ketiga.

Fitur aplikasi dan AVD

Pastikan definisi AVD Anda menyertakan fitur perangkat yang menjadi tempat bergantung aplikasi Anda. Lihat Properti Profil Hardware dan Properti AVD untuk mengetahui daftar fitur yang dapat Anda tetapkan dalam AVD.

Membuat AVD

Tips: Jika Anda ingin meluncurkan aplikasi ke dalam emulator, bukan menjalankan aplikasi Anda dari Android Studio, di dalam 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.

Perhatikan, hanya beberapa profil hardware yang akan ditunjukkan untuk menyertakan Play Store. Hal ini menunjukkan bahwa profil ini sepenuhnya sesuai dengan CTS dan dapat menggunakan image sistem yang menyertakan aplikasi Play Store.
Pilih profil hardware, lalu klik Next.

Jika tidak melihat profil hardware yang diinginkan, Anda dapat membuat atau mengimpor profil hardware.

Halaman System Image akan muncul.

Pilih image sistem untuk API level tertentu, lalu klik Next.

Tab Recommended akan mencantumkan image sistem yang disarankan. Tab lainnya mencantumkan daftar yang lebih lengkap. Panel kanan menunjukkan image sistem yang dipilih. Image x86 dijalankan paling cepat dalam emulator.

Jika melihat Download di sebelah image sistem, Anda perlu mengkliknya untuk mendownload image sistem. Anda harus terhubung ke internet untuk mendownloadnya.

Penting untuk mengetahui tingkat API dari perangkat target, karena aplikasi tidak akan dapat berjalan pada image sistem dengan tingkat API yang kurang dari yang dibutuhkan oleh aplikasi Anda, seperti yang ditetapkan dalam atribut minSdkVersion dari file manifes aplikasi. Untuk mengetahui informasi selengkapnya tentang hubungan antara tingkat API sistem dan minSdkVersion, silakan lihat Penetapan Versi Aplikasi Anda.

Jika aplikasi Anda mencantumkan elemen <uses-library> dalam file manifes, aplikasi tersebut memerlukan image sistem tempat library eksternal tersebut ditampilkan. 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 berisi library Google Maps.

Halaman Verify Configuration akan muncul.

Ubah AVD properties jika perlu, lalu klik Finish.
Klik Show Advanced Settings untuk menampilkan setelan lainnya, seperti skin.

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 di AVD Manager, klik kanan AVD lalu pilih Duplicate.

Atau klik Menu lalu pilih Duplicate.

Halaman Verify Configuration akan muncul.

Klik Change atau Previous jika Anda perlu membuat perubahan pada halaman System Image dan Select Hardware.
Buat perubahan, lalu klik Finish.

AVD akan muncul di halaman Your Virtual Devices.

Membuat profil hardware

AVD Manager menyediakan profil hardware yang telah ditentukan sebelumnya untuk perangkat biasa sehingga Anda dapat dengan mudah menambahkannya ke definisi 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 sebagai awal. 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 jika perlu.
Klik Finish.

Profil hardware baru Anda akan muncul di halaman Select Hardware. Secara opsional, Anda dapat membuat AVD yang menggunakan profil hardware 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 profil hardware lalu klik Clone Device.

Atau klik kanan profil hardware lalu pilih Clone.

Di halaman Configure Hardware Profile, ubah properti profil hardware jika perlu.

Klik Finish.

Mengedit AVD yang ada

Dari halaman Your Virtual Devices, Anda dapat melakukan operasi berikut pada AVD yang ada:

Untuk mengedit AVD, klik Edit this AVD dan buat perubahan Anda.
Untuk menghapus AVD, klik kanan AVD lalu pilih Delete. Atau klik Menu lalu pilih Delete.
Untuk menampilkan file .ini dan .img pada disk, klik kanan pada AVD lalu pilih Show on Disk. Atau klik Menu lalu pilih Show on Disk.
Untuk melihat 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 melakukan operasi berikut pada profil hardware yang ada:

Untuk mengedit profil hardware, pilih lalu klik Edit Device. Atau klik kanan profil hardware lalu pilih Edit. Selanjutnya, buat perubahan Anda.
Untuk menghapus profil hardware, klik kanan lalu pilih Delete.

Anda tidak dapat mengedit atau menghapus profil hardware yang telah ditentukan sebelumnya.

Menjalankan dan menghentikan emulator, serta menghapus data

Dari halaman Your Virtual Devices, Anda dapat melakukan operasi berikut pada emulator:

Untuk menjalankan emulator yang menggunakan AVD, klik dua kali AVD. Atau klik Launch .
Untuk menghentikan emulator yang berjalan, klik kanan AVD lalu pilih Stop Atau klik Menu lalu pilih Stop.
Untuk menghapus data untuk emulator dan mengembalikannya ke keadaan yang sama seperti pertama kali ditentukan, klik kanan pada 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. Tetapkan lokasi tempat Anda ingin menyimpan file XML yang berisi definisi.

Properti profil hardware

Anda dapat menetapkan 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 mengesampingkan keduanya.

Profil hardware yang telah ditentukan 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: Ponsel/Tablet Wear OS Android TV Chrome OS Device Android Automotive
Screen Size	Ukuran fisik layar, dalam inci, diukur pada panjang diagonal. Jika ukurannya lebih besar dari layar komputer Anda, ukurannya akan berkurang pada saat diluncurkan.
Screen Resolution	Masukkan lebar dan tinggi dalam piksel untuk menetapkan total jumlah piksel pada layar simulasi.
Round	Pilih opsi ini jika perangkat memiliki layar bulat, seperti sebagian perangkat Wear OS.
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 navigasi ini diimplementasikan dalam software saja. Jika Anda memilih opsi ini, tombol tidak akan muncul di layar. Anda dapat menggunakan panel samping emulator untuk "menekan" tombol, dalam kasus mana pun.
Input: Has Hardware Keyboard	Pilih opsi ini jika perangkat Anda memiliki keyboard fisik. Batalkan pilihan jika tidak memilikinya. Jika Anda memilih opsi ini, keyboard tidak akan muncul di layar. Anda juga dapat menggunakan keyboard komputer untuk mengirim penekanan tombol ke emulator, dalam kasus mana pun.
Navigation Style	Pilih salah satu opsi berikut: None - No hardware controls. Navigasi dilakukan melalui software. D-pad - Directional Pad support. Trackball Wheel Opsi ini adalah untuk kontrol hardware yang sebenarnya pada perangkat itu sendiri. Akan tetapi, peristiwa yang dikirim ke perangkat oleh pengontrol eksternal sama.
Supported Device States	Pilih salah satu atau kedua opsi: Portrait - Lebih berorientasi pada tinggi daripada lebar. Landscape - Lebih berorientasi pada lebar daripada tinggi. 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: Back-Facing Camera - Lensa tidak menghadap ke pengguna. Front-Facing Camera - Lensa menghadap ke pengguna. Nanti, 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 puntiran. Jika digabungkan dengan akselerometer, perangkat dapat memberikan deteksi orientasi yang lebih halus dan mendukung sistem orientasi enam sumbu.
Sensors: GPS	Pilih jika perangkat memiliki hardware yang mendukung sistem navigasi berbasis satelit Global Positioning System (GPS).
Sensors: Proximity Sensor	Pilih jika perangkat memiliki hardware yang mendeteksi jika perangkat berada dekat wajah Anda selama panggilan telepon guna menonaktifkan masukan dari layar.
Default Skin	Pilih skin yang mengontrol seperti apa tampilan perangkat jika ditampilkan di emulator. Harap diingat bahwa penetapan ukuran layar yang terlalu besar untuk resolusi dapat menyebabkan layar terpotong, sehingga Anda tidak dapat melihat keseluruhan layar. Baca Membuat skin emulator untuk mengetahui 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 hingga 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.
Hardware Profile	Klik Change untuk memilih profil hardware yang berbeda di halaman Select Hardware.
System Image	Klik Change untuk memilih image sistem yang berbeda di halaman System Image. Koneksi internet aktif diperlukan untuk mendownload image baru.
Startup Orientation	Pilih satu opsi untuk orientasi emulator awal: Portrait - Lebih berorientasi pada tinggi daripada lebar. Landscape - Lebih berorientasi pada lebar daripada tinggi. 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: Front - Lensa membelakangi pengguna. Back - Lensa menghadap ke pengguna. Setelan Emulated menghasilkan gambar buatan software, sedangkan setelan Webcam menggunakan webcam komputer pengembangan Anda 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: GSM - Global System for Mobile Communications HSCSD - High-Speed Circuit-Switched Data GPRS - Generic Packet Radio Service EDGE - Enhanced Data rates for GSM Evolution UMTS - Universal Mobile Telecommunications System HSDPA - High-Speed Downlink Packet Access LTE - Long-Term Evolution Full (default) - Mentransfer data secepat yang komputer Anda bisa.
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: Hardware - Menggunakan kartu grafis komputer Anda untuk rendering yang lebih cepat. Software - Melakukan simulasi grafis di software, yang berguna jika Anda mengalami masalah rendering di kartu grafis. Automatic - Memungkinkan emulator memutuskan opsi terbaik berdasarkan kartu grafis Anda.
Emulated Performance: Boot option (Advanced)	Cold boot - Memulai perangkat setiap kali dengan menyalakan dari keadaan saat perangkat dimatikan. Quick boot - Memulai perangkat dengan memuat status perangkat dari snapshot yang disimpan. Untuk mengetahui detail selengkapnya, baca Menjalankan emulator dengan Quick Boot.
Emulated Performance: Multi-Core CPU (Advanced)	Pilih jumlah inti prosesor di komputer yang ingin Anda gunakan 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 Anda. Masukkan ukuran RAM dan pilih salah satu unit, B (byte), KB (kilobyte), MB (megabyte), GB (Gigabyte), atau TB (terabyte).
Memory and Storage: VM Heap	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 mengetahui informasi selengkapnya mengenai VM Android, baca Pengelolaan Memori untuk Mesin Virtual yang Berbeda.
Memory and Storage: Internal Storage	Jumlah ruang memori yang tidak dapat dilepas untuk menyimpan data pada 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).{}
Memory and Storage: SD Card	Jumlah ruang memori yang dapat dilepas yang tersedia untuk menyimpan data pada perangkat. Untuk menggunakan kartu SD virtual yang dikelola Android Studio, pilih Studio managed, masukkan ukurannya dan 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 mengetahui informasi selengkapnya, lihat mksdcard dan direktori data AVD.
Device Frame: Enable Device Frame	Pilih untuk mengaktifkan frame di sekitar jendela emulator yang meniru tampilan perangkat sesungguhnya.
Custom Skin Definition (Advanced)	Pilih skin yang mengontrol seperti apa tampilan perangkat jika ditampilkan di emulator. Harap diingat 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 mengetahui 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 untuk 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, kemudian 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 skin.

Tentukan tampilan visual skin dalam sebuah file teks 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.
Tetapkan konfigurasi perangkat tambahan khusus hardware dalam file hardware.ini untuk setelan perangkat, seperti hw.keyboard dan hw.lcd.density
Arsipkan file dalam folder skin dan pilih file arsip sebagai skin khusus.

Untuk mengetahui informasi mendetail tentang pembuatan skin emulator, baca Spesifikasi File Skin Android Emulator dalam kode sumber fitur.