@capawesome-team/capacitor-android-battery-optimization

中文文档
8.0.1发布于 2026/02/19MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2.5万

在Android上访问电池优化设置的电容插件.

中文使用文档
文档目录13 节
  1. 兼容性
  2. 安装
  3. 机器人
  4. 配置
  5. 演示
  6. 使用量
  7. API 密码
  8. 是Batterry Optimization 启用()
  9. 打开电池 Optimization 设置
  10. 请求忽略Batterry Optimization ()
  11. 接口
  12. 更改日志
  13. 许可证

@capawesome-team/电容-和机器人-电池-优化

Android用于管理电池优化设置的Capacitor插件,请求豁免,并增强多泽和App备用模式下的应用性能.

兼容性

插件版本电容版本状态
8.x.x (英语)>=8.x.x积极支持

安装

npm install @capawesome-team/capacitor-android-battery-optimization
npx cap sync

机器人

此 API 需要将以下权限添加到您 AndroidManifest.xml 之前 application 标签,如果您想要请求直接豁免电源管理特性:

<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

⚠️ 请注意:Google Play政策禁止应用软件在Android 6.0+(Doze and App Suple)中请求直接豁免电源管理功能,除非该应用的核心职能受到不利影响. 来源

配置

此插件不需要配置 .

演示

这里有一个实例: robingenz/电容器-插管-demo

机器人
Android Demo

使用量

import { Capacitor } from '@capacitor/core';
import { BatteryOptimization } from '@capawesome-team/capacitor-android-battery-optimization';

const isBatteryOptimizationEnabled = async () => {
  if (Capacitor.getPlatform() !== 'android') {
    return false;
  }
  const { enabled } = await BatteryOptimization.isBatteryOptimizationEnabled();
  return enabled;
};

const openBatteryOptimizationSettings = async () => {
  if (Capacitor.getPlatform() !== 'android') {
    return;
  }
  await BatteryOptimization.openBatteryOptimizationSettings();
};

const requestIgnoreBatteryOptimization = async () => {
  if (Capacitor.getPlatform() !== 'android') {
    return;
  }
  await BatteryOptimization.requestIgnoreBatteryOptimization();
};

API 密码

是Batterry Optimization 启用()

isBatteryOptimizationEnabled() => Promise<IsBatteryOptimizationEnabledResult>

返回是否启用电池优化 .

只能从Android上找到.

回返情况: Promise<IsBatteryOptimizationEnabledResult>

自: 0.0.1 资源


打开电池 Optimization 设置

openBatteryOptimizationSettings() => Promise<void>

打开电池优化设置页面.

只能从Android上找到.

自: 0.0.1 资源


请求忽略Batterry Optimization ()

requestIgnoreBatteryOptimization() => Promise<void>

请求电池优化忽略权限 . 这种方法需要 REQUEST_IGNORE_BATTERY_OPTIMIZATIONS 请出示许可. 只有在您的应用满足可接受的使用大小写(参见Google Play Policy)时才使用这种方法.

只能从Android上找到.

自: 0.0.1 资源


接口

BatteriOptimization 启用结果

Prop类型说明自兹
enabledboolean是否启用电池优化 .0.0.1 资源

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .

版本与发布记录

@capawesome-team/capacitor-android-battery-optimization 共发布 5 个版本,首次发布于 2023/10/21;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.0.1latest2026/02/198 个月前
8.0.02025/12/1710 个月前
7.0.02025/01/301.8 年前
6.0.02024/04/172 年前
5.0.02023/10/213 年前

关于 @capawesome-team/capacitor-android-battery-optimization 的常见问题

@capawesome-team/capacitor-android-battery-optimization 是什么?

在Android上访问电池优化设置的电容插件.

如何安装 @capawesome-team/capacitor-android-battery-optimization?

在项目目录运行 npm install @capawesome-team/capacitor-android-battery-optimization,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capawesome-team/capacitor-android-battery-optimization 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capawesome-team/capacitor-android-battery-optimization 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capawesome-team/capacitor-android-battery-optimization 可以商用吗?

@capawesome-team/capacitor-android-battery-optimization 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capawesome-team/capacitor-android-battery-optimization 的下载量有多少?

根据 npm 官方下载统计,@capawesome-team/capacitor-android-battery-optimization 在 2026/10/09 – 2026/11/07 这 30 天内被下载 24,599 次,日均约 820 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capawesome-team/capacitor-android-battery-optimization 还在维护吗?

最新版本 8.0.1 发布于 2026/02/19(8 个月前);至今共发布 5 个版本,其中过去 12 个月发布了 2 个;首次发布于 2023/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。