Primeros pasos con Arm64EC

Para empezar a compilar la aplicación o el proyecto mediante Arm64EC, deberá instalar algunos requisitos previos y agregar una configuración de Arm64EC.

Requisitos previos

• La compilación más reciente del SDK de Windows 11. Si usa la versión 22000 del SDK de Windows 11, la versión actualizada el 29 de julio de 2022 incluye correcciones clave para compilar aplicaciones Arm64EC.
• Versión 17.3 de Visual Studio 2022 o posteriores
• Herramientas Arm64EC instaladas con el Instalador de Visual Studio.

En el Instalador de Visual Studio, puede agregar las herramientas de Arm64EC si busca en Componentes individuales y selecciona la casilla Herramientas de compilación de ARM64 de MSVC v143 - VS 2022 C++ ARM64).

Importante

A partir de la versión 17.4 de Visual Studio 2022, las herramientas Arm64EC se incluyen al instalar las herramientas de Arm64 (MSVC v143 - VS 2022 C++ ARM64). Ya no es necesario seleccionar una opción independiente para las herramientas Arm64EC.

Una vez instalados los requisitos previos y las herramientas, puede tener como destino Arm64EC en los proyectos de MSBuild y CMake.

Proyectos de MSBuild

1. Con las herramientas y el SDK instalados, cree un nuevo proyecto de C++ o abra uno existente.

   Nota:

   Si el proyecto usa un SDK anterior a Windows 11 o una versión de MSVC anterior a VS 17.3, deberá volver a configurar la solución para usar la versión más reciente de cada uno.

2. Para agregar la plataforma Arm64EC:

   • En el menú Compilar, seleccione Administrador de configuración.
   • En el cuadro Plataforma de solución activa, seleccione <New…> para crear una nueva plataforma.
   • Seleccione ARM64EC, Copiar la configuración de x64 y active la casilla Crear nuevas plataformas de proyecto.

   

   Puede optar por dejar partes de la solución como x64 según sea necesario. Sin embargo, cuanto más código se compila como Arm64EC, más código que se ejecutará con el rendimiento nativo en Windows 11 en Arm. Para las dependencias externas, asegúrese de que el proyecto se vincula con las versiones x64 o Arm64EC de esos proyectos.

3. Con la nueva plataforma de solución en su lugar y seleccionada, seleccione Compilar en Visual Studio para empezar a compilar archivos binarios Arm64EC.

Por diseño, no todos los proyectos de una solución Arm64EC deben tener como destino Arm64EC, ya que pueden tener como destino x64 en su lugar. Para cualquier proyecto de este tipo que quiera permanecer como x64, asegúrese de configurar esos proyectos en el administrador de configuración para que tengan como destino x64 en la compilación de la solución de ARM64EC.

Proyectos de CMake

1. Abra el proyecto "C++ CMake" o cree uno nuevo.

2. Abra el archivo CMakePresets.json; para ello, vaya a la lista desplegable de configuración activa y seleccione Administrar configuraciones.

3. Modifique la propiedad de arquitectura en la configuración de Windows que desee para Arm64EC.

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

   El generador predeterminado es Ninja. Si usa el generador de Visual Studio, cambie el campo de estrategia que se va a establecer.

4. Si usa el generador Ninja, también tendrá que establecer algunas variables de entorno agregando el objeto de entorno a la configuración de CMakePresets.

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

5. Guarde el archivo CMakePresets y asegúrese de que la configuración activa esté establecida en la configuración de Arm64EC. En la barra de menús, seleccione el menú del proyecto y, a continuación, seleccione Configurar [Nombre del proyecto] para generar la memoria caché de CMake.

6. Compile el proyecto de CMake destinado a Arm64EC como cualquier otro proyecto de CMake; para ello, vaya al menú Compilar y seleccione Compilar todo.

Símbolo del sistema para desarrolladores

Si está interesado en usar el símbolo del sistema para desarrolladores de Visual Studio para compilar y vincular archivos de origen para Arm64EC, debe usar el símbolo del sistema para desarrolladores de Arm64 y, a continuación, ejecutar los comando cl y link por separado. Use el modificador /arm64EC para cl y /MACHINE:ARM64EC para compilar link y vincular código Arm64EC.

cl /arm64EC /c <args>

link /MACHINE:ARM64EC <args>

Obtenga más información sobre cómo usar el conjunto de herramientas de Microsoft C++ desde la línea de comandos.