# @capawesome-team/capacitor-android-battery-optimization 中文文档
规范地址：https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/
版本：8\.0\.1
npm 元数据更新时间：2026-02-19T07:38:46.149Z
中文译文更新时间：2026-11-09T04:27:26.518Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40capawesome-team/capacitor-android-battery-optimization
原文对照：https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/?lang=original
项目主页：https://capawesome.io/plugins/android-battery-optimization/
源码仓库：https://github.com/capawesome-team/capacitor-plugins
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：23.4 kB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2023-10-21T14:40:47.295Z
- 最新版本发布：2026-02-19T07:38:45.841Z
- 近 30 天下载量：24599（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 2 个）
## 中文简介
在Android上访问电池优化设置的电容插件.
## 安装
```sh
npm install @capawesome-team/capacitor-android-battery-optimization
```
也可以使用：`pnpm add @capawesome-team/capacitor-android-battery-optimization`、`yarn add @capawesome-team/capacitor-android-battery-optimization`、`bun add @capawesome-team/capacitor-android-battery-optimization`
## README
# @capawesome-team/电容-和机器人-电池-优化
Android用于管理电池优化设置的Capacitor插件,请求豁免,并增强多泽和App备用模式下的应用性能.
[](https://cloud.capawesome.io/)
## 兼容性
| 插件版本 | 电容版本 | 状态 |
| --- | --- | --- |
| 8.x.x (英语) | \>=8.x.x | 积极支持 |
## 安装
```bash
npm install @capawesome-team/capacitor-android-battery-optimization
npx cap sync
```
### 机器人
此 API 需要将以下权限添加到您 `AndroidManifest.xml` 之前 `application` 标签,如果您想要请求直接豁免电源管理特性:
```xml
```
⚠️ **请注意**:Google Play政策禁止应用软件在Android 6.0+(Doze and App Suple)中请求直接豁免电源管理功能,除非该应用的核心职能受到不利影响. [来源](https://developer.android.com/training/monitoring-device-state/doze-standby.html#support_for_other_use_cases)
## 配置
此插件不需要配置 .
## 演示
这里有一个实例: [robingenz/电容器-插管-demo](https://github.com/robingenz/capacitor-plugin-demo)
| 机器人 |
| --- |
|  |
## 使用量
```typescript
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 密码
- [`isBatteryOptimizationEnabled()`](https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/#readme-isbatteryoptimizationenabled)
- [`openBatteryOptimizationSettings()`](https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/#readme-openbatteryoptimizationsettings)
- [`requestIgnoreBatteryOptimization()`](https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/#readme-requestignorebatteryoptimization)
- [接口](https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/#readme-interfaces)
### 是Batterry Optimization 启用()
```typescript
isBatteryOptimizationEnabled() => Promise
```
返回是否启用电池优化 .
只能从Android上找到.
**回返情况:** `Promise<[IsBatteryOptimizationEnabledResult](https://npmcn.com/package/%40capawesome-team/capacitor-android-battery-optimization/#readme-isbatteryoptimizationenabledresult)>`
**自:** 0.0.1 资源
* * *
### 打开电池 Optimization 设置
```typescript
openBatteryOptimizationSettings() => Promise
```
打开电池优化设置页面.
只能从Android上找到.
**自:** 0.0.1 资源
* * *
### 请求忽略Batterry Optimization ()
```typescript
requestIgnoreBatteryOptimization() => Promise
```
请求电池优化忽略权限 . 这种方法需要 `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` 请出示许可. 只有在您的应用满足可接受的使用大小写(参见Google Play Policy)时才使用这种方法.
只能从Android上找到.
**自:** 0.0.1 资源
* * *
### 接口
#### BatteriOptimization 启用结果
| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`enabled`** | `boolean` | 是否启用电池优化 . | 0.0.1 资源 |
## 更改日志
见 [变动情况](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-battery-optimization/CHANGELOG.md)。 。 。 .
## 许可证
见 [自由主义](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-battery-optimization/LICENSE)。 。 。 .
## 常见问题
### @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 和提交记录判断。