Baca dalam bahasa Inggris

Bagikan melalui


™️ Subsistem Windows untuk Android

™️ Subsistem Windows untuk Android memungkinkan perangkat Windows 11 Anda menjalankan aplikasi Android yang tersedia di Amazon Appstore. Android adalah merek dagang dari Google LLC. Jika Anda adalah pengembang yang tertarik untuk menargetkan perangkat desktop Windows dan mengoptimalkan sistem operasi Windows, panduan ini untuk Anda.

Penting

Microsoft mengakhiri dukungan untuk Subsistem Windows untuk Android ™️ (WSA). Akibatnya, Amazon Appstore di Windows dan semua aplikasi dan game yang bergantung pada WSA tidak akan lagi didukung mulai 5 Maret 2025. Hingga saat itu, dukungan teknis akan tetap tersedia untuk pelanggan.
Pelanggan yang telah menginstal aplikasi Amazon Appstore atau Android sebelum 5 Maret 2024, akan terus memiliki akses ke aplikasi tersebut melalui tanggal penghentian 5 Maret 2025. Silakan hubungi tim dukungan kami untuk pertanyaan lebih lanjut di support.microsoft.com. Kami berterima kasih atas dukungan komunitas pengembang kami dan tetap berkomitmen untuk mendengarkan umpan balik saat kami mengembangkan pengalaman.

Menyiapkan lingkungan pengembangan Anda

Untuk menguji aplikasi Android Anda di lingkungan desktop Windows, sedikit pengaturan akan diperlukan.

Prasyarat

Persyaratan perangkat.

Menginstal Amazon Appstore

Microsoft Store akan secara otomatis menginstal Subsistem Windows untuk Android ™️ diam-diam di latar belakang saat salah satu dari dua tindakan pengguna berikut diambil:

  1. Instal Amazon Appstore dari Microsoft Store. Memilih Dapatkan akan memulai penginstalan aplikasi.
  2. Instal aplikasi Android dari Microsoft Store untuk pertama kalinya, yang juga akan menginstal Amazon Appstore.

Aplikasi Amazon Appstore kemudian akan muncul di menu Mulai Windows 11 dan tersedia di pencarian, menawarkan katalog aplikasi Android. Aplikasi Subsistem Windows untuk Android ™️, yang memungkinkan Anda mengontrol pengaturan dan fitur aplikasi seluler, juga akan muncul di menu Mulai.

Cuplikan layar halaman Microsoft Store yang menampilkan tombol Dapatkan di Amazon App Store

Catatan

Amazon Appstore di Windows (persyaratan untuk menjalankan aplikasi Android di Windows 11) tersedia di wilayah tertentu.

™️ Pengaturan Subsistem Windows untuk Android

Untuk mengubah pengaturan Subsistem Windows untuk Android ™️, buka: Mulai > Semua aplikasi > Subsistem Windows untuk Android ™️. Pelajari selengkapnya tentang fitur aplikasi pengaturan tertentu: Mengelola pengaturan untuk aplikasi seluler di Windows.

Cuplikan layar pengaturan aplikasi Latte

Uji dan debug

Untuk menguji dan men-debug aplikasi Anda di perangkat Windows 11 menggunakan Subsistem Windows untuk Android ™️ langkah-langkah penyiapan berikut diperlukan.

Mengaktifkan mode pengembang di Pengaturan Windows

Anda harus terlebih dahulu mengaktifkan mode pengembang. Buka pengaturan Subsistem Windows untuk Android ™️. Setelah terbuka, aktifkan mode Pengembang di bawah Pengaturan tingkat lanjut.

Menyambungkan ke Subsistem Windows untuk Android ™️ untuk penelusuran kesalahan

Untuk menyambungkan ke VM Subsistem Windows untuk Android ™️ untuk penelusuran kesalahan:

  1. Luncurkan aplikasi Android yang diinstal menggunakan Amazon Appstore.

  2. Anda dapat terhubung menggunakan adb connect dengan perintah berikut (Anda harus menginstal adb):

    adb connect 127.0.0.1:58526
    

Menyambungkan ke perangkat pengujian

