如何自定義一個全域性異常捕獲器-SpiderMan

simplepeng發表於2019-01-09
IDE

如何自定義一個全域性異常捕獲器-SpiderMan

一圖勝前言

如何自定義一個全域性異常捕獲器-SpiderMan

上圖中，我們模擬了NullPointerException的發生，系統捕獲了該異常，並用一個介面展示了出來。

如何實現

想要實現全域性異常的捕獲我們需要了解Thead中的一個內部介面UncaughtExceptionHandler，該介面在JDK1.5中被新增。

所有我們需要自定義一個類去實現該介面，並且設定給Thread的DefaultUncaughtExceptionHandler。

//虛擬碼
public class SpiderMan implements Thread.UncaughtExceptionHandler {
    private SpiderMan() {
        Thread.setDefaultUncaughtExceptionHandler(this);
    }
    
     @Override
    public void uncaughtException(Thread t, Throwable ex) {

    }
}
複製程式碼

UncaughtExceptionHandler會捕獲程式碼中沒有捕獲的異常，然後回撥給uncaughtException方法。

高階操作

解析Throwable

 private CrashModel parseCrash(Throwable ex) {
        CrashModel model = new CrashModel();
        try {
            model.setEx(ex);
            model.setTime(new Date().getTime());
            if (ex.getCause() != null) {
                ex = ex.getCause();
            }
            model.setExceptionMsg(ex.getMessage());
            StringWriter sw = new StringWriter();
            PrintWriter pw = new PrintWriter(sw);
            ex.printStackTrace(pw);
            pw.flush();
            String exceptionType = ex.getClass().getName();

            if (ex.getStackTrace() != null && ex.getStackTrace().length > 0) {
                StackTraceElement element = ex.getStackTrace()[0];

                model.setLineNumber(element.getLineNumber());
                model.setClassName(element.getClassName());
                model.setFileName(element.getFileName());
                model.setMethodName(element.getMethodName());
                model.setExceptionType(exceptionType);
            }

            model.setFullException(sw.toString());
        } catch (Exception e) {
            return model;
        }
        return model;
    }
複製程式碼

如上程式碼所示，我們可以從Throwable類中解析出很多有用的資訊，包括崩潰發生的類，所在行數,exception的型別...

跳轉新的介面顯示Crash資訊

Intent intent = new Intent(mContext, CrashActivity.class);
intent.putExtra(CrashActivity.CRASH_MODEL, model);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
mContext.startActivity(intent);
複製程式碼

在對Throwable解析完成後，我們就可以跳轉到一個新的Activity並展示Crash的相關資訊，這裡Context是Application的Context，所有必須使用Intent.FLAG_ACTIVITY_NEW_TASK才能成功跳轉。

分享Crash資訊

如何自定義一個全域性異常捕獲器-SpiderMan

分享文字

把Throwable解析成有用的字串，呼叫系統的分享方法

private void shareText(String text) {
        Intent intent = new Intent(Intent.ACTION_SEND);
        intent.setType("text/plain");
        intent.putExtra(Intent.EXTRA_SUBJECT, "崩潰資訊：");
        intent.putExtra(Intent.EXTRA_TEXT, text);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        startActivity(Intent.createChooser(intent, "分享到"));
    }
複製程式碼

分享長圖

分享圖片要涉及東西就多啦，比如ScrollView的截圖，如何儲存到Sd卡，6.0需要動態許可權檢測，7.0還要相容fileprovider。

ScrollView的截圖

scrollview截圖原理很簡單，就是建立一個和ScrollView一樣寬高的Bitmap，然後將ScrollView的內容畫在Bitmap上。

public Bitmap getBitmapByView(ScrollView view) {
    if (view == null) return null;
    int height = 0;
    for (int i = 0; i < view.getChildCount(); i++) {
        height += view.getChildAt(i).getHeight();
    }
    Bitmap bitmap = Bitmap.createBitmap(view.getWidth(), height, Bitmap.Config.ARGB_8888);
    Canvas canvas = new Canvas(bitmap);
    canvas.drawRGB(255, 255, 255);
    view.draw(canvas);
    return bitmap;
}
複製程式碼

上面的程式碼中遍歷了ScrollView的所有子view，為了計算出ScrollView的真實高度，但是其實分析原始碼可以得知ScrollView其實只能有一個子view，所以直接獲取ScrollView的第一個子view也是可以的。

//ScrollView
@Override
public void addView(View child) {
    if (getChildCount() > 0) {
        throw new IllegalStateException("ScrollView can host only one direct child");
    }

    super.addView(child);
}
複製程式碼

接著就是建立一個和ScrollView寬高一樣的Bitmap，並將它設定給Canvas，Canvas先draw了一個白色的背景，然後才將view的內容畫在Bitmap上。

