如何自定义一个全局异常捕获器-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/…