Android™️ için Windows Alt Sistemi

Android™️ için Windows Alt Sistemi, Windows 11 cihazınızın Amazon Appstore'da bulunan Android uygulamalarını çalıştırmasını sağlar. Android, Google LLC'nin ticari markasıdır. Windows masaüstü cihazlarını hedeflemek ve Windows işletim sistemini iyileştirmek isteyen bir geliştiriciyseniz, bu kılavuz size yöneliktir.

• Amazon Appstore on Windows 11 sona erdirme bildirimi.
• GitHub'da 'Android™️ için Windows Alt Sistemi' deposu
• Amazon Appstore'dan Uygulamaları
• Windows 'da mobil uygulamalar için Erişilebilirliği

Geliştirme ortamınızı ayarlama

Android uygulamanızı Windows masaüstü ortamında test etmek için bir miktar kurulum gerekir.

Önkoşullar

Cihaz gereksinimleri.

Amazon Appstore'u yükleme

Microsoft Store, aşağıdaki iki kullanıcı eyleminden biri gerçekleştirildiğinde Android™️ için Windows Alt Sistemi'ni arka planda sessizce otomatik olarak yükler:

1. Microsoft Store'danAmazon Appstore'u yükleyin. Al seçildiğinde, uygulamanın yüklenmesi başlar.
2. Amazon Appstore'u da yükleyecek olan bir Android uygulamasını Microsoft Store'dan ilk kez yükleyin.

Amazon Appstore uygulaması Daha sonra Windows 11 Başlat menüsünde görünür ve Android uygulamalarının kataloğunu sunarak aramada kullanılabilir. Mobil uygulama ayarlarını ve özelliklerini denetlemenize olanak tanıyan Android™️ uygulaması için Windows Alt Sistemi, Başlat menüsünde de görünür.

Android™️ için Windows Alt Sistemi Ayarları

Android™️ için Windows Alt Sistemi ayarlarını değiştirmek için şuraya gidin: Başlat > Tüm Uygulamalar > Android™️ için Windows Alt Sistemi. Belirli ayarlar uygulaması özellikleri hakkında daha fazla bilgi edinin: Windows'da mobil uygulamalar için ayarları yönetme.

ekran görüntüsü

Test ve hata ayıklama

Android™️ için Windows Alt Sistemi'ni kullanarak bir Windows 11 cihazında uygulamanızı test etmek ve hatalarını ayıklamak için aşağıdaki kurulum adımları gereklidir.

Windows Ayarları'nda geliştirici modunu etkinleştirme

Önce geliştirici modunu etkinleştirmeniz gerekir. Android™️ayarları içinWindows Alt Sistemi'ni açın. Açıldıktan sonra, Gelişmiş ayarlaraltında Geliştirici modunu etkinleştirin.

Hata ayıklama için Android™️ için Windows Alt Sistemine bağlanma

Hata ayıklama için Android™️ VM için Windows Alt Sistemine bağlanmak için:

1. Amazon Appstore kullanılarak yüklenen bir Android uygulamasını başlatın.

