Bagikan melalui

Menggunakan emulator Surface Duo dengan Visual Studio

  • Artikel

Penting

Artikel ini menjelaskan fungsionalitas dan panduan yang ada di pratinjau publik dan dapat dimodifikasi secara substansial sebelum tersedia secara umum. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Untuk membuat aplikasi Android dengan Xamarin di C# menggunakan Visual Studio, siapkan alat ini lalu ikuti petunjuk di halaman ini:

Menginstal pratinjau emulator

Dapatkan alat penginstal dari Pusat Unduhan Microsoft:

Unduh emulator Surface Duo

Pilih paket .zip untuk Windows atau .dmg untuk macOS.

Setelah pengunduhan selesai, jalankan alat penginstal.

Alat penginstal menempatkan ikon di menu Mulai , di dalam folder SurfaceDuoEmulator . Gunakan ikon berlabel Surface Duo Emulator for Visual Studio untuk membuka emulator sebelum mencoba menyebarkan di dalam Visual Studio.

Jalankan emulator

Visual Studio tidak akan secara otomatis memulai emulator Surface Duo, jadi Anda harus membukanya secara manual sebelum mencoba menyebarkan atau men-debug aplikasi Xamarin Anda.

Ikuti petunjuk berikut untuk memulai emulator, setelah itu emulator akan muncul sebagai opsi penyebaran di Visual Studio:

Setelah menyelesaikan Penyiapan SDK, Anda dapat meluncurkan Emulator Surface Duo untuk Visual Studio melalui tautan menu Mulai .

Entri menu mulai untuk emulator Surface Duo

Di folder penginstalan, ada file batch run_vs.bat yang dapat Anda jalankan secara langsung. Ada juga file run_vs_clean.bat yang akan memulai emulator dalam keadaan segar (daripada melanjutkan sesi sebelumnya).

Jika emulator tidak dimulai, Anda mungkin perlu memperbarui pointer ke penginstalan Android SDK Anda .

Catatan

Folder penginstalan berisi skrip start-up bernama run dan run_vs. Skrip eksekusi ditujukan untuk pengembang yang menggunakan Android Studio dan skrip run_vs ditujukan untuk pengguna Visual Studio. Perbedaannya adalah lokasi Android SDK dan port yang digunakan untuk emulator.

Jika emulator berjalan tetapi tidak muncul sebagai opsi penyebaran di Visual Studio, tutup emulator dan mulai ulang, mengonfirmasi bahwa Anda menggunakan skrip dengan vs dalam nama.

Men-debug Aplikasi Android Xamarin Anda

Buka Proyek Anda di Visual Studio, buat, dan pilih <build> (Android 10.0 - API 29) (dalam daftar Perangkat yang Berjalan) dan sebarkan.

Penelusuran kesalahan (titik henti, melangkah ke, melangkahi, dll) semuanya akan berfungsi seperti biasa.

Memperbarui Emulator Android di SDK Tools

Visual Studio mengelola daftar alat SDK yang disetujui dan secara default proses pembaruan dibatasi untuk daftar ini. Terkadang Anda mungkin perlu mengambil alih default untuk mendapatkan versi terbaru komponen, seperti rilis emulator Android 12L yang memerlukan versi tertentu dari beberapa alat SDK untuk dijalankan.

Ikuti langkah-langkah berikut untuk memperbarui ke versi terbaru Android Emulator di Visual Studio:

  1. Buka tab Alat > Android SDK Manager> Tools.

    Menu Visual Studio Tools Android SDK Manager

  2. Perhatikan bahwa status Emulator Android menampilkan Pembaruan yang tersedia.

  3. Klik tombol Perbarui Tersedia dan jendela baru akan menampilkan versi yang akan diunduh. Dalam contoh ini, ini menunjukkan 31.2.10 akan diinstal TETAPI kami ingin menginstal versi 31.3.12.

    Opsi pembaruan alat SDK daftar default yang diizinkan

  4. Batalkan pembaruan dan di jendela Android SDK dan Alat , klik ikon gigi kecil di sudut kanan bawah. Ini akan mengungkapkan submenu Repositori dengan dua opsi:

    • Daftar yang Disetujui (Disarankan)
    • Daftar Lengkap (Tidak didukung)

    Pilih opsi Daftar lengkap (Tidak didukung).

    Pilih daftar lengkap dari menu repositori

  5. Klik tombol Perbarui Tersedia lagi dan kali ini versi 31.3.12 akan ditawarkan.

    Versi yang lebih baru tersedia dengan daftar lengkap diaktifkan

  6. Klik Instal Updates dan versi terbaru alat SDK yang dipilih akan diinstal.

Pemecahan Masalah

Emulator Surface Duo tidak muncul di daftar perangkat Visual Studio

Versi emulator Surface Duo saat ini tidak dapat dimulai oleh Visual Studio. Pertama, mulai emulator secara manual dan setelah dijalankan, emulator akan muncul dalam daftar untuk penyebaran dan penelusuran kesalahan:

  • Windows - buka Emulator Start > Surface Duo dan pilih Surface Duo Emulator untuk Visual Studio.
  • Mac - mulai dari baris perintah menggunakan sh ./run_vs.sh ("VS" dalam nama skrip menunjukkan bahwa itu ditujukan untuk Visual Studio untuk Mac).

Memperbarui pointer ke Android SDK Anda

Jika Anda mengubah lokasi penginstalan Android SDK dari default, Anda harus memperbarui run_vs skrip untuk menunjuk ke lokasi penginstalan yang benar. Jika tidak, emulator tidak akan berjalan saat Anda mengklik pintasan atau menjalankan skrip.

  1. Temukan lokasi penginstalan Surface Duo Emulator. Lokasi default adalah %USERPROFILE%\SurfaceDuoEmulator.
  2. Buka folder di artifacts dalam folder penginstalan.
  3. Buat salinan run_vs.bat cadangan - Anda dapat menyalinnya ke sesuatu seperti run_vs_original.bat.
  4. Buka file run_vs.bat di editor teks.
  5. Verifikasi nilai ANDROID_SDK_LOCATION jalur di dekat bagian atas file sudah benar.
rem ##### ENSURE THE SDK LOCATION BELOW IS CORRECT: #######
set ANDROID_SDK_LOCATION=C:\Program Files (x86)\Android\android-sdk