Android 之 Metadata简析

Metadata是什么

Google官方文档上这样解释

简单来说，Metadata直译为“元数据”，metadata是一组供父组件使用的名值对（name-value pair），因此相应的meta-data元素应该定义在相应的组件中。即如果想在activity中使用metadata，那么meta-data必须定义在AndroidManifest.xml的activity声明中。该标签可为<activity>、<activity-alias>、<application>、<provider>、<receiver>、<service>等组件提供附加数据项。组件元素可以包含任意数量的子元素。系统将meta-data配置的数据存储于一个Bundle对象中，可以通过PackageItemInfo.metaData字段获取。

使用特性

strings和meta-data看起来似乎并没有什么太大区别，但实际上有作用域的问题，strings只能在应用本地被读取，而处于AndroidManifests.xml下的meta-data则是对外界开放的，是向系统注册的信息，系统及外界是可以通过PackageInfo相关API获取到meta-data的信息的，二者关系可以形象一点看待是私有和公有的关系。

使用语法

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

android:name

分配给该标签的键，即唯一名称。为确保名称唯一应使用Java风格命名约定，如“
com.example.project.activity.fred”。

android:resource

对资源的引用，如“@string/app_name”。该资源ID可以通过该metaData.getInt()方法获取 。

android:value

分配给该标签的值，如String、Boolean等。

Metadata具体用法

在AndroidMainfest.xml中：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="me.fwl.metadatademo">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <!--Application的MetaData的配置-->
        <meta-data android:name="applicationMetadataKey" android:value="applicationMetadataValue"/>
        <activity android:name=".MainActivity">
            <!--Activity的MetaData的配置-->
            <meta-data android:name="activityMetadataKey" android:value="activityMetadataValue"/>
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <receiver android:name=".MainReceiver">
            <!--Receiver的MetaData的配置-->
            <meta-data android:name="receiverMetadataKey" android:value="receiverMetadataValue"/>
        </receiver>
        <service android:name=".MainService">
            <!--Service的MetaData的配置-->
            <meta-data android:name="serviceMetadataKey" android:value="serviceMetadataValue"/>
        </service>
    </application>

</manifest>

在mainActivity中：

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private TextView result;
    private Context mContext;
    private ComponentName cn;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mContext = this;
        cn = this.getComponentName();
        result = (TextView) findViewById(R.id.result);
        findViewById(R.id.app).setOnClickListener(this);
        findViewById(R.id.act).setOnClickListener(this);
        findViewById(R.id.rec).setOnClickListener(this);
        findViewById(R.id.ser).setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.app:
                try {
                    ApplicationInfo appInfo = mContext.getPackageManager().getApplicationInfo(mContext.getPackageName(), PackageManager.GET_META_DATA);
                    String appMV = appInfo.metaData.getString("applicationMetadataKey");
                    result.setText(appMV);
                } catch (PackageManager.NameNotFoundException e) {
                    e.printStackTrace();
                }
                break;
            case R.id.act:
                try {
                    ActivityInfo actInfo = mContext.getPackageManager().getActivityInfo(cn, PackageManager.GET_META_DATA);
                    String actMV = actInfo.metaData.getString("activityMetadataKey");
                    result.setText(actMV);
                } catch (PackageManager.NameNotFoundException e) {
                    e.printStackTrace();
                }

                break;
            case R.id.rec:
                ComponentName recCn = new ComponentName(mContext, MainReceiver.class);
                try {
                    ActivityInfo recInfo = mContext.getPackageManager().getReceiverInfo(recCn, PackageManager.GET_META_DATA);
                    String recMV = recInfo.metaData.getString("receiverMetadataKey");
                    result.setText(recMV);
                } catch (PackageManager.NameNotFoundException e) {
                    e.printStackTrace();
                }
                break;
            case R.id.ser:
                ComponentName serCn = new ComponentName(mContext, MainService.class);
                try {
                    ServiceInfo serInfo = mContext.getPackageManager().getServiceInfo(serCn, PackageManager.GET_META_DATA);
                    String serMV = serInfo.metaData.getString("serviceMetadataKey");
                    result.setText(serMV);
                } catch (PackageManager.NameNotFoundException e) {
                    e.printStackTrace();
                }
                break;
        }
    }
}

运行结果：

05-22 21:21:04.624 14238-14238/com.fedming.notches D/fdm:  meta_app : value from meta_app
05-22 21:21:04.625 14238-14238/com.fedming.notches D/fdm:  meta_act_id : 2131427357, meta_act_string : Notche

可以看到，我们在manifest中配置了，并在Activity中获取了这些配置的信息。
我们点进去看一下源码，metaData到底是什么？本质上就是个Bundle。

实际应用

在系统属性配置、配置屏幕支持比例，配置SearchableActivity等方面都有运用。

分享时：

<meta-data
      android:name="UMENG_APPKEY"
      android:value="000011111" />

配置桌面快捷方式时：

<meta-data
       android:name="android.app.shortcuts"
       android:resource="@xml/shortcuts" />

屏幕适配时：

<meta-data
      android:name="android.max_aspect"
      android:value="2.1" />

配置地图API时：

<meta-data
      android:name="com.amap.api.v2.apikey"
      android:value="oooooooooooooxxxxxxxxxxxx" />

我们接入某分享、某地图、其他私有第三方SDK时，一般都要先申请一个账号，用于接入配置。SDK则会在内部代码中读取这些数据，通过这些key标记来源的信息，分辨接入方，进行访问控制、数据统计等。
其实不知不觉之中，开发者接入了这些SDK，App运营中产生的一些数据也就分享给SDK开发商了，包括使用频率、用户画像等等。