全部产品
云市场

iOS SDK 接入手册

更新时间:2020-07-03 17:50:22

在接入阿里云 SDK 之前,请明确:

  • 您已在阿里云移动研发平台 ( EMAS ) 上建立相关产品,并获得对应的appId和appSecret,以及加tlog.rasSecret

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

一、iOS SDK接入

本文档适用于使用cocoaPods管理依赖的Xcode项目,适用于最低支持iOS 8.0的App。具体接入方法可参考Demo工程

1.1 添加依赖

1.1.1 Pod集成

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

( ~> 为模糊指定版本号方式,~> 1.0.0表明引用版本位于1.0.0 <= version < 1.1.0之间的最新版本SDK,用户可参考Podfile Syntax Reference,根据项目需要指定SDK版本。)

执行pod update。如果在Xcode 9上出现如下错误

  1. RuntimeError - [Xcodeproj] Unknown object version.

请将Project Format改成 Xcode 8.0-compatible

1.1.2 手动集成SDK

1.1.2.1 控制台下载
  • 您可以通过控制台页面,点击“SDK下载”,选择“移动日志”产品获取 SDK,下载并拷贝下载包内所有库文件放在项目工程里。
1.1.2.2 公共包依赖
  • libresolv.tbd
  • libc++.tbd
  • SystemConfiguration.framework
1.1.2.3 SDK目录结构
  • AlicloudTLog.framework
  • AlicloudHAUtil.framework
  • AliHACore.framework
  • AliHALogEngine.framework
  • AliHAMethodTrace.framework
  • AliHAProtocol.framework
  • AliHASecurity.framework
  • AlicloudUtils.framework
  • AlicloudUT.framework
  • AliyunOSSiOS.framework
  • RemoteDebugChannel.framework
  • TBJSONModel.framework
  • TBRest.framework
  • TRemoteDebugger.framework
  • UTDID.framework
  • ZipArchive.framework
1.1.2.4 引入Framework
  • Xcode中,直接把下载SDK目录中的framework拖入对应Target下即可,在弹出框勾选Copy items if needed。
  • 在 Build Phases -> Link Binary With Libraries中,引入1.1.2.2 列出的公共包。

1.2 接入服务

控制台下载AliyunEmasServices-Info.plist并拷贝至项目根目录。在AppDelegate.m文件的application:didFinishLaunchingWithOptions:方法中初始化SDK。引入头文件:

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

示例代码:

  1. NSString *appVersion = @"x.x"; //app版本,会上报
  2. NSString *channel = @"xx"; //渠道标记,自定义,会上报
  3. NSString *nick = @"xx"; //nick 昵称,自定义,会上报
  4. [[AlicloudTlogProvider alloc] autoInitWithAppVersion:appVersion channel:channel nick:nick];
  5. [AlicloudHAProvider start];

1.3 编译

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

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

1.4 使用

引入头文件:

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

示例代码:

  1. TLogBiz *log = [TLogFactory createTLogForModuleName:@"YourModuleName"];
  2. [log error:@"error message"];
  3. [log warn:@"warn message"];
  4. [log debug:@"debug message"];
  5. [log info:@"info message"];

二、测试验证

在您完成上述步骤之后,您可以测试您的App,通过https://emas.console.aliyun.com 找到对应设备并下发日志提取指令,APP联网并到后台的情况下会上传日志,可在 拉取设备列表中找到对应的设备日志。

三、技术支持

EMAS通过钉钉群的形式为您的日常问题进行解答,钉钉群内会不定期推送更新通知等各类信息。请务必下载钉钉,包括PC版和移动版。

(1)EMAS组件服务钉钉群:

  • 性能分析:23166990
  • 远程日志:23352396
  • 崩溃分析:21763813
  • 移动热修复: 群四:23103350( 其它群已满 )
  • HTTPDNS: 11777313
  • 移动推送 11795523
  • 移动测试 11762195

(2)工单

可以通过工单提交问题反馈,工单提交地址为:https://selfservice.console.aliyun.com/ticket/createIndex