™️ Sottosistema Windows per Android

™️ Sottosistema Windows per Android consente al dispositivo Windows 11 di eseguire applicazioni Android disponibili nell'Amazon Appstore. Android è un marchio di Google LLC. Se sei uno sviluppatore interessato a indirizzare i dispositivi desktop Windows e ottimizzando il sistema operativo Windows, questa guida è per te.

Per rendere disponibile l'app Android nei dispositivi Windows 11, è necessario:

• Inviare l'app all'Amazon Appstore.

Per altre informazioni o supporto:

• Iscriversi per gli aggiornamenti al Amazon Appstore nel programma Windows.
• Visitare il portale di supporto per sviluppatori Amazon in cui è possibile trovare articoli, forum, domande frequenti o contattare il supporto diretto tramite la pagina Appstore "Contattaci" dopo aver configurato un account Amazon Developer.

Questa guida consente di testare e eseguire il debug dell'app Android in Windows:

• Configurare l'ambiente di sviluppo, inclusi i prerequisiti, l'installazione del Amazon Appstore e l'uso delle impostazioni.
• Testare ed eseguire il debug dell'app in un dispositivo Windows 11.
• Gestire le considerazioni sulla compatibilità degli input per i dispositivi Windows, ad esempio: input da tastiera, input del mouse e gestione delle finestre e ridimensionamento delle finestre.
• Risolvere i problemi e trovare risposte.

GitHub per sviluppatori

Vuoi altre informazioni su Sottosistema Windows per Android roadmap, discutere i problemi e i bug degli sviluppatori o le richieste di funzionalità con il team del sottosistema? Visitare gitHub per sviluppatori di Sottosistema Windows per Android.

Programma di anteprima

Il programma di anteprima Sottosistema Windows per Android consente agli utenti di ricevere compilazioni in anteprima anticipata dei Sottosistema Windows per Android ™️ ™ e Amazon Appstore in Windows. Per altre informazioni, visitare la pagina Anteprima programma.

Configurazione dell'ambiente di sviluppo

Per testare l'app Android nell'ambiente desktop di Windows, sarà necessario un bit di configurazione.

Prerequisiti

Sottosistema Windows per Android è disponibile in Windows 11. Il dispositivo deve soddisfare requisiti specifici: Requisiti del dispositivo.

Installare il Amazon Appstore

Microsoft Store installerà automaticamente Sottosistema Windows per Android in background quando vengono eseguite una delle due azioni utente seguenti:

1. Installare l'Amazon Appstore da Microsoft Store. Selezionando Get inizierà l'installazione dell'app.
2. Installare un'app Android da Microsoft Store per la prima volta, che installerà anche la Amazon Appstore.

L'app Amazon Appstore verrà quindi visualizzata nel menu Start Windows 11 e sarà disponibile nella ricerca, offrendo un catalogo di app Android. L'app Sottosistema Windows per Android, che consente di controllare le impostazioni e le funzionalità dell'app per dispositivi mobili, verrà visualizzata anche nel menu Start.

Nota

