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下载框架

将拖到您的项目中。当提示时，选择“如果需要则复制项目”选项

在

构建阶段 | 链接库:

确保已列出InsertFramework.framework

在

常规 | 嵌入库:

按+号添加InsertFramework.framework

在

构建设置 | 构建选项:

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

在

构建设置 | 构建选项:

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

在

常规 | 部署目标:

确保您的部署目标是8.0或更高版本

第2步：设置URL方案

在

信息 | URL类型:

通过按+号创建新的URL

根据Insert Web应用程序仪表板中的方案设置URL方案

将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成功初始化后才开始某些应用程序功能。为了在调用initSDK之前注册插入SDK初始化的成功完成，请添加以下内容

[[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成功初始化后才开始某些应用程序功能。为了在调用initSDK之前注册插入SDK初始化的成功完成，请添加以下内容

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

然后实现该方法

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

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

测试您的更改

使用Xcode进行测试

在连接到Xcode的情况下运行应用程序，检查设备日志，寻找以下信息

插入SDK成功集成并连接到插入服务器。您可以在插入网站上开始向您的应用程序添加插入内容。

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

登录到您的插入账户。在 我的应用程序 下，您应验证 应用程序版本数量 是否已从0变为1（或更高）。

问题解决

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