插入 1.52.6

Insert 1.52.6

测试已测试
Lang语言 Obj-CObjective C
许可证 商业
发布上次发布2022年1月

Pendo的iOS团队Yaron Goldberg 维护。



Insert 1.52.6

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 代码 设置为

构建设置 | 构建选项:

请确保标志 启用 Bitcode 设置为

继续执行下面的第 2 步

手动集成

从 software.insert.io 下载框架。

InsertFramwork.framework 拖入您的项目。在提示时,请勾选“如有需要则复制项”选项。

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

请确保 InsertFramework.framework 已列出

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

按下加号并添加 InsertFramework.framework

构建设置 | 构建选项:

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

构建设置 | 构建选项:

请确保标志 启用 Bitcode 设置为

常规 | 部署目标:

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

第 2 步:设置 URL 方案

信息 | URL 类型:

按 + 号创建一个新的 URL

请根据 Insert 网页应用仪表板中的方案设置 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"];
高级

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)