iOS SDK接入（Pod集成）

前提条件

已下载iOS配置文件，具体操作，请参见快速入门：创建监控任务。

使用限制

• 仅支持iOS 8.0及以上的App。

• 推荐使用CocoaPods管理依赖的Xcode项目。

• 日志在手机端上最多存储7天 。

接入概述

1. 添加依赖：采用Pod集成方式添加依赖。

2. 接入服务：添加iOS配置文件；引入头文件；初始化SDK ；设置日志拉取级别。

3. 执行编译：添加编译设置。

4. 打印日志：在业务代码中打印日志信息。

添加依赖

1. 指定官方仓库和阿里云仓库。

   source "https://github.com/CocoaPods/Specs.git"
   source "https://github.com/aliyun/aliyun-specs.git"

2. 添加依赖。

   pod 'AlicloudTLog', '~> 1.0.0.2'

   说明

   执行pod search AlicloudTLog命令，查询AlicloudTLog最新版本。

3. 执行pod install或者pod update命令，获取SDK到项目中。

接入服务

1. 将iOS配置文件AliyunEmasServices-Info.plist拷贝至项目根目录。

   iOS配置文件获取方式参见：前提条件

2. 在AppDelegate.m文件中引入头文件：

   #import <AlicloudTLog/AlicloudTlogProvider.h>
   #import <AlicloudHAUtil/AlicloudHAProvider.h>
   #import <TRemoteDebugger/TRDManagerService.h>

3. 在AppDelegate.m文件的application:didFinishLaunchingWithOptions方法中，添加代码段，初始化SDK。

   NSString *appVersion = @"x.x"; //配置项：App版本。
   NSString *channel = @"xx"; //配置项：渠道标记。
   NSString *nick = @"xx"; //配置项：用户昵称。
   [[AlicloudTlogProvider alloc] autoInitWithAppVersion:appVersion channel:channel nick:nick];
   [AlicloudHAProvider start];
   [TRDManagerService updateLogLevel:TLogLevelXXX]; //配置项：控制台可拉取的日志级别。

   参数说明：

   参数	说明
   appVersion	用于指定App的版本，上报至服务端，进行版本区分。 【数据类型】字符串 【格式要求】自定义 【取值范围】任意长度 说明 该参数值将在控制台显示为下拉列表选项，建议短小凝练。 【是否必选】是 【是否可为空】否 【默认值】无 【大小写敏感】是。例如，vx.x和Vx.x不是一个版本。 【字符类型】英文大小写、数字。 说明 该参数不支持中文字符、特殊字符。 【示例】NSString *appVersion = @"1.0";
   channel	用于指定渠道标识，上报至服务端，进行渠道区分。 【数据类型】字符串 【取值范围】任意长度 【是否必选】是 【是否可为空】否 【默认值】无 【字符类型】英文大小写、数字。 说明 不支持中文字符、特殊字符。 【示例】NSString *channel = @"appstore";
   nick	用于指定用户昵称，上报至服务端，进行用户区分。后续可能依据该参数，进行数据检索。 【数据类型】字符串 【取值范围】任意长度 【是否必选】是 【是否可为空】否 【默认值】无 【字符类型】英文大小写、数字 说明 该参数不支持中文字符、特殊字符。 【命名规范】自定义 【示例】NSString *nick = @"wldtest";
   TLogLevelXXX	用于设置控制台可拉取的日志级别。日志级别说明参见：术语解释 【数据类型】枚举型 【取值范围】 TLogLevelError：拉取Error级别的日志。 TLogLevelWarn：拉取Warn和Error级别的日志。 TLogLevelInfo：拉取Warn、Error和Info级别的日志。 TLogLevelDebug：拉取Warn、Error、Info和Debug级别的日志。 【是否必选】否 【默认取值】TLogLevelInfo 【示例】[TRDManagerService updateLogLevel:TLogLevelInfo];

   说明

   推荐使用autoInitWithAppVersion接口接入服务。如需使用initWithAppKey接口接入服务，须手动配置appKey/secret/tlogRsaSecret参数。

   打开iOS配置文件，查询参数取值：

   参数	配置文件字段	说明
   appKey	emas.appKey	App标识。
   secret	emas.appSecret	App认证信息。
   tlogRsaSecret	appmonitor.tlog.rsaSecret	远程日志公钥。

执行编译

1. 在项目的Build Setting中，将Allow Non-modular Includes In Framework Modules设置为YES。

   

2. 执行编译。

打印日志

1. 如业务流程触发日志输出，需引入头文件：

   #import <TRemoteDebugger/TLogBiz.h>
   #import <TRemoteDebugger/TLogFactory.h>
   #import <TRemoteDebugger/TRDManagerService.h>

2. 在适当位置添加代码，输出日志信息。示例代码：

   TLogBiz *log = [TLogFactory createTLogForModuleName:@"YourModuleName"];
   [log error:@"error message"];
   [log warn:@"warn message"];
   [log debug:@"debug message"];
   [log info:@"info message"];

样例代码

远程日志服务iOS SDK接入工程样例参见：Demo工程