# @capawesome/capacitor-app-review 中文文档

规范地址：https://npmcn.com/package/%40capawesome/capacitor-app-review/

版本：8\.1\.0
npm 元数据更新时间：2026-10-05T09:21:13.239Z
中文译文更新时间：2026-11-09T02:23:47.520Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capawesome/capacitor-app-review
原文对照：https://npmcn.com/package/%40capawesome/capacitor-app-review/?lang=original
项目主页：https://capawesome.io/docs/sdks/capacitor/app-review/
源码仓库：https://github.com/capawesome-team/capacitor-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：39.6 kB，31 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2024-11-25T13:14:05.072Z
- 最新版本发布：2026-10-05T09:21:12.890Z
- 近 30 天下载量：128141（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 5 个）

## 中文简介

Capacitor插件,允许用户在Android和iOS上提交应用商店评论和评分.

## 安装

```sh
npm install @capawesome/capacitor-app-review
```

也可以使用：`pnpm add @capawesome/capacitor-app-review`、`yarn add @capawesome/capacitor-app-review`、`bun add @capawesome/capacitor-app-review`

## README

# 电容应用程序审查插件

允许用户提交应用商店评论和评分的Capacitor插件.

[![Deliver Live Updates to your Capacitor app with Capawesome Cloud](https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1)](https://cloud.capawesome.io/)

## 使用大小写

App Review插件一般用于收集更多App 商店的收视率和评论,例如:

-   **申请审查提示**:在任务完成后等积极时刻询问评分,用户不离开应用程序.
-   **评分此应用程序按钮**: 从设置中的按钮或屏幕上直接打开应用程序存储页面.
-   **反馈流量**: 将满意的用户从您自己的反馈对话框到本地审查对话框或应用程序商店审查页面.

## 兼容性

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

## 安装

你可以用我们的 **AI 辅助设置** 以安装插件. 添加数据 [超级技能](https://github.com/capawesome-team/skills) 至您的 AI 工具,使用以下命令:

```bash
npx skills add capawesome-team/skills --skill capacitor-plugins
```

然后使用下列提示:

```
 Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-app-review` plugin in my project.
```

如果你喜欢 **手动设置**,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

```bash
npm install @capawesome/capacitor-app-review
npx cap sync
```

### 机器人

#### 变量

如果需要, 您可以在您的应用程序中定义以下工程变量 `variables.gradle` 要更改依赖的默认版本的文件 :

-   `$androidPlayReviewVersion` 版本 `com.google.android.play:review` (默认 : `2.0.2`(中文(简体) )

如果您在工程中遇到其它插件的依赖性冲突, 这会有所帮助 .

## 配置

此插件不需要配置 .

## 使用量

以下例子显示如何请求在应用中审查并打开应用商店页面.

### 请求进行申请审查

显示本地的应用程序内审查对话框, 这样用户就可以对您的应用程序进行评分而不离开它 。 请注意,关于iOS,审查请求仅限于每年3个请求. 仅在Android,以及iOS 14及后作:

```typescript
import { AppReview } from '@capawesome/capacitor-app-review';

const requestReview = async () => {
  await AppReview.requestReview();
};
```

### 打开应用程序存储页面

为当前应用程序打开 App Store 页面,如果可能,打开对话框离开审查. 在iOS上,您可以通过 iOS 传递您的应用程序的 Apple ID `appId` 选项。 仅在Android和iOS上提供:

```typescript
import { AppReview } from '@capawesome/capacitor-app-review';

const openAppStore = async () => {
  await AppReview.openAppStore();
};
```

## API 密码

-   [`openAppStore(...)`](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-openappstore)
-   [`requestReview()`](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-requestreview)
-   [接口](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-interfaces)

### 打开 AppStore (...)

```typescript
openAppStore(options?: OpenAppStoreOptions | undefined) => Promise<void>
```

为当前应用程序打开 App Store 页面,如果可能,打开对话框离开审查.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[OpenAppStoreOptions](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-openappstoreoptions)` |

**自:** 6.0.0 (单位:千美元)

* * *

### 请求审查( )

```typescript
requestReview() => Promise<void>
```

要求进行申请审查.

**请注意**:关于iOS,审查请求限于每年3个请求.

仅在Android和iOS(14+)上提供.

**自:** 6.0.0 (单位:千美元)

* * *

### 接口

#### OpenAppStore 选项

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`androidStorePackageName`** | `string` | 商店应用程序的软件包名称应该打开应用程序商店条目(例如. `com.android.vending` 用于谷歌游戏商店). 如果未提供,则系统默认处理器用于 `market://` 链接将被使用。 只能从Android上找到. | 8.1.0 联合国 |
| **`appId`** | `string` | 在 App Store 打开的应用程序的应用ID 。 打开 **iOS系统**,这是您的应用程序的苹果标识(例如. `123456789`) (中文(简体) ). 您可以在您的应用商店条目的URL中找到ID( 如. `https://apps.apple.com/app/id123456789`) (中文(简体) ). **请注意**: iOS上需要这个选项. 仅在iOS上可用. | 6.0.1 国家 |

## 测试

为了测试In-App审查功能,您需要遵循各自平台提供的指示:

-   [机器人](https://developer.android.com/guide/playcore/in-app-review/test)
-   [iOS系统](https://developer.apple.com/documentation/storekit/skstorereviewcontroller/3566727-requestreview#4278434)

## 财务问题

### 为什么内部应用审查对话框没有出现?

操作系统决定审查对话框是否实际显示. 在 iOS 上,审查请求以每年3个请求为限,所以对话框可能不会每次调用时都出现 `requestReview()`两个平台对测试都有特殊要求,参见 [测试](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-testing) 用于官方指示的章节.

### 两者有什么区别 `requestReview` 财务报告和审定财务报表 `openAppStore`? 吗?

这个 `requestReview()` 方法显示本地的应用程序内审查对话框,这样用户就可以对您的应用程序进行评分而不离开它. 这个 `openAppStore(...)` 方法打开当前应用程序的 App Store 页面,如果可能的话,打开对话框将保留一个审查。 使用 `requestReview()` 以温和的音符和 `openAppStore(...)` 对于一个明确的"Rate this app"按钮.

### 我需要提供 `appId`? 吗?

仅在iOS上,在那里 `appId` 选项 `openAppStore(...)` 是您的应用程序的 Apple ID( 例如) . `123456789`) (中文(简体) ). 您可以在您的应用商店条目的URL中找到ID( 如. `https://apps.apple.com/app/id123456789`) (中文(简体) ).

### 我如何测试应用中的审查功能?

您需要遵循相应平台提供的指示,因为应用中的审查在发展和生产环境中表现不同。 Android 和 iOS 的官方测试指南已链接到 [测试](https://npmcn.com/package/%40capawesome/capacitor-app-review/#readme-testing) 节.

### 支持哪些平台?

该插件支持Android和iOS. 这个 `requestReview()` 方法需要iOS 14 或以后 `openAppStore(...)` 方法在Android和iOS上可用.

### 我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

## 相关插件

-   [App 更新](https://capawesome.io/docs/sdks/capacitor/app-update/):协助用户更新本地应用程序.
-   [徽标](https://capawesome.io/docs/sdks/capacitor/badge/): 访问并更新应用程序图标的徽标编号.
-   [安装参考器](https://capawesome.io/docs/sdks/capacitor/install-referrer/): 从 Play 安放参考器和Apple Ad Services 读取安装属性数据.

## 通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 [《卡帕索克通讯》](https://cloud.capawesome.io/newsletter/)。 。 。 .

## 更改日志

见 [变动情况](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-review/CHANGELOG.md)。 。 。 .

## 许可证

见 [自由主义](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-review/LICENSE)。 。 。 .

## 常见问题

### @capawesome/capacitor-app-review 是什么？

Capacitor插件,允许用户在Android和iOS上提交应用商店评论和评分\.

### 如何安装 @capawesome/capacitor-app-review？

在项目目录运行 npm install @capawesome/capacitor-app-review，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capawesome/capacitor-app-review 支持 TypeScript 吗？

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

### @capawesome/capacitor-app-review 支持 ESM 还是 CommonJS？

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

### @capawesome/capacitor-app-review 可以商用吗？

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

### @capawesome/capacitor-app-review 的下载量有多少？

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

### @capawesome/capacitor-app-review 还在维护吗？

最新版本 8\.1\.0 发布于 2026/10/05（1 个月前）；至今共发布 9 个版本，其中过去 12 个月发布了 5 个；首次发布于 2024/11/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。