Subsistema do Windows para Android™️ (2023)

Artigo
01/18/2023
10 minutos para o fim da leitura

O Subsistema do Windows para Android™️ permite que seu dispositivo Windows 11 execute aplicativos Android que estão disponíveis na Amazon Appstore. O Android é uma marca registrada do Google LLC. Se você é um desenvolvedor interessado no direcionamento para dispositivos da área de trabalho do Windows e otimização para o sistema operacional Windows, este guia é para você.

Para disponibilizar seu aplicativo Android em dispositivos Windows 11, você precisa:

Enviar seu aplicativo para a Amazon Appstore.

Para obter mais informações ou suporte:

Inscreva-se para ver as atualizações da Amazon Appstore no programa do Windows.
Visite o portal de suporte ao desenvolvedor da Amazon, no qual você pode encontrar artigos, fóruns, perguntas frequentes ou entrar em contato com o suporte direto por meio da página "Entre em contato conosco" da Appstore depois de configurar uma conta de Desenvolvedor da Amazon.

Este guia pode ajudar você a testar e depurar seu aplicativo Android no Windows:

Configurar seu ambiente de desenvolvimento, incluindo os pré-requisitos, instalar a Amazon Appstore e usar o Aplicativo de configurações.
Lidar com considerações de compatibilidade de entrada para dispositivos Windows, como: entrada do teclado, entrada do mouse e gerenciamento e redimensionamento de janelas.
Testar e depurar seu aplicativo em um dispositivo Windows 11.
Solucionar problemas e encontrar respostas.

GitHub do desenvolvedor

Deseja saber mais sobre o roteiro do Subsistema Windows para Android, discutir problemas de desenvolvedores e comunicar erros ou enviar solicitações de recursos com a equipe do subsistema? Acesse o GitHub de desenvolvedores do Subsistema Windows para Android.

Programa de visualização

O programa de versão prévia Subsistema Windows para Android ™️ permite que os usuários recebam compilações de pré-visualização antecipada do Subsistema Windows para Android ™ e do Amazon Appstore no Windows. Para obter mais detalhes, visite a página Programa de versão prévia.

Configurar seu ambiente de desenvolvimento

Para testar seu aplicativo Android no ambiente de área de trabalho do Windows, será necessário fazer algumas configurações.

Pré-requisitos

O Subsistema Windows para Android está disponível no Windows 11. Seu dispositivo precisa atender a requisitos específicos: Requisitos do dispositivo.

Instalar a Amazon Appstore

A Microsoft Store instala automaticamente o Subsistema Windows para Android silenciosamente em segundo plano quando uma das seguintes ações do usuário é realizada:

Instalar a Amazon Appstore através da Microsoft Store. Ao selecionar Obter, a instalação do aplicativo será iniciada.
Instalar um aplicativo Android por meio da Microsoft Store pela primeira vez, o que também instalará a Amazon Appstore.

O aplicativo Amazon Appstore e o aplicativo Configurações do Subsistema Windows para Android serão exibidos no menu Iniciar do Windows 11 e estarão disponíveis na pesquisa, oferecendo um catálogo de aplicativos Android.

Observação

Aplicativo Configurações do Subsistema Windows para Android™️

Para acessar o aplicativo Configurações do Subsistema Windows para Android, acesse: Iniciar > Todos os Aplicativos > Configurações do Subsistema Windows para Android™️. Saiba mais sobre os recursos do aplicativo de configurações específicas: Gerenciar configurações de aplicativos móveis no Windows.

Considerações sobre compatibilidade de entrada para dispositivos Windows

Há alguns comportamentos de entrada exclusivos a serem considerados, projetados para dispositivos portáteis, que provavelmente exigirão atualizações no código do seu aplicativo Android, para serem compatíveis durante a execução em um dispositivo de área de trabalho do Windows por meio da Amazon Appstore.

Entrada por teclado

Para campos de entrada de texto manipulados por um método de entrada de teclado virtual na tela (ou IME), como EditText, os aplicativos devem se comportar conforme o esperado. (Classe EditText nos documentos do Android).

Para pressionamentos de teclas que não puderem ser previstos pela estrutura, os aplicativos precisarão lidar com o comportamento por conta própria. Se isso já estiver implementado no aplicativo, nenhum trabalho extra será necessário.

Por exemplo, alguns jogos já podem ser compatíveis com a movimentação facilitada por teclado, por meio das teclas wasd, juntamente com a entrada por toque.

Veja a seguir entradas de teclado para as quais os desenvolvedores devem considerar atualizações de código ao compilar para dispositivos Windows 11:

