™️ Subsistem Windows untuk Android

2025-03-05

™️ 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

Mulai 5 Maret 2025, Subsistem Windows untuk Android™ dan Amazon Appstore tidak lagi tersedia di Microsoft Store.

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:

Instal Amazon Appstore dari Microsoft Store. Memilih Dapatkan akan memulai penginstalan aplikasi.
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 debugging

Untuk menyambungkan ke VM Windows Subsystem for Android™️ untuk keperluan debugging:

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
```
Gunakan terminal perangkat debugging 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 menyebabkan overhead performa – untuk performa optimal, kirimkan aplikasi Anda untuk kedua 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.

Masukan 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:

Input dari mouse

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

Klik Kanan
Keterangan Alat / Teks Melayang
Efek Melayang
Tindakan Roda Gulir Mouse
Seret dan Lepaskan

Masukan mouse, mirip dengan masukan keyboard, harus mengikuti panduan aplikasi Android resmi. Ini berarti menggunakan kelas InputDevice yang dipasangkan dengan konstanta SOURCE_MOUSE. 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 diatur 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 dengan ukuran layar perangkat tempat jendela ditampilkan, hasilnya mungkin berupa Letterboxing (jendela lebih lebar daripada tinggi, atau lebih panjang secara horizontal) atau Pillarboxing (jendela lebih sempit daripada lebar, atau lebih panjang secara vertikal). 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 letterboxing dan pillarboxing yang memperlihatkan bilah kosong yang memusatkan jendela

Pertimbangan tambahan untuk mengubah ukuran

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 bentuk 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 menggantikan onPause event dapat mencapai hasil yang Anda inginkan di ponsel atau tablet, namun biasanya merupakan event yang salah digunakan jika Anda mengubah UX aplikasi Anda.

Lihat dokumentasi Android untuk deskripsi peristiwa siklus hidup. Sering kali, Anda ingin menggunakan onStop event dan bukan onPause atau onUserLeaveHint event. 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 mesin virtual (VM) yang menyediakan kompatibilitas dengan AOSP framework dan perangkat seperti keyboard, mouse, layar sentuh, pena, dll.

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

Berlari
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.

Grafik siklus hidup VM menunjukkan berjalan, 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	jendela

Mengalihkan ke aplikasi Windows

Subsistem Windows untuk Android™️ secara otomatis mengalihkan intent untuk berkas dan skema URI umum ke pengolah berkas/protokol bawaan Windows yang sesuai (jika beberapa filter intent cocok, pengguna akan melihat opsi "aplikasi bawaan Windows" dalam dialog pemilih). Perintah file yang didukung meliputi ACTION_VIEW, ACTION_EDIT, ACTION_SEND, dan ACTION_SEND_MULTIPLE, yang akan 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.

Pengembang yang melakukan kueri getSecurityLevel akan mendapatkan SECURITY_LEVEL_SW_SECURE_CRYPTO. Pelajari lebih lanjut tentang di dalam panduan "Referensi Android API" .

Menghapus pemasangan 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.