Windows* でのプロジェクトの移行#

コマンドラインの使用#

インテル® DPC++ 互換性ツールは、コマンドラインから起動できます。

プロジェクトが Microsoft* Visual Studio* を使用している場合、--vcxprojfile オプションを使用して移行するプロジェクトを指定できます。インテル® DPC++ 互換性ツールは、入力ファイルとして提供されるファイルを移行します。

次の手順は、インテル® DPC++ 互換性ツールを使用して Vector Add のサンプルを移行する方法を示しています。

Vector Add サンプルを取得します。
- oneapi-cli ユーティリティーを使用して、[Intel® DPC++ Compatibility Tool] カテゴリーからサンプルを選択します。
- GitHub* (英語) からサンプルをダウンロードします。
Vector Add サンプルのルートに移動します。

サンプルには、src フォルダーに 1 つの CUDA* ファイル (vector_add.cu) が含まれています。
サンプル・プロジェクトの root フォルダーから、インテル® DPC++ 互換性ツール実行します。

vector-add.vcxproj の一部である単一ファイル src\vector_add.cu を移行するには、次のコマンドを実行します。
```
dpct --vcxprojfile=vector-add.vcxproj --in-root=./ --out-root=output_proj src\vector_add.cu
```
または、ツールが検出した vector-add.vcxproj 内のすべての関連ファイルを移行するには、次のコマンドを実行します。
```
dpct --vcxprojfile=vector-add.vcxproj --in-root=./ --out-root=output_proj
```
どちらのケースでも、移行の結果は、output_proj フォルダーに生成されます。

Microsoft* Visual Studio* IDE からインテル® DPC++ 互換性ツール使用して、プロジェクトを SYCL* プロジェクトに移行できます。

ステップ 1: 既存のプロジェクトの選択と移行の開始

Microsoft* Visual Studio* の既存のプロジェクトを選択して移行を開始するには、次の操作を行います。

ステップ 2: 移行設定の指定

既存のプロジェクトを選択すると、[Migration Configuration] ダイアログが表示されます。これらの設定にはデフォルト値があります。新しいプロジェクト・ファイル名とディレクトリー、--in-root 引数、移行の追加オプションを含む設定を指定できます。

コマンドライン領域は読み取り専用で、プロジェクトの移行に使用されるコマンドラインが表示されます。

[OK] をクリックすると移行が開始します。

ステップ 3: ソースの正当性の検証

プリプロセッサー・ディレクティブを使用して宣言された変数を使用するソースコードの移行を確認します。移行されたソースコードを確認し、インテル® DPCT により警告が出力された場合は対処し、新しいプログラムの正当性を検証してください。

挿入された警告とコメントの詳細は、「警告の出力」を参照してください。

最も正確で詳細な警告の対処法については、サンプルの README ファイルの「Addressing Warnings in the Migrated Code (移行されたコードの警告の対処法)」を参照してください。

ステップ 4: 詳細な診断メッセージの確認

診断メッセージのを確認するには、[Intel® DPC++ Compatibility Tool] ビューのテーブルにある [Actions] カラムの [Help] ハイパーリンクをクリックします。診断メッセージが生成された理由と問題を解決する情報が表示されます。

オプションの指定

Microsoft* Visual Studio* でインテル® DPC++ 互換性ツールを使用する設定を指定できます。

移行後に常に警告を表示するには、次の操作を行います。
1. [ツール] > [オプション] > [Intel® DPC++ Compatibility Tool] > [General] を選択します。
2. [Always show warnings after migration] オプションを [True] (デフォルト) にします。
3. [OK] をクリックします。
コードを並べて表示するには、次の操作を行います。
1. [ツール] > [オプション] > [Intel® DPC++ Compatibility Tool] > [General] を選択します。
2. [Enable opening code side-by-side] オプションを [True] (デフォルト) にします。
3. [OK] をクリックします。
ツールのバージョンを選択するには、次の操作を行います。

複数のバージョンのインテル® DPC++ 互換性ツールがインストールされている場合、使用するバージョンを選択できます。
1. [ツール] > [オプション] > [Intel® DPC++ Compatibility Tool] [Tools] を選択します。
2. 上記のステップのドロップダウン・メニューからツールの適切なバージョンを選択します。
3. (オプション) デフォルトのオプションを選択します。
4. [OK] をクリックします。