Tecla Enter
Navegação com a tecla de direção e com a tecla TAB
Cor de realce de alteração do item selecionado
Atalhos baseados em Ctrl

Saiba mais sobre como otimizar para esses cenários de entrada de teclado em dispositivos de área de trabalho seguindo a documentação do Android:

Entrada por mouse

Os desenvolvedores devem considerar a atualização do código para as seguintes entradas de mouse ao compilar para dispositivos Windows:

Clicar com o botão direito do mouse
Dicas de ferramenta/Texto ao passar o mouse
Efeitos da passagem do mouse
Ação da roda de rolagem do mouse
Arrastar e soltar

A entrada do mouse, semelhante à entrada do teclado, deve seguir as diretrizes oficiais de aplicativos Android. Isso significa usar a classe InputDevice emparelhada com a constante SOURCE_MOUSE. Saiba mais sobre como otimizar para esses cenários de entrada de mouse em dispositivos de área de trabalho seguindo a documentação do Android:

Gerenciamento e dimensionamento de janelas

Ao contrário dos fatores forma móveis tradicionais, os aplicativos Android em execução no Windows 11 podem ser redimensionados livremente, devem ser responsivos durante o redimensionamento e podem ser encaixados usando ações/gestos do Windows.

Requisito mínimo de tela

O Windows 11 impõe um requisito mínimo de tela com resolução de 720p (1280x720) e uma tela maior que 9 polegadas.

Letterbox e pillarbox

Quando a taxa de proporção do tamanho de uma janela não se alinha entre os tamanhos da tela do dispositivo em que a janela está sendo exibida, o resultado pode ser o formato Letterbox (a janela fica mais larga do que alta ou horizontalmente mais longa) ou Pillarbox (a janela fica mais estreita ou verticalmente mais longa). O resultado são as barras que são colocadas nos lados da janela para centralizá-la. Essas barras podem ter temas claros ou escuros, dependendo das configurações do sistema selecionadas. Isso só ocorrerá se for necessário quando o aplicativo Android for encaixado ou maximizado, permitindo que os aplicativos Android aproveitem os recursos avançados de encaixe do Windows e integrem-se ao modelo de janelas.

Considerações adicionais de redimensionamento

Considere também o seguinte ao atualizar um aplicativo Android para ser executado em um dispositivo Windows 11, em relação ao gerenciamento e redimensionamento de janelas:

Tamanho inicial de inicialização
Dimensões da janela
- Limites do conteúdo
- Redimensionamento com forma livre
Orientação da tela

Saiba mais sobre como otimizar para cenários de redimensionamento de janelas em dispositivos da área de trabalho seguindo o Guia de Gerenciamento de Janelas nos documentos do Android.

Testar e depurar

Para testar e depurar seu aplicativo em um dispositivo Windows 11 usando o Subsistema Windows para Android, as etapas de configuração a seguir são necessárias.

Habilitar o modo de desenvolvedor nas Configurações do Windows

Primeiro, você deve habilitar o modo de desenvolvedor nas Configurações do Windows. Há três maneiras de habilitar o modo de desenvolvedor:

Abra o aplicativo de Configurações do Subsistema Windows para Android. Depois de abrir, habilite o Modo de Desenvolvedor.
Pesquise por "Configurações de Desenvolvedor" na pesquisa do Windows.
Navegue até Configurações > Privacidade e Segurança > Para desenvolvedores > Modo de desenvolvedor.

Conectar-se ao Subsistema Windows para Android para depuração

Para conectar-se à VM do Subsistema Windows para Android para depuração:

Inicie um aplicativo Android que foi instalado usando o Amazon Appstore.
Você pode se conectar usando o adb connect com o seguinte comando (você deve ter o adb instalado):
```
adb connect 127.0.0.1:58526
```

Conectar-se a um dispositivo de teste

Para se conectar a um dispositivo de teste (com o Subsistema Windows para Android instalado) na mesma rede do Windows/Mac:

No dispositivo de teste (em que Subsistema Windows para Android está instalado), abra uma janela do PowerShell e identifique o endereço IP do dispositivo de teste executando o comando:
```
ipconfig
```
Usando o terminal do dispositivo de depuração em que o Android Studio e o SDK do Android estão instalados (Mac/Windows), digite o comando:
```
adb connect <TEST DEVICE IP ADDRESS>:58526
```

O <TEST DEVICE IP ADDRESS> pode ser encontrado na saída do "ipconfig" do dispositivo de teste. Você também pode implantar e depurar aplicativos no Android Studio.

Para usar o ADB (Android Debug Bridge) para conectar sua estação de trabalho de desenvolvimento diretamente ao dispositivo Android para que você possa instalar pacotes e avaliar alterações, confira Android Debug Bridge nos documentos do Android Open Source Project.

