Bagikan melalui

Mengelola Perangkat Virtual dengan Android Device Manager

  • Artikel

Artikel ini menjelaskan cara menggunakan Android Device Manager untuk membuat dan mengonfigurasi Android Virtual Devices (AVD) yang meniru perangkat Android fisik. Anda dapat menggunakan perangkat virtual ini untuk menjalankan dan menguji aplikasi tanpa harus mengandalkan perangkat fisik.

Setelah Anda memverifikasi bahwa akselerasi perangkat keras diaktifkan (seperti yang dijelaskan dalam Akselerasi Perangkat Keras untuk Performa Emulator), langkah selanjutnya adalah menggunakan Android Device Manager (juga disebut sebagai Xamarin Android Device Manager) untuk membuat perangkat virtual yang dapat Anda gunakan untuk menguji dan men-debug aplikasi Anda.

Android Device Manager di Windows

Artikel ini menjelaskan cara menggunakan Android Device Manager untuk membuat, menduplikasi, menyesuaikan, dan meluncurkan perangkat virtual Android.

Screenshot of the Android Device Manager in the Devices tab

Anda menggunakan Android Device Manager untuk membuat dan mengonfigurasi Android Virtual Devices (AVD) yang berjalan di Android Emulator. Setiap AVD adalah konfigurasi emulator yang mensimulasikan perangkat Android fisik. Ini memungkinkan untuk menjalankan dan menguji aplikasi Anda dalam berbagai konfigurasi yang mensimulasikan berbagai perangkat Android fisik.

Persyaratan

Untuk menggunakan Android Device Manager, Anda memerlukan item berikut:

  • Komunitas, Profesional, atau Perusahaan Visual Studio 2019.

  • ATAU Visual Studio 2017 versi 15.8 atau yang lebih baru diperlukan. Edisi Visual Studio Community, Professional, dan Enterprise didukung.

  • Alat Visual Studio untuk Xamarin versi 4.9 atau yang lebih baru.

  • Android SDK harus diinstal (lihat Menyiapkan Android SDK untuk Xamarin.Android). Pastikan untuk menginstal Android SDK di lokasi defaultnya jika belum diinstal: C:\Program Files (x86)\Android\android-sdk.

  • Paket berikut harus diinstal (melalui Android SDK Manager):

    • Android SDK Tools versi 26.1.1 atau yang lebih baru
    • Android SDK Platform-Tools 27.0.1 atau yang lebih baru
    • Android SDK Build-Tools 27.0.3 atau yang lebih baru
    • Android Emulator 27.2.7 atau yang lebih baru.

    Paket-paket ini harus ditampilkan dengan status Terinstal seperti yang terlihat pada cuplikan layar berikut:

    Installing Android SDK Tools

Meluncurkan Manajer Perangkat

Luncurkan Android Device Manager dari menu Alat dengan mengklik Alat > Android > Android Device Manager:

Launching the Device manager from the Tools menu

Jika dialog kesalahan berikut disajikan saat diluncurkan, lihat bagian Pemecahan Masalah untuk instruksi solusi:

Android SDK instance error dialog

Layar Utama

Ketika Anda pertama kali meluncurkan Android Device Manager, ini menyajikan layar yang menampilkan semua perangkat virtual yang saat ini dikonfigurasi. Untuk setiap perangkat virtual, Nama, OS (Versi Android), Prosesor, Ukuran memori, dan Resolusi layar ditampilkan:

List of installed devices and their parameters

Saat Anda memilih perangkat dalam daftar, tombol Mulai muncul di sebelah kanan. Anda dapat mengklik tombol Mulai untuk meluncurkan emulator dengan perangkat virtual ini:

Start button for a device image

Setelah emulator dimulai dengan perangkat virtual yang dipilih, tombol Mulai berubah menjadi tombol Berhenti yang dapat Anda gunakan untuk menghentikan emulator:

Stop button for the running device

Perangkat Baru

