™️ 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.
Microsoft Store akan secara otomatis menginstal Subsistem Windows untuk Android ™️ diam-diam di latar belakang saat salah satu dari dua tindakan pengguna berikut diambil:
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.
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.
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
Menyambungkan ke Subsistem Windows untuk Android ™️ untuk penelusuran kesalahan
Untuk menyambungkan ke VM Subsistem Windows untuk Android ™️ untuk penelusuran kesalahan:
Luncurkan aplikasi Android yang diinstal menggunakan Amazon Appstore.
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:
Pada perangkat pengujian (tempat Subsistem Windows untuk Android ™️ diinstal) buka jendela PowerShell dan identifikasi alamat IP perangkat pengujian dengan menjalankan perintah:
ipconfig
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:
Ikuti langkah-langkah untuk menyambungkan ke VM Subsistem Windows untuk Android ™️ di atas.
Instal APK menggunakan perintah adb install: adb install app-debug.apk
Output yang Diharapkan:
Performing Streamed Install
Success
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 wasd 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:
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:
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.
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 ™️:
Sedang berjalan
Doze Ringan: Diaktifkan setelah tidak ada aktivitas aplikasi selama 3 menit. Dinonaktifkan oleh aktivitas pengguna atau pemberitahuan aplikasi.
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.
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™️ (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:
Pilih pencarian Windows dari bilah tugas Windows.
Cari "Amazon Appstore" dan klik kanan pada ikon Amazon Appstore.
Pilih "Pengaturan Aplikasi" di opsi dropdown.
Pilih "Penyimpanan dan Cache" dan klik "Hapus Penyimpanan" dan "Hapus cache".
Kembali dan pilih "Hentikan Paksa".
Tutup jendela Pengaturan Amazon Appstore.
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.
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Umpan balik Windows developer
Windows developer adalah proyek sumber terbuka. Pilih tautan untuk memberikan umpan balik: