in_app_review 2.0.6 copy "in_app_review: ^2.0.6" to clipboard
in_app_review: ^2.0.6 copied to clipboard

Flutter plugin for showing the In-App Review/System Rating pop up on Android, iOS and MacOS. It makes it easy for users to rate your app.

in_app_review #

tests pub package In-App Review Android Demo In-App Review iOS Demo

Description #

A Flutter plugin that lets you show a review pop up where users can leave a review for your app without needing to close your app. Alternatively, you can open your store listing via a deep link.

It uses the In-App Review API on Android and the SKStoreReviewController on iOS/MacOS.

Usage #

requestReview() #

The following code triggers the In-App Review prompt. This should not be used frequently as the underlying API's enforce strict quotas on this feature to provide a great user experience.

import 'package:in_app_review/in_app_review.dart';

final InAppReview inAppReview = InAppReview.instance;

if (await inAppReview.isAvailable()) {
    inAppReview.requestReview();
}

Do #

  • Use this after a user has experienced your app for long enough to provide useful feedback, e.g., after the completion of a game level or after a few days.
  • Use this sparingly otherwise no pop up will appear.

Avoid #

  • Triggering this via a button in your app as it will only work when the quota enforced by the underlying API has not been exceeded. (Android)
  • Interrupting the user if they are mid way through a task.

Testing requestReview() on Android isn't as simple as running your app via the emulator or a physical device. See Testing for more info.


openStoreListing() #

The following code opens the Google Play Store on Android, the App Store with a review screen on iOS & MacOS and the Microsoft Store on Windows. Use this if you want to permanently provide a button or other call-to-action to let users leave a review as it isn't restricted by a quota.

import 'package:in_app_review/in_app_review.dart';

final InAppReview inAppReview = InAppReview.instance;

inAppReview.openStoreListing(appStoreId: '...', microsoftStoreId: '...');

appStoreId is only required on iOS and MacOS and can be found in App Store Connect under General > App Information > Apple ID.

microsoftStoreId is only required on Windows.

Guidelines #

https://developer.apple.com/design/human-interface-guidelines/ios/system-capabilities/ratings-and-reviews/

https://developer.android.com/guide/playcore/in-app-review#when-to-request https://developer.android.com/guide/playcore/in-app-review#design-guidelines

Since there is a quota on how many times the pop up can be shown, you should not trigger requestReview() via a button or other call-to-action option. Instead, you can reliably redirect users to your store listing via openStoreListing().

Testing #

Android #

You must upload your app to the Play Store to test requestReview(). An easy way to do this is to build an apk/app bundle and upload it via internal app sharing.

Real reviews cannot be created while testing requestReview() and the submit button is disabled to emphasize this.

More details at https://developer.android.com/guide/playcore/in-app-review/test

iOS #

requestReview() can be tested via the iOS simulator or on a physical device. Note that requestReview() has no effect when testing via TestFlight as documented.

Real reviews cannot be created while testing requestReview() and the submit button is disabled to emphasize this.

openStoreListing() can only be tested with a physical device as the iOS simulator does not have the App Store installed.

MacOS #

This plugin can be tested by running your MacOS application locally.

Cross Platform Compatibility #

Function Android iOS MacOS Windows(UWP)
isAvailable()
requestReview()
openStoreListing()

Upvote https://github.com/flutter/flutter/issues/14967 if you're interested in Windows support!

Requirements #

Android #

Requires Android 5 Lollipop(API 21) or higher and the Google Play Store must be installed.

iOS #

Requires iOS version 10.3

MacOS #

Requires MacOS version 10.14

Issues & pull requests are more than welcome!

2042
likes
0
pub points
100%
popularity

Publisher

verified publisherbritannio.dev

Flutter plugin for showing the In-App Review/System Rating pop up on Android, iOS and MacOS. It makes it easy for users to rate your app.

Homepage
Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

flutter, in_app_review_platform_interface

More

Packages that depend on in_app_review