Atualizar a arquitetura do aplicativo de Arm32 para Arm64

  • Artigo

Este guia abordará as etapas recomendadas para alterar um aplicativo existente com suporte para a arquitetura da 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 ajudará seu aplicativo a ser executado nos dispositivos Windows on Arm mais recentes que usam processadores Arm (ARM64/AArch64) de 64 bits.

Este tópico é relevante para aplicativos UWP que não têm um destino ARM64. Os modelos de projeto UWP mais antigos geravam um destino ARM32 (ou AArch32), mas não incluíam 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 e, no menu suspenso "Plataformas de Solução" na barra de ferramentas Padrão, selecione Configuration Manager... (também disponível no menu Compilar), onde você poderá exibir 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 serão mais compatíveis com AArch32 (Arm32). Essa alteração afeta os aplicativos da Plataforma Universal do Windows que atualmente são direcionados ao AArch32 (Arm32). O suporte para versões Arm de aplicativos de 32 bits será removido em uma versão futura do Windows 11. Os binários do sistema para suporte a ARM32 (presentes na pasta sysarm32 ) também serã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, recomendamos atualizar suas plataformas de destino para AArch64 (Arm64), que tem suporte em todos os dispositivos Windows on Arm, o mais rápido possível para garantir que seus clientes possam continuar a desfrutar da melhor experiência possível. Siga as diretrizes nesta página para atualizar seus aplicativos para AArch64 (Arm64).

Adicionar uma configuração do Arm64 ao seu projeto

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

  1. Abra sua solução (código de projeto) no Visual Studio (é necessário o Visual Studio 2017 versão 15.9 ou mais recente).
  2. No menu suspenso "Plataformas de Solução" na barra de ferramentas Padrão (ou no menu "Compilar"), selecione Gerenciador de Configurações...
  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" habilitada e selecione OK.

Crie sua solução Arm64

Depois de adicionar a plataforma de solução Arm64 ao seu projeto ou solução existente, se você quiser confirmar se a versão Arm64 do seu aplicativo é compilada corretamente, feche a janela "Plataforma de solução ativa" e altere a configuração de build de Depurar para Versão. No menu suspenso "Compilar", selecione Recompilar solução e aguarde a recompilação do projeto. Você deve receber uma saída "Recompilar tudo com êxito". Caso contrário, consulte a seção Solucionar problemas abaixo.

(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 bin\ARM64\Release diretório do projeto seja selecionado. Insira o comando: dumpbin .\<appname>.exe (substituindo <appname> pelo nome do aplicativo). Em seguida, digite o comando: dumpbin /headers .\<appname>.exe. Rolando para cima nos resultados de saída do seu terminal, encontre a FILE HEADER VALUES seção 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 acima, você pode atualizar o pacote de aplicativos existente na Microsoft Store visitando o painel do Partner Center e adicionando os binários ARM64 recém-criados ao envio. (É uma opção para remover também os binários ARM32 anteriores).

(opcionalmente) removendo os binários anteriores do Arm32. Para obter mais informações sobre opções, 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á impedindo que você faça uma compilação bem-sucedida

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

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

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

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

  • A última opção seria remover e/ou substituir a dependência do projeto de aplicativo.

Precisa de assistência? Aproveite nosso serviço de Garantia de Aplicativo

Saiba mais sobre a assistência de compatibilidade da Garantia de Aplicativo para ajudar a portar seu aplicativo ou driver do Windows para o Arm64. Para se registrar e se conectar ao App Assure, visite aka.ms/AppAssureRequest ou envie um email para enviar sua solicitação de achelp@microsoft.com suporte à compatibilidade do Windows no Arm.