react-native-rate

React Native Rate is a cross platform solution to getting users to easily rate your app.

##### Stores Supported:
Apple App Store | Google Play | Amazon | Other Android Markets | All Others
--- | --- | --- | --- | ---
✓ | ✓ | ✓ | ✓ Building your app for a different Android store, you can provide your own URL | ✓ If your platform isn't one of the others, you can input a fallback url to send users to instead

Getting started

$ npm i react-native-rate

$3

cd ios && pod install && cd ../

$3

$ react-native link react-native-rate

$3

#### iOS

##### Without CocoaPods
1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-rate and add RNRate.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNRate.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)<

##### Using CocoaPods

Add the following to your Podfile (and run pod install):
``pod 'RNRate', :path => '../node_modules/react-native-rate'`

#### Other Platforms Android, Windows, etc don't use any native code. So don't worry! (There still is linking to Android if you do react-native link. We only left this here so that we can call native code if there is native code to call someday.)

#### iOS Specific:

Users using iOS 10.3 (from 2017) and above can now use SKStoreReviewControllerto open a Rating Alert right from within their app. There are a few gotchas to using this ReviewController though: - Users are first presented with a pop up allowing them to choose 1-5 stars. If they give a numerical rating, the pop up will allow them to then write a review. They can cancel at any time, leaving you with either nothing, a rating, or a rating and review. - To prevent annoying popups, Apple decides whether or not you can display it, and they do not offer a callback to let you know if it was displayed or not. It is limited to being shown 3-4 times per year. - If you do want this ReviewController to show up, we wrote a little hack to see if it worked, and if it doesn't, we just open the App Store (using the optional for all devices pre-iOS10.3). Hopefully this hack continues to work, and hopefully Apple updates the API so we don't have to use this hack. - If you setoptions.preferInApp = true, the popup will happen on appropriate devices the first time you call it after the app is open. The hack used checks the number of windows the application has. For some reason, when the inapp window is dismissed, it is still on the stack. So if you try it again, the popup will appear (if it is 3 or less times you've done it this year), but after a short delay, the App Store will open too. - Due to all these issues, we recommend only setting preferInApp to true when you are absolutely sure you want a one time, rare chance to ask users to rate your app from within the app. Do not use it to spam them between levels. Do not have a button for rating/reviewing the app, and call this method. And if you want to have a really professional app, save the number of attempts to the device, along with a date. Otherwise you will get some strange behavior. - If you want to open via theSKStoreReviewController, but don't want the App Store App to open after the timeout, you can set openAppStoreIfInAppFails:false in options. By default, it will open after the timeout.

#### Android Specific for in-app popups:

- Similar to iOS since 2017, Android FINALLY supports an in-app dialogue that allows users to rate/review your app. As of August 2020, this is our first release using Android's PlayCore in-app-review popup, so there may be some hiccups. Note that this only works for the Android Google Play store (and Chrome OS devices that have the Google Play Store installed). No Amazon marketplace, sorry :( Also requires Android 5.0 and above, which I think has been required for newer versions of React Native for at least the least year or two. So if you've updated your react-nativelibrary since probably 2018, you should be good to use this. - If you setpreferredAndroidMarket = AndroidMarket.Google and options.preferInApp = true, it will open the native UI in the app (see Official docs). - Your app needs to be published at least once to the Play Store for it to show (see How to test). - It seems that it only shows on a real device, not on a simulator. - Need troubleshooting? Check out the official documentation on common problems here. - Want to show the in-app review dialogue even after the user has reviewed your app? Maybe they tapped a button to edit their review? Unfortunately, like Apple, Google doesn't tell us if the user has reviewed or not. So if you try to open the in-app dialogue, your callback will be SUCCESS. But actually, nothing will happen. And since it is "successful", the Play Store page won't open either. In order to handle this, I suggest 1 of two solutions. Either create a separate button that ALWAYS opens the play store (never the in-app prompt). Or create some logic to estimate if a user has rated or not. For example, if the user comes back to the app within 10 seconds, they probably didn't rate the app. Or you could just never try the in-app prompt once it has been successful once. Or, if you're a programming genius, and you know the usernames of your users, make a Google Play query and search for their review. If exists, don't try again. Ya, but I bet you won't have access to that info. But that's hopeful dreaming.

`Example`

javascript
import React from 'react'
import { View, Button } from 'react-native'
import Rate, { AndroidMarket } from 'react-native-rate'
export default class ExamplePage extends React.Component {
  constructor(props) {
    super(props)
    this.state = {
      rated: false
    }
  }

render() { return (