README.zh-CN.md

xCrash

xCrash 能为安卓 app 提供捕获 java 崩溃，native 崩溃和 ANR 的能力。不需要 root 权限或任何系统权限。

xCrash 能在 app 进程崩溃或 ANR 时，在你指定的目录中生成一个 tombstone 文件（格式与安卓系统的 tombstone 文件类似）。

xCrash 已经在 爱奇艺 的不同平台（手机，平板，电视）的很多安卓 app（包括爱奇艺视频）中被使用了很多年。

README English Version

特征

• 支持 Android 4.1 - 11（API level 16 - 30）。
• 支持 armeabi-v7a，arm64-v8a，x86 和 x86_64。
• 捕获 java 崩溃，native 崩溃和 ANR。
• 获取详细的进程、线程、内存、FD、网络统计信息。
• 通过正则表达式设置需要获取哪些线程的信息。
• 不需要 root 权限或任何系统权限。

Tombstone 文件预览

• java 崩溃
• native 崩溃 (armeabi-v7a)
• native 崩溃 (arm64-v8a)
• native 崩溃 (x86)
• native 崩溃 (x86_64)
• ANR (armeabi-v7a)
• ANR (arm64-v8a)
• ANR (x86)
• ANR (x86_64)

概览图

架构

捕获 native 崩溃

捕获 ANR

使用

1. 增加依赖。

dependencies {
    implementation 'com.iqiyi.xcrash:xcrash-android-lib:3.0.0'
}

2. 指定一个或多个你需要的 ABI。

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }
}

3. 初始化 xCrash。

Java

public class MyCustomApplication extends Application {

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        
        xcrash.XCrash.init(this);
    }
}

Kotlin

class MyCustomApplication : Application() {

    override fun attachBaseContext(base: Context) {
        super.attachBaseContext(base)

        xcrash.XCrash.init(this)
    }
}

Tombstone 文件默认将被写入到 Context#getFilesDir() + "/tombstones" 目录。（通常在： /data/data/PACKAGE_NAME/files/tombstones）

在 xcrash_sample 文件夹中，有一个更实际和复杂的示例 app。

构建

编译 xCrash AAR 库:

./gradlew :xcrash_lib:build

技术支持

• GitHub Issues
• GitHub Discussions
• Telegram Public Group
• Email: caikelun@gmail.com, xuqnqn@qq.com

贡献

请阅读 xCrash Contributing Guide。

许可证

xCrash 使用 MIT 许可证。

xCrash 的文档使用 Creative Commons 许可证。