KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness

Plugin.Maui.AppRating

★ 86 Open GitHub ↗

An easy way to quickly add store rating reviews to your .Net MAUI app.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://raw.githubusercontent.com/FabriBertani/Plugin.Maui.AppRating/main/Assets/plugin.maui.apprating_128x128.png)

# Plugin.Maui.AppRating
[![NuGet](https://img.shields.io/nuget/v/Plugin.Maui.AppRating.svg?label=NuGet)](https://www.nuget.org/packages/Plugin.Maui.AppRating/) [![NuGet Downloads](https://img.shields.io/nuget/dt/Plugin.Maui.AppRating)](https://www.nuget.org/packages/Plugin.Maui.AppRating/#versions-body-tab) [![Buy Me a Coffee](https://img.shields.io/badge/support-buy%20me%20a%20coffee-FFDD00)](https://buymeacoffee.com/fabribertani)

`Plugin.Maui.AppRating` gives developers a fast and easy way to ask users to rate the app on the stores.

## Platforms supported

|     Platform      |   Version   |
|-------------------|:-----------:|
| .Net MAUI Android | API 21+     |
| .Net MAUI iOS.    | iOS 15.0+   |
| Mac Catalyst      | 15.0+       |
| Windows           | 10.0.17763+ |

## Installation
`Plugin.Maui.AppRating` is available via NuGet, grab the latest package and install it in your solution:

```bash
dotnet add package Plugin.Maui.AppRating --version 1.3.0
```

In your `MauiProgram` class add the following using statement:

```csharp
using Plugin.Maui.AppRating;
```

Finally, add the default instance of the plugin as a singleton to inject it in your code late:

```csharp
builder.Services.AddSingleton<IAppRating>(AppRating.Default);
```

## Version 1.3.0
### New Features
- Removed `.Net8` platform support.
- Added `.Net10` support to all platforms.
- Update Android review package.
- Updated sample project.

Click [here](https://github.com/FabriBertani/Plugin.Maui.AppRating/releases/tag/v1.3.0) to see the full Changelog!

## :warning: Considerations regarding new platform policies :warning:
### Android
- It's highly recommended to test this or any other store review plugin on a real device with Google Play installed instead of using an emulator.
- Due to new regulations from Google, the review dialogue will not be displayed on manual distribution or debug mode (apparently), only on apps published and distributed via Google Play Store, however, it is recommended to release your app under "Internal distribution" or "Internal App Sharing" to effectively test the store review popup. [Read here for more information](https://developer.android.com/guide/playcore/in-app-review/test). Additionally, you can debug the error using `adb logcat`.
- `FakeReviewManager` is a new feature released by Google, primarily designed for testing and unit testing purposes. It operates without a user interface (UI). For more information, visit the [official Android documentation](https://developer.android.com/reference/com/google/android/play/core/review/testing/FakeReviewManager).
- To integrate `FakeReviewManager` in your implementation of this plugin, pass `true` to the method `PerformInAppRateAsync`. This feature is exclusive to Android.

### iOS
- During development, submitting a review is not possible, but the review popup dialog will still show on your simulator or device.
- :warning: The review dialogue **_will not be opened_** if the app is downloaded from TestFlight.

## API Usage
Call the injected interface in any page or viewmodel to gain access to the APIs.

There are two main methods in the plugin: `PerformInAppRateAsync` and `PerformRatingOnStoreAsync`.

### Android
```csharp
/// <summary>
/// Perform rating without leaving the app.
/// </summary>
Task PerformInAppRateAsync(bool isTestOrDebugMode = false);
```
> This method will open an in-app review dialogue, using the `packageName` declared on the `AndroidManifest` file.

```csharp
/// <summary>
/// Perform rating on the current OS store app or open the store page on the browser.
/// </summary>
Task PerformRatingOnStoreAsync();
```
> This method will open the **_Google Play app_** on the store page of your current application. Otherwise, it will try to open the store page on the browser.

```csharp
/// <summary>
/// If set to true, exceptions will be thrown when an error occurs.
/// </summary>
bool ThrowErrors
```
> This will allow users to catch exceptions with the new error handling implementation.

If neither the store page nor the browser store page works, it will display an error through the console and throw the exception if `ThrowErrors` is set to `true`.

`packageName` **must** be provided as a named argument to open the store page on the store app or browser.

#### Example
```csharp
await _appRating.PerformRatingOnStoreAsync(packageName: "com.instagram.android");
```

### iOS | Mac Catalyst
```csharp
/// <summary>
/// Perform rating without leaving the app.
/// </summary>
Task PerformInAppRateAsync();
```
> if the device current OS version is _10.3+_ in **iOS**, or _14.0+_ in **Mac Catalyst**, this method will raise an in-app review popup of your current application, otherwise, it will display a console log error announcing that it's not supported.

```csharp
/// <summary>
/// Perform rating on the current OS store app or open the store page on the browser.
/// </summary>
Task PerformRatingOnStoreAsync();
```
> This method will open the **App Store app** on the store page of your current application. Otherwise, it will try to open the store page on the browser.

If the method fails, it will display an error through the console and throw the exception if `ThrowErrors` is set to `true`.

`applicationId` property is the **_StoreId_** of your application and it **must** be provided as a named argument to open the store page on the store app or browser.

#### Example
```csharp
await _appRating.PerformRatingOnStoreAsync(applicationId: "id389801252");
```

### Windows
```csharp
/// <summary>
/// Perform rating without leaving the app.
/// </summary>
Task PerformInAppRateAsync();
```
> This method will raise an in-app review dialog of your current application, otherwise, it will display a console log error announcing that it's not supported.

```csharp
/// <summary>
/// Perform rating on the current OS store app or open the store page on the browser.
/// </summary>
Task PerformRatingOnStoreAsync();
```
> This method will open the **_Microsoft Store application_** on the store page of your current application. Otherwise, it will try to open the store page on the browser.

If this method fails, it will display an error through the console and throw the exception if `ThrowErrors` is set to `true`.

`productId` property is the **ProductId** of your application and it **must** be provided as a named argument to open the store page on the store app or browser.

Example
```csharp
await _appRating.PerformRatingOnStoreAsync(productId: "9nblggh5l9xt");
```

## Usage
> :warning: **Warning** - You should be careful about **how and when** you ask users to rate your app, there may be penalties from stores. As for advice, I recommend using a counter on the app start and storage that count, then when the counter reaches a specific number, display a dialogue asking the users if they want to rate the app, if they decline the offer, reset the counter to ask them later, also leave the option to do it themselves.

```csharp
public partial class MainPage : ContentPage
{
    private readonly IAppRating _appRating;

// We are using the Instagram application as an example here
    private const string androidPackageName = "com.instagram.android";
    private const string iOSApplicationId = "id389801252";
    private const string windowsProductId = "9nblggh5l9xt";

public MainPage(IAppRating appRating)
    {
        InitializeComponent();

_appRating = appRating;

// Set to true if you want to catch exceptions.
        _appRating.ThrowErrors = true;

if (!Preferences.Get("application_rated", false))
            Task.Run(() => CheckAppCountAndRate());
    }

private async Task CheckAppCountAndRate()
    {
        if (Preferences.Get("application_counter",0) >= 5)
        {
            if (!await DisplayAlert("Rate this App!", "Are you enjoying the so far? Would you like to leave a review in the store?", "Yes", "No"))
            {
                Preferences.Set("application_counter", 0);

return;
            }

await RateApplicationInApp();
        }
    }

private Task RateApplicationInApp()
    {
        await MainThread.InvokeOnMainThreadAsync(async () =>
        {
# if DEBUG
            await _appRating.PerformInAppRateAsync(true);
#else
            await _appRating.PerformInAppRateAsync();
#endif
        });

Preferences.Set("application_rated", true);

return Task.CompletedTask;
    }

private Task RateApplicationOnStore()
    {
        await MainThread.InvokeOnMainThreadAsync(async () =>
        {
            try
            {
                await _appRating.PerformRatingOnStoreAsync(packageName: androidPackageName, applicationId: iOSApplicationId, productId: windowsProductId);
            }
            catch (Exception ex)
            {
                // Handle the exception here...
            }
        });

Preferences.Set("application_rated", true);

return Task.CompletedTask;
    }

private void InAppRating_Clicked(object sender, EventArgs e)
    {
        Task.Run(RateApplicationInApp);
    }

private void AppRateOnStore_Clicked(object sender, EventArgs e)
    {
        if (!Preferences.Get("application_rated", false))
            Task.Run(RateApplicationOnStore);
    }
}
```

## Sample
Take a look at the [AppRatingSample](https://github.com/FabriBertani/Plugin.Maui.AppRating/tree/main/samples/AppRatingSample) for a fully detailed implementation of this plugin.

## Contributions
Feel free to open an [Issue](https://github.com/FabriBertani/Plugin.Maui.AppRating/issues) if you encounter any bugs or submit a PR to contribute improvements or fixes. Your contributions are greatly appreaciated.

## License
Plugin.Maui.AppRating is licensed under [MIT](https://github.com/FabriBertani/Plugin.Maui.AppRating/blob/main/LICENSE).

Plugin.Maui.AppRating

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README