Untuk membuat perangkat baru, klik tombol Baru (terletak di area kanan atas layar):

New button for creating a new device

Mengklik Baru meluncurkan layar Perangkat Baru:

New Device screen of the Device Manager

Untuk mengonfigurasi perangkat baru di layar Perangkat Baru, gunakan langkah-langkah berikut:

  1. Beri nama baru pada perangkat. Dalam contoh berikut, perangkat baru diberi nama Pixel_API_27:

    Naming the new device

  2. Pilih perangkat fisik untuk ditiru dengan mengklik menu tarik-turun Perangkat Dasar:

    Selecting the physical device to emulate

  3. Pilih jenis prosesor untuk perangkat virtual ini dengan mengklik menu tarik-turun Prosesor . Memilih x86 akan memberikan performa terbaik karena memungkinkan emulator untuk memanfaatkan akselerasi perangkat keras. Opsi x86_64 juga akan menggunakan akselerasi perangkat keras, tetapi berjalan sedikit lebih lambat dari x86 (x86_64 biasanya digunakan untuk menguji aplikasi 64-bit):

    Selecting the processor type

  4. Pilih versi Android (tingkat API) dengan mengklik menu tarik-turun OS . Misalnya, pilih Oreo 8.1 - API 27 untuk membuat perangkat virtual untuk API level 27:

    Selecting the Android version

    Jika Anda memilih tingkat Android API yang belum diinstal, Manajer Perangkat akan menampilkan Pesan perangkat baru akan diunduh di bagian bawah layar - ia akan mengunduh dan menginstal file yang diperlukan karena membuat perangkat virtual baru:

    A new device image will be downloaded

  5. Jika Anda ingin menyertakan API Layanan Google Play di perangkat virtual Anda, aktifkan opsi Google API . Untuk menyertakan aplikasi Google Play Store, aktifkan opsi Google Play Store :

    Selecting Google Play Services and Google Play Store

    Perhatikan bahwa gambar Google Play Store hanya tersedia untuk beberapa jenis perangkat dasar seperti Pixel, Pixel 2, Nexus 5, dan Nexus 5X.

  6. Edit properti apa pun yang perlu Anda ubah. Untuk membuat perubahan pada properti, lihat Mengedit Properti Perangkat Virtual Android.

  7. Tambahkan properti tambahan apa pun yang perlu Anda tetapkan secara eksplisit. Layar Perangkat Baru hanya mencantumkan properti yang paling umum dimodifikasi, tetapi Anda dapat mengklik menu tarik-turun Tambahkan Properti (di bagian bawah) untuk menambahkan properti tambahan:

    Add Property pull-down menu

    Anda juga dapat menentukan properti kustom dengan memilih Kustom... di bagian atas daftar properti.

  8. Klik tombol Buat (sudut kanan bawah) untuk membuat perangkat baru:

    Create button

  9. Anda mungkin mendapatkan layar Penerimaan Lisensi. Klik Terima jika Anda menyetujui persyaratan lisensi:

    License Acceptance screen

  10. Android Device Manager menambahkan perangkat baru ke daftar perangkat virtual yang diinstal saat menampilkan indikator Membuat kemajuan selama pembuatan perangkat:

    Creation progress Indicator

  11. Ketika proses pembuatan selesai, perangkat baru ditampilkan dalam daftar perangkat virtual yang diinstal dengan tombol Mulai , siap untuk diluncurkan:

    Newly-created device ready to launch

Edit Perangkat

Untuk mengedit perangkat virtual yang ada, pilih perangkat dan klik tombol Edit (terletak di sudut kanan atas layar):

Edit button for modifying a device

Mengklik Edit meluncurkan Editor Perangkat untuk perangkat virtual yang dipilih:

Device Editor screen

Layar Editor Perangkat mencantumkan properti perangkat virtual di bawah kolom Properti , dengan nilai terkait dari setiap properti di kolom Nilai . Saat Anda memilih properti, deskripsi terperinci tentang properti tersebut ditampilkan di sebelah kanan.