Untuk menyambungkan ke perangkat pengujian (dengan Subsistem Windows untuk Android ™️ terinstal) pada jaringan yang sama dari Windows/Mac:

  1. Pada perangkat pengujian (tempat Subsistem Windows untuk Android ™️ diinstal) buka jendela PowerShell dan identifikasi alamat IP perangkat pengujian dengan menjalankan perintah:

    ipconfig
    
  2. Menggunakan terminal perangkat penelusuran kesalahan tempat Android Studio dan Android SDK diinstal (Mac/Windows), masukkan perintah:

    adb connect <TEST DEVICE IP ADDRESS>:58526
    

<TEST DEVICE IP ADDRESS> dapat ditemukan dalam output "ipconfig" dari perangkat pengujian. Anda juga dapat menyebarkan dan men-debug aplikasi dari Android Studio.

Untuk menggunakan Android Debug Bridge (ADB) untuk menyambungkan stasiun kerja pengembangan langsung ke perangkat Android sehingga Anda dapat menginstal paket dan mengevaluasi perubahan, lihat Android Debug Bridge di dokumen Android Open Source Project.

Men-debug aplikasi Anda

Meskipun aplikasi harus diinstal menggunakan Amazon Appstore, penelusuran kesalahan aplikasi Android di perangkat Windows dimungkinkan menggunakan APK (paket aplikasi Android) dan adb (Android Debug Bridge).

Untuk men-debug APK menggunakan adb:

  1. Ikuti langkah-langkah untuk menyambungkan ke VM Subsistem Windows untuk Android ™️ di atas.

  2. Instal APK menggunakan perintah adb install: adb install app-debug.apk

    Output yang Diharapkan:

    Performing Streamed Install
    Success
    
  3. Pemberitahuan "aplikasi terinstal" yang berhasil akan muncul di menu pemberitahuan Windows dan aplikasi akan diluncurkan setelah dipilih.

Membangun APK Universal

™️ Subsistem Windows untuk Android menggunakan Intel Bridge Technology untuk mengaktifkan aplikasi Arm pada prosesor berbasis x86. Aplikasi arm akan berjalan pada prosesor berbasis Arm secara asli. Lapisan emulasi akan menginduksi overhead performa – untuk performa optimal, kirimkan aplikasi Anda untuk arsitektur x86-64 dan Arm64.

Pertimbangan kompatibilitas input untuk perangkat Windows

Ada beberapa perilaku input unik yang perlu dipertimbangkan yang kemungkinan akan memerlukan pembaruan pada kode aplikasi Android Anda, yang dirancang untuk perangkat genggam, agar kompatibel saat berjalan di perangkat desktop Windows melalui Amazon Appstore.

Input keyboard

Untuk bidang input teks yang ditangani oleh metode input keyboard virtual (atau IME) di layar, seperti EditText, aplikasi harus berulah seperti yang diharapkan. (Kelas EditText di dokumen Android).

Untuk penekanan kunci yang tidak dapat diantisipasi oleh kerangka kerja, aplikasi harus menangani perilaku itu sendiri. Jika ini sudah diimplementasikan dalam aplikasi, tidak diperlukan pekerjaan tambahan.

Sebagai contoh, beberapa game mungkin sudah mendukung gerakan yang difasilitasi melalui keyboard, melalui w a s d tombol, bersama dengan input sentuhan.

Berikut ini adalah input keyboard yang harus dipertimbangkan pengembang untuk pembaruan kode saat membangun untuk perangkat Windows 11:

  • Masukkan Kunci
  • Navigasi Tombol Panah dan Tombol Tab
  • Ubah Warna Sorotan Item Terpilih
  • Pintasan berbasis Ctrl

Pelajari selengkapnya tentang cara mengoptimalkan skenario input keyboard ini di perangkat desktop dengan mengikuti dokumentasi Android:

Input mouse

Pengembang harus mempertimbangkan untuk memperbarui kode untuk input mouse berikut saat membangun untuk perangkat Windows:

  • Klik Kanan
  • Tooltips / Hover Text
  • Efek Melayang
  • Tindakan Roda Gulir Mouse
  • Seret dan Lepaskan

