Apptentive Mac SDK

这个适用于 OS X 的 Cocoa 库允许您在一键反馈机制中快速便捷地将反馈发送到您的 Mac 应用程序中。反馈将被发送到 Apptentive Web 服务。

快速入门

示例应用程序

示例应用程序 FeedbackDemo 展示了如何将 SDK 与您的应用程序集成。

必需框架

为了使用 ApptentiveConnect，您必须链接以下框架到您的项目中

• AppKit
• CoreGraphics
• Foundation
• QuartzCore
• SystemConfiguration

Xcode 4 项目设置

从 GitHub 检出 apptentive-osx 项目。您可以将它放在项目的一个子文件夹中，或者如果您使用 git，则将其添加为 git submodule

在您的目标 Build Settings 部分中，将以下内容添加到 Other Linker Flags 设置

-ObjC -all_load

然后，在 Xcode 中打开您的项目，并将 ApptentiveConnect.xcodeproj 项目文件拖放到您的项目中

在您的应用程序的目标设置中，将 ApptentiveConnect 添加到 "Target Dependencies" 构建阶段

接下来，将 ApptentiveConnect.framework 添加到 "Link Binary With Libraries" 构建阶段

最后，将 ApptentiveConnect.framework 从 ApptentiveConnect 项目拖动到 "Copy Bundle Resources" 构建阶段

使用库

ApptentiveConnect 将反馈排队并尝试在后台上传。这是为了提供尽可能快地提交反馈的机制。

为了继续上传 已经排队/中断的反馈，我们建议在应用程序启动时实例化 ATConnect 并设置 API 密钥，例如

#import <ApptentiveConnect/ATConnect.h>
// ...
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    ATConnect *connection = [ATConnect sharedConnection];
    connection.apiKey = kApptentiveAPIKey;
    // ...
}

其中 kApptentiveAPIKey 是包含您的 API 密钥的 NSString。一旦您在共享连接对象上设置了 API 密钥，任何已排队的反馈都将开始上传，待网络可用。您也不必再次在共享连接对象上设置 API 密钥。

现在，您可以使用以下方式显示 Apptentive 反馈 UI

#import <ApptentiveConnect/ATConnect.h>
// ...
ATConnect *connection = [ATConnect sharedConnection];
[connection showFeedbackWindow:sender];

简单！

应用程序评分流程

ApptentiveConnect 现在提供与其他项目如 appirator 类似的 App 评分流程。要使用它，将头文件 ATAppRatingFlow.h 添加到您的项目中。

然后，在启动时，使用您的 iTunes App ID (请参阅下文的 "查找您的 iTunes App ID") 实例化一个共享的 ATAppRatingFlow 对象。

#import <ApptentiveConnect/ATAppRatingFlow.h>
// ...
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    [[ATConnect sharedConnection] setApiKey:kApptentiveAPIKey];
    ATAppRatingFlow *ratingFlow = [ATAppRatingFlow sharedRatingFlowWithAppID:kApptentiveAppID];
    [ratingFlow appDidLaunch:YES];
}

您还可以选择手动显示对话框

ATAppRatingFlow *ratingFlow = [ATAppRatingFlow sharedRatingFlowWithAppID:kApptentiveAppID];
[ratingFlow showEnjoymentDialog:sender];

如果您想为评分流程实现自定义触发器，这将非常有用。

查找您的 iTunes App ID 在 iTunesConnect 中，转到 "管理您的应用"，点击您的应用。在页面上的 "应用信息" 部分，查找 "Apple ID"，它将是数字。这是您的 iTunes 应用程序 ID。