为何android.jar缺失BatteryStatsManager类导致符号无法解析？

问题概述 #

项目已配置compileSdk = 35（API 35，Android 15）和minSdk = 28（API 28，Android 9.0，BatteryStatsManager引入版本），但BatteryStatsManager及相关类（BatteryUsageStats、BatteryUsageStatsQuery、UidBatteryConsumer）始终提示Cannot resolve symbol错误。

错误详情 #

• 错误表现：Android Studio在导入和使用BatteryStatsManager的代码行标记Cannot resolve symbol。
• 排查发现：用7-Zip检查\\AppData\\Local\\Android\\Sdk\\platforms\\android-35\\android.jar及android-28\\android.jar，android/os目录下存在Bundle.class、Build.class、BatteryManager.class，但没有BatteryStatsManager.class。
• 预期：BatteryStatsManager是API 28引入的公开API，compileSdk >=28的android.jar应该包含该类。

已尝试的解决步骤 #

• 重装SDK：通过Tools > SDK Manager > SDK Platforms卸载并重装API 35和API 28，问题未解决。
• 完全重置：卸载Android Studio，删除\\AppData\\Local\\Android\\Sdk后重装，结果一致。
• 清除缓存：执行File > Invalidate Caches / Restart，修复了其他错误但未解决此问题。
• 切换compileSdk：设置compileSdk = 28并安装对应SDK，android-28\\android.jar中仍无该类。

疑问 #

1. 为什么BatteryStatsManager.class不在android.jar中？是SDK的bug还是被刻意排除了？
2. 为什么会出现Cannot resolve symbol错误？是android.jar损坏还是该类的处理方式特殊？
3. 如何解决？我的应用是拥有BATTERY_STATS权限的系统应用，目前可以通过反射getSystemService("batterystats")调用，但希望能直接调用API。

问题原因及解决方案 #

1. 类不在android.jar中的原因 #

BatteryStatsManager属于系统隐藏API，尽管官方文档标注为API 28引入的公开API，但实际上它并未包含在公开的android.jar中，而是属于系统框架层的内部API，Google刻意在公开SDK中排除了这些类，仅允许系统应用或拥有特殊权限的应用通过特定方式访问。

2. 符号无法解析的原因 #

Android Studio依赖公开SDK中的android.jar进行代码编译和语法检查，既然该类不在其中，IDE自然无法识别，从而抛出符号无法解析的错误，这和android.jar是否损坏无关，是Google对该类的特殊处理导致的。

3. 解决方案 #

如果你希望直接调用而非使用反射，有两种可行方式：

方式一：使用系统framework.jar（不推荐）

• 找到对应SDK版本的framework.jar（部分版本需从系统镜像提取，路径通常为\\AppData\\Local\\Android\\Sdk\\platforms\\android-XX\\）。
• 将framework.jar添加到项目依赖中，并设置其优先级高于android.jar，确保编译时优先加载该jar中的类。
• 注意：这种方式存在兼容性风险，后续SDK更新可能导致失效，且Google不推荐非系统应用使用。

方式二：创建存根类（推荐）

• 在项目中手动创建BatteryStatsManager及相关类的存根，模拟官方API的方法签名和结构，编译时IDE会识别这些存根，运行时则调用系统框架中的真实实现（你的系统应用有权限访问对应服务）。
• 示例存根代码：

package android.os;

import android.content.Context;

public class BatteryStatsManager {
    public static final String BATTERY_STATS_SERVICE = "batterystats";

    public static BatteryStatsManager getInstance(Context context) {
        return (BatteryStatsManager) context.getSystemService(BATTERY_STATS_SERVICE);
    }

    public BatteryUsageStats queryBatteryUsageStats(long startTime, long endTime, BatteryUsageStatsQuery query) {
        return null;
    }
    // 按需添加其他需要的方法签名
}

// 配套的BatteryUsageStats存根示例
package android.os;

public class BatteryUsageStats {}

// BatteryUsageStatsQuery存根示例
package android.os;

public class BatteryUsageStatsQuery {}

• 这种方式更稳定，避免了依赖隐藏jar的兼容性问题，同时满足直接调用API的需求。

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