Untuk mengubah properti, edit nilainya di kolom Nilai . Misalnya, dalam cuplikan hw.lcd.density layar berikut properti sedang diubah dari 480 menjadi 240:

Device Editing example

Setelah Anda membuat perubahan konfigurasi yang diperlukan, klik tombol Simpan . Untuk informasi selengkapnya tentang mengubah properti perangkat virtual, lihat Mengedit Properti Perangkat Virtual Android.

Opsi Tambahan

Opsi tambahan untuk bekerja dengan perangkat tersedia dari menu tarik-turun Opsi Tambahan (...) di sudut kanan atas:

Location of additional options menu

Menu opsi tambahan berisi item berikut:

  • Duplikat dan Edit – Menduplikasi perangkat yang saat ini dipilih dan membukanya di layar Perangkat Baru dengan nama unik yang berbeda. Misalnya, memilih Pixel_API_27 dan mengklik Duplikat dan Edit menambahkan penghitung ke nama:

    Duplicate and Edit screen

  • Ungkapkan di Explorer – Membuka jendela Windows Explorer di folder yang menyimpan file untuk perangkat virtual. Misalnya, memilih Pixel_API_27 dan mengklik Ungkapkan di Explorer akan membuka jendela seperti contoh berikut:

    Results of clicking Reveal in Explorer

  • Reset Pabrik – Mengatur ulang perangkat yang dipilih ke pengaturan defaultnya, menghapus perubahan pengguna apa pun yang dilakukan pada status internal perangkat saat sedang berjalan (ini juga menghapus rekam jepret Quick Boot saat ini, jika ada). Perubahan ini tidak mengubah modifikasi yang Anda lakukan pada perangkat virtual selama pembuatan dan pengeditan. Kotak dialog akan muncul dengan pengingat bahwa reset ini tidak dapat dibatalkan. Klik Reset Pabrik untuk mengonfirmasi pengaturan ulang:

    Factory Reset dialog

  • Hapus – Menghapus perangkat virtual yang dipilih secara permanen. Kotak dialog akan muncul dengan pengingat bahwa menghapus perangkat tidak dapat dibatalkan. Klik Hapus jika Anda yakin ingin menghapus perangkat.

    Delete device dialog

Catatan

Jika Anda menggunakan Mac dengan chip Apple, seperti M1, Anda harus menginstal Emulator Android untuk pratinjau M1 dari GitHub.

Android Device Manager di macOS

Artikel ini menjelaskan cara menggunakan Android Device Manager untuk membuat, menduplikasi, menyesuaikan, dan meluncurkan perangkat virtual Android.

Screenshot of the Android Device Manager in the Devices tab

Anda menggunakan Android Device Manager untuk membuat dan mengonfigurasi Android Virtual Devices (AVD) yang berjalan di Android Emulator. Setiap AVD adalah konfigurasi emulator yang mensimulasikan perangkat Android fisik. Ini memungkinkan untuk menjalankan dan menguji aplikasi Anda dalam berbagai konfigurasi yang mensimulasikan berbagai perangkat Android fisik.

Persyaratan

Untuk menggunakan Android Device Manager, Anda memerlukan item berikut:

  • Visual Studio untuk Mac 7.6 atau yang lebih baru.

  • Android SDK harus diinstal (lihat Menyiapkan Android SDK untuk Xamarin.Android).

  • Paket berikut harus diinstal (melalui Android SDK Manager):

    • Alat SDK versi 26.1.1 atau yang lebih baru
    • Android SDK Platform-Tools 28.0.1 atau yang lebih baru
    • Android SDK Build-Tools 26.0.3 atau yang lebih baru

    Paket-paket ini harus ditampilkan dengan status Terinstal seperti yang terlihat pada cuplikan layar berikut:

    Installing Android SDK Tools

Meluncurkan Manajer Perangkat

Luncurkan Android Device Manager dengan mengklik Tools > Device Manager:

Launching the Device manager from the Tools menu

Jika dialog kesalahan berikut disajikan saat diluncurkan, lihat bagian Pemecahan Masalah untuk instruksi solusi:

Screenshot shows the Android SDK instance error dialog box for troubleshooting information.

Layar Utama

Ketika Anda pertama kali meluncurkan Android Device Manager, ini menyajikan layar yang menampilkan semua perangkat virtual yang saat ini dikonfigurasi. Untuk setiap perangkat virtual, Nama, OS (Versi Android), Prosesor, Ukuran memori, dan Resolusi layar ditampilkan:

List of installed devices and their parameters

Saat Anda memilih perangkat dalam daftar, tombol Putar muncul di sebelah kanan. Anda dapat mengklik tombol Putar untuk meluncurkan emulator dengan perangkat virtual ini:

Play button for a device image

Setelah emulator dimulai dengan perangkat virtual yang dipilih, tombol Putar berubah menjadi tombol Berhenti yang dapat Anda gunakan untuk menghentikan emulator:

Stop button for the running device

Saat menghentikan emulator, Anda mungkin mendapatkan permintaan yang menanyakan apakah Anda ingin menyimpan status saat ini untuk boot cepat berikutnya:

Save current state for Quick Boot dialog

Menyimpan status saat ini akan membuat boot emulator lebih cepat ketika perangkat virtual ini diluncurkan lagi. Untuk informasi selengkapnya tentang Quick Boot, lihat Quick Boot.

Perangkat Baru

Untuk membuat perangkat baru, klik tombol Perangkat Baru (terletak di area kiri atas layar):

New button for creating a new device

Mengklik Perangkat Baru meluncurkan layar Perangkat Baru:

New Device screen of the Device Manager

Gunakan langkah-langkah berikut untuk mengonfigurasi perangkat baru di layar Perangkat Baru:

  1. Beri nama baru pada perangkat. Dalam contoh berikut, perangkat baru diberi nama Pixel_API_27:

    Naming the new device

  2. Pilih perangkat fisik untuk ditiru dengan mengklik menu tarik-turun Perangkat Dasar:

    Selecting the physical device to emulate

  3. Pilih jenis prosesor untuk perangkat virtual ini dengan mengklik menu tarik-turun Prosesor . Memilih x86 akan memberikan performa terbaik karena memungkinkan emulator untuk memanfaatkan akselerasi perangkat keras. Opsi x86_64 juga akan menggunakan akselerasi perangkat keras, tetapi berjalan sedikit lebih lambat dari x86 (x86_64 biasanya digunakan untuk menguji aplikasi 64-bit):

    Selecting the processor type

  4. Pilih versi Android (tingkat API) dengan mengklik menu tarik-turun OS . Misalnya, pilih Oreo 8.1 - API 27 untuk membuat perangkat virtual untuk API level 27:

    Selecting the Android version

    Jika Anda memilih tingkat Android API yang belum diinstal, Manajer Perangkat akan menampilkan Pesan perangkat baru akan diunduh di bagian bawah layar - ia akan mengunduh dan menginstal file yang diperlukan karena membuat perangkat virtual baru:

    A new device image will be downloaded

  5. Jika Anda ingin menyertakan API Layanan Google Play di perangkat virtual Anda, aktifkan opsi Google API . Untuk menyertakan aplikasi Google Play Store, aktifkan opsi Google Play Store :

    Selecting Google Play Services and Google Play Store

    Perhatikan bahwa gambar Google Play Store hanya tersedia untuk beberapa jenis perangkat dasar seperti Pixel, Pixel 2, Nexus 5, dan Nexus 5X.

  6. Edit properti apa pun yang perlu Anda ubah. Untuk membuat perubahan pada properti, lihat Mengedit Properti Perangkat Virtual Android.

  7. Tambahkan properti tambahan apa pun yang perlu Anda tetapkan secara eksplisit. Layar Perangkat Baru hanya mencantumkan properti yang paling umum dimodifikasi, tetapi Anda dapat mengklik menu tarik-turun Tambahkan Properti (di bagian bawah) untuk menambahkan properti tambahan:

    Add Property pull-down menu

    Anda juga dapat menentukan properti kustom dengan mengklik Kustom... di bagian atas daftar properti ini.

  8. Klik tombol Buat (sudut kanan bawah) untuk membuat perangkat baru:

    Create button

  9. Android Device Manager menambahkan perangkat baru ke daftar perangkat virtual yang diinstal saat menampilkan indikator Membuat kemajuan selama pembuatan perangkat:

    Creation progress indicator

  10. Ketika proses pembuatan selesai, perangkat baru ditampilkan dalam daftar perangkat virtual yang diinstal dengan tombol Mulai , siap untuk diluncurkan:

    Newly-created device ready to launch

