Visual Studio 2026 では、API バージョンベースの互換性モデルが導入されています。これにより、メジャー リリース全体での拡張機能の更新の必要性が軽減されます。 Visual Studio 2022 用にビルドされた VSIX 拡張機能は、Visual Studio 2026 で引き続き機能し、サポートされている API を対象にしても変更はありません。
概要
以前の拡張機能では、VSIX マニフェストで Visual Studio 製品のバージョン範囲 を指定することで互換性を宣言しました。通常、新しいメジャー リリースごとに上限を変更する必要があります。 Visual Studio 2026 以降では、互換性は製品 バージョンではなく API バージョンのサポート に基づくため、ほとんどの Visual Studio 2022 拡張機能は再公開せずに Visual Studio 2026 に読み込むことができます。
重要な原則
拡張機能は、製品バージョンではなく API バージョンを宣言します。 読み込み時に、Visual Studio は拡張機能のターゲットとなる API バージョンを評価し、互換性のある拡張機能のみを読み込みます。
安定した API は、破壊的変更を回避します。 主要なプラットフォームシフト (Visual Studio 2022 での 64 ビットへの移行など) を除き、プラットフォームは安定した API の下位互換性を維持することを目的としています。
新しい API は最初に追加され、プレビュー版として提供されます。 プレビュー API は変更または削除される可能性があり、運用環境の拡張機能や Visual Studio Marketplace への発行ではサポートされていません。
既存の拡張機能への影響
VSIX 拡張機能が Visual Studio 2022 で動作する場合、Visual Studio 2026 に変更は必要ありません。 Visual Studio 2026:
- API バージョン 17.x をサポートします。
- インストールターゲットのバージョン範囲 の下限のみを 使用して互換性を評価します。
- 範囲の上限を無視します。
Example
このインストール ターゲットの拡張機能は、Visual Studio 2022 と Visual Studio 2026 の両方で実行されます。
<InstallationTarget
Id="Microsoft.VisualStudio.Community"
Version="[17.0,18.0)" />
Visual Studio 2026 で作成された新しい拡張機能
Visual Studio 2026 で拡張機能を作成すると、VSIX マニフェストは下限 17.0 で構成され、上限はありません。
<InstallationTarget
Id="Microsoft.VisualStudio.Community"
Version="[17.0,)" />
この構成により、拡張機能は Visual Studio 2022 と Visual Studio 2026 の両方で変更なしで実行できます。
テストおよびトラブルシューティング
変更が必要ない場合でも、Visual Studio 2026 で拡張機能をテストして、以下をキャッチします。
- 動作の変更。
- プラットフォームの問題。
- サポートされていない API の使用。
プラットフォームの問題が発生した場合は、Visual Studio で 問題の報告 を使用して報告します。
MSI ベースの拡張機能
互換性モデルは VSIX 拡張機能にのみ適用されます。 MSI 分散拡張機能の場合:
- Visual Studio では、インストールや互換性は管理されません。
- Visual Studio 2026 のインストーラーを調整する責任があります。
- 以前のバージョンの Visual Studio からの自動移行は適用されません。
ヒント
可能な限り、ディストリビューションに VSIX を採用します。 MSI ベースのインストールは、カスタム配布のニーズにのみ使用する必要があります。