アプリ リソースとリソース管理システム

  • [アーティクル]

このセクションでは、アプリの文字列、画像、ファイル リソースを作成、パッケージ化、利用する方法を示します。 たとえば、カジュアル ゲームと共に、ゲームのレベルの定義が含まれるファイルをパッケージ化し、実行時にそのファイルを読み込むことができます。 アプリのロジックとは別にリソースを管理することによって、さまざまなロケール、デバイスのディスプレイ、アクセシビリティの設定、その他のユーザーとコンピューターのコンテキストに合わせたアプリのローカライズやカスタマイズが容易になることも説明します。 文字列や画像などのリソースには、通常、言語、スケール、コントラストの複数のバリエーションが存在している必要があります。 そのようなリソースについては、リソース管理システムを活用できます。

アプリ リソースには、次の 2 種類があります。

  • ファイル リソースは、ディスク上のファイルとして格納されているリソースです。 ファイル リソースには、ビットマップ画像、XAML、XML、HTML、またはその他のあらゆる種類のデータを含めることができます。
  • 埋め込みリソースは、特定の格納するリソース ファイル内に埋め込まれたリソースです。 最も一般的な例は、リソース ファイル (.resw または .resjson) に埋め込まれた文字列リソースです。

アプリのローカライズの価値提案の詳細については、「グローバリゼーションとローカライズ」 を参照してください。

[アーティクル] 説明
リソース管理システム ビルド時に、リソース管理システムは、アプリとしてパッケージ化されているリソースのさまざまなバリエーションすべてのインデックスを作成します。 実行時に、システムは、有効になっているユーザーやコンピューターの設定を検出し、それらの設定に最適なリソースを読み込みます。
リソース管理システムでのリソースの照合と選択の仕組み リソースを要求すると、現在のリソース コンテキストにある程度一致するリソース候補がいくつか存在する場合があります。 リソース管理システムはすべての候補を分析して、返すのに最もよい候補を決定します。 このトピックでは、そのプロセスの詳細について説明し、例を示します。
リソース管理システムでの言語タグの照合の仕組み 前のトピック (「リソース管理システムでのリソースの照合と選択の仕組み」) では、一般的な修飾子の照合について説明しました。 このトピックでは、言語タグの照合についてさらに詳しく説明します。
言語、スケール、ハイ コントラスト、その他の修飾子用にリソースを調整する このトピックでは、リソース修飾子の一般概念、使用方法、各修飾子名の目的について説明します。
UI とアプリ パッケージ マニフェスト内の文字列をローカライズする アプリで複数の表示言語をサポートする必要があり、コード、XAML マークアップ、アプリ パッケージ マニフェスト内に文字列リテラルが含まれている場合は、その文字列をリソース ファイル (.resw) に移動します。 アプリでサポートする各言語用に、このリソース ファイルを翻訳したコピーを作成することができます。
スケール、テーマ、ハイ コントラストなどに合わせた画像と資産の読み込み アプリで、表示倍率、テーマ、ハイ コントラスト、その他の実行時のコンテキストに合わせた画像を含む画像リソース ファイルを読み込むことができます。
URI スキーム アプリのパッケージ、アプリのデータ フォルダー、またはクラウドからのファイルを参照するために使用できる URI (Uniform Resource Identifier) スキームはいくつかあります。 また、URI スキームを使用して、アプリのリソース ファイル (.resw) から読み込まれた文字列を参照することもできます。
アプリで使用する既定のリソースを指定する アプリにユーザーのデバイスの特定の設定に一致するリソースがない場合、アプリの既定のリソースが使用されます。 このトピックでは、これらの既定のリソースの内容を指定する方法について説明します。
リソースをリソース パックではなくアプリ パッケージに組み込む 一部の種類のアプリ (多言語の辞書、翻訳ツールなど) は、アプリ バンドルの既定の動作をオーバーライドし、別のリソース パッケージではなくアプリ パッケージにリソースを組み込む必要があります。 このトピックでは、その方法について説明します。
パッケージ リソース インデックス (PRI) API とカスタム ビルド システム パッケージ リソース インデックス (PRI) API を使用すると、UWP アプリのリソース用にカスタム ビルド システムを開発することができます。 ビルド システムでは、UWP アプリが必要とする複雑さのレベルにかかわらず、パッケージ リソース インデックス (PRI) ファイルを (XML として) 作成、バージョン管理、ダンプすることができます。
MakePri.exe を使用して手動でリソースをコンパイルする MakePri.exe は、PRI ファイルを作成およびダンプするために使用できるコマンド ライン ツールです。 このツールは、Microsoft Visual Studio の MSBuild の一部として統合されていますが、パッケージを手動で作成したり、カスタム ビルド システムを使って作成する場合にも使うことができます。
レガシ アプリやゲームで Windows 10 のリソース管理システムを使用する .NET または Win32 アプリやゲームを .msix または .appx パッケージとしてパッケージ化することにより、リソース管理システムを活用して実行時のコンテキストに合わせたアプリ リソースを読み込むことができます。 この詳細なトピックでは、この手法について説明します。

「言語、スケール、ハイ コントラストに合わせたタイルとトースト通知のサポート」も参照してください。