在 Android 框架中,接口的可见性规则

!!!出现问题:当普通应用通过SDK调用接口时遇见AndroidRuntime: java.lang.NoSuchMethodError: No virtual method

得知:Android 中接口访问控制规则说明

在 Android 系统开发中,不同包名下的接口默认访问权限是不一样的。以下是详细的说明。

1. frameworks/base/core/java/android.* 包下新增的接口

  • 默认访问权限:公开(public)
  • 是否可被普通应用直接访问:✅ 是
  • 说明
    • 这些接口属于系统公开 API。
    • 普通应用可以直接调用这些类和方法。
    • 系统应用可以直接调用这些类和方法。

示例:

java 复制代码
package android.app;

public class MyManager {
    public void doSomething() { ... }
}

该方法 doSomething() 可以被任意普通 App 调用。


2. 其他包下新增的接口(如 frameworks/base/core/java/com/android/server, frameworks/base/core/java/com/android/internal,只要不是 frameworks/base/core/java/android.*都是默认隐藏的接口)

  • 默认访问权限:隐藏(hidden)
  • 是否可被普通应用直接访问:❌ 否
  • 是否可被系统应用直接访问:✅ 是
  • 说明
    • Android 从 10 开始加强了对隐藏 API 的限制(Hidden API Policy)。
    • 即使你在 SDK 中能看到这些类或方法,运行时也会被限制访问。
    • 只有系统应用能正常访问

3. 如何开放隐藏接口给普通应用?

使用注解:

java 复制代码
@UnsupportedAppUsage

作用:

  • 标记该方法为"被系统使用",并允许通过反射等方式被普通应用访问。
  • 在构建时,该注解会保留到 public-api.xmlsystem-api.xml 中,避免被标记为 hidden。

示例:

java 复制代码
package com.android.server.myfeature;

import android.annotation.UnsupportedAppUsage;

public class MyInternalService {

    @UnsupportedAppUsage
    public void exposeToApp() {
        // 可以被普通 App 调用
    }
}

添加此注解后,普通应用可以通过以下方式调用:

  • 反射调用;
  • 在调试模式下(开启 --runtime-flags allow-incompatible-changes)直接调用。

⚠️ 注意事项

项目 说明
注解用途 用于兼容性过渡,不建议长期依赖
兼容性风险 使用隐藏 API 有版本升级不兼容的风险
官方推荐 如果需要开放接口,应申请加入 SDK Public API
Android 版本限制 Android 10 及以上加强了 hidden API 控制,需特别注意

🧩 延伸建议

如果你是在系统框架层修改代码,并希望某个接口能被第三方 App 调用,请确保:

  1. 接口所在的类/包不是 @hide
  2. 方法上加上 @UnsupportedAppUsage
  3. 构建时确认其出现在 public-api.xml 中;
  4. App 编译时能找到对应的类和方法(可通过反射或定制 framework.jar)。

相关推荐
你过来啊你2 小时前
Android用户鉴权实现方案深度分析
android·鉴权
kerli4 小时前
Android 嵌套滑动设计思想
android·客户端
恣艺5 小时前
LeetCode 854:相似度为 K 的字符串
android·算法·leetcode
阿华的代码王国6 小时前
【Android】相对布局应用-登录界面
android·xml·java
用户207038619496 小时前
StateFlow与SharedFlow如何取舍?
android
QmDeve6 小时前
原生Android Java调用系统指纹识别方法
android
淹没6 小时前
🚀 告别复杂的HTTP模拟!HttpHook让Dart应用测试变得超简单
android·flutter·dart
HX4367 小时前
MP - List (not just list)
android·ios·全栈