Ionic 4中BatteryStatus电池状态监听无变化问题求助

核心原因归类 #

• 插件调用时机错误：Cordova原生插件必须在Ionic平台完全初始化完成后才能调用，你当前直接在ngOnInit中注册监听，此时原生插件还未加载完成，监听事件没有成功注册到原生层，自然无法触发回调。
• 浏览器端API限制：主流浏览器（Chrome 103+、Firefox、全版本Safari）均已废弃Battery Status API的支持，浏览器环境下本就无法触发监听回调，必须打包到安卓/iOS原生设备上测试。
• 依赖版本不匹配：@ionic-native/battery-status的版本需要和项目的Ionic/Angular大版本保持一致，版本不兼容会导致插件逻辑异常但编译无报错。
• 安卓权限缺失：安卓12（API Level 32）及以上系统要求应用必须申请BATTERY_STATS权限才能读取电池状态信息，未申请权限会导致原生层拒绝返回电池数据。
• 插件安装不完整：依赖安装过程中可能出现静默失败，cordova-plugin-battery-status实际未被添加到项目原生配置中。

修复步骤 #

1. 调整插件调用时机 #

必须等待Platform.ready()回调触发后再注册电池状态监听，参考修改后的代码：

import { Platform } from '@ionic/angular'; // 对应你项目的ionic导入路径
import { Subscription } from 'rxjs';
import { BatteryStatus, BatteryStatusResponse } from '@ionic-native/battery-status/ngx';

// ...组件内代码
batterySubscription: Subscription;
batteryLevel: number = 100;
isBatteryPlugged: boolean = false;

constructor(
  private batteryStatus: BatteryStatus,
  private platform: Platform
) { }

ngOnInit() {
  // 等待平台就绪后再初始化监听
  this.platform.ready().then(() => {
    this.initSubscriptions();
  });
}

initSubscriptions() {
  this.batterySubscription = this.batteryStatus.onChange().subscribe( (status: BatteryStatusResponse) => {
    console.log(status.level, status.isPlugged);
    this.batteryLevel = status.level;
    this.isBatteryPlugged = status.isPlugged;
  });
}

// 组件销毁时取消订阅，避免内存泄漏
ngOnDestroy() {
  this.batterySubscription?.unsubscribe();
}

2. 校验依赖安装 #

• 执行命令ionic cordova plugin ls，确认输出列表中存在cordova-plugin-battery-status
• 核对package.json中@ionic-native/battery-status的版本，与项目Ionic大版本匹配：Ionic 5/6对应5.x版本，Ionic 7+对应6.x版本，版本不匹配可执行对应版本的安装命令修正。

3. 补全安卓权限 #

在项目根目录的config.xml中添加如下配置，打包时会自动注入安卓清单文件：

<platform name="android">
    <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest">
        <uses-permission android:name="android.permission.BATTERY_STATS" />
    </edit-config>
    <!-- 其他安卓配置保持不变 -->
</platform>

4. 测试环境要求 #

所有测试必须在真实的安卓/iOS设备上进行，不要使用浏览器、模拟器测试，部分模拟器对电池状态API的模拟支持不完善也会导致回调不触发。

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