Edit Perangkat

Untuk mengedit perangkat virtual yang ada, pilih menu tarik-turun Opsi Tambahan (ikon roda gigi) dan pilih Edit:

Edit menu selection for modifying a new device

Mengklik Edit meluncurkan Editor Perangkat untuk perangkat virtual yang dipilih:

Device Editor screen

Layar Editor Perangkat mencantumkan properti perangkat virtual di bawah kolom Properti , dengan nilai terkait dari setiap properti di kolom Nilai . Saat Anda memilih properti, deskripsi terperinci tentang properti tersebut ditampilkan di sebelah kanan.

Untuk mengubah properti, edit nilainya di kolom Nilai . Misalnya, dalam cuplikan hw.lcd.density layar berikut properti sedang diubah dari 480 menjadi 240:

Device Editing example

Setelah Anda membuat perubahan konfigurasi yang diperlukan, klik tombol Simpan . Untuk informasi selengkapnya tentang mengubah properti perangkat virtual, lihat Mengedit Properti Perangkat Virtual Android.

Opsi Tambahan

Opsi tambahan untuk bekerja dengan perangkat tersedia dari menu tarik-turun yang terletak di sebelah kiri tombol Putar :

Location of additional options menu

Menu opsi tambahan berisi item berikut:

  • Edit – Membuka perangkat yang saat ini dipilih di editor perangkat seperti yang dijelaskan sebelumnya.

  • Duplikat dan Edit – Menduplikasi perangkat yang saat ini dipilih dan membukanya di layar Perangkat Baru dengan nama unik yang berbeda. Misalnya, memilih Pixel 2 API 28 dan mengklik Duplikat dan Edit menambahkan penghitung ke nama:

    Duplicate and Edit screen

  • Mengungkapkan di Finder – Membuka jendela MacOS Finder di folder yang menyimpan file untuk perangkat virtual. Misalnya, memilih Pixel 2 API 28 dan mengklik Ungkapkan di Finder akan membuka jendela seperti contoh berikut:

    Results of clicking Reveal in Finder

  • Reset Pabrik – Mengatur ulang perangkat yang dipilih ke pengaturan defaultnya, menghapus perubahan pengguna apa pun yang dilakukan pada status internal perangkat saat sedang berjalan (ini juga menghapus rekam jepret Quick Boot saat ini, jika ada). Perubahan ini tidak mengubah modifikasi yang Anda lakukan pada perangkat virtual selama pembuatan dan pengeditan. Kotak dialog akan muncul dengan pengingat bahwa reset ini tidak dapat dibatalkan. Klik Reset Pabrik untuk mengonfirmasi pengaturan ulang.

    Factory reset dialog

  • Hapus – Menghapus perangkat virtual yang dipilih secara permanen. Kotak dialog akan muncul dengan pengingat bahwa menghapus perangkat tidak dapat dibatalkan. Klik Hapus jika Anda yakin ingin menghapus perangkat.

    Delete device dialog

Pemecahan Masalah

Bagian berikut menjelaskan cara mendiagnosis dan mengatasi masalah yang mungkin terjadi saat menggunakan Android Device Manager untuk mengonfigurasi perangkat virtual.

