다음을 통해 공유


Arm64EC 시작

Arm64EC를 사용하여 앱 또는 프로젝트 빌드를 시작하려면 몇 가지 필수 구성 요소를 설치하고 Arm64EC 구성을 추가해야 합니다.

필수 조건

  • 최신 Windows 11 SDK 빌드. Windows 11 SDK 버전 22000을 사용하는 경우, 2022년 7월 29일에 업데이트된 버전에는 Arm64EC 앱을 빌드하기 위한 주요 수정 사항이 포함되어 있습니다.
  • Visual Studio 2022 버전 17.3 이상.
  • Visual Studio 설치 관리자와 함께 설치된 Arm64EC 도구입니다.

Visual Studio 설치 관리자에서 개별 구성 요소를 검색하고 MSVC v143 - VS 2022 C++ ARM64 빌드 도구 확인란을 선택하여 Arm64EC 도구를 추가할 수 있습니다.

Visual Studio Installer Arm64EC checkbox screenshot

중요

Visual Studio 2022 버전 17.4를 기준으로, Arm64EC 도구는 Arm64 도구(MSVC v143 - VS 2022 C++ ARM64 빌드 도구)를 설치할 때 포함됩니다. Arm64EC 도구에 대한 별도의 옵션을 더 이상 선택할 필요가 없습니다.

필수 구성 요소 및 도구를 설치한 후에는 MSBuild 및 CMake 프로젝트에서 Arm64EC를 대상으로 지정할 수 있습니다.

MSBuild 프로젝트

  1. 도구 및 SDK가 설치된 상태에서 새 C++ 프로젝트를 만들거나 기존 프로젝트를 엽니다.

    참고

    프로젝트에서 Windows 11 이전 SDK 또는 VS 17.3 이전 버전의 MSVC를 사용하는 경우, 각각의 최신 버전을 사용하도록 솔루션의 대상을 변경해야 합니다.

  2. Arm64EC 플랫폼을 추가하려면 다음을 수행합니다.

    • 빌드 메뉴에서 구성 관리자를 선택합니다.
    • 활성 솔루션 플랫폼 상자에서 <New…>을(를) 선택하여 새 플랫폼을 만듭니다.
    • ARM64EC를 선택하고, x64에서 설정을 복사한 후, 새 프로젝트 플랫폼 만들기 확인란을 선택합니다.

    Visual Studio Installer New Arm64EC Platform screenshot

    필요에 따라 솔루션의 일부를 x64로 유지하도록 선택할 수 있습니다. 그러나 Arm64EC로 빌드된 코드가 많을수록 Arm의 Windows 11 네이티브 성능으로 실행되는 코드가 더 많아집니다. 외부 종속성의 경우 프로젝트가 해당 프로젝트의 x64 또는 Arm64EC 버전에 연결되는지 확인합니다.

  3. 새 솔루션 플랫폼이 준비되고 선택되면 Visual Studio에서 빌드를 선택하여 Arm64EC 이진 파일 빌드를 시작합니다.

기본적으로 설계된 Arm64EC 솔루션의 모든 프로젝트가 x64를 대상으로 할 수 있으므로 Arm64EC를 대상으로 지정해야 하는 것은 아닙니다. x64로 유지하려는 프로젝트의 경우 ARM64EC 솔루션 빌드에서 x64를 대상으로 하도록 구성 관리자에서 해당 프로젝트를 구성해야 합니다.

CMake 프로젝트

  1. 'C++ CMake' 프로젝트를 열거나 새 프로젝트를 생성합니다.

  2. 활성 구성 드롭다운으로 이동하고 구성 관리를 선택하여 CMakePresets.json 파일을 엽니다.

  3. Arm64EC에 대해 원하는 Windows 구성에서 아키텍처 속성을 수정합니다.

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

    기본 생성기는 Ninja입니다. Visual Studio 생성기를 사용하는 경우 설정할 전략 필드를 변경합니다.

  4. Ninja 생성기를 사용하는 경우 CMakePresets 구성에 환경 개체를 추가하여 일부 환경 변수를 설정해야 합니다.

     "environment": { 
        "CXXFLAGS": "/arm64EC",
        "CFLAGS": "/arm64EC" 
     }
    
  5. CMakePresets 파일을 저장하고 활성 구성이 Arm64EC 구성으로 설정되어 있는지 확인합니다. 메뉴 모음에서 프로젝트 메뉴를 선택한 다음 CMake 캐시를 생성하기 위해 [프로젝트 이름] 구성을 선택합니다.

  6. 빌드 메뉴로 이동하고 모두 빌드를 선택하여 다른 CMake 프로젝트와 마찬가지로 Arm64EC를 대상으로 하는 CMake 프로젝트를 빌드합니다.

개발자 명령 프롬프트

Visual Studio 개발자 명령 프롬프트를 사용하여 Arm64EC의 원본 파일을 컴파일하고 연결하는 데 관심이 있는 경우 Arm64 개발자 명령 프롬프트를 사용한 다음, 명령cllink명령을 별도로 실행해야 합니다. Arm64EC 코드를 빌드 및 연결하려면 cl에는 /arm64EC 스위치를, link에는 /MACHINE:ARM64EC 스위치를 사용합니다.

cl /arm64EC /c <args>

link /MACHINE:ARM64EC <args>

명령줄에서 Microsoft C++ 도구 집합을 사용하는 방법에 대해 자세히 알아봅니다.