meta-data的使用
<meta-data android:name="string" android:resource="resource specification" android:value="string"/>
它可以被包括在如下组件中:
<activity>
<activity-alias>
<service>
<receiver>
meta-data使用name-value名值对的格式给其父组件提供任意可选的数据。一个组件元素能够包含任意多个<meta-data>子元素,所有这些元素中定义的值会被收集到一个Bundle对象中,并且提供给组件的PackageItemInfo.metaData属性字段。
通常值是通过其value属性来指定的。但是,也可以使用resource属性来代替,把一个资源ID跟值进行关联。
例如,下面的代码就是把存储在@string/kangaroo资源中的值跟”zoo”名称进行关联:<meta-data android:name="zoo" android:value="@string/kangaroo" />
另一个方面,使用resource属性会给zoo分配一个数字资源ID,而不是保存在资源中的值。例如:<meta-data android:name="zoo" android:resource="@string/kangaroo" />
注意:这里保存的是对应的Id,而不是保存的Id对应的资源。 所以要取得android:resource对应的值得话,首先通过Bundle的getInt()方式取得对应的Id,然后根据这个资源Id获取资源文件中的值。
注意:要避免使用多个独立的<meta-data>实体来提供相关的数据。相反如果有复杂的数据要跟组件关联,那么把数据作为资源来保存,并使用resource属性,把相关的资源ID通知给组件。
属性介绍如下:
android:name 唯一名称。使用Java样式的命名规则来确保名称的唯一性,例如:com.example.project.activity.fred。
android:resource 要引用的资源。资源的ID会跟这个项目进行关联。通过Bundle.getInt()方法能够从meta-data的Bundle对象中获取这个ID。
android:value 对应的值
下表列出了可能分配的数据的数据类型,以及获取这些数据的方法:
类型 Bundle对象方法
字符串。对于一个Unicode字符,要使用双斜线(\\)来进行转义,如\\n和\\uxxxx getString()
整数值,如100 getInt()
布尔值,true或false getBoolean()
颜色值,如#rgb、#argb、#rrggbb、#aarrggbb getString()
浮点值,如1.23 getFloat()
被引入版本(INTRODUCED IN):
API Level 1
在清单文件中设置过后,在java文件中获取相应的值,不同的父元素,在应用时读取的方法略有不同。
1 :在Activity中:
<activity...>
<meta-data android:name="name" android:value="value"></meta-data>
</activity>
ActivityInfo info=this.getPackageManager()
.getActivityInfo(getComponentName(),
PackageManager.GET_META_DATA);
String value=info.metaData.getString("name");
2:在application中
<application...>
<meta-data android:name="name" android:value="value" ></meta-data>
</application>
ApplicationInfo appInfo = this.getPackageManager()
.getApplicationInfo(getPackageName(),
PackageManager.GET_META_DATA);
String value=appInfo.metaData.getString("name");
3:在service中:
<service android:name=".MetaDataService">
<meta-data android:name="name" android:value="value" ></meta-data>
</service>
ComponentName cn=new ComponentName(this, MetaDataService.class);
ServiceInfo info=this.getPackageManager()
.getServiceInfo(cn, PackageManager.GET_META_DATA);
String value=info.metaData.getString("name");
4: 在receiver中:
<receiver android:name=".MetaDataReceiver">
<meta-data android:value="value" android:name="name"></meta-data>
<intent-filter>
<action android:name="android.intent.action.PHONE_STATE"></action>
</intent-filter>
</receiver>
ComponentName cn=new ComponentName(context, MetaDataReceiver.class);
ActivityInfo info=context.getPackageManager()
.getReceiverInfo(cn, PackageManager.GET_META_DATA);
String value=info.metaData.getString("name");
前面提到Meta-data中的内容会被收集到一个Bundle对象中,并且提供给组件的PackageItemInfo.metaData属性字段。我们可以通过调用PackageItemInfo 对象的metaData属性获得。而上边的例子中ActivityInfo ServiceInfo ApplicationInfo都是直接或者间接继承自PackageItemInfo 。