简介

Appirater 是一个类，您可以将它添加到任何 iOS 4.0 或更高版本的 iPhone 应用程序中，以帮助提醒用户在 App Store 上为您的应用程序进行评分。代码在 MIT/X11 许可下发布，因此您可以自由修改并与世界分享您的更改。请继续阅读以下内容以了解如何开始。如果您在使用库时需要任何帮助，请查看 Appirater 群组。

开始使用

手动

1. 将 Appirater 代码添加到您的项目中。
2. 如果您的项目不使用 ARC，请将 -fobjc-arc 编译器标志添加到目标“构建阶段”中的“编译源文件”部分下的 Appirater.m。
3. 将 CFNetwork、SystemConfiguration 和 StoreKit 框架添加到您的项目中。请确保在目标“构建阶段”中的“链接二进制与库”部分将 StoreKit 的“必需”更改为“可选”。

配置

1. Appirater 提供了配置其行为的方法。有关更多信息，请参阅 Appirater.h。

[Appirater setAppId:@"552035781"];
[Appirater setDaysUntilPrompt:1];
[Appirater setUsesUntilPrompt:10];
[Appirater setSignificantEventsUntilPrompt:-1];
[Appirater setTimeBeforeReminding:2];
[Appirater setDebug:YES];

1. 使用为您提供的 app id 调用 [Appirater setAppId:@"yourAppId"]。在您的应用代理的 application:didFinishLaunchingWithOptions: 方法的开头做这件事是个好地方。
2. 在您的应用代理的 application:didFinishLaunchingWithOptions: 方法结束时调用 [Appirater appLaunched:YES]。
3. 在您的应用代理的 applicationWillEnterForeground: 方法中调用 [Appirater appEnteredForeground:YES]。
4. （可选）当用户在应用程序中进行“重要”操作时调用 [Appirater userDidSignificantEvent:YES]。

开发

将 [Appirater setDebug:YES] 设置为将确保每次启动应用程序时都显示评分请求。

生产

请确保您将 [Appirater setDebug:NO] 设置为确保每次启动应用程序时都不会显示请求。同时请确保在每个组件都在 application:didFinishLaunchingWithOptions: 方法中设置。

此示例表明，评分请求仅在应用程序启动 5 次且 7 天后显示。

[Appirater setAppId:@"770699556"];
[Appirater setDaysUntilPrompt:7];
[Appirater setUsesUntilPrompt:5];
[Appirater setSignificantEventsUntilPrompt:-1];
[Appirater setTimeBeforeReminding:2];
[Appirater setDebug:NO];
[Appirater appLaunched:YES];

如果您想仅在 5 天后显示请求，可以设置如下：

[Appirater setAppId:@"770699556"];
[Appirater setDaysUntilPrompt:5];
[Appirater setUsesUntilPrompt:0];
[Appirater setSignificantEventsUntilPrompt:-1];
[Appirater setTimeBeforeReminding:2];
[Appirater setDebug:NO];
[Appirater appLaunched:YES];

帮助和支持组

关于帮助、使用问题、建议和其他相关主题，请发帖至 Appirater 组。虽然我希望能帮助所有给我发邮件的人，但我无法回复私人邮件，但我会回复组内的帖子，让其他人也能从问答中受益。

许可

版权所有 2014. Arash Payan。此库基于 MIT/X11 条款分发。

虽然在法律上并非必须，但我强烈鼓励并感谢您将改进的贡献回这个库，以使所有使用 Appirater 的人受益。

其他 SDK 的端口

一些人已经将 Appirater 移植到了其他 SDK。以下列出了这些端口，希望它们能帮助那些 SDK 的开发者。我不确定他们是否与 Appirater 的 Objective-C 版本保持紧密的跟进（如果有的话）。如果您需要任何库的支持，请联系端口的维护者。

• MonoTouch 端口（使用 C#）。Github
• MonoTouch 绑定（使用原生的 Appirater）。Github
• Corona SDK。Github
• Titanium SDK。Github