用途:在 Ionic/Capacitor 应用中弹出 App Store / Play Store 的原生评分对话框,由系统负责展示、限流与提交。
主要能力:调用 @capacitor-community/in-app-review 的 InAppReview.requestReview() 触发原生评分提示;系统对调用频率有配额限制,是否真正显示由操作系统决定,应用无法感知用户是否评分。
安装:npm install @capacitor-community/in-app-review,随后执行 npx cap sync。
基本用法:import { InAppReview } from '@capacitor-community/in-app-review'; await InAppReview.requestReview();
推荐触发模式:在用户完成购买、通关、达成里程碑或成功保存等正向时刻调用;建议至少经过若干次会话后再触发,并设置冷却期(示例用 5 次会话、90 天冷却),可用 @capacitor/preferences 记录会话数与上次提示时间。
限制与规则:不要自建“是否愿意评分”的中间 UI;不要每次会话都调用,Apple 可能对整个应用的评分提示做全局限流;不要以奖励换取好评,会被 App Review 与 Play Console 拒绝;系统在配额耗尽时可能静默不显示。
可选回退:可在设置中提供“评价应用”按钮,用 @capacitor/browser 打开商店详情页(iOS 用 itms-apps://itunes.apple.com/app/idAPPSTORE_ID?action=write-review,Android 用 market://details?id=com.company.appname),需替换为实际 ID。
适用场景:需要原生评分 UX 的 Ionic/Capacitor 移动应用。具体配额数值与平台行为以官方文档为准,资料未提供更多细节。