2026年8月7日 / 最終更新日時 : 2026年8月7日 user 不具合・制限事項

Microsoft MSBuildのアップデートによるRanorex Studio エラーの対応方法

最新のWindowsおよびVisual Studioのアップデートにより、Ranorex Studioと互換性のないMicrosoft MSBuildのバージョンがインストールされる場合があります。
このMicrosoft MSBuildのインストールにより、Ranorex Studio 12.7.1以降のバージョン（2026年7月31日時点）でソリューションファイルを読み込む際に、エラーが発生して正しく開くことができない事象が確認されています。

MSBuildはソリューションやプロジェクトの読み込み・ビルドをおこなうためのツールです。Ranorex Studioとの互換性に問題がある場合、ソリューションファイルの読み込みの時点でエラーが発生する場合があります。

本記事では、新しいバージョンのMicrosoft MSBuildと、Ranorex Studioの互換性の問題が解消するまでの、エラーの対応方法について説明します。
※本事象が解消したRanorex Studioバージョンについては、開発元よりリリースがあり次第、順次公開予定です

エラー内容

Ranorex 12.7.1以降のバージョンのインストールまたはバージョンアップ後、Ranorex Studioと互換性のないMSBuildのバージョンがインストールされることにより、新規ソリューションファイルおよび既存ソリューションファイルを開く際に、以下のエラーが発生する場合があります。

新規ソリューションファイルのオープン時

既存ソリューションファイルのオープン時

互換性のあるMSBuildバージョン

以下のMSBuildバージョンが、Ranorex Studio 12.7.1以降のバージョン（2026年7月31日時点）と互換性があります。
※MSBuild 17.14.36以降およびMSBuild 18.3.4以降のバージョンは、この互換性の問題の影響を受けます。

MSBuildバージョン	Ranorex Studio 12.7.1以降のバージョンと互換性のあるバージョン詳細
MSBuild 16（Visual Studio Build Tools 2019）	全バージョン
MSBuild 17（Visual Studio Build Tools 2022）	17.14.35以前のバージョン
MSBuild 18（Visual Studio Build Tools 2026）	18.3.3以前のバージョン

エラーの対応方法

本エラーの対応方法は、対象のマシンにインストール済みのMSBuildのバージョンによって異なります。
Visual Studio Installerまたはコントロールパネル > プログラム > プログラムと機能より、Visual Studuio Build Toolsのインストール状況およびバージョンを参照のうえ、該当する対応方法を確認ください。

インストール状況	影響の有無	対応方法
Visual Studio Build Tools 2019	無し	–
Visual Studio Build Tools 2022（17.14.35以前）	無し	–
Visual Studio Build Tools 2022（17.14.36以降）	有り	対応方法２
Visual Studio Build Tools 2026（18.3.3以前）	無し	–
Visual Studio Build Tools 2026（18.3.4以降）	有り	対応方法３
Visual Studio Build Tools 2019 Visual Studio Build Tools 2022（17.14.36以降） ※上記２つのバージョンがインストールされている場合	有り	対応方法１または対応方法２
Visual Studio Build Tools 2019 Visual Studio Build Tools 2026（18.3.4以降） ※上記２つのバージョンがインストールされている場合	有り	対応方法１または対応方法３
Visual Studio Build Tools 2022（17.14.36以降） Visual Studio Build Tools 2026（18.3.4以降） ※上記２つのバージョンがインストールされている場合	有り	対応方法２または対応方法３

対応方法１：MSBuild 16を使用する

Ranorex Studioと互換性のあるMSBuild 16を使用（参照）するように、Ranorex Studioの設定ファイルの値を変更します。

[手順]

1. 以下のRanorex Studioの設定ファイルを、それぞれ任意の場所にコピーして開きます。
　C:\Program Files (x86)\Ranorex\Studio\Bin\RanorexStudio.exe.config
　C:\Program Files (x86)\Ranorex\Studio\Bin\x64\RanorexStudio.exe.config

2. 両ファイル内の以下の行の値を、”17″から”16″に書き換えます。
※書き換え前に、必ずConfigファイルのバックアップを取得いただくようお願いいたします。
　 <add key=”MSBuildVersion” value=”16″ />

3. 更新した両ファイルを、以下のパスに再度格納します。
※管理者権限が必要となります
　 C:\Program Files (x86)\Ranorex\Studio\Bin
　 C:\Program Files (x86)\Ranorex\Studio\Bin\x64

4. Ranorex Studioを起動している場合は、再起動します。

5. 手順１-４実施後、再度エラーが発生する場合は、他のVisual Studio Build Tools バージョン（2022または2026）のアンインストールを実施ください。

対応方法２：MSBuild 17を使用する

Ranorex Studioと互換性のあるMSBuild 17.14.35以前のバージョンを使用（参照）するように、MSBuild 17.14.35以前のバージョンをインストールします。
※以下の手順では、MSBuild 17.14.35を対象としています。

[手順]

1. Visual Studio Installerまたはコントロールパネル > プログラム > プログラムと機能より、既存のVisual Studio Build Tools 2022をアンインストールします。

2. 以下からvs_BuildTools.exe（MSBuild 17.14.35）をダウンロードします。

vs_BuildTools.exe

3. 手順２でダウンロードしたインストーラーをダブルクリックで起動し、表示された以下の画面で[続行]をクリックします。

4. [C++ によるデスクトップ開発]を選択し、[インストール]をクリックします。

対応方法３：MSBuild 18を使用する

Ranorex Studioと互換性のあるMSBuild 18.3.3以前のバージョンを使用（参照）するように、MSBuild 18.3.3以前のバージョンをインストールします。
※以下の手順では、MSBuild 18.3.3を対象としています。
また、Ranorex Studioの設定ファイルの値を変更します。

[MSBuild 18 インストール手順]

1. Visual Studio Installerまたはコントロールパネル > プログラム > プログラムと機能より、既存のVisual Studio Build Tools 2026をアンインストールします。

2. 以下からvs_BuildTools.exe（MSBuild 18.3.3）をダウンロードします。

vs_BuildTools.exe

3. 手順２でダウンロードしたインストーラーをダブルクリックで起動し、表示された以下の画面で[続行]をクリックします。