Android SDK di Lokasi Non-Standar

Biasanya, Android SDK diinstal di lokasi berikut:

C:\Program Files (x86)\Android\android-sdk

Jika SDK tidak diinstal di lokasi ini, Anda mungkin mendapatkan kesalahan ini saat meluncurkan Android Device Manager:

Android SDK instance error

Untuk mengatasi masalah ini, gunakan langkah-langkah berikut:

  1. Dari desktop Windows, navigasikan ke C:\Users\username\AppData\Roaming\XamarinDeviceManager:

    Android Device Manager log file location

  2. Klik dua kali untuk membuka salah satu file log dan menemukan jalur file Konfigurasi. Contohnya:

    Config file path in log file

  3. Navigasi ke lokasi ini dan klik dua kali user.config untuk membukanya.

  4. Di user.config, temukan <UserSettings> elemen dan tambahkan atribut AndroidSdkPath ke dalamnya. Atur atribut ini ke jalur tempat Android SDK diinstal di komputer Anda dan simpan file. Misalnya, <UserSettings> akan terlihat seperti berikut ini jika Android SDK diinstal di C:\Programs\Android\SDK:

    <UserSettings SdkLibLastWriteTimeUtcTicks="636409365200000000" AndroidSdkPath="C:ProgramsAndroidSDK" />

Setelah membuat perubahan ini ke user.config, Anda harus dapat meluncurkan Android Device Manager.

Versi Alat Android SDK yang Salah

Jika alat Android SDK 26.1.1 atau yang lebih baru tidak diinstal, Anda mungkin melihat dialog kesalahan ini saat diluncurkan:

Screenshot shows the Android SDK instance error dialog box.

Jika Anda melihat dialog kesalahan ini, klik Buka SDK Manager untuk membuka Android SDK Manager. Di Android SDK Manager, klik tab Alat dan instal paket berikut:

  • Android SDK Tools 26.1.1 atau yang lebih baru
  • Android SDK Platform-Tools 27.0.1 atau yang lebih baru
  • Android SDK Build-Tools 27.0.3 atau yang lebih baru

Rekam jepret menonaktifkan WiFi di Android Oreo

Jika Anda memiliki AVD yang dikonfigurasi untuk Android Oreo dengan akses Wi-Fi yang disimulasikan, memulai ulang AVD setelah rekam jepret dapat menyebabkan akses Wi-Fi dinonaktifkan.

Untuk mengatasi masalah ini,

  1. Pilih AVD di Android Device Manager.

  2. Dari menu opsi tambahan, klik Ungkapkan di Explorer.

  3. Navigasikan ke rekam jepret > default_boot.

  4. Hapus file snapshot.pb:

    Location of the snapshot.pb file

  5. Mulai ulang AVD.

Setelah perubahan ini dilakukan, AVD akan dimulai ulang dalam keadaan yang memungkinkan Wi-Fi berfungsi lagi.

Membuat Laporan Bug

Jika Anda menemukan masalah dengan Android Device Manager yang tidak dapat diselesaikan menggunakan tips pemecahan masalah di atas, silakan ajukan laporan bug dengan mengklik kanan bilah judul dan memilih Hasilkan Laporan Bug:

Location of menu item for filing a bug report

Ringkasan

Panduan ini memperkenalkan Android Device Manager yang tersedia di Visual Studio Tools untuk Xamarin dan Visual Studio untuk Mac. Ini menjelaskan fitur-fitur penting seperti memulai dan menghentikan emulator Android, memilih perangkat virtual Android (AVD) untuk dijalankan, membuat perangkat virtual baru, dan cara mengedit perangkat virtual. Ini menjelaskan cara mengedit properti perangkat keras profil untuk penyesuaian lebih lanjut, dan memberikan tips pemecahan masalah untuk masalah umum.

Temukan video Xamarin lainnya di Channel 9 dan YouTube.