Atualizar a arquitetura do aplicativo do Arm32 para o Arm64

  • Artigo

Este guia abordará 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 ajudará seu aplicativo a ser executado nos dispositivos Windows on Arm mais recentes que usam processadores Arm de 64 bits (ARM64/AArch64).

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 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 Gerenciador de Configurações... (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 suportarão mais AArch32 (Arm32). Essa alteração afeta os aplicativos da Plataforma Universal do Windows que atualmente se destinam 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 ao 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 é 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 desta 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 do projeto de aplicativo existente:

  1. Abra sua solução (código de projeto) no Visual Studio (Visual Studio 2017 versão 15.9 ou mais recente é necessária).
  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" ativada e 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 Depurar para Liberar. No menu suspenso "Compilar", selecione Reconstruir solução e aguarde a reconstrução do projeto. Você deve receber uma saída "Rebuild All succeeded". Caso contrário, consulte a seção Solução de 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. Digite o comando: dumpbin .\<appname>.exe (substituindo <appname> pelo nome do seu aplicativo). Em seguida, digite o comando: dumpbin /headers .\<appname>.exe. Rolando para cima nos resultados de saída do seu terminal, encontre a seção e confirme se a FILE HEADER VALUES 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 do aplicativo 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 também remover os binários ARM32 anteriores).

(opcionalmente) removendo os binários Arm32 anteriores. 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á bloqueando você de uma compilação bem-sucedida

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

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

  • Para dependências de terceiros 3, recomendamos o arquivamento de uma solicitação para que o mantenedor reconstrua com suporte ao ARM64.

  • Para dependências de código aberto, 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ê possa atualizar. Se nenhuma atualização existir, considere contribuir com a adição do suporte ARM64 ao pacote você mesmo. Muitos mantenedores de código aberto ficariam gratos pela contribuição.

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

Precisa de ajuda? Aproveite 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 ou envie um email para achelp@microsoft.com enviar sua solicitação de suporte de compatibilidade do Windows on Arm.