Android 中如何调用被 @hide 隐藏的方法?
可以尝试通过反射调用,但普通 Android 应用没有受支持的开关,可以将 @hide 方法变成能稳定调用的公开 API。反射能否成功,取决于设备上的实现和非 SDK 接口限制。如果只是格式化日志,建议用公开常量自行生成描述。
为什么 public 方法仍然无法编译
/** @hide */ 是源码中的文档标记,不是 Java 注解。Android 构建工具会根据这个标记,将相关接口排除在公开 SDK 之外。
应用通常使用 SDK 中的 android.jar 编译,其中的 API 桩没有这个隐藏方法的声明。所以,即使系统源码将方法声明为 public,编译器也找不到它。关闭 Android Studio 检查,或添加 @SuppressLint、@SuppressWarnings,都无法补上缺失的方法声明。
编译和运行时需要分别看:
- 编译时,SDK 是否包含方法声明。
- 运行时,设备是否提供该方法,以及是否允许应用访问。
编译问题解决后,运行时仍可能调用失败。
如何通过反射尝试调用
反射按方法名查找接口,无须在编译时直接引用隐藏方法。前提是目标设备包含该方法,并且允许当前应用通过反射访问。
import android.media.AudioFormat;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
private static String tryEncodingDescription(int encoding) {
try {
Method method = AudioFormat.class.getDeclaredMethod(
"toLogFriendlyEncoding", int.class);
// static 方法不需要实例,接收对象传 null。
Object result = method.invoke(null, encoding);
if (result instanceof String) {
return (String) result;
}
} catch (NoSuchMethodException
| IllegalAccessException
| InvocationTargetException
| SecurityException ignored) {
// 日志辅助功能失败时,保留原始编码值。
}
return "encoding(" + encoding + ")";
}
调用方式:
Log.d(TAG, "encoding: " + tryEncodingDescription(AUDIO_ENCODING));
参数类型必须写成 int.class,与原方法的 int 参数对应。
题中的方法是 public,因此这里不需要调用 setAccessible(true)。这个调用也不是绕过 Android 非 SDK 接口限制的通用办法。
为什么反射不能保证可用
从 Android 9(API 28)开始,Android 限制应用访问非 SDK 接口,反射和 JNI 都在限制范围内。具体行为取决于系统版本、应用的 targetSdkVersion,以及该接口在对应系统中的限制类别。因此,不能笼统地说所有隐藏方法都能调用,或都不能调用。
通过反射查找受限制的方法时,可能会遇到 NoSuchMethodException。系统更新也可能修改或移除隐藏接口。在某台设备上调用成功,只说明该设备和当前应用配置允许这次调用。
即使方法只是返回字符串,没有明显的安全风险,也不享有公开 API 的兼容性承诺。使用包含隐藏声明的编译桩或平台内部 JAR,同样只能解决编译阶段的问题。
只为输出日志时,如何减少维护
只映射应用实际使用的公开编码常量即可,无须复制系统方法的完整实现:
private static String encodingDescription(int encoding) {
switch (encoding) {
case AudioFormat.ENCODING_PCM_8BIT:
return "ENCODING_PCM_8BIT";
case AudioFormat.ENCODING_PCM_16BIT:
return "ENCODING_PCM_16BIT";
default:
return "encoding(" + encoding + ")";
}
}
Log.d(TAG, "encoding: " + encodingDescription(AUDIO_ENCODING));
这样可以使用应用自己的日志格式,无须与系统内部字符串逐字保持一致。应用新增支持的编码时,再补充相应分支;未识别的值仍以数字形式保留。
如果必须取得当前设备内部方法返回的原始文本,可以保留反射尝试,并在失败时回退,但录音、播放等业务功能不应依赖这个方法。
备注:内容仅供参考。