Input mouse, mirip dengan input keyboard, harus mengikuti panduan aplikasi Android resmi. Ini berarti menggunakan kelas yang InputDevice dipasangkan dengan SOURCE_MOUSE konstanta. Pelajari selengkapnya tentang cara mengoptimalkan skenario input mouse ini di perangkat desktop dengan mengikuti dokumentasi Android:

Manajemen jendela dan mengubah ukuran

Tidak seperti faktor bentuk seluler tradisional, aplikasi Android yang berjalan di Windows 11 dapat diubah ukurannya dengan bebas, harus responsif dalam mengubah ukurannya, dan dapat diciutkan menggunakan tindakan/gerakan Windows.

Persyaratan layar minimum

Windows 11 memberlakukan persyaratan layar minimum resolusi 720p (1280x720) dengan >layar 9".

Huruf & pilar tinju

Ketika rasio aspek ukuran jendela tidak selaras antara ukuran layar perangkat tempat jendela ditampilkan, hasilnya mungkin Letterboxing (jendela lebih lebar dari tinggi, atau horizontal lebih panjang) atau Pillarboxing (jendela lebih sempit daripada lebar, atau vertikal lebih panjang). Hasilnya adalah bilah yang ditempatkan di sisi jendela untuk memusatkannya. Bilah ini mungkin bertema terang atau gelap tergantung pada pengaturan sistem yang dipilih. Ini hanya akan terjadi seperlunya ketika aplikasi Android di-snap atau dimaksimalkan, memungkinkan aplikasi Android untuk memanfaatkan fitur snapping yang kaya di Windows dan diintegrasikan ke dalam model windowing.

Contoh kotak surat dan Kotak Pilar memperlihatkan bilah kosong yang tengah di tengah jendela

Pertimbangan mengubah ukuran tambahan

Berikut ini juga harus dipertimbangkan saat memperbarui aplikasi Android untuk dijalankan pada perangkat Windows 11 sehubungan dengan manajemen jendela dan mengubah ukuran:

  • Ukuran peluncuran awal
  • Dimensi jendela
    • Batas konten
    • Mengubah ukuran formulir bebas
  • Orientasi Layar

Pelajari selengkapnya tentang cara mengoptimalkan skenario pengubahan ukuran jendela di perangkat desktop dengan mengikuti panduan Manajemen Jendela di dokumen Android.

Peristiwa Siklus Hidup Aplikasi

Mengembangkan aplikasi Android untuk lingkungan multi-jendela berdampak pada peristiwa siklus hidup yang Anda pilih untuk digunakan dalam aplikasi Anda. Saat mengesampingkan onPause peristiwa dapat mencapai hasil yang Anda inginkan di ponsel atau tablet, biasanya peristiwa yang salah digunakan jika Anda mengubah UX aplikasi Anda.

Lihat dokumentasi Android untuk deskripsi peristiwa siklus hidup. Lebih sering daripada tidak, Anda mungkin ingin menggunakan onStop peristiwa dan bukan onPause peristiwa atau onUserLeaveHint . Bahkan, banyak implementasi Android multi-jendela tidak memberikan onUserLeaveHint pemberitahuan, dan dengan demikian logika penting bisnis apa pun yang mungkin ada di penanganan aktivitas tersebut tidak akan dipanggil pada platform ini, termasuk Subsistem Windows untuk Android ™️.

Pertimbangan siklus hidup VM

™️ Subsistem Windows untuk Android menggunakan komputer virtual (VM) yang menyediakan kompatibilitas dengan Kerangka kerja dan perangkat AOSP seperti keyboard, tikus, sentuhan, pena, dll.

Ada tiga kemungkinan status untuk aplikasi yang menjalankan VM dengan Subsistem Windows untuk Android ™️:

  1. Sedang berjalan
  2. Doze Ringan: Diaktifkan setelah tidak ada aktivitas aplikasi selama 3 menit. Dinonaktifkan oleh aktivitas pengguna atau pemberitahuan aplikasi.
  3. Tidak Berjalan: Diaktifkan setelah tidak ada aktivitas aplikasi selama 7 menit.

Transisi antara status ini dipicu oleh aktivitas pengguna, seperti peluncuran atau interaksi dengan aplikasi Android atau pemberitahuan aplikasi. Aplikasi Android dijeda lalu dihentikan saat jendelanya diminimalkan.

