リソース ユーティリティ

このトピックでは、MUI アプリケーションのビルドに使用される 2 つのユーティリティについて説明します。 MUIRCT は MUI 固有のツールですが、MUI は標準の Windows RC コンパイラ ユーティリティも使用します。 これらのユーティリティを使用する手順については、「 リソースのローカライズとアプリケーションのビルド」を参照してください。

MUIRCT ユーティリティ

MUIRCT (Muirct.exe) は、標準の実行可能ファイルを LN ファイルと言語固有の (つまりローカライズ可能な) リソース ファイルに分割するためのコマンド ライン ユーティリティです。 結果の各ファイルには、ファイル関連付けのリソース構成データが含まれています。 MUIRCT は Windows Vista のMicrosoft Windows SDKに含まれています。

MUIRCT の使用状況

1. rc_configファイルに基づいてバイナリをバイナリファイルとmuiファイルメイン分割します。

   Muirct -q rc_config [-c checksum_file [-b LangID]] [-x LangID] [-g LangId] [-f] [-m] [-v level] source_file [output_LN_file] [output_MUI_file]

2. checksum_fileからチェックサムを抽出し、output_fileに挿入します。

   Muirct -c checksum_file [-b LangID] -e output_file

3. checksum_fileに基づいてチェックサムを計算し、output_fileに挿入します。

   Muirct -c checksum_file [-b LangID] -q rc_config -z output_file

4. input_fileからリソース構成データの内容をダンプします。

   Muirct -d input_file

MUIRCT 構文

MUIRCT は、コマンド ライン スイッチまたは -q スイッチを使用して指定されたリソース構成ファイルから方向を取得できます。

