我太懂这种踩坑的感觉了——做系统级开发或者深度定制的时候，SDK自带的android.jar确实会因为只包含公开API，导致各种隐藏类、系统注解找不到的问题，给你梳理几个可行的解决方向：

一、先搞懂核心问题的原因 #

• 关于SystemApi注解：这个注解是Android系统内部用来标记仅系统应用可调用的API的，Google在对外发布的SDK android.jar里故意移除了这类注解和对应的隐藏API，所以你在普通SDK环境里引用肯定会报错。
• 关于缺失的com文件夹：SDK的android.jar是经过裁剪的，只保留了对外公开的API类，像系统内部的com开头的很多类（比如com.android.internal.*这类）都被剔除了，但源码包里会包含完整的系统代码，所以才会出现源码有但jar里没有的情况。

二、获取完整android.jar的可行方案 #

1. 从AOSP源码编译（最靠谱的官方方式） #

这是获取对应版本完整系统框架jar的标准途径：

• 第一步：下载对应Android版本的AOSP源码，比如你需要的API 30就切换到android-11.0.0_rXX分支。
• 第二步：编译框架模块，在AOSP根目录执行命令：

  make framework -j$(nproc)
  

  编译完成后，完整的框架jar会生成在out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar路径下，这个jar包含了所有系统类、SystemApi注解以及你缺失的com文件夹内容。
• 第三步：替换项目依赖，把这个classes.jar替换掉你当前项目中使用的android.jar，或者在IDE的项目配置里把它设为系统库依赖。

2. 从系统镜像提取（快速但版本匹配要精准） #

如果不想编译整个AOSP，可以从对应版本的系统镜像（比如factory镜像）里提取：

• 解压系统镜像里的system/framework/framework.jar，这个jar就是完整的系统框架文件，包含所有系统类和注解。不过要注意，不同厂商的定制ROM可能会有修改，最好用原生Android镜像的文件。

3. 第三方预编译框架jar（临时应急用） #

有些开发者会把编译好的AOSP框架jar分享出来，你可以找对应版本的资源，但要注意来源可靠性，避免引入修改过的文件导致兼容性问题。

三、额外提醒 #

用完整系统框架jar开发的应用，属于系统级应用，普通用户无法直接安装，必须通过刷入系统分区、用root权限安装，或者在定制ROM中集成，这点要提前做好心理准备哦。

内容的提问来源于stack exchange，提问作者user14787178