更新记录

1.0.3（2026-08-20） 下载此版本

• 安卓市场列表的 packageName 改为 packageNames 数组，同一渠道支持配置多个包名，按顺序依次尝试
• OPPO 市场适配：安卓 9 以下 com.oppo.market，安卓 9 及以上 com.heytap.market，按系统版本排序后再轮询
• 包名支持 minAndroid / maxAndroid 版本区间，命中当前系统版本的包名优先，未命中的排在后面兜底
• openAppstore / review 新增 storeList 参数，可自定义安卓市场列表
• 渠道优先排序改为调用时计算，避免模块加载时 plus 未就绪

1.0.2（2026-02-26） 下载此版本

增加 TypeScript 类型定义

1.0.1（2025-09-27） 下载此版本

增加通用评分方法，优先 iOS 应用内评分，不可用则跳转 App Store/安卓市场

平台兼容性

uni-app(4.81)

uni-app x(4.81)

其他

📦 uni-app iOS / Android 应用评分 & 应用市场插件

一个用于 uni-app 的评分和应用市场跳转插件，支持：

• iOS 系统评分弹窗（SKStoreReviewController）
• 跳转到 App Store 评论页
• Android 多应用市场轮询打开应用详情页或评分页
• 跨平台统一调用接口

⚠️ 该插件不仅可以让用户对应用进行评论，也可以直接打开应用市场，用于引导用户查看应用详情、评分或下载更新。

🚀 安装

将 uni_modules/dh-store-review 放入项目中即可，无需额外依赖。

📖 使用方法

import { iosRequestReview, openAppstore, review } from '@/uni_modules/dh-store-review/index.js';

// iOS 系统评分弹窗
iosRequestReview();

// 跳转到 App Store / Android 应用市场（可用于评论或查看应用）
openAppstore({
  iosAppId: '1234567890',
  androidPkg: 'com.example.app',
  action: 'write-review', // 可选值，ios设置为write-review，可以打开应用市场评论
});

// 通用评分方法，优先iOS应用内评分，不可用则跳转 App Store/安卓市场
review({
  iosAppId: '1234567890',
  androidPkg: 'com.example.app',
});

🔑 API 说明

iosRequestReview()

触发 iOS 系统评分弹窗（仅 iOS 平台可用）。

• 系统会根据 Apple 规则决定是否显示弹窗。
• Apple 规定同一用户一年最多显示 3 次。

openAppstore(options)

跳转 App Store 或 Android 应用市场，既可以用于评论，也可以查看应用详情。

参数说明：

Android 会尝试当前设备安装的应用市场，如果都未安装，会 fallback 到网页。

🤖 安卓市场列表说明

每个渠道的 packageNames 是一个数组，用于兼容同一厂商的多个市场包名，轮询时按数组顺序依次尝试。

数组元素可以是字符串，也可以是带版本区间的对象：

排序规则：

1. plus.runtime.channel 对应的渠道排最前；
2. 同一渠道内，命中当前系统版本的包名优先，未命中的排在后面兜底（版本判断不一定 100% 准确，保留兜底更稳）。

典型场景是 OPPO：安卓 9 以下是 com.oppo.market，安卓 9 及以上换成了 com.heytap.market。

openAppstore({
  androidPkg: 'com.example.app',
  storeList: [
    {
      channel: 'oppo',
      packageNames: [
        { name: 'com.heytap.market', minAndroid: 9 },
        { name: 'com.oppo.market', maxAndroid: 9 },
      ],
    },
    { channel: 'xiaomi', packageNames: ['com.xiaomi.market'] },
  ],
});

📌 特点

• 跨平台：同时支持 iOS 和 Android
• Android 多市场兼容：轮询常见应用市场，优先打开默认渠道
• 功能多样：不仅评分，还能打开应用市场查看应用详情
• 独立函数封装：按需导入，不依赖统一对象

🛠 插件目录结构

uni_modules/
 └── dh-store-review/
      ├── package.json
      ├── index.js
      └── readme.md

📜 License

MIT