in_app_review

pub package pub points likes popularity

In-App Review Android Demo In-App Review IOS Demo

Description

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

Uses the In-App Review API on Android and the SKStoreReviewController on iOS/MacOS

Usage

Use the following code to attempt to display the system review pop up. Beware that this does not guarantee that the pop up will be displayed as the quota may have been exceeded. On IOS & MacOS, this quota is three times in a 365 day period. On Android it is unclear: https://developer.android.com/guide/playcore/in-app-review#quotas

import 'package:in_app_review/in_app_review.dart';

final InAppReview inAppReview = InAppReview.instance;

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

Use the following code to open the Google Play Store on Android or the App Store on IOS & MacOS. This is the recommended option if you want to permanently provide a button or other call-to-action to let users leave a review.

import 'package:in_app_review/in_app_review.dart';

final InAppReview inAppReview = InAppReview.instance;

inAppReview.openStoreListing(appStoreId: '<YOUR_APP_STORE_ID>');

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

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.

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

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.

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

IOS

This plugin can be tested via the IOS simulator or on a physical device.

MacOS

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

Issues & pull requests are more than welcome!

Libraries

in_app_review