Partilhar via

Atualizar a arquitetura do aplicativo de Arm32 para Arm64

Este guia aborda as etapas recomendadas para alterar um aplicativo existente com suporte para arquitetura de plataforma Arm de 32 bits para a arquitetura Arm de 64 bits mais atualizada, adicionando a configuração necessária usando o Visual Studio. Esta atualização ajuda seu aplicativo a ser executado no Windows mais recente em dispositivos Arm que usam processadores Arm (Arm64/AArch64) de 64 bits.

Este tópico é relevante para aplicativos UWP que não têm um destino Arm64. Modelos de projeto UWP mais antigos geraram um destino Arm32 (ou AArch32), mas não incluíram suporte para Arm64 (AArch64).

Para verificar a Plataforma de Solução atual do seu aplicativo para ver se o Arm64 está presente, abra o código do projeto do aplicativo no Visual Studio. No menu suspenso "Plataformas de Solução" na barra de ferramentas Padrão, selecione Gerenciador de Configurações... (também disponível no menu Compilar), onde você pode visualizar a lista de Plataformas de Solução e confirmar se o Arm64 está presente.

Observação

Os dispositivos Windows executados em um processador Arm (por exemplo, processadores Snapdragon da Qualcomm) não suportam mais AArch32 (Arm32). Essa alteração afeta os aplicativos da Plataforma Universal do Windows que atualmente visam AArch32 (Arm32). O suporte para versões Arm de 32 bits de aplicativos é removido em uma versão futura do Windows 11. Os binários do sistema para suporte a Arm32 (presentes na pasta sysarm32 ) também são removidos. Após essa alteração, para o pequeno número de aplicativos afetados, os recursos do aplicativo podem ser diferentes e você pode notar uma diferença no desempenho. Portanto, atualize suas plataformas direcionadas para AArch64 (Arm64), que é suportado em todos os dispositivos Windows on Arm, o mais rápido possível, a fim de garantir que seus clientes possam continuar a desfrutar da melhor experiência possível. Siga as orientações nesta página para atualizar seus aplicativos para AArch64 (Arm64).

Adicionar uma configuração Arm64 ao seu projeto

Para adicionar uma plataforma de solução Arm64 ao código de projeto de aplicativo existente:

  1. Abra sua solução (código do projeto) no Visual Studio (Visual Studio 2017 versão 15.9 ou mais recente é necessário).
  2. No menu de seleção "Plataformas de solução" na barra de ferramentas padrão (ou no menu "Compilar"), selecione Configuration Manager...
  3. Abra o menu suspenso "Plataforma de solução ativa" e selecione <novo...>.
  4. No menu suspenso "Digite ou selecione a nova plataforma", selecione Arm64 e verifique se o valor "Copiar configurações de" está definido como ARM com a caixa de seleção "Criar novas plataformas de projeto" ativada e, em seguida, selecione OK.

Construa sua solução Arm64

Depois de adicionar a plataforma de solução Arm64 ao seu projeto ou solução existente, se quiser confirmar que a versão Arm64 do seu aplicativo é compilada corretamente, feche a janela "Plataforma de solução ativa" e altere a configuração de compilação de Debug para Release. No menu suspenso "Compilar", selecione Reconstruir Solução e aguarde que o projeto seja reconstruído. Você deve receber uma mensagem "Recompilação de tudo concluída com sucesso". Caso contrário, consulte a seção Solução de problemas .

(Opcional): Verifique se o binário do aplicativo agora foi criado para a arquitetura Arm64 abrindo o diretório do projeto no PowerShell (clique com o botão direito do mouse no projeto do aplicativo no Gerenciador de Soluções do Visual Studio e selecione Abrir no Terminal). Altere os diretórios para que o novo diretório bin\ARM64\Release do seu projeto seja selecionado. Digite o comando: dumpbin .\<appname>.exe (substituindo <appname> pelo nome do seu aplicativo). Em seguida, digite o comando: dumpbin /headers .\<appname>.exe. Percorrendo para cima os resultados de saída do seu terminal, encontre a seção FILE HEADER VALUES e confirme se a primeira linha é AA64 machine (ARM64).

Publicar seu aplicativo atualizado na Microsoft Store

Depois de criar uma versão Arm64 do seu aplicativo seguindo as etapas de configuração na seção anterior, você pode atualizar o pacote de aplicativo existente na Microsoft Store. Visite o painel do Partner Center e adicione os binários ARM64 recém-criados ao envio. Você também pode remover os binários ARM32 anteriores, se desejar.

Para obter mais informações sobre opções de publicação, consulte Publicar seu aplicativo na Microsoft Store.

Solução de problemas

Se você tiver problemas ao portar seu aplicativo Arm32 para Arm64, aqui estão algumas soluções comuns.

Uma dependência não compilada para ARM64 está bloqueando você de uma compilação bem-sucedida

Se você não puder criar devido a uma dependência, seja interna, de terceiros ou de uma biblioteca de código aberto, será necessário atualizar essa dependência para oferecer suporte à arquitetura ARM64 ou removê-la.

  • Para dependências internas, recompile a dependência para suporte a ARM64.

  • Para dependências de terceiros, registre uma solicitação para que o mantenedor reconstrua com suporte a ARM64.

  • Para dependências de código aberto, verifique vcpkg para ver se uma versão mais recente da dependência inclui suporte ARM64 para o qual você pode atualizar. Se não houver nenhuma atualização, considere contribuir com a adição do suporte ARM64 ao pacote. Muitos mantenedores de código aberto ficariam gratos pela contribuição.

  • Remova e substitua a dependência em seu projeto de aplicativo.

Precisa de assistência? Aproveite nosso serviço App Assure

Saiba mais sobre a assistência de compatibilidade do App Assure para ajudar com a portabilidade do seu aplicativo ou driver do Windows para o Arm64. Para se registrar e se conectar com o App Assure, visite aka.ms/AppAssureRequest.

  • Last updated on