在 Visual Studio 2022 中建立延伸模組時，以 Visual Studio 2022 (ARM64) 為目標

2025-06-12

當您使用 Visual Studio 2022 建立新的 VSIX 專案時，會從目標設為 Visual Studio 2022 (Amd64) 的範本建立專案。如果您想要以 Visual Studio 2022 (ARM64) 為目標，則必須修改已建立的專案。

在應以 Visual Studio 2022 (ARM64) 為目標的 VSIX 專案上遵循下列步驟：

安裝 Visual Studio 並編譯延伸模組

從 Visual Studio 2022 下載安裝 Visual Studio 2022。

以 .NET 語言撰寫的延伸模組

以 Visual Studio 2022 為目標適用於受控延伸模組的 Visual Studio SDK 僅位於 NuGet 上：

Microsoft.VisualStudio.Sdk (版本 17.x) 中繼套件引進了您所需的大部分或所有參考組件。
Microsoft.VSSDK.BuildTools (版本 17.x) 套件應該從 VSIX 專案參考，以便建置符合 Visual Studio 2022 規範的 VSIX。

以 C++ 撰寫的延伸模組

一如往常，以 C++ 編譯適用於延伸模組的 Visual Studio SDK 會隨已安裝的 Visual Studio SDK 提供。延伸模組「必須」特別針對 Visual Studio 2022 SDK 和 ARM64 進行編譯。

新增 Visual Studio 2022 目標：ARM64

遵循下列步驟，將 Visual Studio 2022:ARM64 支援新增至延伸模組。

對於受控 Visual Studio 延伸模組：
1. 將 VSIX 專案開啟至您的方案。此專案將以 Visual Studio 2022 ARM64 為目標。
2. 確認 VSIX 專案已建置妥當。您可能需要新增參考以符合原始 VSIX 專案，以解決任何編譯器錯誤。
3. 在 Visual Studio 2022 目標專案檔中使用套件參考 17.x (或更早版本)。使用 NuGet 套件管理員或直接編輯專案檔。
  - Microsoft.VisualStudio.Sdk (版本 17.x) 中繼套件引進了您所需的大部分或所有參考組件。
  - Microsoft.VSSDK.BuildTools (版本 17.x) 套件應該從 VSIX 專案參考，以便建置符合 Visual Studio 2022 規範的 VSIX。
4. 如果您的專案已針對 [任何 CPU] 建置，則您不需要編輯建置組態，因為它也會針對 [ARM64] 建置。不過，如果您想要專以 [ARM64] 為目標，請將專案變更為建置 [ARM64]，而不是 [任何 CPU]。
5. 編輯 source.extension.vsixmanifest 檔案，以反映以 Visual Studio 2022 為目標。設定 <InstallationTarget> 旗標以指明 Visual Studio 2022。設定 ProductArchitecture 元素以指明 ARM64 裝載。
```
 <InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,18.0)">
    <ProductArchitecture>amd64</ProductArchitecture>
 </InstallationTarget>
 <InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,18.0)">
    <ProductArchitecture>arm64</ProductArchitecture>
 </InstallationTarget>
```
注意

針對 AnyCPU 建置時，受控 Visual Studio 延伸模組裝載可以同時以 arm64 和 amd64 安裝為目標。
對於 C++ Visual Studio 延伸模組：
1. 將 VSIX 專案開啟至您的方案。此專案將以 Visual Studio 2022 ARM64 為目標。
2. 確認 VSIX 專案已建置妥當。您可能需要新增參考以符合原始 VSIX 專案，以解決任何編譯器錯誤。
3. 將專案從以 [ARM64] 為目標建置變更。
4. 更新相依性 - 延伸模組在原生模組上可能擁有的任何相依性都必須更新為 ARM64 映像。
5. 編輯 source.extension.vsixmanifest 檔案，以反映以 Visual Studio 2022 為目標。設定 <InstallationTarget> 旗標以指明 Visual Studio 2022。設定 ProductArchitecture 元素以指明 ARM64 裝載。
```
<InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,18.0)">
   <ProductArchitecture>arm64</ProductArchitecture>
</InstallationTarget>
```
注意

單一 C++ Visual Studio 延伸模組裝載無法同時以 arm64 和 amd64 安裝為目標。

此時，您有 Visual Studio 2022 目標延伸模組 VSIX。您應該建置 Visual Studio 2022 目標 VSIX 專案。

使用設計工具檢視設定 `<InstallationTarget>` 旗標以指明 Visual Studio 2022

顯示新增 InstallationTarget 的螢幕擷取畫面。

範例延伸模組 vsixmanifest：以 AMD64 和 ARM64 為目標

顯示新增 amd64 和 arm64 InstallationTarget 的螢幕擷取畫面。

如何編譯受控 Visual Studio 延伸模組：僅以 ARM64 為目標

將 ARM64 組態新增至您的專案 (.csproj)。

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|arm64' ">
   <DebugSymbols>true</DebugSymbols>
   <DebugType>full</DebugType>
   <Optimize>false</Optimize>
   <OutputPath>bin\Debug\</OutputPath>
   <DefineConstants>DEBUG;TRACE</DefineConstants>
   <ErrorReport>prompt</ErrorReport>
   <WarningLevel>4</WarningLevel>
   <PlatformTarget>ARM64</PlatformTarget>
   <RuntimeIdentifier>win-arm64</RuntimeIdentifier>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|arm64' ">
   <DebugType>pdbonly</DebugType>
   <Optimize>true</Optimize>
   <OutputPath>bin\Release\</OutputPath>
   <DefineConstants>TRACE</DefineConstants>
   <ErrorReport>prompt</ErrorReport>
   <WarningLevel>4</WarningLevel>
   <PlatformTarget>arm64</PlatformTarget>
   <RuntimeIdentifier>win-arm64</RuntimeIdentifier>
</PropertyGroup>