Aan de slag met Arm64EC

Als u aan de slag wilt met het bouwen van uw app of project met behulp van Arm64EC-, moet u enkele vereisten installeren en een Arm64EC-configuratie toevoegen.

Vereiste voorwaarden

• De nieuwste Windows 11 SDK-build. Als u de Windows 11 SDK versie 22000 gebruikt, bevat de bijgewerkte versie op 29 juli 2022 belangrijke oplossingen voor het bouwen van Arm64EC-apps.
• Visual Studio 2022 versie 17.3 of hoger.
• Arm64EC-hulpprogramma's geïnstalleerd met het Visual Studio-installatieprogramma.

In het Installatieprogramma van Visual Studio kunt u de Arm64EC-hulpprogramma's toevoegen door te zoeken onder Afzonderlijke onderdelen en het selectievakje MSVC v143 - VS 2022 C++ ARM64-buildhulpprogramma's in te schakelen.

Nadat u de vereisten en hulpprogramma's hebt geïnstalleerd, kunt u Arm64EC in uw MSBuild- en CMake-projecten targeten.

MSBuild-projecten

1. Wanneer de hulpprogramma's en SDK zijn geïnstalleerd, maakt u een nieuw C++-project of opent u een bestaand project.

   Opmerking

   Als uw project gebruikmaakt van een pre-Windows 11 SDK of een versie van MSVC ouder dan VS 17.3, moet u de oplossing opnieuw instellen voor het gebruik van de nieuwste versie van elk project.

2. Het Arm64EC-platform toevoegen:

   • Selecteer in het menu BuildConfiguration Manager.
   • Selecteer in het <New…> om een nieuw platform te maken.
   • Selecteer Arm64EC, Kopieer instellingen van x64 en schakel het selectievakje Nieuwe projectplatformen maken in.

   Schermafbeelding van de Visual Studio Installer voor het nieuwe Arm64EC-platform

   U kunt ervoor kiezen om onderdelen van de oplossing zo nodig als x64 achter te laten. Echter, hoe meer code wordt gebouwd als Arm64EC, des te meer code wordt uitgevoerd met systeemeigen prestaties op Windows 11 op Arm. Voor externe afhankelijkheden moet u ervoor zorgen dat uw project is gekoppeld aan de x64- of Arm64EC-versies van deze projecten.

3. Als het nieuwe oplossingsplatform is ingesteld en geselecteerd, selecteert u Build in Visual Studio om binaire Arm64EC-bestanden te bouwen.

Standaard moeten niet alle projecten in een Arm64EC-oplossing gericht zijn op Arm64EC, omdat ze in plaats daarvan op x64 kunnen worden gericht. Voor dergelijke projecten die u als x64 wilt behouden, moet u ervoor zorgen dat u deze projecten in de configuratiebeheer configureert om x64 te richten onder de build van de Arm64EC-oplossing.

CMake Projects

1. Open uw C++ CMake-project of maak een nieuw project.

2. Open het CMakePresets.json bestand door naar de vervolgkeuzelijst met actieve configuratie te gaan en configuraties beherente selecteren.

3. Wijzig de architectuureigenschap onder de gewenste Windows-configuratie voor Arm64EC.

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

   De standaardgenerator is Ninja. Als u de Visual Studio-generator gebruikt, wijzigt u het strategieveld in ingesteld op.

4. Als u de Ninja-generator gebruikt, moet u ook enkele omgevingsvariabelen instellen door het omgevingsobject toe te voegen aan uw CMakePresets-configuratie.

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

5. Sla het CMakePresets-bestand op en zorg ervoor dat de actieve configuratie is ingesteld op de Arm64EC-configuratie. Selecteer in de menubalk projectmenuen selecteer vervolgens [Projectnaam] configureren om uw CMake-cache te genereren.

6. Bouw uw CMake-project dat gericht is op Arm64EC, net als elk ander CMake-project door naar het menu Build te gaan en Build Allte selecteren.

Opdrachtprompt voor ontwikkelaars

Als u geïnteresseerd bent in het gebruik van de Opdrachtprompt voor Ontwikkelaars van Visual Studio voor het compileren en koppelen van bronbestanden voor Arm64EC, moet u de Arm64 Developer-opdrachtprompt gebruiken en vervolgens uw cl en link opdrachten afzonderlijk uitvoeren. Gebruik de /arm64EC-switch voor cl en /MACHINE:ARM64EC voor link om Arm64EC-code te maken en te koppelen.

cl /arm64EC /c <args>

link /MACHINE:ARM64EC <args>

Meer informatie over het Gebruik de Microsoft C++-toolset vanaf de opdrachtregel.