2. Aşağıdaki komutla adb connect kullanarak bağlanabilirsiniz (yüklüadb'niz olmalıdır):

   adb connect 127.0.0.1:58526
   

Test cihazına bağlanma

Windows/Mac'ten aynı ağdaki bir test cihazına (Android™️ için Windows Alt Sistemi yüklü olarak) bağlanmak için:

1. Test cihazında (Android™️ için Windows Alt Sistemi'nin yüklü olduğu) bir PowerShell penceresi açın ve komutunu çalıştırarak test cihazının IP adresini belirleyin:

   ipconfig
   

2. Android Studio ve Android SDK'sının yüklü olduğu hata ayıklama cihaz terminalini (Mac/Windows) kullanarak şu komutu girin:

   adb connect <TEST DEVICE IP ADDRESS>:58526
   

<TEST DEVICE IP ADDRESS>, test cihazından "ipconfig" çıkışında bulunabilir. Ayrıca Android Studio'dan uygulama dağıtabilir ve hatalarını ayıklayabilirsiniz.

Paketleri yükleyip değişiklikleri değerlendirebilmeniz için android hata ayıklama köprüsünü (ADB) kullanarak geliştirme iş istasyonunuzu doğrudan Android cihazınıza bağlamak için bkz. Android Açık Kaynak Projesi belgelerinde Android Hata Ayıklama Köprüsü.

Uygulamanızda hata ayıklama

Uygulamaların Amazon Appstore kullanılarak yüklenmesi gerekirken, Bir Windows cihazında Android uygulamasında hata ayıklamak APK (Android uygulama paketi) ve adb (Android Hata Ayıklama Köprüsü) kullanılarak mümkündür.

adb kullanarak apk hatalarını ayıklamak için:

1. Yukarıdaki Android™️ VM için Windows Alt Sistemi'ne bağlanmak için adımları izleyin.

2. Adb yükleme komutunu kullanarak APK'yi yükleyin: adb install app-debug.apk

   Beklenen Çıkış:

   Performing Streamed Install
   Success
   

3. Windows bildirim menüsünde başarılı bir "uygulama yüklendi" bildirimi görüntülenir ve uygulama seçildikten sonra başlatılır.

Evrensel APK dosyaları oluşturma

Android™️ için Windows Alt Sistemi, x86 tabanlı işlemcilerde Arm uygulamalarını etkinleştirmek için Intel Bridge Teknolojisini kullanır. Arm uygulamaları Arm tabanlı işlemcilerde yerel olarak çalışır. Öykünme katmanı bir performans yükü oluşturur; en iyi performans için hem x86-64 hem de Arm64 mimarileri için uygulamanızı gönderin.

Windows cihazları için giriş uyumluluğu konusunda dikkat edilmesi gerekenler

Amazon Appstore aracılığıyla bir Windows masaüstü cihazında çalışırken uyumlu olması için el cihazları için tasarlanmış Android uygulama kodunuzda güncelleştirmelerin yapılması gerekeceğini göz önünde bulundurmanız gereken birkaç benzersiz giriş davranışı vardır.

Klavye girişi

EditTextgibi bir ekran sanal klavye giriş yöntemi (veya IME) tarafından işlenen metin girişi alanları için uygulamalar beklendiği gibi davranmalıdır. (Android belgelerinde) EditText sınıfı.

Çerçeve tarafından tahmin edilemeyen tuş vuruşları için uygulamaların davranışı kendi başlarına işlemesi gerekir. Bu uygulama içinde zaten uygulandıysa ek bir çalışma gerekmez.

Örneğin, bazı oyunlar dokunmatik girişin yanı sıra klavyedeki wasd tuşları aracılığıyla kolaylaştırılan hareketi zaten destekleyebilir.

Aşağıda, geliştiricilerin Windows 11 cihazları oluştururken kod güncelleştirmelerini dikkate alması gereken klavye girişleri bulunur:

• Anahtar Girin
• Ok tuşu ve Sekme Tuşu Gezintisi
• Seçili Öğe Vurgu Rengini Değiştir
• Ctrl Tabanlı Kısayollar

Android belgelerini izleyerek masaüstü cihazlarda bu klavye giriş senaryoları için iyileştirme hakkında daha fazla bilgi edinin:

• Android belgelerindeki giriş uyumluluğu kılavuzu
• Android belgelerinde klavye girişi kılavuzunu işleme
• Android belgelerindeki dokunma hareketleri kılavuzunu kullanın

Fare girdisi

Geliştiriciler, Windows cihazları için oluştururken aşağıdaki fare girişleri için kodu güncelleştirmeyi düşünmelidir:

• Sağ Tıklama
• Araç İpuçları / Üzerine Gelme Metni
• Hover Efektleri
• Fare Kaydırma Tekerleği Eylemi
• Sürükle ve Bırak

Fare girişi, klavye girişine benzer şekilde resmi Android uygulama yönergelerine uymalıdır. Bu, SOURCE_MOUSE sabiti ile eşleştirilmiş InputDevice sınıfını kullanmak anlamına gelir. Android belgelerini izleyerek masaüstü cihazlarda bu fare giriş senaryoları için iyileştirme hakkında daha fazla bilgi edinin:

• Android belgeleri Giriş uyumluluğu kılavuzu
• Android belgelerinde InputDevice başvurusu
• SOURCE_MOUSE referansı Android belgelerinde

Pencere yönetimi ve yeniden boyutlandırma

Geleneksel mobil form faktörlerinden farklı olarak, Windows 11'de çalışan Android uygulamaları serbestçe yeniden boyutlandırılabilir, yeniden boyutlandırmada yanıt vermelidir ve Windows eylemleri/hareketleri kullanılarak tutturılabilir.

En düşük ekran gereksinimi

Windows 11, >9" ekranlı en az 720p çözünürlük (1280x720) ekran gereksinimini zorunlu kılıyor.

Harf & sütunlu kutulama

Pencere boyutunun en boy oranı, pencerenin görüntülendiği cihaz ekranı boyutlarıyla uyumlu olmadığında, sonuç Letterboxing (pencere yükseklikten daha geniş veya yatay olarak daha uzun) veya Pillarboxing (pencere genişlikten daha dar veya dikey olarak daha uzun) olabilir. Sonuç, pencerenin ortalanabilmesi için yanlarına çubukların yerleştirilmesi olur. Bu çubuklar, seçilen sistem ayarlarına bağlı olarak açık veya koyu temalı olabilir. Bu durum yalnızca Android uygulaması pencereye tutturulduğunda veya tam ekran yapıldığında, Android uygulamalarının Windows'taki zengin tutturma özelliklerinden yararlanmasına ve pencereleme modeliyle tümleştirilmesine olanak tanıyacak şekilde gerçekleşir.

Pencereyi ortalayan boş çubukları gösteren Letterboxing ve Pillarboxing örneği

İlave yeniden boyutlandırma ile ilgili hususlar

Windows 11 cihazında çalıştırılacak bir Android uygulaması güncelleştirilirken pencere yönetimi ve yeniden boyutlandırma konusunda da aşağıdakiler dikkate alınmalıdır:

• İlk başlatma boyutu
• Pencere boyutları
  • İçerik sınırları
  • Biçimi serbestçe yeniden boyutlandırma
• Ekran Yönü

Android belgelerindekiPencere Yönetimi kılavuzunu izleyerek masaüstü cihazlarda pencere yeniden boyutlandırma senaryoları için iyileştirme hakkında daha fazla bilgi edinin.

Uygulama Yaşam Döngüsü Olayları

Çok pencereli bir ortam için Android uygulamaları geliştirmek, uygulamanızda kullanmayı seçtiğiniz yaşam döngüsü olaylarını etkiler. onPause olayını geçersiz kılma, telefon veya tablette istediğiniz sonuçları elde edebilir ancak uygulamanızın UX'ini değiştirirken genellikle yanlış olay kullanılır.

Yaşam döngüsü olaylarının açıklaması için Android belgelerine bakın. Çoğu zaman, onPause veya onUserLeaveHint olaylarını değil onStop olayını kullanmak istersiniz. Aslında, birçok çok pencereli Android uygulaması onUserLeaveHint bildirimini sunmaz ve bu nedenle bu olay işleyicisinde olabilecek iş açısından kritik mantık, Android™️ için Windows Alt Sistemi de dahil olmak üzere bu platformlarda çağrılmaz.

VM yaşam döngüsüyle ilgili dikkat edilmesi gerekenler

Android™️ için Windows Alt Sistemi, AOSP çerçevesi ve klavye, fare, dokunma, kalem gibi cihazlarla uyumluluk sağlayan bir sanal makine (VM) kullanır.

Android™️ için Windows Alt Sistemi ile uygulama çalıştıran VM için üç olası durum vardır:

1. Koşu
2. Basit Doze: 3 dakika boyunca hiçbir uygulama etkinliği yapılmadıktan sonra etkinleştirilir. Kullanıcı etkinliği veya uygulama bildirimi tarafından devre dışı bırakıldı.
3. Çalışmıyor: 7 dakika boyunca hiçbir uygulama etkinliği yapılmadıktan sonra etkinleştirilir.

Bu durumlar arasındaki geçişler, Android uygulamasını başlatma veya android uygulamasıyla etkileşim veya uygulama bildirimi gibi kullanıcı etkinlikleri tarafından tetiklenir. Android uygulamaları duraklatılır ve pencere simge durumuna küçültüldüğünde durdurulur.

gösteren VM yaşam döngüsü grafiği

VM Özellikleri

Android™️ VM için Windows Alt Sistemi özellikleri aşağıda listelenmiştir. Gelecekte uyumsuzluklara neden olabileceği için bu değerlerin sabit kodlaması önerilmez.

Windows uygulamalarına yeniden yönlendirme

Android™️ için Windows Alt Sistemi, dosyalar ve ortak URI düzenleri için amaçları otomatik olarak ilgili Windows varsayılan dosya/protokol işleyicisine yönlendirir (birden çok amaç filtresi eşleşiyorsa, kullanıcılar seçici iletişim kutusunda bir "Windows varsayılan uygulaması" seçeneği görür). Desteklenen dosya amaçları, dosyayı açmadan önce Windows İndirmeleri klasörüne kopyalayan ACTION_VIEW, ACTION_EDIT, ACTION_SENDve ACTION_SEND_MULTIPLEiçerir. Desteklenen URI amaçları http/https şemaları için ACTION_VIEW, mailto düzeni için ACTION_VIEW ve ACTION_SENDTO içerir.

Android uygulamaları ayrıca özel URI düzenlerini kullanarak Windows uygulamalarına el ile yeniden yönlendirebilir. Niyet eylemini com.microsoft.windows.LAUNCH_URI olarak ayarlayın ve özel URI'yi değer olarak kullanarak com.microsoft.windows.EXTRA_URI adlı niyete fazladan bir dize ekleyin. Örneğin, Windows Hesap Makinesi uygulamasını bir Android uygulamasından (Java) başlatmak için:

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).
}

