设置

开始之前

您将需要用于集成过程中的 API 密钥和公共加密证书。以下步骤将指导您获取这些项目。

1. 登录到 Moki 仪表板 https://mo.ki
2. 扩展页面底部的“管理员”部分
3. 点击“应用”
4. 查找您的应用
5. API 密钥列在应用名称下方
6. 下载公共加密证书（moki_public_key.der）的链接列在 API 密钥下方
   

入门

1. 将以下内容添加到您的 Podfile 中：Moki

   pod 'Moki'
   

   由于我们使用了其他第三方库，我们强烈建议您使用 CocoaPods 安装 SDK。如果您不使用 CocoaPods，请访问“手动安装”部分。

   CocoaPods 是 Objective-C 的依赖管理器，它自动并简化了在项目中使用第三方库的过程。如果您尚未使用 CocoaPods 但想尝试，请访问网站以启动 CocoaPods。

2. 在项目根目录的终端中运行 pod install

   $ pod install
   

3. 将 'moki_public_key.der' 添加到您的项目中

   我们为每个 API 密钥生成一个与其相对应的公共加密密钥。此密钥打包为 der 证书。它必须包含在您的资源包中。

   有关查找此文件的帮助，请参考上面的“开始之前”部分。

4. 在您的应用程序代理中导入 "MOCore.h"

   #import "MOCore.h"
   

5. 在您的应用程序代理的 'application didFinishLaunchingWithOptions:' 中使用 API 密钥初始化 SDK

   [MOCore initWithApiKey:@"YOUR_API_KEY"];
   

   有关查找此密钥的帮助，请参考上面的“开始之前”部分。

   有关更多详细信息，请参阅我们的 SDK 文档

手动安装

1. 在 https://github.com/MokiMobility/MokiSDK/tree/ios-inclusive 下载 SDK 源代码
2. 将其添加到您的项目中
   • 将 Inclusive 目录拖入 Xcode
   • 确保 libInclusive.a 被添加到 Build Phases 部分的 Link Binary with Libraries 部分

3. 添加以下框架：

   • SystemConfiguration
   • AVFoundation
   • ExternalAccessory
   • CoreTelephony
   • MobileCoreServices
   • CoreLocation

4. 将链接器标志 '-ObjC' 添加到目标的“Build Setting”部分中的“Other Linker Flags”中

5. 完成“入门”部分中的第 3-5 步

高级实现

添加用户ID

为了启用对用户行为的监控，您必须提供一个用户ID。这可以关联到您系统中的用户，或者您可以生成一个唯一的用户ID。

#import "MOLogging.h"

...

[MOLogging setUserId:@"unique-identifier-for-a-user"];

有关更多详细信息，请参阅我们的 SDK 文档

添加面包屑

Moki SDK会自动跟踪每个视图控制器在出现时的行为。如果您想跟踪额外的用户行为或应用程序活动，您可以通过添加自己的面包屑来实现。

#import "MOLogging.h"

...

[MOLogging addBreadcrumb:@"User Action Happened"];

警告： 仅存储面包屑条目前50个字符

有关更多详细信息，请参阅我们的 SDK 文档

添加应用程序数据

应用程序数据是一个键值数据结构，提供了一个位置来贡献任何与应用程序状态相关的应用程序特定指标到我们的日志中。这些值通过我们的Splunk端点展现出来。

#import "MOLogging.h"

...

[MOLogging setAppDataValue:@"an-interesting-metric" forKey:@"a-unique-key";

有关更多详细信息，请参阅我们的 SDK 文档