Use the SKStoreReviewController from iOS 10.3+ in your Ttanium application. Also use a native Android dialog
for best parity.
- Titanium Mobile SDK 8+
- iOS 10.3+
- Android 4.4+
import Review from 'ti.reviewdialog';
if (!Review.isSupported()) { return; }
Review.requestReview({
storeURL: `https://play.google.com/store/apps/details?id=${Ti.App.id}`
onFeedback: event => {
// Send feedback to your server via "event.value"
}
});
// when review is done
Review.addEventListener("complete", function(e){
console.log(e.success);
});There are some important notes on when to show the rating dialog (thanks to @skypanther:
- The internal API itself will decide when, or if, to show the prompt
- You should not show it more than once for a given version of your app
- You should not show the dialog in response to user actions (like after a user clicks a button)
- You should not show it on first app launch (even after an update) but should wait until the user has used your app for a "meaningful" amount.
The following (ES6+ based) example shows how to use it in a real world example. It relies on the semver module / http://gitt.io/component/semver to compare app versions. Apple's own example uses a simple launch count to determine "meaningful" amount of use, which is also used in this example. You should use something appropriate for your app (amount of time, completion of an action N times, etc.):
import semver from 'semver';
import Review from 'ti.reviewdialog';
// first, check that the user has used your app for a "meaningful" amount
// here, a simple count of some action
let countOfSomeUserAction = Ti.App.Properties.getInt('countOfSomeUserAction', 0);
countOfSomeUserAction += 1;
Ti.App.Properties.setInt('countOfSomeUserAction', countOfSomeUserAction);
if (countOfSomeUserAction >= 4) {
// if they've done whatever action 4 or more times, check the app version
const lastVersionPromptedForReview = Ti.App.Properties.getString('lastVersionPromptedForReview', '1.0.0');
let appVersion = Ti.App.version;
const appVersionAsArray = appVersion.split('.');
if (appVersionAsArray.length > 3) {
// the semver library supports max 3-part version numbers (per semver rules)
appVersion = appVersionAsArray[0] + '.' + appVersionAsArray[1] + '.' + appVersionAsArray[2];
}
if (semver.gt(appVersion, lastVersionPromptedForReview)) {
// if the current app version is greater-than the last time you prompted them
// prompt them with the titanium-review-dialog alert
Ti.App.Properties.setString('lastVersionPromptedForReview', appVersion);
if (Review.isSupported()) {
Review.requestReview();
}
}
}
Unpack the modules and place them inside the modules/iphone/ and modules/android/ folder of your project.
Edit the modules section of your tiapp.xml file to include this module:
<modules>
<module platform="iphone">ti.reviewdialog</module>
<module platform="android">ti.reviewdialog</module>
</modules>Request a new review dialog:
import Review from 'ti.reviewdialog';
if (Review.isSupported()) {
Review.requestReview();
}-
isSupported -
requestReview
-
complete(Android only) Note: The API does not indicate whether the user reviewed or not, or even whether the review dialog was shown.
Hans Knoechel (@hansemannnn / Web)
Apache 2.0
Code contributions are greatly appreciated, please submit a new pull request!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent