This repository has been archived by the owner on Oct 3, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 22
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
1. Compatible with Android 11. 2. Use cmake instead of ndk-build. 3. Support AddressSanitizer(ASan). 4. No longer supports API level 14 and 15. 5. No longer supports armeabi.
- Loading branch information
Showing
239 changed files
with
651 additions
and
13,143 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,12 +1,11 @@ | ||
| .DS_Store | ||
|
|
||
| libs/ | ||
| obj/ | ||
|
|
||
| build/ | ||
| .cxx/ | ||
| .gradle/ | ||
| .idea/ | ||
| *.iml | ||
| *.log | ||
| *.so | ||
| wrap.sh | ||
| local.properties |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,24 +4,22 @@ | |
|
|
||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|
|
||
| xCrash provides the Android app with the ability to capture java crash, native crash and ANR. No root permission or any system permissions are required. | ||
|
|
||
| <p align="left"><img src="doc/intro.png" alt="intro" width="320px"></p> | ||
|
|
||
| xCrash can generate a tombstone file (similar format as Android system's tombstone file) in the directory you specified when the app process crashes or ANRs. | ||
|
|
||
| xCrash has been used in many Android apps (including iQIYI video) on different platforms (mobile, tablet, TV) of [iQIYI](http://www.iqiyi.com/) for many years. | ||
|
|
||
| [README 中文版](README.zh-CN.md) | ||
|
|
||
|
|
||
| ## Features | ||
|
|
||
| * Support Android 4.0 - 10 (API level 14 - 29). | ||
| * Support Android 4.1 - 11 (API level 16 - 30). | ||
| * Support armeabi, armeabi-v7a, arm64-v8a, x86 and x86_64. | ||
| * Capturing java crash, native crash and ANR. | ||
| * Dumping detailed statistics about process, threads, memory, FD and network. | ||
|
|
@@ -32,12 +30,10 @@ xCrash has been used in many Android apps (including iQIYI video) on different p | |
| ## Tombstone File Previews | ||
|
|
||
| * [java crash](doc/tombstone_java.txt) | ||
| * [native crash (armeabi)](doc/tombstone_native_armeabi.txt) | ||
| * [native crash (armeabi-v7a)](doc/tombstone_native_armeabi-v7a.txt) | ||
| * [native crash (arm64-v8a)](doc/tombstone_native_arm64-v8a.txt) | ||
| * [native crash (x86)](doc/tombstone_native_x86.txt) | ||
| * [native crash (x86_64)](doc/tombstone_native_x86_64.txt) | ||
| * [ANR (armeabi)](doc/tombstone_anr_armeabi.txt) | ||
| * [ANR (armeabi-v7a)](doc/tombstone_anr_armeabi-v7a.txt) | ||
| * [ANR (arm64-v8a)](doc/tombstone_anr_arm64-v8a.txt) | ||
| * [ANR (x86)](doc/tombstone_anr_x86.txt) | ||
|
|
@@ -64,7 +60,7 @@ xCrash has been used in many Android apps (including iQIYI video) on different p | |
|
|
||
| ```Gradle | ||
| dependencies { | ||
| implementation 'com.iqiyi.xcrash:xcrash-android-lib:2.4.9' | ||
| implementation 'io.hexhacking.xcrash:xcrash-android-lib:3.0.0' | ||
| } | ||
| ``` | ||
|
|
||
|
|
@@ -74,7 +70,7 @@ dependencies { | |
| android { | ||
| defaultConfig { | ||
| ndk { | ||
| abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' | ||
| abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' | ||
| } | ||
| } | ||
| } | ||
|
|
@@ -114,41 +110,17 @@ Tombstone files will be written to `Context#getFilesDir() + "/tombstones"` direc | |
| There is a more practical and complex sample app in the [src/java/xcrash/xcrash_sample](src/java/xcrash/xcrash_sample) folder. | ||
|
|
||
|
|
||
| ## Build | ||
|
|
||
| If you want to build xCrash from source code. Follow this guide: | ||
|
|
||
| #### 1. Download [Android NDK r16b](https://developer.android.com/ndk/downloads/revision_history.html), set PATH environment. | ||
|
|
||
| #### 2. Build and copy the native libraries. | ||
|
|
||
| ``` | ||
| cd ./src/native/ | ||
| ./build.sh | ||
| ./install.sh | ||
| ``` | ||
|
|
||
| #### 3. Build AAR library. | ||
|
|
||
| ``` | ||
| cd ./src/java/xcrash/ | ||
| ./gradlew :xcrash_lib:build | ||
| ``` | ||
|
|
||
|
|
||
| ## Support | ||
|
|
||
| 1. Check the [xcrash-sample](src/java/xcrash/xcrash_sample). | ||
| 2. Communicate on [GitHub issues](https://github.com/iqiyi/xCrash/issues). | ||
| 2. Communicate on [GitHub issues](https://github.com/hexhacking/xCrash/issues). | ||
| 3. Email: <a href="mailto:[email protected]">[email protected]</a> | ||
| 4. QQ group: 603635869. QR code: | ||
|
|
||
| <p align="left"><img src="doc/qq_group.jpg" alt="qq group" width="300px"></p> | ||
| 4. QQ group: 603635869. | ||
|
|
||
|
|
||
| ## Contributing | ||
|
|
||
| See [xCrash Contributing Guide](CONTRIBUTING.md). | ||
| [xCrash Contributing Guide](CONTRIBUTING.md). | ||
|
|
||
|
|
||
| ## License | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,24 +4,22 @@ | |
|
|
||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|  | ||
|
|
||
| xCrash 能为安卓 app 提供捕获 java 崩溃，native 崩溃和 ANR 的能力。不需要 root 权限或任何系统权限。 | ||
|
|
||
| <p align="left"><img src="doc/intro.png" alt="intro" width="320px"></p> | ||
|
|
||
| xCrash 能在 app 进程崩溃或 ANR 时，在你指定的目录中生成一个 tombstone 文件（格式与安卓系统的 tombstone 文件类似）。 | ||
|
|
||
| xCrash 已经在 [爱奇艺](http://www.iqiyi.com/) 的不同平台（手机，平板，电视）的很多安卓 app（包括爱奇艺视频）中被使用了很多年。 | ||
|
|
||
| [README English Version](README.md) | ||
|
|
||
|
|
||
| ## 特征 | ||
|
|
||
| * 支持 Android 4.0 - 10（API level 14 - 29）。 | ||
| * 支持 Android 4.1 - 11（API level 16 - 30）。 | ||
| * 支持 armeabi，armeabi-v7a，arm64-v8a，x86 和 x86_64。 | ||
| * 捕获 java 崩溃，native 崩溃和 ANR。 | ||
| * 获取详细的进程、线程、内存、FD、网络统计信息。 | ||
|
|
@@ -32,12 +30,10 @@ xCrash 已经在 [爱奇艺](http://www.iqiyi.com/) 的不同平台（手机， | |
| ## Tombstone 文件预览 | ||
|
|
||
| * [java 崩溃](doc/tombstone_java.txt) | ||
| * [native 崩溃 (armeabi)](doc/tombstone_native_armeabi.txt) | ||
| * [native 崩溃 (armeabi-v7a)](doc/tombstone_native_armeabi-v7a.txt) | ||
| * [native 崩溃 (arm64-v8a)](doc/tombstone_native_arm64-v8a.txt) | ||
| * [native 崩溃 (x86)](doc/tombstone_native_x86.txt) | ||
| * [native 崩溃 (x86_64)](doc/tombstone_native_x86_64.txt) | ||
| * [ANR (armeabi)](doc/tombstone_anr_armeabi.txt) | ||
| * [ANR (armeabi-v7a)](doc/tombstone_anr_armeabi-v7a.txt) | ||
| * [ANR (arm64-v8a)](doc/tombstone_anr_arm64-v8a.txt) | ||
| * [ANR (x86)](doc/tombstone_anr_x86.txt) | ||
|
|
@@ -64,7 +60,7 @@ xCrash 已经在 [爱奇艺](http://www.iqiyi.com/) 的不同平台（手机， | |
|
|
||
| ```Gradle | ||
| dependencies { | ||
| implementation 'com.iqiyi.xcrash:xcrash-android-lib:2.4.9' | ||
| implementation 'io.hexhacking.xcrash:xcrash-android-lib:3.0.0' | ||
| } | ||
| ``` | ||
|
|
||
|
|
@@ -74,7 +70,7 @@ dependencies { | |
| android { | ||
| defaultConfig { | ||
| ndk { | ||
| abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' | ||
| abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' | ||
| } | ||
| } | ||
| } | ||
|
|
@@ -114,41 +110,17 @@ Tombstone 文件默认将被写入到 `Context#getFilesDir() + "/tombstones"` | |
| 在 [src/java/xcrash/xcrash_sample](src/java/xcrash/xcrash_sample) 文件夹中，有一个更实际和复杂的示例 app。 | ||
|
|
||
|
|
||
| ## 构建 | ||
|
|
||
| 如果你想编译 xCrash 的源码。请按以下步骤进行： | ||
|
|
||
| #### 1. 下载 [Android NDK r16b](https://developer.android.com/ndk/downloads/revision_history.html)，设置 PATH 环境变量。 | ||
|
|
||
| #### 2. 编译和复制 native 库。 | ||
|
|
||
| ``` | ||
| cd ./src/native/ | ||
| ./build.sh | ||
| ./install.sh | ||
| ``` | ||
|
|
||
| #### 3. 编译 AAR 库。 | ||
|
|
||
| ``` | ||
| cd ./src/java/xcrash/ | ||
| ./gradlew :xcrash_lib:build | ||
| ``` | ||
|
|
||
|
|
||
| ## 技术支持 | ||
|
|
||
| 1. 查看 [xcrash-sample](src/java/xcrash/xcrash_sample)。 | ||
| 2. 在 [GitHub issues](https://github.com/iqiyi/xCrash/issues) 交流。 | ||
| 2. 在 [GitHub issues](https://github.com/hexhacking/xCrash/issues) 交流。 | ||
| 3. 邮件: <a href="mailto:[email protected]">[email protected]</a> | ||
| 4. QQ 群: 603635869。二维码: | ||
|
|
||
| <p align="left"><img src="doc/qq_group.jpg" alt="qq group" width="300px"></p> | ||
| 4. QQ 群: 603635869。 | ||
|
|
||
|
|
||
| ## 贡献 | ||
|
|
||
| 请阅读 [xCrash Contributing Guide](CONTRIBUTING.md)。 | ||
| [xCrash Contributing Guide](CONTRIBUTING.md) | ||
|
|
||
|
|
||
| ## 许可证 | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
Binary file not shown.
Oops, something went wrong.