如何自定義一個全局異常捕獲器-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信息

分享文本

把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/…