在 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)。

相关推荐
zhangphil20 分钟前
Android理解onTrimMemory中ComponentCallbacks2的内存警戒水位线值
android
你过来啊你30 分钟前
Android View的绘制原理详解
android
移动开发者1号3 小时前
使用 Android App Bundle 极致压缩应用体积
android·kotlin
移动开发者1号3 小时前
构建高可用线上性能监控体系:从原理到实战
android·kotlin
ii_best8 小时前
按键精灵支持安卓14、15系统,兼容64位环境开发辅助工具
android
美狐美颜sdk8 小时前
跨平台直播美颜SDK集成实录:Android/iOS如何适配贴纸功能
android·人工智能·ios·架构·音视频·美颜sdk·第三方美颜sdk
恋猫de小郭13 小时前
Meta 宣布加入 Kotlin 基金会,将为 Kotlin 和 Android 生态提供全新支持
android·开发语言·ios·kotlin
aqi0014 小时前
FFmpeg开发笔记(七十七)Android的开源音视频剪辑框架RxFFmpeg
android·ffmpeg·音视频·流媒体
androidwork16 小时前
深入解析内存抖动:定位与修复实战(Kotlin版)
android·kotlin
梦天201516 小时前
android核心技术摘要
android