meta-data

meta-data的使用

在使用社会化分享Sdk的时候，经常会看到需要在我们的清单文件中使用 meta-data。下面就总结下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 。

即：AppliacationInfo 直接继承自PackageItemInfo  ，而ActivityInfo ServiceInfo继承自ComponentInfo，ComponentInfo继承自PackageItemInfo 。

注意获取相应的PackageItemInfo值的时候， AppliacationInfo需要传递包名，其他的传递ComponentName,所以需要构造一个 ComponentName对象

而不应该使用getComponentName()方式，本方法返回当前组件。可能获取Meta-data值得地方不在对应的组件中。