Il Amazon Appstore in Windows (requisito per l'esecuzione di app Android in Windows 11) è disponibile nelle aree selezionate.

™️ Impostazioni Sottosistema Windows per Android

Per modificare le impostazioni di Sottosistema Windows per Android, passare a: Avviare > tutte le app > Sottosistema Windows per Android ™️. Altre informazioni sulle funzionalità specifiche delle app per le impostazioni: Gestire le impostazioni per le app per dispositivi mobili in Windows.

Eseguire test e debug

Per testare ed eseguire il debug dell'app in un dispositivo Windows 11 usando il Sottosistema Windows per Android sono necessari i passaggi di configurazione seguenti.

Abilitare la modalità sviluppatore nelle impostazioni di Windows

È prima necessario abilitare la modalità sviluppatore. Aprire le impostazioni di Sottosistema Windows per Android ™️. Dopo aver aperto, abilitare la modalità sviluppatore in Impostazioni avanzate.

Connettersi alla Sottosistema Windows per Android per il debug

Per connettersi alla macchina virtuale Sottosistema Windows per Android per il debug:

1. Avviare un'app Android installata usando la Amazon Appstore.

2. È possibile connettersi usando adb connect con il comando seguente (è necessario avere installato adb):

   adb connect 127.0.0.1:58526
   

Connettersi a un dispositivo di test

Per connettersi a un dispositivo di test (con Sottosistema Windows per Android installato) nella stessa rete da Windows/Mac:

1. Nel dispositivo di test (in cui è installato Sottosistema Windows per Android) aprire una finestra di PowerShell e identificare l'indirizzo IP del dispositivo di test eseguendo il comando:

   ipconfig
   

2. Usando il terminale del dispositivo di debug in cui Android Studio e Android SDK è installato (Mac/Windows), immettere il comando:

   adb connect <TEST DEVICE IP ADDRESS>:58526
   

L'oggetto <TEST DEVICE IP ADDRESS> può essere trovato nell'output di "ipconfig" dal dispositivo di test. È anche possibile distribuire e eseguire il debug di app da Android Studio.

Per usare Android Debug Bridge (ADB) per connettere la workstation di sviluppo direttamente al dispositivo Android in modo da poter installare pacchetti e valutare le modifiche, vedere Android Debug Bridge nella documentazione del progetto Android Open Source.

Eseguire il debug dell'app

Anche se le app devono essere installate usando il Amazon Appstore, è possibile eseguire il debug di un'app Android in un dispositivo Windows usando un APK (pacchetto applicazione Android) e adb (Android Debug Bridge).

Per eseguire il debug di un APK usando adb:

1. Seguire la procedura per connettersi alla macchina virtuale Sottosistema Windows per Android precedente.

2. Installare l'APK usando il comando di installazione di adb: adb install app-debug.apk

   Output previsto:

   Performing Streamed Install
   Success
   

3. Verrà visualizzata una notifica "app installata" nel menu di notifica di Windows e l'app verrà avviata una volta selezionata.

Creazione di SDK universali

Sottosistema Windows per Android usa La tecnologia Intel Bridge per abilitare le applicazioni Arm su processori basati su x86. Le applicazioni Arm verranno eseguite in modo nativo sui processori basati su Arm. Il livello di emulazione indurrà un sovraccarico delle prestazioni: per prestazioni ottimali, inviare l'applicazione per le architetture x86-64 e Arm64.

Considerazioni sulla compatibilità di input per i dispositivi Windows

Esistono alcuni comportamenti di input univoci da considerare che probabilmente richiederanno aggiornamenti al codice dell'app Android, progettato per i dispositivi portatili, per essere compatibili quando in esecuzione in un dispositivo desktop Windows tramite il Amazon Appstore.

Input da tastiera

Per i campi di input di testo gestiti da un metodo di input della tastiera virtuale sullo schermo (o IME), ad esempio EditText, le app devono comportarsi come previsto. (Classe EditText nella documentazione Android).

Per le sequenze di tasti che non possono essere previste dal framework, le app dovranno gestire il comportamento stesso. Se questa operazione è già implementata in-app, non è necessario alcun lavoro aggiuntivo.

Ad esempio, alcuni giochi possono già supportare lo spostamento facilitato tramite tastiera, tramite wasd tasti, insieme all'input tocco.

Di seguito sono riportati gli input della tastiera che gli sviluppatori devono considerare gli aggiornamenti del codice per quando si compilano per i dispositivi Windows 11:

• Immettere chiave
• Spostamento con tasto freccia e tabulazioni
• Modifica colore evidenziazione elemento selezionato
• Tasti di scelta rapida basati su CTRL

Altre informazioni su come ottimizzare per questi scenari di input da tastiera nei dispositivi desktop seguendo la documentazione di Android:

• Guida alla compatibilità di input nella documentazione Android
• Gestire la guida all'input della tastiera nella documentazione Android
• Usare la guida ai movimenti di tocco nella documentazione Android

Input tramite mouse

Gli sviluppatori devono considerare l'aggiornamento del codice per gli input del mouse seguenti durante la compilazione per i dispositivi Windows:

• Fare clic con il pulsante destro del mouse
• Descrizioni comandi/Testo del puntatore del mouse
• Effetti del puntatore del mouse
• Azione rotellina di scorrimento del mouse
• Trascinamento e rilascio

L'input del mouse, simile all'input della tastiera, deve seguire le linee guida ufficiali dell'app Android. Ciò significa usare la InputDevice classe associata alla SOURCE_MOUSE costante. Altre informazioni su come ottimizzare per questi scenari di input del mouse nei dispositivi desktop seguendo la documentazione di Android:

• Guida alla compatibilità di input nella documentazione Android
• Informazioni di riferimento su InputDevice nella documentazione Android
• SOURCE_MOUSE riferimento nella documentazione Android

Gestione delle finestre e ridimensionamento delle finestre

A differenza dei fattori di modulo per dispositivi mobili tradizionali, le app Android in esecuzione in Windows 11 possono essere ridimensionate liberamente, devono essere reattive nel ridimensionamento e possono essere rimosse usando azioni/gesti di Windows.

Requisito minimo dello schermo

Windows 11 applica un requisito minimo di risoluzione dello schermo 720p (1280x720) con uno >schermo da 9".

Boxing di colonne lettera &

Quando il rapporto di aspetto di una dimensione della finestra non è allineato tra le dimensioni dello schermo del dispositivo visualizzate in, il risultato può essere Letteraboxing (la finestra è più ampia di quanto sia alta o orizzontale) o Pillarboxing (la finestra è più stretta rispetto a quella estesa o verticalmente più lunga). Il risultato è costituito da barre posizionate sui lati della finestra per centrarla. Queste barre possono essere chiare o scure a seconda delle impostazioni di sistema selezionate. Ciò si verificherà solo quando l'app Android viene rimossa o ingrandita, consentendo alle app Android di sfruttare le funzionalità di snapping avanzate in Windows e integrarsi nel modello di finestra.

Considerazioni aggiuntive sul ridimensionamento

Quando si aggiorna un'app Android da eseguire in un dispositivo Windows 11 rispetto alla gestione delle finestre e al ridimensionamento, è consigliabile considerare quanto segue:

• Dimensioni iniziali di avvio
• Dimensioni finestra
  • Limiti di contenuto
  • Ridimensionamento del modulo gratuito
• Orientamento dello schermo

Altre informazioni su come ottimizzare gli scenari di ridimensionamento delle finestre nei dispositivi desktop seguendo la guida Gestione finestre nella documentazione Android.

Eventi del ciclo di vita dell'applicazione

Lo sviluppo di applicazioni Android per un ambiente multi-finestra ha un impatto sugli eventi del ciclo di vita che si sceglie di usare nell'applicazione. Quando si esegue l'override dell'evento onPause , è in genere l'evento errato da usare se si modifica l'esperienza utente dell'app.

Per una descrizione degli eventi del ciclo di vita, vedere la documentazione di Android . Più spesso di non, si vuole usare l'evento onStop e non gli onPause eventi o onUserLeaveHint . In realtà, molte implementazioni android a più finestre non recapitano la onUserLeaveHint notifica e quindi qualsiasi logica di business critical che potrebbe trovarsi in tale gestore eventi non verrà chiamata su queste piattaforme, incluso Sottosistema Windows per Android.

Considerazioni sul ciclo di vita delle macchine virtuali

Sottosistema Windows per Android usa una macchina virtuale (VM) che offre compatibilità con il framework AOSP e i dispositivi come tastiere, mouse, tocco, penna e così via.

Esistono tre possibili stati per la macchina virtuale che esegue app con Sottosistema Windows per Android:

1. In esecuzione
2. Doze leggero: attivato dopo nessuna attività dell'app per 3 minuti. Disattivato dall'attività utente o da una notifica dell'app.
3. Non in esecuzione: attivato dopo nessuna attività dell'app per 7 minuti.

Le transizioni tra questi stati vengono attivate dall'attività utente, ad esempio l'avvio o l'interazione con l'app Android o una notifica dell'app. Le app Android vengono sospese e quindi arrestate quando la finestra viene ridotta al minimo.

Proprietà della macchina virtuale

Le proprietà per la macchina virtuale Sottosistema Windows per Android sono elencate di seguito. L'inserimento di hardcoding di questi valori non è consigliato perché potrebbe causare incompatibilità future.

Proprietà	Valore
Build.MANUFACTURER	Microsoft Corporation
Build.MODEL	Sottosistema per Android(TM)
Build.VERSION.SDK_INT	32
Build.BOARD	windows

Sicurezza

Sottosistema Windows per Android esegue la crittografia per file basata su software.

Sia i driver in modalità kernel windows che le applicazioni Windows in esecuzione a livello di integrità medio (IL) possono controllare contenitori Android arbitrari e memoria delle app Android. Non sono previsti piani per aggiungere il rilevamento di errori/macro/bot/comportamenti sospetti nel breve termine.

Gli sviluppatori che getSecurityLevel eseguono query otterranno SECURITY_LEVEL_SW_SECURE_CRYPTO. Altre informazioni sulla guida di riferimento alle getSecurityLevel API Android.

Disinstallazione di Sottosistema Windows per Android

È possibile disinstallare la Sottosistema Windows per Android, ma si noti che tutte le app associate verranno disinstallate anche.

• La disinstallazione del Amazon Appstore disinstalla la Sottosistema Windows per Android e tutte le altre app Android.
• La disinstallazione di un'app Amazon Appstore disinstalla solo l'app (lo stesso comportamento delle app di Windows).
• La disinstallazione del Sottosistema Windows per Android disinstalla la Amazon Appstore e tutte le app Android.

Risoluzione dei problemi

Se si verificano problemi specifici dell'Amazon Appstore in Windows, provare la procedura di risoluzione dei problemi seguente:

1. Selezionare Ricerca di Windows dalla barra delle applicazioni di Windows.
2. Cercare "Amazon Appstore" e fare clic con il pulsante destro del mouse sull'icona Amazon Appstore.
3. Selezionare "Impostazioni app" nelle opzioni a discesa.
4. Selezionare "Archiviazione e cache" e fare clic su "Cancella archiviazione" e "Cancella cache".
5. Indietro e selezionare "Forza arresto".
6. Chiudere la finestra Impostazioni Amazon Appstore.
7. Riavviare l'Amazon Appstore.

Per ulteriori passaggi di risoluzione dei problemi relativi all'app Impostazioni Sottosistema Windows per Android o per lasciare commenti e suggerimenti tramite l'hub di feedback, vedere Risoluzione dei problemi e domande frequenti per le app per dispositivi mobili in Windows.

Per eventuali altre domande e supporto per sviluppatori, usare il tag Sottosistema Windows per Android in Microsoft Q&A.

Risorse aggiuntive

• App dall'Amazon Appstore
• Accessibilità su Sottosistema Windows per Android