全部产品
云市场

iOS SDK 接入手册

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

崩溃分析属于EMAS服务的一个部分,接入后可以在控制台直接开通使用。

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

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

一、摘要

  • 针对客户端运维需求,提供了完备的客户端崩溃分析监控能力,具体包括:

    • Crash监控、Abort监控、崩溃问题聚合、影响面分析等

二、iOS SDK 接入

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

2.1 添加依赖

2.1.1 Pod集成

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

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

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

  1. RuntimeError - [Xcodeproj] Unknown object version.

请将Project Format改成 Xcode 8.0-compatible

2.1.2 手动集成SDK

2.1.2.1 控制台下载
  • 您可以通过控制台页面,点击“SDK下载”,选择“崩溃分析”产品获取 SDK,下载并拷贝下载包内所有库文件放在项目工程里。
2.1.2.2 公共包依赖
  • libc++.tbd
  • SystemConfiguration.framework
2.1.2.3 SDK目录结构
  • AlicloudCrash.framework
  • AliHACore.framework
  • AliHALogEngine.framework
  • AliHAProtocol.framework
  • AlicloudHAUtil.framework
  • AlicloudUtils.framework
  • AlicloudUT.framework
  • CrashReporter.framework
  • JDYThreadTrace.framework
  • TBCrashReporter.framework
  • TBJSONModel.framework
  • TBRest.framework
  • UTDID.framework
  • ZipArchive.framework
2.1.2.4 引入Framework
  • Xcode中,直接把下载SDK目录中的framework拖入对应Target下即可,在弹出框勾选Copy items if needed。
  • 在 Build Phases -> Link Binary With Libraries中,引入1.1.2.2 列出的公共包。

2.2 接入服务

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

  1. #import <AlicloudCrash/AlicloudCrashProvider.h>
  2. #import <AlicloudHAUtil/AlicloudHAProvider.h>

示例代码:

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

2.3 编译

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

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

三、 测试验证

在您完成上述步骤之后,您可以测试您的App,通过https://emas.console.aliyun.com查看数据报表。

四、技术支持

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

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

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

如果发现崩溃分析与移动数据分析发生冲突,请移步钉钉群21979548解决此问题。

(2)工单

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