在Android应用开发中，<meta-data>标签是清单文件里用于配置额外数据的重要组件，开发者可以在Application、Activity、Service、Receiver等组件下添加该标签存储键值对参数，后续在代码中读取这些配置实现动态功能调整。
meta-data的基础配置方式
首先我们需要了解<meta-data>在清单文件中的基本配置格式，它通常作为某个组件标签的子标签存在，核心属性是android:name和android:value，前者就是我们要获取的Key，后者是对应的配置值。以下是常见的配置示例：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.metadatademo">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/Theme.MetaDataDemo">
<!-- Application级别的meta-data配置 -->
<meta-data
android:name="app_config_key"
android:value="app_global_config" />
<activity
android:name=".MainActivity"
android:exported="true">
<!-- Activity级别的meta-data配置 -->
<meta-data
android:name="main_activity_key"
android:value="main_page_param" />
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<service android:name=".DemoService">
<!-- Service级别的meta-data配置 -->
<meta-data
android:name="demo_service_key"
android:value="service_param" />
</service>
</application>
</manifest>
不同场景下的meta-data读取方法
读取Application级别的meta-data Key
Application级别的<meta-data>配置在<application>标签下，我们可以通过PackageManager获取应用的ApplicationInfo对象，进而读取其中的meta-data信息。以下是完整的读取代码：
import android.content.Context;
import android.content.pm.ApplicationInfo;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.util.Log;
public class MetaDataUtil {
private static final String TAG = "MetaDataUtil";
/**
* 读取Application级别的meta-data Key对应的值
* @param context 上下文对象
* @param key 要获取的meta-data的name值（即Key）
* @return 对应的配置值，未找到返回null
*/
public static String getApplicationMetaData(Context context, String key) {
try {
// 获取PackageManager实例
PackageManager packageManager = context.getPackageManager();
// 获取当前应用的ApplicationInfo，注意要传入GET_META_DATA标志才能读取meta-data
ApplicationInfo applicationInfo = packageManager.getApplicationInfo(
context.getPackageName(),
PackageManager.GET_META_DATA
);
// 从ApplicationInfo的metaData中获取对应Key的值
Bundle metaData = applicationInfo.metaData;
if (metaData != null) {
return metaData.getString(key);
}
} catch (PackageManager.NameNotFoundException e) {
Log.e(TAG, "获取ApplicationInfo失败", e);
}
return null;
}
}
读取Activity级别的meta-data Key
Activity级别的<meta-data>配置在对应<activity>标签下，读取时需要先获取该Activity的ActivityInfo对象，再提取其中的meta-data。代码示例如下：
import android.content.Context;
import android.content.pm.ActivityInfo;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.util.Log;
public class MetaDataUtil {
private static final String TAG = "MetaDataUtil";
/**
* 读取Activity级别的meta-data Key对应的值
* @param context 上下文对象
* @param activityClassName 目标Activity的完整类名，例如com.example.metadatademo.MainActivity
* @param key 要获取的meta-data的name值（即Key）
* @return 对应的配置值，未找到返回null
*/
public static String getActivityMetaData(Context context, String activityClassName, String key) {
try {
PackageManager packageManager = context.getPackageManager();
// 获取目标Activity的ActivityInfo，传入GET_META_DATA标志
ActivityInfo activityInfo = packageManager.getActivityInfo(
context.getPackageManager().getComponentEnabledSetting(
new android.content.ComponentName(context, activityClassName)
) == PackageManager.COMPONENT_ENABLED_STATE_ENABLED ?
new android.content.ComponentName(context, activityClassName) :
new android.content.ComponentName(context, activityClassName),
PackageManager.GET_META_DATA
);
// 简化写法，直接通过ComponentName获取ActivityInfo
ActivityInfo simpleActivityInfo = packageManager.getActivityInfo(
new android.content.ComponentName(context, activityClassName),
PackageManager.GET_META_DATA
);
Bundle metaData = simpleActivityInfo.metaData;
if (metaData != null) {
return metaData.getString(key);
}
} catch (PackageManager.NameNotFoundException e) {
Log.e(TAG, "获取ActivityInfo失败", e);
}
return null;
}
}
读取Service/Receiver级别的meta-data Key
Service和Receiver的<meta-data>读取逻辑与Activity类似，只是获取的信息对象分别为ServiceInfo和ReceiverInfo，以下是Service的读取示例：
import android.content.Context;
import android.content.pm.PackageManager;
import android.content.pm.ServiceInfo;
import android.os.Bundle;
import android.util.Log;
public class MetaDataUtil {
private static final String TAG = "MetaDataUtil";
/**
* 读取Service级别的meta-data Key对应的值
* @param context 上下文对象
* @param serviceClassName 目标Service的完整类名
* @param key 要获取的meta-data的name值（即Key）
* @return 对应的配置值，未找到返回null
*/
public static String getServiceMetaData(Context context, String serviceClassName, String key) {
try {
PackageManager packageManager = context.getPackageManager();
// 获取目标Service的ServiceInfo
ServiceInfo serviceInfo = packageManager.getServiceInfo(
new android.content.ComponentName(context, serviceClassName),
PackageManager.GET_META_DATA
);
Bundle metaData = serviceInfo.metaData;
if (metaData != null) {
return metaData.getString(key);
}
} catch (PackageManager.NameNotFoundException e) {
Log.e(TAG, "获取ServiceInfo失败", e);
}
return null;
}
}
读取时的注意事项
- 读取meta-data时必须传入
PackageManager.GET_META_DATA标志，否则获取到的metaData对象会为空，无法读取到配置的Key和值。 - meta-data的value支持多种类型，除了字符串还可以是数值、布尔值等，读取时需要根据配置的类型调用对应的方法，比如
getInt()、getBoolean()，如果类型不匹配会抛出异常。 - 如果同一个Key在多个组件下都有配置，读取对应组件级别的meta-data时只会获取到该组件下的配置值，不会和其他组件的配置冲突。
- 配置meta-data时，
android:name的Key值建议遵循包名命名规范，避免和其他第三方库的Key重名导致读取错误。
实际调用示例
以下是我们在MainActivity中调用上述工具类读取不同级别meta-data的示例：
import android.os.Bundle;
import android.util.Log;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
private static final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 读取Application级别的meta-data
String appConfig = MetaDataUtil.getApplicationMetaData(this, "app_config_key");
Log.d(TAG, "Application级别的meta-data值：" + appConfig);
// 读取当前Activity级别的meta-data
String activityConfig = MetaDataUtil.getActivityMetaData(this, MainActivity.class.getName(), "main_activity_key");
Log.d(TAG, "Activity级别的meta-data值：" + activityConfig);
// 读取Service级别的meta-data
String serviceConfig = MetaDataUtil.getServiceMetaData(this, "com.example.metadatademo.DemoService", "demo_service_key");
Log.d(TAG, "Service级别的meta-data值：" + serviceConfig);
}
}