パッケージ リソース インデックス (PRI) API とカスタム ビルド システム

  • [アーティクル]

パッケージ リソース インデックス (PRI) API を使用すると、UWP アプリのリソース用にカスタム ビルド システムを開発することができます。 ビルド システムでは、UWP アプリが必要とする複雑さのレベルにかかわらず、パッケージ リソース インデックス (PRI) ファイルを (XML として) 作成、バージョン管理、ダンプすることができます。 現在 MakePri.exe コマンド ライン ツールを使用しているカスタム ビルド システムがある場合 (「MakePri.exe を使用して手動でリソースをコンパイルする」を参照)、パフォーマンスと制御を向上させるために、MakePri.exe の呼び出しではなく、PRI API の呼び出しに切り替えることをお勧めします。

PRI API は、Windows 10 向け Windows SDK のバージョン 1803 で導入されました。 API は、Win32 Windows API の形式になります。つまり、それらを呼び出すオプションがいくつかあります。 Win32 アプリから直接それらを呼び出すか、または .NET アプリ、さらには UWP アプリからでも platform invoke を介してそれらを呼び出すことができます。

このトピックのシナリオでは、Win32 Visual C++ Windows Console Application プロジェクトからの PRI API の呼び出しを示します。 背景情報については、「リソース管理システム」を参照してください。

注意

おそらくカスタム ビルド システム アプリを Microsoft Store に提出する必要はないため、この注意事項が問題になることはあまりありません。 ただし、UWP アプリの形式でカスタム ビルド システムを開発するオプションを選択する場合、そのアプリは Microsoft Store に提出することができないという点で通常とは異なる UWP アプリになります。 これは、プラットフォーム呼び出しを使用する UWP アプリが Microsoft Store 認定に失敗するためです。 この場合、プラットフォームの起動呼び出しは、配布する UWP アプリ (PRI ファイルを作成しているアプリ) ではなく、カスタム ビルド システムでのみ行われる点に注意してください。

シナリオのチュートリアル

トピック 説明
シナリオ 1: 文字列リソースとアセット ファイルから PRI ファイルを生成する このシナリオでは、カスタム ビルド システムを表す新しいアプリを作成します。 リソース インデクサーを作成し、文字列とその他の種類のリソースを追加します。 次に、PRI ファイルを生成してダンプします。

重要な API