Compartilhar via

Atualizar a arquitetura do aplicativo do Arm32 para o Arm64

Este guia aborda as etapas recomendadas para alterar um aplicativo existente com suporte para a arquitetura da plataforma Arm de 32 bits para a arquitetura mais atualizada do Arm de 64 bits adicionando a configuração necessária usando o Visual Studio. Essa atualização ajuda seu aplicativo a ser executado nos dispositivos Windows no 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. 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 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 Standard, selecione Configuration Manager... (também disponível no menu Build), onde você pode exibir a lista de Plataformas de Solução e confirmar se o Arm64 está presente.

Observação

Os dispositivos Windows em execução em um processador Arm (por exemplo, processadores Snapdragon da Qualcomm) não dão mais suporte a AArch32 (Arm32). Essa alteração afeta aplicativos da Plataforma Universal do Windows que atualmente são direcionados ao 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 do Arm32 (presentes na pasta sysarm32 ) também são removidos. Após esta alteração, para o pequeno número de aplicações afetadas, as funcionalidades da aplicação podem ser diferentes e poderá notar uma diferença no desempenho. Portanto, atualize suas plataformas de destino para o AArch64 (Arm64), que tem suporte em todos os dispositivos Windows no 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 diretrizes nesta página para atualizar seus aplicativos para o 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 do projeto) no Visual Studio (o Visual Studio 2017 versão 15.9 ou mais recente é necessário).
  2. No menu suspenso "Plataformas de Solução" na barra de ferramentas Standard (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" habilitada e selecione OK.

Criar 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 "Reconstruir Tudo com êxito". Caso contrário, consulte a seção Solução de problemas .

(Opcional): verifique se o binário do aplicativo 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 seu aplicativo). Em seguida, insira o comando: dumpbin /headers .\<appname>.exe. Nos resultados de saída do terminal, rolando para cima, localize 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 do Arm64 do seu aplicativo seguindo as etapas de configuração na seção anterior, você poderá atualizar seu pacote de aplicativos 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.

Resolução de problemas

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

Uma dependência não compilada para ARM64 está bloqueando você de um build bem-sucedido

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

  • Para dependências internas, reconstrua a dependência para compatibilidade com ARM64.

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

  • Para dependências de software livre, verifique vcpkg para ver se uma versão mais recente da dependência inclui suporte arm64 para o qual você pode atualizar. Se nenhuma atualização existir, considere contribuir com a adição do suporte do ARM64 ao pacote por conta própria. Muitos mantenedores de software livre ficariam gratos pela contribuição.

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

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

Saiba mais sobre a assistência de compatibilidade do App Assure 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.

  • Last updated on