您有两种方式来添加 insert 框架。通过 CocoaPods 或手动。
打开您的 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 代码 设置为 是
在
构建设置 | 构建选项:
请确保标志 启用 Bitcode 设置为 否
继续执行下面的第 2 步
从 software.insert.io 下载框架。
将 InsertFramwork.framework 拖入您的项目。在提示时,请勾选“如有需要则复制项”选项。
在
构建阶段 | 与库链接二进制文件:
请确保 InsertFramework.framework 已列出
在
常规 | 嵌入式二进制文件:
按下加号并添加 InsertFramework.framework
在
构建设置 | 构建选项:
将 嵌入式内容包含 Swift 代码 设置为 是
在
构建设置 | 构建选项:
请确保标志 启用 Bitcode 设置为 否
在
常规 | 部署目标:
请确保您的部署目标已设置为 8.0 或更高版本
在
信息 | URL 类型:
按 + 号创建一个新的 URL
请根据 Insert 网页应用仪表板中的方案设置 URL 方案
将 URL 身份标识符设置为您选择的任何名称(或留空)。
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"];
Insert 平台允许添加在应用启动时显示的屏幕,例如 App Walkthrough insert 类型。为了正确显示初始相关的屏幕,您可能需要在初始化 insert 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")
Insert 平台允许添加在应用启动时显示的屏幕,例如 App Walkthrough insert 类型。为了正确显示初始相关的屏幕,您可能需要在初始化 insert SDK 成功后仅启动某些应用程序功能。要注册初始化 SDK 成功,请在 initSDK 调用之前添加以下代码:
NSNotificationCenter.defaultCenter().addObserver(self, selector: "didSuccessfullyInitSDK", name: kIIODidSuccessfullyInitializeSDKNotification, object: nil)
然后实现此方法
func didSuccessfullyInitSDK() {
// your post initialization code here
}
以相同方式,您可以通过注册 kIIOErrorInitializeSDKNotification 来注册初始化失败。
使用 Xcode 进行测试
将应用程序与 Xcode 连接,查看设备日志并查找消息
SDK 成功集成并连接到 Insert 服务器。您可以在 Insert 的网站上开始向您的应用程序添加插入内容。
使用 Insert 管理器网络应用程序进行测试
登录您的 Insert 账户。在 我的应用程序 下,应验证 应用程序版本数量 已从 0 变为 1(或更多)。
请访问我们帮助中心的 iOS 部分:[http://support.insert.io/hc/en-us/articles/206984289-iOS-Troubleshooting](http://support.insert.io/hc/en-us/articles/206984289-iOS-Troubleshooting)