轻量化威胁感知 iOS SDK 开发指南

要求

iOS 8.0 和 Xcode 10以上

一、简介

威胁感知系统通过实时数据采集、数据分析和数据应用，帮助企业闭环APP在运营环境中可能遇到的各种威胁。并将移动威胁态势通过可视化的数据报告呈现给企业运营者。

二、 准备

接入前期准备工作包括：获取 AppKey 以及 SDK 文件（已完成用户可略过此步骤）

（1）获取 AppKey

AppKey 是接入 SDK 的必要参数，参数值需要到管理平台去创建应用获取；对于本地化部署，则需要在本地服务器上进行登录管理页面进行分配 Appkey 参数。具体操作步骤如下：登入管理平台，在左侧菜单【系统配置】选项下选择【应用管理】 1.打开应用管理模块，在右侧点击上传应用。见图1-1-1
2.提交完成，应用列表点击查看 AppKey。见图1-1-2

（2）目录结构

注：使用CocoaPods的用户可以通过以下方式集成：

pod 'MTSSSDK', '~> 1.2.0'

注意（在终端更新pod之前进行搜索）

rm ~/Library/Caches/CocoaPods/search_index.json
Pod setup

登录管理平台，在左侧菜单【系统配置】选项下选择【SDK 管理】，选择数据采集 SDK 下载 iOS 版本。（文件夹目录如图1-2-1所示）

三、 集成

将下载的SDK包拖入工程内（包含: MTSSSecSDK.framework）

（1）集成SDK

在项目构建阶段如上图所示进行配置

（2）工程配置

1、在工程设置中选择构建设置，在"Other Linker Flags"中添加"-ObjC"（注意大小写区分）。

2、在你的工程设置中选择构建设置，在"Enable Bitcode"选项中选择 NO。见下图

(3）数据采集SDK对接

1、在AppDelegate.m文件中导入SDK头文件 #import <MTSSecSDK/MTSSecSDK.h> 2、初始化SDK 在AppDelegate.m文件中didFinishLaunchingWithOptions方法中初始化SDK

四、常见问题解答（FAQ）

(1)、网络请求失败

如果你的 App 基于 iOS 9.0 编译，那么为了适配 iOS 9.0 中的 App Transport Security(ATS)对 HTTP 的限制，在 App 对应的 Info.plist 中添加如下配置。（如果采用 https 方式则无需进行配置）

<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key><true/>
</dict>

(2)、授权失败处理

首次启动用户拒绝推送或定位授权后，在 AppDelegate.m 的 didFinishLaunchingWithOptions 方法内加入 SDK 提供的接口方法，可设置每次启动 App 时开启检测并提示去设置的授权弹框。（注意：默认授权弹窗只在首次运行 App 时弹出一次，特定的授权类型在设置 YES 之后，如果检测到未授权，每次启动 App 都会弹窗提示用户去设置）具体设置如下图所示:

(3)、崩溃分析日志异常

发生崩溃以后，在管理中心并没有找到崩溃日志。可能是由于以下4种情况造成：

1. 崩溃以后没有重新启动 App，因为崩溃的时候来不及发送崩溃日志给服务器。所以需要重新启动 App 来进行网络请求发送日志到服务器。

2. iOS 捕获异常的函数NSSetUncaughtExceptionHandler()被其他的崩溃收集类覆盖。导致威胁感知 SDK 捕获不到NSSetUncaughtExceptionHandler的回调消息。解决办法是找出其他的崩溃收集类，在其捕获异常的时候先判断是否已经有其他的 handle 已经设置。可以先将该 handle 保存，然后在其收集完成异常以后回调该 handle。如图所示
   
   

3. 没有连接网络，导致日志没法上报。

4. 发生崩溃的时候 App 还是断点状态，导致无法保存崩溃信息，放开断点即可完成崩溃信息收集。