Insert 框架与 iOS SDK 集成

步骤 1: 集成 Insert 框架

您有两种方式添加 insert 框架。通过 CocoaPods 或手动添加

通过 CocoaPods 添加 Insert 框架

打开您的 Podfile 并添加以下几行

platform:ios, '8.0'
use_frameworks!
# other pod statements

# Uncomment for Xcode 7.2
# pod 'Insert', '1.x' 
# Uncomment for Xcode 7.3
# pod 'Insert', '1.x.XCode-7.3'

(注意：insert 只支持 iOS 8 或更高版本)

如果您使用 Swift 编写应用程序，您需要添加一个“桥接”头文件，并包含框架头文件

 // your bridging header
 ... import statements
 #import <InsertFramework/InsertFramework.h> // import the framework header

构建设置

在

构建设置 | 构建选项:

确保标志 嵌入式内容包含 Swift 代码 设置为 是

在

构建设置 | 构建选项:

确保标志 启用位代码 设置为 否

继续以下步骤 2

手动集成

从 software.insert.io 下载框架

将 InsertFramwork.framework 拖入您的项目。提示时，选择“如果需要，则复制项目”选项

在

构建阶段 | 将库链接到二进制文件:

确保 InsertFramework.framework 已被列出

在

常规 | 嵌入的二进制文件:

按下加号并添加 InsertFramework.framework

在

构建设置 | 构建选项:

将 嵌入式内容包含 Swift 代码 设置为 是

在

构建设置 | 构建选项:

确保标志 启用位代码 设置为 否

在

常规 | 部署目标:

确保您的部署目标设置为 8.0 或更高版本

步骤 2: 设置 URL 方案

在

信息 | URL 类型:

点击加号创建一个新的 URL

设置 URL 方案应与 Insert 网页应用程序仪表板中的方案一致

将 URL 标识符设置为任何您想用的名称（或者留空）。

步骤 3: 初始化代码

Objective-C

在您的 AppDelegate 文件中添加

#import <InsertFramework/InsertFramework.h>

添加或修改函数

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
  if ([[url scheme] containsString:@"insert"]) {
      [[InsertManager sharedManager] initWithUrl:url];
      return YES;
  }
  //  your code here ...
  return YES;
}

在 didFinishLaunchingWithOptions 下添加以下代码行

[[InsertManager sharedManager] initSDK:@"your app key"
                       companyName:@"your company"];

高级

插入平台允许在应用启动时添加屏幕，例如应用操作流程插入类型。为了在启动时正确显示与插入相关的屏幕，您可能需要在插入SDK成功初始化后才能启动某些应用功能。为了注册插入SDK初始化成功，请在initSDK调用之前添加以下内容：

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didSuccessfullyInitSDK) name:kIIODidSuccessfullyInitializeSDKNotification object:nil];

然后实现该方法

-(void)didSuccessfullyInitSDK {
  // your post initialization code here
}

以相同的方式，您可以通过注册 kIIOErrorInitializeSDKNotification 来注册失败初始化

Swift 专用

在您的 AppDelegate 文件中添加

import InsertFramework.InsertManager

添加或修改以下函数：

func application(application: UIApplication, openURL url: NSURL,sourceApplication: String?, annotation: AnyObject) -> Bool {
    if url.scheme.rangeOfString("insert") != nil   {
      InsertManager.sharedManager().initWithUrl(url)
      return true
     }
    // your code here...
    return true
}

在函数 didFinishLaunchingWithOptions 下添加以下行代码：

InsertManager.sharedManager().initSDK("your app key",companyName:"your company")

高级

插入平台允许在应用启动时添加屏幕，例如应用操作流程插入类型。为了在启动时正确显示与插入相关的屏幕，您可能需要在插入SDK成功初始化后才能启动某些应用功能。为了注册插入SDK初始化成功，请在initSDK调用之前添加以下内容：

NSNotificationCenter.defaultCenter().addObserver(self, selector: "didSuccessfullyInitSDK", name: kIIODidSuccessfullyInitializeSDKNotification, object: nil)

然后实现该方法

func didSuccessfullyInitSDK() {
  // your post initialization code here
}

以相同的方式，您可以通过注册 kIIOErrorInitializeSDKNotification 来注册失败初始化

测试您的更改

使用 Xcode 进行测试

在连接到 Xcode 的应用中运行，查看设备日志并寻找消息

插入SDK已成功集成并连接到插入服务器。您现在可以开始在网上插入网站上添加插入到您的应用中。

使用插入管理器网络应用程序进行测试

登录到您的插入帐户。在 我的应用 下，您应该会看到 应用程序版本数量 从0变为1（或更大）。

故障排除

请访问我们帮助中心的iOS部分：http://support.insert.io/hc/en-us/articles/206984289-iOS-Troubleshooting