@planbook/nativescript-rater
提醒您的应用程序用户通过 PlayStore 或 AppStore 对应用程序进行评价。喜欢它,给它评分!
npm i --save @planbook/nativescript-rater

Nativescript-rater

npm npm Commitizen friendly

提醒您的应用程序用户通过 PlayStore 或 AppStore 对应用程序进行评价。喜欢它,给它评分!

iOS 10.3 〜

SwiftRater1

对于 iOS 10.3 设备,SwiftRater 使用 SKStoreReviewController。

〜 iOS 10.2

SwiftRater2

Android

Android-Rate

平台控件使用

Android iOS
Android-Rate SwiftRater

需求

iOS iOS 8.0 或更高版本,Xcode 8.2 或更高版本。

android API 级别 9 和更高。

安装

tns plugin add nativescript-rater

变更日志

src/CHANGELOG.md

使用方法

import {appRater} from 'nativescript-rater';

// put init before `application.start`
// in ng application, you may have to put init before `platformNativeScriptDynamic`
appRater.init({
showNeverButton:false,
debugMode:true
});

// check
appRater.showRateDialogIfMeetsConditions();

// show directly
appRater.showRateDialog();

API

属性 默认值 描述
ios 原始 iOS 控件,以下为高级用法
android 原始 Android 控件,应用程序启动后值将可用
init(configs:AppRaterConfigs):void 让评分器知道您的应用程序已启动。请参见下面的配置
incrementSignificantUsageCount():void 对于 significantUsesUntilPrompt,您需要添加 incrementSignificantUsageCount仅限 iOS
showRateDialogIfMeetsConditions():boolean 如果满足条件则显示评分对话框。函数将返回对话框是否显示。
showRateDialog():void 显示评分对话框

配置

属性 默认值 描述
daysUntilPrompt 7 如果自首次应用程序启动以来已过去 days 天,则显示评价请求。
usesUntilPrompt 3 如果用户启动次数超过 uses 次,则显示评价请求。
daysBeforeReminding 5 如果用户选择稍后评分,则弹出提醒的日期。 适用于 ~iOS10.2 和 Android
significantUsesUntilPrompt 0 如果用户执行超过 uses 次的重要操作,则显示评价请求。 仅限 iOS
debugMode false 每次都显示评价请求。默认为 false。 提交应用程序时需要设置为 false
showLaterButton true 在评价请求对话框中显示“稍后”按钮。 适用于 ~iOS10.2 和 Android
showNeverButton true 在评价请求对话框中显示“永不”按钮。 仅限 Android

您也可以通过设置器更改该值。

import {appRater} from 'nativescript-rater';

appRater
.setDaysUntilPrompt(7)
.setUsesUntilPrompt(3)
.setSignificantUsesUntilPrompt(2)
.setShowLaterButton(true)
.setShowNeverButton(true)
.setDebugMode(true);

自定义对话框

Android

如果您想使用自己的对话框标签,请覆盖应用程序中的字符串 xml 资源。

<resources>
<string name="rate_dialog_title">Rate this app</string>
<string name="rate_dialog_message">If you enjoy playing this app, would you mind taking a moment to rate it? It won\'t take more than a minute. Thanks for your support!</string>
<string name="rate_dialog_ok">Rate It Now</string>
<string name="rate_dialog_cancel">Remind Me Later</string>
<string name="rate_dialog_no">No, Thanks</string>
</resources>

iOS

您可以为 iOS10.2 或更早的设备自定义评价请求对话框中的文本。在以下属性中设置文本。

appRater.ios.setAlertTitle('title')
appRater.ios.setAlertMessage('message')
appRater.ios.setAlertCancelTitle('cancel')
appRater.ios.setAlertRateTitle('rate')
appRater.ios.setAlertRateLaterTitle('later')
appRater.ios.setAppName('your app name')

许可

MIT