安卓manifest中的meta-data及其应用

前言

在日常的Android开发中，AndroidManifest中总会出现一些< meta-data>标签，或是第三方SDK配置信息，或是系统配置，那么< meta-data>到底是什么？有什么用？怎么用？有哪些应用场景？

一、meta-data简介

< meta-data>

直译为“元数据”，该标签可为< activity>、< activity-alias>、< application>、< provider>、< receiver>、< service>等组件提供附加数据项。
组件元素可以包含任意数量的< meta-data>子元素。系统将meta-data配置的数据存储于一个Bundle对象中，可以通过PackageItemInfo.metaData字段获取。

语法配置

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

• android:name
  分配给该标签的键，即唯一名称。为确保名称唯一应使用Java风格命名约定，如“ com.example.project.activity.fred”。
• android:resource
  对资源的引用，如“@string/app_name”。该资源ID可以通过该metaData.getInt()方法获取 。
• android:value
  分配给该标签的值，如String、Boolean等。

二、meta-data用法

正如前文所说，< meta-data>可用于常见的组件，那么在程序中应该如何配置，并获取这些配置好的外部数据呢？
配置示例：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:sharedUserId="android.uid.system">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />


    <uses-permission
        android:name="android.permission.PACKAGE_USAGE_STATS"
        tools:ignore="ProtectedPermissions" />

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AppCompat.Light"
        tools:targetApi="31">
        <activity
            android:name="com.android.henrytest.iccpanelActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data
                android:name="meta_act"
                android:resource="@string/app_name" />
        </activity>
        <meta-data
            android:name="meta_app"
            android:value="value from meta_app" />
    </application>

</manifest>

获取配置信息示例：

public class testActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ......
        String meta_app = getMetaDataFromApp();
        int meta_act = getMetaDataIdFromAct();
        Log.d("henry", "meta_app: " + meta_app + " meta_act: " + meta_act);
    }


    //获取value
    private String getMetaDataFromApp() {
        String value = "";
        try {
            ApplicationInfo appInfo = getPackageManager().getApplicationInfo(getPackageName(),
                    PackageManager.GET_META_DATA);
            value = appInfo.metaData.getString("meta_app");
        } catch (PackageManager.NameNotFoundException e) {
            e.printStackTrace();
        }
        return value;
    }

    //获取resource id
    private int getMetaDataIdFromAct() {
        int resId = 0;
        try {
            ActivityInfo activityInfo = getPackageManager().getActivityInfo(getComponentName(),
                    PackageManager.GET_META_DATA);
            resId = activityInfo.metaData.getInt("meta_act");
        } catch (PackageManager.NameNotFoundException e) {
            e.printStackTrace();
        }
        return resId;
    }
}

运行结果:

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

三、meta-data应用场景

讲到这里，可能就会有人问了，这个东西什么用啊？我自己程序里用这个配置拿自己的数据，那不是脱裤子放屁？
别急…一开始就说到了< meta-data>这个标签经常是在接入第三方SDK时见到，那么它的应用场景肯定跟SDK开发有关啊！并且在系统属性配置上也有应用，比如配置屏幕支持比例，配置SearchableActivity等等。来看几个示例：
示例一：某分享

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

示例二：桌面快捷方式

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

示例三：18:9屏幕适配

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

示例四：某地图

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

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

我们在开发自己的SDK过程中，也可以使用这种方法控制访问。通过分配账号的方式要求接入方配置相关信息，并在SDK中读取配置好的< meta-data>信息，用于对比鉴权，若无相关匹配账号，则直接抛异常或者返回相关返回码。当然了，账号分配这一步也可以放到后台做，然而并不是所有的SDK接入都需要后台接入，比如分享SDK。

参考链接：

谷歌开发者------元数据