Introdução ao Arm64EC

Para começar a criar seu aplicativo ou projeto usando o Arm64EC, você precisará instalar alguns pré-requisitos e adicionar uma configuração do Arm64EC.

Pré-requisitos

• A compilação mais recente do SDK Windows 11. Se estiver usando o SDK do Windows 11 versão 22000, a versão atualizada em 29 de julho de 2022 inclui correções de chave para a criação de aplicativos Arm64EC.
• Visual Studio 2022 versão 17.3 ou posterior.
• Ferramentas Arm64EC instaladas com o Visual Studio Installer.

No instalador do Visual Studio, pode adicionar as ferramentas Arm64EC pesquisando em componentes individuais e marcando a caixa de seleção ferramentas de compilação MSVC v143 - VS 2022 C++ ARM64.

Depois de instalar os pré-requisitos e as ferramentas, você pode direcionar o Arm64EC em seus projetos MSBuild e CMake.

Projetos MSBuild

1. Com as ferramentas e o SDK instalados, crie um novo projeto C++ ou abra um existente.

   Observação

   Se o seu projeto estiver usando um SDK anterior ao Windows 11 ou uma versão do MSVC mais antiga que o VS 17.3, você precisará redirecionar a solução para usar a versão mais recente de cada um.

2. Para adicionar a plataforma Arm64EC:

   • No menu Construção, selecione Gestor de Configuração.
   • Na caixa Plataforma de solução ativa , selecione <New…> para criar uma nova plataforma.
   • Selecione Arm64EC, Copiar configurações de x64 e marque a caixa de seleção Criar novas plataformas de projeto .

   

   Você pode optar por deixar partes da solução como x64, conforme necessário. No entanto, quanto mais código construído como Arm64EC, mais código será executado com desempenho nativo no Windows 11 no Arm. Para quaisquer dependências externas, certifique-se de que seu projeto se vincule às versões x64 ou Arm64EC desses projetos.

3. Com a nova plataforma de solução instalada e selecionada, selecione Compilar no Visual Studio para começar a criar binários Arm64EC.

Por definição, nem todos os projetos numa solução Arm64EC precisam ser configurados para Arm64EC, pois, em vez de Arm64EC, podem ter como alvo x64. Para quaisquer projetos que pretenda manter como x64, certifique-se de que configure esses projetos no gerenciador de configuração para definir o alvo como x64 sob a compilação da solução Arm64EC.

Projetos CMake

1. Abra seu projeto "C++ CMake" ou crie um novo.

2. Abra o arquivo CMakePresets.json indo para a lista suspensa de configuração ativa e seleccionando Gerir configurações.

3. Modifique a propriedade de arquitetura na configuração Windows que deseja para Arm64EC.

    "architecture": { 
       "value": "arm64ec", 
       "strategy": "external"
    }
   

   O gerador padrão é Ninja. Se estiver a usar o gerador do Visual Studio, altere o campo de estratégia para e defina.

4. Se estiver usando o gerador Ninja, você também precisará definir algumas variáveis de ambiente adicionando o objeto de ambiente à sua configuração CMakePresets.

    "environment": { 
       "CXXFLAGS": "/arm64EC",
       "CFLAGS": "/arm64EC" 
    }
   

5. Salve o arquivo CMakePresets e verifique se a configuração ativa está definida para a configuração Arm64EC. Na barra de menus, selecione menu do projetoe, em seguida, selecione Configurar [Nome do Projeto] para gerar seu cache CMake.

6. Construa o seu projeto CMake dirigido para Arm64EC, como qualquer outro projeto CMake, vá ao Build Menu e selecione Build All.

Linha de comandos do desenvolvedor

Se você estiver interessado em usar o Visual Studio Developer Command Prompt para compilar e vincular arquivos de origem para Arm64EC, você precisa usar o Arm64 Developer Command Prompt e, em seguida, executar seus cl comandos e link separadamente. Use a opção /arm64EC para cl e /MACHINE:ARM64EC para link para criar e vincular o código Arm64EC.

cl /arm64EC /c <args>

link /MACHINE:ARM64EC <args>

Saiba mais sobre como usar o conjunto de ferramentas do Microsoft C++ na linha de comando.