OPPO开放平台 应用评论调起能力接入指南
接入OPPO软件商店的评论功能后，可以直接在本应用当前页面调起评论窗口，进行评分和评论，无须跳转至软件商店内。
效果示例：
1、评分和评论会影响您的App在软件商店的排名，优质的评论以及较高的评分，有助于提升App在应用商店的排名。
2、优质的评论以及较高的评分，有助于激发用户下载的欲望，能有效提高自然下载量。
3、一键调起商店评论页面，降低用户评论成本，帮助您更方便高效地收集用户评论
oaps://mk/developer/comment?pkg={callerPkg}
参数说明：
pkg:要拉起评论的应用的包名，必须和调用商店的应用是同一个包名，否则无法拉起商店评论。
示例(游戏中心拉起其在商店的评论页的协议链接)：
oaps://mk/developer/comment?pkg=com.nearme.gamecente
软件商店的版本号(versionCode) >= 84000。
Android 从 R(11) 开始对获取应用包信息做了限制，官方适配文档链接
1）https://developer.android.com/preview/privacy/package-visibility#common-interactions
2）https://developer.android.com/training/basics/intents/package-visibility
兼容方案：（2个方式任意选择一个，推荐方案一）。
在R上 需要在manifest添加标签（该方式，只获取软件商店信息）
<manifest package="com.example.xxxxx">
...
<queries>
<package android:name="com.heytap.market"/>
</queries>
...
</manifest>
说明：
标签可能会编译不过，出现此问题请升级Android Studio 和 Gradle 插件：
1）Android Studio 3.6.1 或更高版本
2）最新版本的 Android Gradle 插件
在manifest添加下申请如下权限：
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />
说明：
使用这种方式，后续Android版本可能会收紧这个权限的申请，存在被禁用风险。
强调：为了使商店评论页面有盖在当前应用之上的效果，必须满足以下条件
1）Context 必须使用 Activity 对象。
2）Intent 不能使用 Intent.FLAG_ACTIVITY_NEW_TASK 这个Flag。
private final static String PKG_MK_HEYTAP = "com.heytap.market";//Q之后的软件商店包名
private final static String PKG_MK_OPPO = "com.oppo.market";//Q之前的软件商店包名
private final static String COMMENT_DEEPLINK_PREFIX = "oaps://mk/developer/comment?pkg=";
private final static int SUPPORT_MK_VERSION = 84000; // 支持评论功能的软件商店版本
/**
* 拉起评论页面。
*/
public static boolean jumpToComment(Activity context) {
// 此处一定要传入调用方自己的包名，不能给其他应用拉起评论页。
String url = COMMENT_DEEPLINK_PREFIX + context.getPackageName();
// 优先判断heytap包
if (getVersionCode(context, PKG_MK_HEYTAP) >= SUPPORT_MK_VERSION) {
return jumpApp(context, Uri.parse(url), PKG_MK_HEYTAP);
}
if (getVersionCode(context, PKG_MK_OPPO) >= SUPPORT_MK_VERSION) {
return jumpApp(context, Uri.parse(url), PKG_MK_OPPO);
}
return false;
}
/**
* 获取目标app版本号~
*
* @param context
* @param packageName
* @return 返回版本号
*/
private static long getVersionCode(Activity context, String packageName) {
long versionCode = -1;
try {
PackageInfo info = context.getPackageManager().getPackageInfo(packageName, PackageManager.GET_META_DATA);
if (info != null) {
versionCode = Build.VERSION.SDK_INT >= Build.VERSION_CODES.P ? info.getLongVersionCode() : info.versionCode;
}
} catch (PackageManager.NameNotFoundException e) {
}
return versionCode;
}
private static boolean jumpApp(Activity context, Uri uri, String targetPkgName) {
try {
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.addCategory(Intent.CATEGORY_DEFAULT);
intent.setPackage(targetPkgName);
intent.setData(uri);
// 建议采用startActivityForResult 方法启动商店页面，requestCode由调用方自定义且必须大于0，软件商店不关注
context.startActivityForResult(intent, 100);
return true;
} catch (Exception e) {
e.printStackTrace();
}
return false;
}
建议：
1）使用Activity做为context，并且调用Activity.startActivityForResult方法拉起商店，这样更安全。
2）如果使用startActivityForResult方法拉起商店，requestCode >0 并且 intent 不能设置Intent.FLAG_ACTIVITY_NEW_TASK这个flag。