6.0 動態許可權

Android從 6.0(API 23)開始，對系統許可權做了很大的改變。從6.0開始，一些敏感許可權，需要在使用時動態申請，並且使用者可以拒絕授權訪問這些許可權，已授予過的許可權，使用者也可以去APP設定頁面去關閉授權。因為我們需要將長圖儲存到SD卡後分享，所以我們就需要讀寫SD卡的許可權，讀寫SD卡許可權也屬於敏感許可權。

我們需要呼叫ActivityCompat類下的requestPermissions方法去申請許可權。

ActivityCompat.requestPermissions(Activity activity, String[] permissions, int requestCode);
複製程式碼
  • activity 當前申請許可權的Activity
  • permissions 要申請的許可權組
  • requestCode 請求碼

然後我們需要在當前Activity下重寫onRequestPermissionsResult來判斷使用者是否授權了我們申請的許可權。

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                       @NonNull int[] grantResults) {
    //判斷請求碼，確定當前申請的許可權
    if (requestCode == REQUEST_CODE) {
        //判斷許可權是否申請通過
        if (grantResults.length == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            //授權成功
            shareImage();
        } else {
            //授權失敗
            showToast("請授予SD卡許可權才能分享圖片");
        }
    } else {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    }
}
複製程式碼

其實gayhub上已經有很多優秀的許可權申請框架了，幫我們簡化了很多操作，並且裡面有一些思想我們也可以學習一下的。就比如用一個透明的Fragment做代理直接回撥許可權申請的結果，這樣我們就可以不重寫onRequestPermissionsResult方法。

圖片儲存到SD卡

圖片儲存到SD卡也很簡單，直接new一個File將Bitmap寫入即可，但是記得使用完Bitmap及時呼叫recycle回收。

private File BitmapToFile(Bitmap bitmap) {
    if (bitmap == null) return null;
    String path = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
            .getAbsolutePath();
    File imageFile = new File(path, "spiderMan-" + df.format(model.getTime()) + ".jpg");
    try {
        FileOutputStream out = new FileOutputStream(imageFile);
        bitmap.compress(Bitmap.CompressFormat.JPEG, 100, out);
        out.flush();
        out.close();
        bitmap.recycle();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
    return imageFile;
}
複製程式碼
7.0 FileProvider

最後才到真正分享圖片的環節，分享圖片其實就是分享File，但是分享File其實又是用的攜帶Uri的Intent，在7.0以前我們可以直接呼叫Uri.fromFile(file)方法直接取得檔案的Uri地址，但是7.0以後我們就需要FileProvider這個東東。那FileProvider又是個啥呢？

從 Android 7.0 開始，為了提高私有目錄的安全性，防止應用資訊的洩漏，開發人員不能夠再簡單地通過 file://Uri 訪問應用的私有目錄檔案或者讓其他應用訪問自己的私有目錄檔案。

並且從 7.0 開始，Android SDK 中的 StrictMode策略禁止開發人員在應用外部公開 file:// Uri。也就是說當我們在應用中使用包含 file:// Uri 的 Intent 離開自己的應用時，程式會出現FileUriExposedException的異常。

為了解決這個問題，首先我們在 res/xml 目錄下新建一個 xml 檔案，用於存放應用需要共享的目錄檔案。

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path
        name="image_cache"
        path="Download" />
</paths>
複製程式碼

然後用一個類去繼承FileProvider類，這樣做的好處是多個應用間同時用到了這個FileProvider類也不會出現衝突。

public class SpiderManFileProvider extends FileProvider {
}
複製程式碼

接著在AndroidManifest.xml加上我們自定義的Provider，因為FileProvider也是繼承與ContentProvider，屬於四大元件之一，所以必須在AndroidManifest.xml檔案中宣告。

<application>
        <provider
            android:name="com.simple.spiderman.SpiderManFileProvider"
            android:authorities="${applicationId}.spidermanfileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        </provider>
</application>
複製程式碼

最後才是Intent攜帶File Uri並分享的程式碼

Intent intent = new Intent();
intent.setAction(Intent.ACTION_SEND);
intent.setType("image/*");
//判斷版本是否為7.0及以上
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    Uri contentUri = FileProvider.getUriForFile(getApplicationContext(),
            getApplicationContext().getPackageName() + ".spidermanfileprovider", file);
    intent.putExtra(Intent.EXTRA_STREAM, contentUri);
} else {
    intent.putExtra(Intent.EXTRA_STREAM, Uri.fromFile(file));
}
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
startActivity(Intent.createChooser(intent, "分享圖片"));
複製程式碼

原始碼地址

github.com/simplepeng/…

相關文章