muirct [-h|-?] [ -c checksum_file] [-b langid]  ]
     [-g langid] [-q resource configuration file<RCF>] [-v level] [-x langid]
     [-e output_file]  [-z output_file] [-f] [-d MUI'ized file] [-m file_version]

source_filename [language_neutral_filename] [mui_filename]

スイッチと引数

MUIRCT 言語出力

MUIRCT は、最も高い優先順位から最も低い順に、次の順序に基づいて LN ファイル リソース構成データに挿入する "UltimateFallbackLanguage" 属性値を選択します。

1. ソース リソース構成ファイルの "UltimateFallbackLanguage" 属性 (入力として渡される場合)。
2. g スイッチで指定された言語。
3. 入力ファイルの言語。

MUIRCT は、次の順序に基づいて 、.mui ファイル リソース構成データに挿入する "language" 属性値を選択します。

1. ソース リソース構成ファイルの "language" 属性 (入力として渡される場合)。
2. -x スイッチで指定された言語 (強制言語)。
3. 入力ファイルの言語。

MUIRCT チェックサム処理

通常、オペレーティング システムは、リソース構成ファイルでチェックサムを指定しない限り、ファイル内の言語固有のリソースに対してチェックサムを計算します。 チェックサムが LN ファイルと関連付けられているすべての言語固有リソース ファイルと、LN と言語依存の一致のリソース構成の言語属性に対して同じである限り、リソース ローダーはリソースを正常に読み込むことができます。

MUIRCT では、リソース構成データに適切なチェックサムを配置するためのいくつかの方法がサポートされています。

1. コードとリソースの両方を含む各言語の実行可能ファイルをビルドします。 その後、MUIRCT を使用して、これらの各ファイルを LN ファイルと言語固有のリソース ファイルに分割します。 MUIRCT は、1 回ずつ複数回実行され、言語ごとにリソース ファイルが生成されます。 ビルドは、次の方法で実行できます。
   1. -q スイッチを使用して、リソース構成ファイルにチェックサム値を指定します。 MUIRCT は、生成されたすべての LN ファイルと言語固有のリソース ファイルにこの値を配置します。 このトピックで後述するように、この値を選択するための戦略を採用する必要があります。
   2. -c スイッチ (および必要に応じて -b スイッチ) を使用して、MUIRCT がチェックサムを抽出するリソースを持つ 1 つの言語を選択します。
   3. -z スイッチを使用して、MUIRCT が常にチェックサムを抽出するリソースを持つ 1 つの言語を選択します。 他の方法を使用してファイルがビルドされた後に、このチェックサムを適用します。
2. 1 つの言語のコードとリソースの両方を含む実行可能ファイルをビルドします。 その後、MUIRCT を使用して、LN ファイルと言語固有のリソース ファイルの間でリソースを分割します。 最後に、バイナリ ローカライズ ツールを使用して、各言語の結果のリソース ファイルを変更します。

チェックサム処理の最も一般的な規則は、英語 (米国) リソースにチェックサムを基にすることです。 LN ファイルごとに一貫性がある限り、異なる規則を自由に採用できます。 たとえば、ソフトウェア開発企業は、すべてのアプリケーションにチェックサムの基になるフランス語 (フランス) リソースがある限り、英語 (米国) リソースではなくフランス語 (フランス) リソースに基づいてチェックサムをベースにすることは、完全に許容されます。 また、リソース構成ファイルを使用して、チェックサムとして最大 16 桁の 16 進数の任意の 16 進値を割り当てることもできます。 この最後の戦略では、MUIRCT の -z、-c、および -b スイッチの効果的な使用が除外されます。 チェックサム値を生成するには、 GuidGen またはその他のツールを使用するメソッドを採用する必要があります。 この方法では、新しいローカライズ可能なリソースを追加するときに値を変更するタイミングを決定するためのポリシーを設定する必要もあります。

英語 (米国) チェックサムをすべてのファイルに適用するには、上記のチェックサム処理方法のいずれかを使用できます。 たとえば、英語 (米国) の LN ファイルと言語固有のリソース ファイルを生成し、MUIRCT -d スイッチを使用して結果のチェックサムを取得できます。 このチェックサムをリソース構成ファイルにコピーし、MUIRCT で -q スイッチを使用して、チェックサムを他のすべてのファイルに適用できます。

MUIRCT でのリソース構成ファイルの使用

MUIRCT を使用する場合は、リソース構成データを指定できます。 リソース構成ファイルを明示的に指定するかどうかに関係なく、すべての言語固有のリソース ファイルには、関連付けられたリソース ファイルを含む LN ファイルと同様に、リソース構成データが含まれます。 次に例を示します。

• -q スイッチを使用してリソース構成ファイルを指定しても、入力ソース ファイルにローカライズ可能なリソースがない場合、言語固有のリソース ファイルは生成されず、結果の LN ファイルにはリソース構成データは含まれません。 また、入力ソース ファイルに多言語リソースがある場合、MUIRCT はファイルを分割しません。

MUIRCT の使用例

標準使用例

muirct -q mui.MMF bar.exe barnew.exe barnew.exe.mui

muirct -d myprog.exe.mui

-d スイッチを使用した LN ファイル出力の例

MUIRCT で -d スイッチを使用して LN ファイルから出力されるリソース構成データの例を次に Shell32.dll します。

Signature          -    fecdfecd
Length             -    148
RC Config Version  -    10000
FileType           -    11
SystemAttributes   -    100
UltimateFallback location    -  external
Service Checksum   -    14f44a8d86bef14af26d9a885964c935
Checksum           -    f5b3b7ab330439d6fcc07582c3afb613
MainNameTypes      -    AVI FTR ORDERSTREAM TYPELIB UIFILE XML MUI
MainIDTypes        -    1 2 3 12 14 16 24
MuiNameTypes       -    MUI
MuiIDTypes         -    2 3 4 5 6 9 14 16
UltimateFallbackLanguage   -   en-US

-d スイッチを使用したリソース ファイル出力の Language-Specific 例

MUIRCT の -d スイッチを使用した .mui ファイル (Shell32.dll.mui) からのリソース構成データ出力の例を次に示します。

Signature          -    fecdfecd
Length             -     c8
RC Config Version  -    10000
FileType           -    12
SystemAttributes   -    100
Service Checksum   -    14f44a8d86bef14af26d9a885964c935
Checksum           -    f5b3b7ab330439d6fcc07582c3afb613
MainNameTypes      -    MUI
MainIDTypes        -    2 3 4 5 6 9 14 16
Language           -    en-US

RC コンパイラ ユーティリティ

RC コンパイラ (Rc.exe) は、リソース定義スクリプト ファイル (.rc 拡張子) をリソース ファイル (.res 拡張子) にコンパイルするためのコマンド ライン ユーティリティです。 RC コンパイラは Windows SDK に含まれています。 このドキュメントでは、リソース ローダーの MUI 関連機能を使用した RC コンパイラの使用についてのみ説明します。 コンパイラの詳細については、「 リソース ファイルについて」を参照してください。

RC コンパイラを使用すると、1 つのソース セット、LN ファイル、および個別の言語固有のリソース ファイルからビルドできます。 MUIRCT に関しては、ファイルはリソース構成データによって関連付けられます。

MUI リソースに使用される RC コンパイラ構文

RC コンパイラ スイッチの詳細については、「 RC の使用」を参照してください。 このセクションでは、MUI リソースの構築に使用されるスイッチのみを定義します。 各スイッチでは大文字と小文字が区別されない点に注意してください。 特に指定がない限り、リソースの種類は言語に依存しないと見なされます。

rc [-h|-?] -fm mui_res_name [-q rc_config_file_name] [-g langid] [-g1 ] [-g2 version]

スイッチと引数

RC コンパイラを使用して MUI リソースを構築する例

MUI リソースを使用した RC コンパイラ操作を示すために、リソース ファイル Myfile.rc の次のコマンド ラインを調べてみましょう。

rc -fm myfile_res.res -q myfile.rcconfig myfile.rc

このコマンド ラインにより、RC コンパイラは次の操作を実行します。

• .rc ファイルの名前に基づいて、言語固有のリソース ファイル Myfile_res.res と、既定で Myfile.res に設定される言語に依存しないリソース ファイルを作成します。
• 2 (項目 5 6 7 8 9 10 11 12)、4、5、6、9、11、16、23、240、1024 MY_TYPEリソースの種類を .rc ファイル内にある場合は、言語固有の .res ファイルに追加します。
• リソース の種類 16 を、リソース ファイルで説明されているその他のリソースの種類と共に、言語に依存しない .res ファイルと言語固有の .res ファイルに追加します。 この例では、リソースの種類 16 が 2 か所に追加されていることに注意してください。
• "UltimateFallbackLanguage" 属性値を選択して、次の条件に基づいて LN ファイル リソース構成データに挿入します。優先順位が最も高いものから最も低いものに並べ替えられます。
  • リソース構成ファイルの "UltimateFallbackLanguage" 属性 (入力として渡される場合)。
  • RC コンパイラ言語の順序に基づいてリソース構成データに挿入する言語属性値 (言語に依存せず、言語固有のリソース ファイル言語)。 考慮事項には、.rc ファイルの言語、-gl スイッチの言語値、英語 (米国) の識別子0x0409などがあります。

注釈

neutralResources 要素に ICON(3)、DIALOG(5)、STRING(6)、または VERSION(16) リソースの種類を含める場合は、リソース構成ファイルの localizedResources 要素でそのエントリを複製する必要があります。

関連トピック

多言語ユーザー インターフェイス リファレンス

MUI リソース管理

リソースのローカライズとアプリケーションの構築