Güvenlik

Hem Windows çekirdek modu sürücüleri hem de orta bütünlük düzeyinde (IL) çalışan Windows uygulamaları rastgele Android kapsayıcılarını ve Android uygulama belleğini inceleyebilir. Kısa vadede hileler/makro/bot/şüpheli davranış algılama için algılama ekleme planı yoktur.

getSecurityLevel sorgulayan geliştiriciler SECURITY_LEVEL_SW_SECURE_CRYPTOelde eder. Android API Referans Kılavuzu'nda getSecurityLevel hakkında daha fazla bilgi edinin.

Android™️ için Windows Alt Sistemi'ni kaldırma

Android™️ için Windows Alt Sistemi'ni kaldırabilirsiniz, ancak ilişkili tüm uygulamaların da kaldırılacağını unutmayın.

• Amazon Appstore'un kaldırılması Android ve diğer tüm Android™️ uygulamaları için Windows Alt Sistemi'ni kaldırır.
• Amazon Appstore uygulamasının kaldırılması yalnızca uygulamayı kaldırır (Windows uygulamalarıyla aynı davranış).
• Android™️ için Windows Alt Sistemi kaldırıldığında Amazon Appstore ve tüm Android uygulamaları kaldırılır.

Sorun giderme

Windows'da Amazon Appstore'a özgü sorunlarla karşılaşırsanız aşağıdaki sorun giderme adımlarını deneyin:

1. Windows görev çubuğundan Windows arama seçin.
2. "Amazon Appstore" araması yapın ve Amazon Appstore simgesine sağ tıklayın.
3. Açılan seçeneklerden "Uygulama Ayarları"nı seçin.
4. "Depolama ve Önbellek" öğesini seçin ve hem "Depolama alanını temizle" hem de "Önbelleği temizle" seçeneğine tıklayın.
5. Geri dönün ve "Durmaya Zorla" seçeneğini belirleyin.
6. Amazon Appstore Ayarları penceresini kapatın.
7. Amazon Appstore'un yeniden başlatılması.

Android™️ için Windows Alt Sistemi Ayarlar uygulamasıyla ilgili diğer sorun giderme adımları veya Geri Bildirim Merkezi'ni kullanarak geri bildirimde bulunmak için, Windows'ta mobil uygulamalar için sorun giderme ve SSS için vebölümlerine bakın.