Crasheye 常见问题

Android

Q: 符号文件什么时候生成？

A：每编译一次就会生成全新的符号文件，Android平台中，目标文件对应的是SO文件。每次构建或者发布APP版本的时候，一定要做好 备份好符号文件，或 做符号文件自动上传。自动上传方法可查看Q3

Q: 符号文件路径位置？

A：通常游戏项目，需要上传项目编译的so （如果有c++代码，也需要上传c++ 编译的so），以及libunity.so 工程中，有xx.sym.so 或 xxx.dbg.so 或 xxx.so 这几种符号文件 uuid是相同的，通常推荐上传xxx.dbg.so
符号文件的位置通常在：
il2cpp

• libunity.so (如果没有重新编译引擎，默认在编辑器的如下目录）
• libil2cpp.so (打包后在项目自己的构建临时目录下）

il2cpp Release(armeabi-v7a)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Release\Symbols\armeabi-v7a\libunity.sym.so

il2cpp Development(armeabi-v7a)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Development\Symbols\x86\libunity.sym.so

il2cpp Release(x86)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Release\Symbols\x86\libunity.sym.so

il2cpp Development(x86)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Development\Symbols\x86\libunity.sym.so

MONO

mono需要上传的符号文件

• libunity.so (如果没有重新编译引擎，默认在编辑器的如下目录）
• libmono.so (如果没有重现编辑mono，默认在编辑器的如下目录）

Release(armeabi-v7a)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\armeabi-v7a\libunity.sym.so

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\MonoLibs\armeabi-v7a\libmono.so

Release(x86)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\x86\libunity.sym.so

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\MonoLibs\x86\libmono.so

Development(armeabi-v7a)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\Symbols\armeabi-v7a\libunity.sym.so

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\MonoLibs\armeabi-v7a\libmono.so

Development(x86)版本

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\Symbols\x86\libunity.sym.so

\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\MonoLibs\x86\libmono.so

注意！！！

1. 如果勾选了 strip engine code， 必须要勾选Creat Symbol.zip , 项目打包出来以后会生成符号zip和libunity.so，否则将没有符号文件生成！！！

Q: 符号文件每次都要上传吗？怎么做自动上传

A：为了方便找回Crash对应的Debug SO文件和还原堆栈，每次构建或者发布APP版本的时候，一定要做好 备份好符号文件，或 做符号文件自动上传。一旦符号文件无法找回，堆栈将无法还原！！！
符号文件自动上传方法：

• 构建脚本使用符号文件工具进行上传

使用符号文件工具，在构建脚本中进行上传

注意！！！

1. 上传xx.sym.so 或 xxx.dbg.so 的时候！！！必须！！！重命名，重命名规则：xxx.sym.so->xxx.so, xxx.dbg.so->xxx.so 然后再上传。（不重命名再跑命令行，分析后台会无法匹配到符号）

2. 如果勾选了 strip engine code， 必须要勾选Creat Symbol.zip , 项目打包出来以后会生成符号zip和libunity.so，否则将没有符号文件生成！！！

Q: 平台显示符号文件uuid比本地符号文件uuid多了一个0，是为什么？

A： Crasheye 里面uuid计算方式和buildid是有些区别的，最后一位都会加一个0，不影响符号文件匹配

Q: 符号文件的uuid 是什么？

A：elf文件的build id，每次编译生成唯一ID

Q: 调用了log接口，但是没有收集上log

A: manifest中是否有 READ_LOGS 权限

Q: Android 触发dump 后，为什么收不到崩溃？

A：按照下述步骤进行排查

1. 查看日志，确认Crasheye init 成功
2. 触发崩溃后，是否重启游戏，dump 将在重新启动游戏后上报，通常10min内就会上报
3. 确认android 初始化是否在java 层，打java包的方法，详见Android初始化

Q: 后台只看到Java相关的错误堆栈信息，没发现有NDK相关的堆栈异常？

A: 问题排除方法：

1. 这种情况应该是初始化错误，Crasheye NDK相关的初始化应该是调用：详情参考Android NDK接入指南

   Crasheye.initWithNativeHandle(this, "Your_Appkey");

2. 不同的项目引擎排除方法也不一样，Logcat中有相应的日志输出，例如：引擎使用Cocos2d，查看logcat初始化日志：

查看是否有以上的NDK初始化信息，如果没有，代表NDK没有初始化成功，请参照第一步重新初始化；
3. 请不要将Crasheye加入代码混淆；
4. 如果是项目的so也加入了混淆，则Crasheye无法捕获NDK的宕机；

Q: 部分机型在Android5.0 之后的版本捕获不到NDK异常？

A: libCrasheyeNDK.so 版本过旧，更新官网最新版本的so就可以成功捕获；（NDK下载）

Q: 接入Unity SDK后，初始化提示 mono signal chain fail 是啥原因？

A： 该Error并不影响Crasheye 的接入，忽略即可

Q: 页面堆栈未解析，是什么原因？

A： 请根据下述方法进行排查

• 符号文件没有上传

  页面提示 module “符号文件名” uuid “符号文件uuid” is miss

1. 点击重新分析，如果页面仍然进行 miss提示，进行步骤2排查
2. 在设置 - 符号文件 页面，根据uuid，搜索符号文件是否存在，符号文件名 是否完全匹配
3. 如果符号文件不存在，请在构建机上查找符号文件并重新上传

• 堆栈损坏

页面提示 module “符号文件名” uuid “符号文件uuid” is corrupt，底层breakpad 无法解析，此种崩溃无论是Crasheye 还是用户都无法进行任何处理，通常这种崩溃仍然可以解析出部分堆栈，用户可以根据有限的堆栈，进行崩溃分析。更多的解释可见：

Heap corruption occurs when dynamic allocation of memory is not handled properly. Typical heap corruption problems are reading, or writing outside of the bounds of allocated memory, or double-freeing memory. Since the result (e.g. a hard crash) can happen later, when the program tries to manipulate the incorrectly allocated piece of memory, the root cause of the issue can remain hidden from your eyes.

• 先触发崩溃，再上传崩溃，点击重新分析即可

服务不会实施监控符号文件上传，因此先触发崩溃，再上传崩溃，页面堆栈也会未解析，此时需要点击重新分析，堆栈将会重新解析

Q: 如何获取lua 的脚本异常？

A：在初始化后调用API，捕获到脚本异常（例如空指针等），Android、iOS、Unity 插件均支持捕获脚本异常，具体接入见常用API

为了减少重复上报，相同的异常信息在 10 分钟内只能上报一次

Q: 堆栈解析可以定位到行号吗？

A: 有些可以定位到行号，有些不行。
不是所有的堆栈都可以解析出行号的，需要具体问题具体分析。
如果已经上传符号文件，并且已经点击重新分析，可以查看解析后的堆栈

iOS

Q: 什么是dSYM文件？

A: iOS中，dSYM文件是指具有调试信息的目标文件，文件名通常为： xxx.app.dSYM
一般情况下，项目编译完dSYM文件跟app文件在同一个目录下
XCode -> 项目工程 -> Products -> XXX.app -> 右键"显示文件夹" -> XXX.app.dSYM
为了保证能够还原堆栈信息， 建议每次构建或者发布版本时候，备份好dSYM文件 。

Q: 符号文件工具上传报错 dump_syms command is exception，怎么解决？

A: dump_syms没有访问权限，要执行以下chmod a+x dump_syms的这个可执行文件。

Q: 接入Crasheye后app启动崩溃，Log里有输出 <Error>: +[NSString ksgIsNilOrEmpty:]: unrecognized selector？

A: Linker Flags中没有添加-ObjC选项；（详情参考：iOS SDK接入指南）

Q: 生成的crash 文件存储在什么位置？

A: 保存在Library/Caches/Crasheye下

Q: 产生崩溃后，为什么没有生成对应的crash文件？

A: 1.检查log，查看Crasheye是否有正常初始；
    2.检查是否连接debugger，连接debugger时，不生成crash文件；

Q: 产生崩溃后，网站上为什么没有对应记录？

A: 重新启动App才会上传上一次崩溃的crash文件。

Q: iOS 触发dump 后，为什么收不到崩溃？

A：按照下述步骤进行排查

1. 查看日志，确认Crasheye init 成功
2. Crasheye不收集杀端 sigkill 、内存宕机、无限递归宕机，如果宕机类型为这几种，将不会上报
3. 触发崩溃后，是否重启游戏，dump 将在重新启动游戏后上报，通常10min内就会上报
4. 确认是否在调试状态下，调试状态下不捕捉dump， 测试的时候不要接调试器（xcode

Unity

Q: Unity工程符号文件在哪里？

MONO
mono需要上传的符号文件

• libunity.so (如果没有重新编译引擎，默认在编辑器的如下目录）
• libmono.so (如果没有重现编辑mono，默认在编辑器的如下目录）

Release(armeabi-v7a)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\armeabi-v7a\libunity.sym.so
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\MonoLibs\armeabi-v7a\libmono.so

Release(x86)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\x86\libunity.sym.so
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\MonoLibs\x86\libmono.so

Development(armeabi-v7a)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\Symbols\armeabi-v7a\libunity.sym.so
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\MonoLibs\armeabi-v7a\libmono.so

Development(x86)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\Symbols\x86\libunity.sym.so
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Development\MonoLibs\x86\libmono.so

il2cpp

il2cpp需要上传的符号文件

• libunity.so (如果没有重新编译引擎，默认在编辑器的如下目录）
• libil2cpp.so (打包后在项目自己的构建临时目录下）

il2cpp Release(armeabi-v7a)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Release\Symbols\armeabi-v7a\libunity.sym.so

il2cpp Development(armeabi-v7a)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Development\Symbols\x86\libunity.sym.so

il2cpp Release(x86)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Release\Symbols\x86\libunity.sym.so

il2cpp Development(x86)版本
\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Development\Symbols\x86\libunity.sym.so

如果勾了这个striped，那么需要在打包的时候勾上create symbols.zip，里面才会有符号文件，不能再去引擎目录拿了， striped过后的so连buildid都变了。
其他第三方库符号文件根据应用需求上传即可

Q: Unity捕获不到脚本异常信息？

A: 问题排除方法：

1. 应用程序在最外层添加了try catch，导致异常被try catch捕获，没有被Crasheye捕获到;
2. 搜索项目其他地方有无重复使用 Application.RegisterLogCallback，如果有请使用Crasheye.SetRegisterLogFunction 代替，详情查看 帮助文档 ；
3. 确定Crasheye.cs 在项目启动入口有初始化；

Q: Unity使用MONO接入的好处是什么？

A: 使用unity接入后可以查看到部分NDK崩溃的C#的堆栈信息，如下图

Q: Unity如何查看NDK堆栈信息？

A: 把unity版本下的libmain.so、libunity.so、libmono.so符号文件上传到Crasheye服务，Crasheye会自动进行重新分析，稍等片刻即可查看到相关的NDK堆栈信息；

符号文件

Q: 什么是符号表，配置符号表的作用是什么？

A: 符号表是内存地址与函数名、文件名、行号的映射表。为了能快速并准确地定位用户APP发生Crash的代码位置，Crasheye使用符号表对APP发生Crash的程序堆栈进行解析和还原

Q: 配置符号表是不是必须的？什么情况下必须配置符号表？

A: 不是必须的，不会影响异常上报，但建议您进行配置。

Android( Java及NDK )符号表配置指南
iOS符号表配置指南

Q: 符号文件上传提示成功，但崩溃堆栈信息仍未分析出详细结果

A: 确认所上传的符号文件版本是否正确（方法是：刷新崩溃详情页，在页面头部显示的提示信息中的uuid是否在“设置 – 符号文件 – 符号文件上传 - 已上传列表”中存在）

Q: 符号文件上传是否有文件大小限制？

A: 使用工具上传时，单文件最大1G，其他方式上传无限制，请放心使用

Q: iOS 上传文件提示 run lipo -info false？

A: 问题排除方法：

1. 是否使用了正确的符号文件上传工具，iOS应用的符号文件上传工具文件名为***iOS***.jar，Android应用的符号文件上传工具文件名为***Android***.jar；
2. 符号文件路径不支持空格，若有，请将空格删除；

Crasheye 后台使用

Q: 如何添加成员？

A： 第一步：在Crasheye平台鼠标移入左边菜单栏选择权限管理平台 (opens new window)

第二步：切换成员管理，点击新增，通过Email进行搜索项目成员并选择用户组信息，Email以英文逗号隔开可同时添加多个成员，点击保存即添加成功

非管理员权限，无法添加成员，可咨询对应项目的管理员，进行添加

Q: 如何创建AppKey？

A：第一步：在Crasheye平台鼠标移入左边菜单栏选择权限管理平台 (opens new window)

第二步：切换至项目信息，点击新增，填写应用名称（通常建议填写地区）、选择平台，确定后系统自动生成AppKey

Q: 如何进行告警？

A: 在Crasheye 平台 (opens new window) 设置 - 监控设置 - 告警设置 点击添加告警规则

满足告警规则后，App的使用次数必须> 0 ，才能触发告警，项目将（以AppKey 作为唯一标识）从此刻开始24小时内（崩溃数、崩溃率、受影响用户数、受影响用户率），发送告警邮件，邮件无上限。

同一个崩溃问题：

• 首次触发告警，大约在10min - 30min 内收到告警邮件；

• 再次达到告警阈值（与上一次作比较数值不变，不触发告）隔1个小时后发送第2封邮件；

• 服务每10min左右校验一次告警规则，邮件服务接收告警失败，每0.5min重试1次，重试失败抛异常，达到3次停止重试，结果记录日志。

监控项

• 指定版本: 指定一个版本号并且该版本号上报崩溃触发告警规则；指定多个版本号时，任一版本满足告警规则，触发告警。

• 所有版: 所有版本满足告警规则，触发告警。

• 单个版本: 任一版本满足告警规则，触发告警。

• 单个崩溃问题: 当某个崩溃问题，崩溃数超过x时候，触发告警

监控指标

• 崩溃率 （推荐）: 崩溃率 (%)=崩溃次数/ 使用次数，保留1位小数点

• 受影响用户率（推荐）: 受影响用户率(%) = 受影响用户数/ 用户数，保留1位小数点

• 崩溃数: 使用App 发生的闪退数量，整数

• 受影响用户数: 一台设备发生多次闪退，计做一个受影响用户数，整数

Q: 如何升级Crasheye后台？

为了进一步提高用户体验，系统服务性能，Crasheye 后台将升级至新版，旧数据不会收到影响 旧版同时会停止权限管理的入口

注意：仅管理员权限才能进行升级

提交后，项目将完成升级

Q: Crasheye是否收费？

A: 永久免费，请放心使用

Q: Crasheye是否会有数据泄漏问题？收集了哪些信息？

A: 所收集的数据都是与崩溃相关，目的是为了给开发者提供真实的崩溃场景，并未收集任何个人隐私信息，且数据分析完成后，只针对该项目成员开放

常规收集的信息主要包括：
崩溃环境：Crash信息及线程堆栈，ROM/RAM、网络环境/系统语言等
App信息：包名、版本、所属进程名
设备信息：设备名称、系统版本、屏幕分辨率
开发者均可以通过打印上报数据日志来查看所有上报内容

Q: 未上线的应用可以使用吗？

A: 可以

Q: Crasheye和第三方SDK同时编译会不会有冲突？

A: 可能会有冲突，接入时遇到问题可联系Crasheye或第三方SDK的官方人员，或在相应帮助中查找解决方案

Q: Crasheye和同类SDK同时使用会不会有冲突？

A: 不会，建议将Crasheye在同类SDK初始化之后再初始化

Q: 接入Crasheye后会不会影响程序的运行速度？

A: 几乎没有影响，Crasheye只会在应用启动的时候，检查上次是否有崩溃数据需要上传，若有，则数据经过压缩后再上传，不影响应用的功能

Q: 消耗的流量大不大？

A: Crasheye提供接口设置只在wifi环境下才上报，当不在wifi下产生的宕机文件会保存到本地，等wifi环境下再上传，据Crasheye的统计，平均每个崩溃的数据传输量在10K左右

Q: (iOS)接入Crasheye会影响app store发布吗？

A: 不会

Q: Crasheye支持哪些自定义的功能？

A: 提供了多个功能控制接口和信息记录API：

Android Api使用说明
iOS Api使用说明

Q: 我现在使用我自己的账号登录，由于工作变动可以把登录账号更改了吗？

A: 如果你是“应用所有者”，无法将帐号和应用进行解绑，建议在创建应用时使用公司产品邮箱，而非个人名字邮箱 如果你非“应用所有者”，联系“应用所有者”进行解除关联即可

Q: 接入Crasheye之后，对原应用的内存占用和CPU消耗会有多大影响？

A: 接入Crasheye之后，内存占用增加了0.86MB，CPU峰值均为1%，并无影响。
    测试方法：使用 TestPlus客户端 (opens new window) 性能测试工具，对同一程序在接入Crasheye前后均至少测试三次，每次测试时间不少于30秒，取平均值。
测试数据见下表：

	无Crasheye	有Crasheye	增幅
内存	32.81MB	33.67MB	0.86MB
CPU峰值	1%	1%	0%

测试手机：红米note3

Q: 项目已经接入了Crasheye，但页面显示未接入？

A: 问题排除方法：

Step1：访问网络权限是否已经添加；
< uses-permission android:name="android.permission.INTERNET"/>

Step2：在logcat搜索是否有以下字符（上报活跃）；
NetSender: Sending data to url: http://rp.crasheye.cn/session (opens new window)

Step3：查看是否有以下结果；
NetSender: Transmitting result {"ret":0,"msg":"","data":{"appkeyvalid":true}}

若以上3步检查不通过，请查看帮忙文档重新接入或者联系官方工作人员

Q: 为什么我的应用崩溃率会超过100%？

A: 有以下两种可能:

1. 应用一启动就产生了崩溃，并成功被Crasheye捕获到，但是，报活未完成，由于崩溃堆栈有上报失败缓存功能，而报活无此逻辑，导致在之后的某次上报中，同时上报了多条崩溃，但只有一次报活，在这种情况下，可能会出现崩溃次数大于报活的情况，就终会导致崩溃率会超过100%；

2. 应用在服务（service）里初始化了Crasheye，服务在产生崩溃之后，Crasheye会将该崩溃上报，但由于服务启动时是不会进行session（报活），而主程序此时并未崩溃，如果大量出现这种（服务崩溃的）情况就会导致 崩溃数 > 报活数；如果确定需要在服务里收集崩溃，崩溃数大于报活数的现象是属于正常的；

ps：Crasheye为什么不对服务进行报活？服务的崩溃，是不会对主程序功能产生影响的，并且主程序可以随时把服务启动起来，但服务的启动不能算是一次用户的活跃，所以Crasheye才确定不在服务里提供报活。

Q: 如何通过发生宕机的手机，在页面上查找到对应的宕机信息？

A: 有两种方法可以定位到宕机问题：

方法一：通过uid 可以定位到此机器的所有宕机信息；

1. 手机接入电脑，通过logcat可以查到uid的值，通过此值可以在电脑上查找，如下图的uid为：69d86f0988d898df246e36071bb02baa

2. 通过设备ID可以直接在页面上进行搜索：

编号#950的宕机信息就是我们需要搜索的宕机。

方法二：通过用户标识定位宕机信息；

1. 用户标识是在初始化Crasheye的时候设置进来： （可以查看常用API: 设置用户标识 ）
2. 假如你设置的用户标识为UserByCQF，那么在页面里就可以这么搜索：

页面就会把所有有关UserByCQF这位用户的所有宕机都会列出来。