android程序崩溃框架—CustomActivityOnCrash

在android中如果你的程序发生崩溃,一般程序就会退出,这时用户就要重新打开App并重复进行操作,当这个时候,我们或许会需要一个需求,让App自动重启,有的公司会发布公测版App这个时候,如果发生问题,可以让用户填写反馈报告,这时CustomActivityOnCrash就给我们带来了便利!

  • 效果图

    使用框架自带错误页面

android程序崩溃框架—CustomActivityOnCrash_第1张图片

  使用自定义错误页面

android程序崩溃框架—CustomActivityOnCrash_第2张图片

  • 引入CustomActivityOnCrash
    implementation 'cat.ereza:customactivityoncrash:2.2.0'
  • 初始化CustomActivityOnCrash
package com.example.customactivityoncrash;

import android.annotation.SuppressLint;
import android.app.Application;
import android.util.Log;

import cat.ereza.customactivityoncrash.CustomActivityOnCrash;
import cat.ereza.customactivityoncrash.config.CaocConfig;

/**
 * Created by 黄家三少 on 2018/1/13.
 */

public class MyApplication extends Application {
    @SuppressLint("RestrictedApi")
    @Override
    public void onCreate() {
        super.onCreate();
        //整个配置属性,可以设置一个或多个,也可以一个都不设置
        CaocConfig.Builder.create()
                //程序在后台时,发生崩溃的三种处理方式
                //BackgroundMode.BACKGROUND_MODE_SHOW_CUSTOM: //当应用程序处于后台时崩溃,也会启动错误页面,
                //BackgroundMode.BACKGROUND_MODE_CRASH:      //当应用程序处于后台崩溃时显示默认系统错误(一个系统提示的错误对话框),
                //BackgroundMode.BACKGROUND_MODE_SILENT:     //当应用程序处于后台时崩溃,默默地关闭程序!
                .backgroundMode(CaocConfig.BACKGROUND_MODE_SILENT)
                .enabled(true)     //false表示对崩溃的拦截阻止。用它来禁用customactivityoncrash框架
                .showErrorDetails(false) //这将隐藏错误活动中的“错误详细信息”按钮,从而隐藏堆栈跟踪,—》针对框架自带程序崩溃后显示的页面有用(DefaultErrorActivity)。。
                .showRestartButton(false)    //是否可以重启页面,针对框架自带程序崩溃后显示的页面有用(DefaultErrorActivity)。
                .trackActivities(true)     //错误页面中显示错误详细信息;针对框架自带程序崩溃后显示的页面有用(DefaultErrorActivity)。
                .minTimeBetweenCrashesMs(2000)      //定义应用程序崩溃之间的最短时间,以确定我们不在崩溃循环中。比如:在规定的时间内再次崩溃,框架将不处理,让系统处理!
                .errorDrawable(R.mipmap.ic_launcher)     //崩溃页面显示的图标
                .restartActivity(MainActivity.class)      //重新启动后的页面
                .errorActivity(MyDefaultErrorActivity.class) //程序崩溃后显示的页面
                .eventListener(new CustomEventListener())//设置监听
                .apply();
        //如果没有任何配置,程序崩溃显示的是默认的设置
        CustomActivityOnCrash.install(this);
    }

    /**
     * 监听程序崩溃/重启
     */
    private static class CustomEventListener implements CustomActivityOnCrash.EventListener {
        //程序崩溃回调
        @Override
        public void onLaunchErrorActivity() {
            Log.d("huangxiaoguo", "程序崩溃回调");
        }

        //重启程序时回调
        @Override
        public void onRestartAppFromErrorActivity() {
            Log.d("huangxiaoguo", "重启程序时回调");
        }

        //在崩溃提示页面关闭程序时回调
        @Override
        public void onCloseAppFromErrorActivity() {
            Log.d("huangxiaoguo", "在崩溃提示页面关闭程序时回调");
        }

    }
}

框架自带错误页面我们一般不用!

  • 自定义错误页面

android程序崩溃框架—CustomActivityOnCrash_第3张图片

package com.example.customactivityoncrash;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;

import cat.ereza.customactivityoncrash.CustomActivityOnCrash;
import cat.ereza.customactivityoncrash.config.CaocConfig;

public class MyDefaultErrorActivity extends AppCompatActivity implements View.OnClickListener {

    /**
     * 一键反馈
     */
    private Button mButten;
    /**
     * 关闭程序
     */
    private Button mClose;
    private CaocConfig config;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my_default_error);
        initView();
        initData();
    }

    private void initData() {
        //可以获取到的四个信息:
        //将堆栈跟踪作为字符串获取。
        String stackString = CustomActivityOnCrash.getStackTraceFromIntent(getIntent());
        Log.d("huangxiaoguo","将堆栈跟踪作为字符串获取==>"+stackString);
        //获取错误报告的Log信息
        String logString = CustomActivityOnCrash.getActivityLogFromIntent(getIntent());
        Log.d("huangxiaoguo","获取错误报告的Log信息==>"+logString);
        // 获取所有的信息
        String allString = CustomActivityOnCrash.getAllErrorDetailsFromIntent(this, getIntent());
        Log.d("huangxiaoguo","获取所有的信息==>"+allString);
        //获得配置信息,比如设置的程序崩溃显示的页面和重新启动显示的页面等等信息
        config = CustomActivityOnCrash.getConfigFromIntent(getIntent());
    }

    private void initView() {
        mButten = (Button) findViewById(R.id.butten);
        mButten.setOnClickListener(this);
        mClose = (Button) findViewById(R.id.close);
        mClose.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            default:
                break;
            case R.id.butten://一键反馈,重新打开
                if (config!=null&&config.getRestartActivityClass()!=null){
                    CustomActivityOnCrash.restartApplication(this,config);
                }
                break;
            case R.id.close://关闭程序
                if (config != null) {
                    CustomActivityOnCrash.closeApplication(this, config);
                }
                break;
        }
    }
}

代码有详细介绍,这里主要说明一下

  1. .showErrorDetails(false)
  2. .showRestartButton(false)
  3. .trackActivities(true)

这三个主要是在框架自带的错误页面有用,对我们自定义的错误页面是没有用的!

你可能感兴趣的:(android学习)