Depurar seu aplicativo

Embora os aplicativos devam ser instalados usando a Amazon Appstore, a depuração de um aplicativo Android em um dispositivo Windows é possível usando um APK (pacote de aplicativo do Android) e o adb (Android Debug Bridge).

Para depurar um APK usando o adb:

Siga as etapas acima para se conectar à VM do Subsistema Windows para Android.
See Also
Aplicar formatação de tabela condicional no Power BI - Power BI
Instale o APK usando o comando de instalação adb: adb install app-debug.apk
Saída esperada:
```
Performing Streamed InstallSuccess
```
Uma notificação bem-sucedida de "aplicativo instalado" será exibida no menu de notificação do Windows e o aplicativo será inicializado depois de selecionado.

Criação de APKs Universais

O Subsistema Windows para Android utiliza a Intel Bridge Technology para emular aplicativos ARM em processadores baseados em x86. Os aplicativos ARM serão executados em processadores baseados nativamente em ARM. A camada de emulação induzirá uma sobrecarga de desempenho. Para obter um desempenho ideal, envie seu aplicativo para as arquiteturas x86-64 e ARM64.

Considerações de ciclo de vida da VM

O Subsistema Windows para Android utiliza uma VM (máquina virtual) que fornece compatibilidade com a Estrutura AOSP e dispositivos como teclados, mouses, toque, caneta etc.

Há três estados possíveis para a VM que executa aplicativos com o Subsistema Windows para Android:

Executando
Hibernação leve: ativada se não houver nenhuma atividade de aplicativo por 3 minutos. Desativada pela atividade do usuário ou por uma notificação de aplicativo.
Não Executando: ativado se não houver nenhuma atividade de aplicativo por 7 minutos.

As transições entre esses estados são disparadas pela atividade do usuário, como a inicialização ou interação com o aplicativo Android ou uma notificação de aplicativo. Os aplicativos Android são pausados e interrompidos quando a janela é minimizada.

Propriedades de VM

As propriedades da VM do Subsistema Windows para Android estão listadas abaixo. Não é recomendável incluir esses valores no código, pois isso poderá causar incompatibilidades no futuro.

Propriedade	Valor
Build.MANUFACTURER	Microsoft Corporation
Build.MODEL	Subsistema para Android(TM)
Build.VERSION.SDK_INT	32
Build.BOARD	windows

Segurança

O Subsistema Windows para Android executa a criptografia por arquivo baseada em software.

Os drivers de modo kernel do Windows e os aplicativos Windows em execução em IL (nível de integridade) médio podem inspecionar contêineres arbitrários do Android e a memória do aplicativo Android. Não há planos para adicionar a detecção de trapaça/macro/bot/comportamentos suspeitos em curto prazo.

Os desenvolvedores que consultarem getSecurityLevel obterão SECURITY_LEVEL_SW_SECURE_CRYPTO. Saiba mais sobre getSecurityLevel no Guia de referência da API do Android.

Desinstalar o Subsistema Windows para Android

Você pode desinstalar o Subsistema Windows para Android, mas observe que todos os aplicativos associados também serão desinstalados.

A desinstalação da Amazon Appstore desinstala o Subsistema Windows para Android e todos os outros aplicativos Android.
A desinstalação de um aplicativo da Amazon Appstore apenas desinstalará o aplicativo (mesmo comportamento que os aplicativos Windows).
A desinstalação do Subsistema Windows para Android desinstala a Amazon Appstore e todos os aplicativos Android.

Solução de problemas

Se você encontrar problemas específicos com a Amazon Appstore no Windows, experimente as seguintes etapas de solução de problemas:

Selecione a Pesquisa do Windows na barra de tarefas do Windows.
Pesquise por "Amazon Appstore" e clique com o botão direito do mouse no ícone da Amazon Appstore.
Selecione "Configurações do Aplicativo" nas opções da lista suspensa.
Selecione "Armazenamento e Cache" e clique em "Limpar Armazenamento" e "Limpar Cache".
Volte e selecione "Forçar Parada".
Feche a janela Configurações da Amazon Appstore.
Reinicie a Amazon Appstore.

Para obter mais etapas de solução de problemas relacionadas ao aplicativo Configurações do Subsistema Windows para Android ou para deixar comentários usando o Hub de Comentários, confira Solucionar problemas e perguntas frequentes dos aplicativos móveis no Windows.

Para qualquer outra dúvida do desenvolvedor e suporte, use a .

Recursos adicionais

Aplicativos do Amazon Appstore
Acessibilidade no Subsistema Windows para Android