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

コマンドラインの使用#

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

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

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

  1. Vector Add サンプルを取得します。

    • oneapi-cli ユーティリティーを使用して、[Intel® DPC++ Compatibility Tool] カテゴリーからサンプルを選択します。

    • GitHub* (英語) からサンプルをダウンロードします。

  2. Vector Add サンプルのルートに移動します。

    サンプルには、src フォルダーに 1 つの CUDA* ファイル (vector_add.cu) が含まれています。

  3. サンプル・プロジェクトの 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* の使用#

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

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

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

  1. [拡張機能] メニューから [Browse Intel® oneAPI Samples] を選択します。

  2. [Intel® DPC++ Compatibility Tool] カテゴリーから [Rodinia NW DPCT] を選択します。

  3. [プロジェクト] メニューから [Migrate Project to DPC++] を選択します。

  4. [Select Project to Migrate] ダイアログで [Browse] をクリックします。

  5. [Open] ダイアログでディレクトリーと既存のプロジェクト・ファイルを選択します。

  6. 移行する [Configuration][Platform] を選択します。

  7. [OK] をクリックします。

ステップ 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] をクリックします。