如何通过Pod集成方式添加依赖接入远程日志服务-阿里云帮助中心

本文介绍如何通过Pod集成方式添加依赖接入远程日志服务。

说明

接入远程日志服务的iOS SDK可采用Pod集成和手动集成2种方式添加依赖。推荐使用Pod集成方式添加依赖，可大幅简化接入操作。
如需使用手动集成方式添加依赖，操作方法请参见iOS SDK接入（手动集成）。

前提条件

已创建工作空间/应用。

使用限制

仅支持iOS 10.0及以上的App。
推荐使用CocoaPods管理依赖的Xcode项目。
日志在手机端上最多存储7天。

接入概述

添加依赖：采用Pod集成方式添加依赖。
接入服务：配置相关密钥信息；引入头文件；初始化SDK ；设置日志拉取级别。
执行编译：添加编译设置。
打印日志：在业务代码中打印日志信息。

添加依赖

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

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

2：添加依赖。

pod 'AlicloudTLog', '1.1.1'

说明

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

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

接入服务

打开EMAS控制台，在应用配置信息页，获得必要配置信息。

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

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

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

NSString *appVersion = @"<Your AppVersion>";  
NSString *channel = @"<Your App Releasing Channel>";  
NSString *nick = @"<User Nickname>"; 
NSString *appKey = @"<Your AppKey>";
NSString *appSecret = @"<Your AppSecret>";
NSString *appRsaSecret = @"<Your AppRsaSecret>";

[[AlicloudTlogProvider alloc] initWithAppKey:appKey secret:appSecret tlogRsaSecret:appRsaSecret appVersion:appVersion channel:channel nick:nick];
[AlicloudHAProvider start];
[TRDManagerService updateLogLevel:TLogLevelInfo]; //配置项：控制台可拉取的日志级别

参数说明：

参数	说明
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];`

执行编译

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

编译设置

2：执行编译。

说明

编译过程中如出现duplicate symbol类型错误，确认本地依赖与CocoaPods管理的依赖是否重复；如是，则删除本地依赖。
如同时使用其他阿里云产品，可能会因为依赖中存在UTDID冲突，造成编译失败。解决办法请参见SDK UTTID冲突解决方案。

打印日志

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

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

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

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

选项	说明
YourModuleName	指定保存日志信息的模块的名称。
error/warn/debug/info message	根据实际场景，区分级别输出日志信息，便于后续按照级别进行日志信息查询。日志级别说明请参见基本概念。

样例代码

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