構文:

<meta-data android:name="string"
           android:resource="resource specification"
           android:value="string" />

上位の要素:

<activity>
<activity-alias>
<application>
<provider>
<receiver>
<service>

説明:

親コンポーネントに提供可能な任意の追加データアイテムの名前と値のペア。コンポーネント要素には任意の数の <meta-data> サブ要素を含めることができます。すべてのサブ要素の値が 1 つの Bundle オブジェクト内に集められ、コンポーネントで PackageItemInfo.metaData フィールドとして利用できます。

通常の値は value 属性で指定します。リソース ID を値として割り当てるには、代わりに resource 属性を使用します。たとえば、以下のコードは、@string/kangaroo リソースにどのような値が格納されていても、名前として zoo に割り当てます。

<meta-data android:name="zoo" android:value="@string/kangaroo" />

一方、resource 属性を使用すると、リソースに格納されている値ではなく、リソースの数値 ID が zoo に割り当てられます。

<meta-data android:name="zoo" android:resource="@string/kangaroo" />

関連データを複数の個別 <meta-data> エントリとして提供しないようにすることを、強くおすすめします。そうではなく、コンポーネントに関連付ける複雑なデータがある場合はリソースとして保存し、resource 属性を使用してコンポーネントにその ID を伝えます。

属性:

android:name

アイテムの一意の名前。名前を一意にするには、Java スタイルの命名規則（「com.example.project.activity.fred」など）を使用します。

android:resource

リソースへの参照。リソースの ID はアイテムに割り当てられた値です。ID は、Bundle.getInt() メソッドを使用してメタデータ Bundle から取得します。

android:value

アイテムに割り当てられた値。以下の表に、値として割り当てることができるデータ型と、コンポーネントでこれらの値を取得する場合に使用する Bundle メソッドを示します。

タイプ	Bundle メソッド
文字列: 二重バックスラッシュ（\\）を使用して文字をエスケープします。たとえば、改行の場合は \\n、Unicode 文字の場合は \\uxxxxx です。	getString()
整数: 100 など	getInt()
ブール値: true または false	getBoolean()
カラー: #rgb、#argb、#rrggbb、#aarrggbb の形式	getInt()
浮動小数点数: 1.23 など	getFloat()

導入時の API レベル:

API レベル 1