You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 24, 2023. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+16-28Lines changed: 16 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,13 @@
1
1
Introduction
2
-
------------
3
-
Appirater is a class that you can drop into any iPhone app (iOS 4.0 or later) that will help remind your users
4
-
to review your app on the App Store. The code is released under the MIT/X11, so feel free to
5
-
modify and share your changes with the world. Read on below for how to get started. If you need any help using,
6
-
the library check out the [Appirater group][appiratergroup].
2
+
---------------
7
3
4
+
Appirater is a class that you can drop into any iPhone app (iOS 4.0 or later) that will help remind your users to review your app on the App Store. The code is released under the MIT/X11, so feel free to modify and share your changes with the world. Read on below for how to get started. If you need any help using, the library, post your questions on [Stack Overflow][stackoverflow] under the `appirater` tag.
8
5
9
6
Getting Started
10
7
---------------
11
8
12
-
###Cocoapods
13
-
If you're new to Cocoapods [watch this](http://nsscreencast.com/episodes/5-cocoapods). To add Appirater to your app, add `pod "Appirater"` to your Podfile.
14
-
15
-
Cocoapods support is still experimental, and might not work in all use cases. If you experience problems, open an issue and install via Git submodule
16
-
17
-
###Manually
18
-
1. Add the Appirater code into your project.
19
-
2. If your project doesn't use ARC, add the `-fobjc-arc` compiler flag to `Appirater.m` in your target's Build Phases » Compile Sources section.
20
-
3. Add the `CFNetwork`, `SystemConfiguration`, and `StoreKit` frameworks to your project. Be sure to **change Required to Optional** for StoreKit in your target's Build Phases » Link Binary with Libraries section.
9
+
### CocoaPods
10
+
To add Appirater to your app, add `pod "Appirater"` to your Podfile.
21
11
22
12
Configuration
23
13
-------------
@@ -37,10 +27,10 @@ Configuration
37
27
4. Call `[Appirater appEnteredForeground:YES]` in your app delegate's `applicationWillEnterForeground:` method.
38
28
5. (OPTIONAL) Call `[Appirater userDidSignificantEvent:YES]` when the user does something 'significant' in the app.
39
29
40
-
###Development
30
+
###Development
41
31
Setting `[Appirater setDebug:YES]` will ensure that the rating request is shown each time the app is launched.
42
32
43
-
###Production
33
+
###Production
44
34
Make sure you set `[Appirater setDebug:NO]` to ensure the request is not shown every time the app is launched. Also make sure that each of these components are set in the `application:didFinishLaunchingWithOptions:` method.
45
35
46
36
This example states that the rating request is only shown when the app has been launched 5 times **and** after 7 days.
@@ -67,13 +57,17 @@ If you wanted to show the request after 5 days only you can set the following:
67
57
[Appirater appLaunched:YES];
68
58
```
69
59
70
-
Help and Support Group
60
+
SKStoreReviewController
71
61
----------------------
72
-
Requests for help, questions about usage, suggestions and other relevant topics should be posted at the [Appirater group] [appiratergroup]. As much as I'd like to help everyone who emails me, I can't respond to private emails, but I'll respond to posts on the group where others can benefit from the Q&As.
62
+
In iOS 10.3, [SKStoreReviewController](https://developer.apple.com/library/content/releasenotes/General/WhatsNewIniOS/Articles/iOS10_3.html) was introduced which allows rating directly within the app without any additional setup.
63
+
64
+
Appirater automatically uses `SKStoreReviewController` if available. You'll need to manually link `StoreKit` in your App however.
65
+
66
+
If `SKStoreReviewController` is used, Appirater is used only to decide when to show the rating dialog to the user. Keep in mind, that `SKStoreReviewController` automatically limits the number of impressions, so the dialog might be displayed less frequently than your configured conditions might suggest.
73
67
74
68
License
75
69
-------
76
-
Copyright 2014. [Arash Payan] [arash].
70
+
Copyright 2017. [Arash Payan] [arash].
77
71
This library is distributed under the terms of the MIT/X11.
78
72
79
73
While not required, I greatly encourage and appreciate any improvements that you make
@@ -83,16 +77,10 @@ Ports for other SDKs
83
77
--------------
84
78
A few people have ported Appirater to other SDKs. The ports are listed here in hopes that they may assist developers of those SDKs. I don't know how closesly (if at all) they track the Objective-C version of Appirater. If you need support for any of the libraries, please contact the maintainer of the port.
85
79
86
-
+ MonoTouch Port (using C#). [Github] [monotouchport]
"If you enjoy using %@, would you mind taking a moment to rate it? It won't take more than a minute. Thanks for your support!" = "اگر از استفاده برنامه %@ لذت میبرید، زمان دارید بهش امتیاز دهید؟ بیشتر از یک دقیقه زمان نخواهد گرفت. با تشکر از اینکه ما را همایت میکنید.";
"If you enjoy using %@, would you mind taking a moment to rate it? It won't take more than a minute. Thanks for your support!" = "Եթե Դուք հաճույքով եք օգտագործում %@-ը, դեմ չե՞ք լինի տրամադրել մեկ րոպե այն գնահատելու համար: Այն չի պահանջի ձեզանից ավելի քան մեկ րոպե: Շնորհակալություն աջակցության համար:";
0 commit comments