Grafik siklus hidup VM memperlihatkan eksekusi, doze ringan, dan tidak berjalan

Properti VM

Properti untuk VM Subsistem Windows untuk Android ™️ tercantum di bawah ini. Hardcoding nilai-nilai ini tidak disarankan karena dapat menyebabkan ketidakcocokan di masa depan.

Properti Nilai
Build.MANUFACTURER Microsoft Corporation
Build.MODEL Subsistem untuk Android(TM)
Build.VERSION.SDK_INT 33
Build.BOARD windows

Mengalihkan ke aplikasi Windows

™️ Subsistem Windows untuk Android secara otomatis mengalihkan niat untuk file dan skema URI umum ke penangan file/protokol default Windows yang sesuai (jika beberapa filter niat cocok, pengguna akan melihat opsi "aplikasi default Windows" dalam dialog pemilih). Niat file yang didukung termasuk ACTION_VIEW, ACTION_EDIT, ACTION_SEND, dan ACTION_SEND_MULTIPLE, yang menyalin file ke folder Unduhan Windows sebelum membukanya. Niat URI yang didukung mencakup ACTION_VIEW untuk skema http/https dan ACTION_VIEW dan ACTION_SENDTO untuk skema mailto.

Aplikasi Android juga dapat mengalihkan secara manual ke aplikasi Windows menggunakan skema URI kustom. Atur tindakan niat ke com.microsoft.windows.LAUNCH_URI dan tambahkan string tambahan ke niat bernama com.microsoft.windows.EXTRA_URI dengan URI kustom sebagai nilai . Misalnya, untuk meluncurkan aplikasi Kalkulator Windows dari aplikasi Android (Java):

Intent intent = new Intent("com.microsoft.windows.LAUNCH_URI");
intent.putExtra("com.microsoft.windows.EXTRA_URI", "ms-calculator:");
 
try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    // Not running in Windows Subsystem for Android&trade;️ (or running on an older build that did not contain this feature).
}

Keamanan

Driver mode kernel Windows dan aplikasi Windows yang berjalan pada tingkat integritas sedang (IL) dapat memeriksa kontainer Android arbitrer dan memori aplikasi Android. Tidak ada rencana untuk menambahkan deteksi untuk deteksi perilaku curang/makro/bot/mencurigakan dalam jangka pendek.

Kueri pengembang getSecurityLevel akan mendapatkan SECURITY_LEVEL_SW_SECURE_CRYPTO. Pelajari lebih getSecurityLevel lanjut di panduan Referensi Android API.

Menghapus instalan Subsistem Windows untuk Android ™️

Anda dapat menghapus instalan Subsistem Windows untuk Android ™️, tetapi perhatikan bahwa semua aplikasi terkait juga akan dihapus instalasinya.

  • Menghapus instalan Amazon Appstore akan menghapus instalan Subsistem Windows untuk Android ™️ dan semua aplikasi Android lainnya.
  • Menghapus instalan aplikasi Amazon Appstore hanya akan menghapus instalan aplikasi (perilaku yang sama dengan aplikasi Windows).
  • Menghapus instalan Subsistem Windows untuk Android ™️ akan menghapus instalan Amazon Appstore dan semua aplikasi Android.

Memecahkan masalah

Jika Anda mengalami masalah khusus untuk Amazon Appstore di Windows, coba langkah-langkah pemecahan masalah berikut:

  1. Pilih pencarian Windows dari bilah tugas Windows.
  2. Cari "Amazon Appstore" dan klik kanan pada ikon Amazon Appstore.
  3. Pilih "Pengaturan Aplikasi" di opsi dropdown.
  4. Pilih "Penyimpanan dan Cache" dan klik "Hapus Penyimpanan" dan "Hapus cache".
  5. Kembali dan pilih "Hentikan Paksa".
  6. Tutup jendela Pengaturan Amazon Appstore.
  7. Jalankan kembali Amazon Appstore.

Untuk langkah-langkah pemecahan masalah lebih lanjut yang berkaitan dengan aplikasi pengaturan Subsistem Windows untuk Android ™️ atau meninggalkan umpan balik menggunakan Hub Umpan Balik, lihat Pemecahan Masalah dan FAQ untuk aplikasi seluler di Windows.