借助 App 监控的 SDK,您可以获取完备的远程日志。

前提条件

已将应用接入 App 监控。请参见创建监控任务

背景信息

本文档适用于使用 cocoaPods 管理依赖的 Xcode 项目,以及支持 iOS 8.0 或以上版本的 App。

说明 日志在移动端最多存储7天。

步骤一:添加依赖

Pod 依赖接入

  1. 指定官方仓库和阿里云仓库。
    source "https://github.com/CocoaPods/Specs.git"
    source "https://github.com/aliyun/aliyun-specs.git"
  2. 添加依赖。
    pod 'AlicloudTLog', '~> 1.0.0'

    ~> 为模糊指定版本号方式,~> 1.0.0 表明引用位于 1.0.0 <= version < 1.1.0 之间的最新版本 SDK。

    SDK 版本可参考Podfile Syntax Reference

  3. 执行 pod update
    说明 如果在 Xcode 9 上出现报错:RuntimeError - [Xcodeproj] Unknown object version.,请将 Project Format 改成 Xcode 8.0-compatible。

步骤二:接入服务

AppDelegate.m 文件的 application:didFinishLaunchingWithOptions: 方法中初始化 SDK。引入头文件:

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

示例代码:

NSString *appVersion = @"x.x"; //app版本,会上报
NSString *channel = @"xx";     //渠道标记,自定义,会上报
NSString *nick = @"xx";        //昵称,自定义,会上报

[[AlicloudTlogProvider alloc] autoInitWithAppVersion:appVersion channel:channel nick:nick];
[AlicloudHAProvider start];

步骤三:编译

如果编译报错,请在项目的 build setting 里设置 Allow Non-modular Includes In Framework Modules 为 YES。

如果出现包含 duplicate symbol 的错误,请确认其他本地依赖和 CocoaPods 管理的依赖是否有重复。如有重复,请删除本地依赖。强烈建议所有依赖都通过 CocoaPods 管理。

步骤四获取远程日志

引入头文件:

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

示例代码:

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

结果验证

在完成上述步骤之后,您可以对您的 APP 进行测试,并登录 ARMS 控制台查看数据报表。