xCrash

xクラッシュ

xCrash は、Java クラッシュ、ネイティブ クラッシュ、ANR をキャプチャする機能を Android アプリに提供します。 root 権限やシステム権限は必要ありません。

xCrash は、アプリのプロセスがクラッシュしたり ANR が発生したときに、指定したディレクトリにトゥームストーン ファイル (Android システムのトゥームストーン ファイルと同様の形式) を生成できます。

xCrash は、iQIYI のさまざまなプラットフォーム (モバイル、タブレット、テレビ) 上の多くの Android アプリ (iQIYI ビデオを含む) で長年使用されてきました。

お読みください

特徴

• Android 4.1 ～ 11 (API レベル 16 ～ 30) をサポートします。
• armeabi-v7a、arm64-v8a、x86、および x86_64 をサポートします。
• Java クラッシュ、ネイティブ クラッシュ、ANR をキャプチャします。
• プロセス、スレッド、メモリ、FD、ネットワークに関する詳細な統計をダンプします。
• 正規表現を使用してどのスレッドの情報をダンプするかを設定します。
• root 権限やシステム権限は必要ありません。

トゥームストーン ファイルのプレビュー

• Javaクラッシュ
• ネイティブクラッシュ (armeabi-v7a)
• ネイティブクラッシュ (arm64-v8a)
• ネイティブクラッシュ (x86)
• ネイティブクラッシュ (x86_64)
• ANR (アルメアビ-v7a)
• ANR (arm64-v8a)
• ANR (x86)
• ANR (x86_64)

概要マップ

建築

ネイティブクラッシュをキャプチャ

ANRをキャプチャ

使用法

1. 依存関係を追加します。

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

2. 必要な 1 つ以上の ABI を指定します。

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

3. xCrash を初期化します。

ジャワ

 public class MyCustomApplication extends Application {

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

コトリン

 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 フォルダーには、より実用的で複雑なサンプル アプリがあります。

建てる

ソース コードから xCrash をビルドする場合。このガイドに従ってください:

AARライブラリを構築します。

 ./gradlew :xcrash_lib:build

サポート

• GitHubの問題
• GitHub ディスカッション
• テレグラムパブリックグループ
• 電子メール: [email protected]、[email protected]

貢献する

「xCrash 貢献ガイド」を参照してください。

ライセンス

LICENSE ファイルに記載されているように、xCrash は MIT ライセンスを取得しています。

xCrash ドキュメントは、LICENSE-docs ファイルにあるように、クリエイティブ コモンズ ライセンスを取得しています。