异常捕获 ACRA 崩溃报告

Posted 2020-11-14 baiqiantao

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了异常捕获 ACRA 崩溃报告相关的知识，希望对你有一定的参考价值。

介绍

ACRA：Application Crash Report for android，即一个Android异常日志收集的开源框架

ACRA is a library enabling是能够 Android Application to automatically post their crash reports to a report server. It is targeted to android applications developers to help them get data from their applications when they crash or behave erroneously行为错误.

特点：

developer configurable user interaction开发者可配置的用户交互: silent reports, Toast notification, status bar notification + dialog or direct dialog
usable可用的 with ALL versions of Android from 2.2 onwards.
more detailed crash reports about the device running the app than what is displayed in the Android Market developer console error reports
you can add your own variables content or debug traces to the reports
you can send error reports even if the application doesn‘t crash
works for any application even if not delivered through Google PLay => great for devices/regions地区 where the Google Play is not available, beta releases or for enterprise private apps
if there is no network coverage覆盖, reports are kept and sent on a later application restart
can be used with your own self-hosted report receiver script可以同自托管报告接收脚本一起使用

ACRA‘s notification systems are clean. If a crash occurs, your application does not add user notifications over existing system‘s crash notifications or reporting features. By default, the "force close" dialog is not displayed anymore, to enable it set alsoReportToAndroidFramework to true.

The user is notified of an error only once, and you might enhance the perceived quality提高感知质量 of your application by defining your own texts in the notifications/dialogs.

Please do not hesitate犹豫 to open defects/enhancements requests in the issue tracker.在问题跟踪器中打开缺陷/增强请求。

配置

基本配置

com.android.tools.build:gradle:3.0.0 or later.
Acra requires java 8 (native, not RetroLambda or similar):

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

x
 
android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Choose sender（More info: Report Destinations）

def acraVersion = ‘5.1.3‘

 
def acraVersion = ‘5.1.3‘

implementation "ch.acra:acra-http:$acraVersion"//Http
implementation "ch.acra:acra-mail:$acraVersion"//Email
implementation "ch.acra:acra-core:$acraVersion"//Custom

x
 
implementation "ch.acra:acra-http:$acraVersion"//Http
implementation "ch.acra:acra-mail:$acraVersion"//Email
implementation "ch.acra:acra-core:$acraVersion"//Custom

Choose interaction（More info: Interactions）

implementation "ch.acra:acra-dialog:$acraVersion"//Dialog
implementation "ch.acra:acra-notification:$acraVersion"//Notification
implementation "ch.acra:acra-toast:$acraVersion"//Toast
//Silent:Add nothing.

x
 
implementation "ch.acra:acra-dialog:$acraVersion"//Dialog
implementation "ch.acra:acra-notification:$acraVersion"//Notification
implementation "ch.acra:acra-toast:$acraVersion"//Toast
//Silent:Add nothing.

可选配置

Limiter: (limits how many reports acra sends from one device)

implementation "ch.acra:acra-limiter:$acraVersion"

 
implementation "ch.acra:acra-limiter:$acraVersion"

Advanced Scheduler: [since 5.2.0-rc1] (controls when reports are sent (e.g. only on wifi) and can restart an application after a crash)

implementation "ch.acra:acra-advanced-scheduler:$acraVersion"

 
implementation "ch.acra:acra-advanced-scheduler:$acraVersion"

编译时配置

Add annotations to your Application class and override the attachBaseContext() method to add ACRA.init(this)

@AcraCore(buildConfigClass = BuildConfig.class)
public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        ACRA.init(this);
    }
}

x
 
@AcraCore(buildConfigClass = BuildConfig.class)
public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        ACRA.init(this);
    }
}

I addition to除了 the @AcraCore annotation, each plugin you added in the dependencies step provides another annotation, which you have to add to activate and configure that plugin:

PS：如果时重度用户，个人不建议通过注解配置各个插件，因为易读性太差；当然，如果只是简单的使用，不需要进行复杂的配置，则通过注解配置即可。

运行时配置

Construct a CoreConfigurationBuilder and pass it to ACRA.init:

CoreConfigurationBuilder builder = new CoreConfigurationBuilder(this);
builder.setBuildConfigClass(BuildConfig.class).setReportFormat(StringFormat.JSON);
builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class).setResText(R.string.acra_toast_text);
ACRA.init(this, builder);

x
 
CoreConfigurationBuilder builder = new CoreConfigurationBuilder(this);
builder.setBuildConfigClass(BuildConfig.class).setReportFormat(StringFormat.JSON);
builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class).setResText(R.string.acra_toast_text);
ACRA.init(this, builder);

Please note that plugins are disabled if their respective各自的 annotation is not present. You can activate them by calling:

builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class).setEnabled(true);

 
builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class).setEnabled(true);

If you use both run- and compile-time configuration, compile-time values will serve as defaults for runtime configuration.

Available plugin builders:

案例

def acraVersion = ‘5.1.3‘
implementation "ch.acra:acra-http:$acraVersion"//Http
implementation "ch.acra:acra-mail:$acraVersion"//Email
implementation "ch.acra:acra-core:$acraVersion"//Custom
implementation "ch.acra:acra-dialog:$acraVersion"//Dialog
implementation "ch.acra:acra-notification:$acraVersion"//Notification
implementation "ch.acra:acra-toast:$acraVersion"//Toast

 
def acraVersion = ‘5.1.3‘
implementation "ch.acra:acra-http:$acraVersion"//Http
implementation "ch.acra:acra-mail:$acraVersion"//Email
implementation "ch.acra:acra-core:$acraVersion"//Custom
implementation "ch.acra:acra-dialog:$acraVersion"//Dialog
implementation "ch.acra:acra-notification:$acraVersion"//Notification
implementation "ch.acra:acra-toast:$acraVersion"//Toast

@AcraCore(buildConfigClass = BuildConfig.class)
public class App extends Application {

	@Override
	protected void attachBaseContext(Context base) {
		super.attachBaseContext(base);
		
		CoreConfigurationBuilder builder = new CoreConfigurationBuilder(this)
				.setBuildConfigClass(BuildConfig.class)
				.setReportFormat(StringFormat.JSON);
		
		builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class)//吐司
				.setLength(Toast.LENGTH_SHORT)
				.setResText(R.string.acra_crash_tips)//或者setText
				.setEnabled(true);
		
		builder.getPluginConfigurationBuilder(DialogConfigurationBuilder.class)//弹窗
				.setResIcon(R.drawable.icon)
				.setResTheme(R.style.AppTheme)
				.setTitle("标题")//setResTitle
				.setText("内容

呵呵呵呵呵呵呵呵")//setResText
				.setCommentPrompt("CommentPrompt")//注释输入提示符的标签。setResCommentPrompt
				.setEmailPrompt("EmailPrompt")//	setResEmailPrompt
				.setNegativeButtonText("NegativeButtonText")//	setResNegativeButtonText
				.setPositiveButtonText("PositiveButtonText")//	setResPositiveButtonText
				//.setReportDialogClass(BaseCrashReportDialog.class)//自定义CrashReportDialog
				.setEnabled(true);
		
		builder.getPluginConfigurationBuilder(MailSenderConfigurationBuilder.class)//发邮件。测试失败
				.setMailTo("[email protected]")
				.setSubject("主题(崩溃日志)")//或者setResSubject
				.setReportAsFile(true)
				.setReportFileName("附件名称")
				.setEnabled(false);//是通过跳到系统邮箱中，在用户预览并确认后由用户发出去的，而不是在后台默默发送的
		
		builder.getPluginConfigurationBuilder(HttpSenderConfigurationBuilder.class)//HTTP请求。不知道怎么测试
				.setHttpMethod(HttpSender.Method.POST)
				.setConnectionTimeout(30 * 1000)
				.setSocketTimeout(30 * 1000)
				.setHttpHeaders(new HashMap<>())
				.setBasicAuthLogin("")//认证
				.setBasicAuthPassword("")
				.setCertificatePath("")//证书地址。或者setResCertificate
				.setCertificateType("")//证书类型
				.setDropReportsOnTimeout(false)//超时是否删除报告
				.setKeyStoreFactoryClass(KeyStoreFactory.class)//该类创建了可以包含可信证书的密钥库
				.setEnabled(false);
		
		builder.getPluginConfigurationBuilder(NotificationConfigurationBuilder.class)//通知栏。测试失败
				.setResIcon(R.drawable.icon)
				.setTitle("标题")//setResTitle
				.setText("内容

呵呵呵呵呵呵呵呵")
				.setResSendButtonIcon(R.drawable.icon)
				.setResSendButtonText(R.string.acra_crash_tips)
				.setEnabled(false);
		ACRA.init(this, builder);
	}
}

x
 
@AcraCore(buildConfigClass = BuildConfig.class)
public class App extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        
        CoreConfigurationBuilder builder = new CoreConfigurationBuilder(this)
                .setBuildConfigClass(BuildConfig.class)
                .setReportFormat(StringFormat.JSON);
        
        builder.getPluginConfigurationBuilder(ToastConfigurationBuilder.class)//吐司
                .setLength(Toast.LENGTH_SHORT)
                .setResText(R.string.acra_crash_tips)//或者setText
                .setEnabled(true);
        
        builder.getPluginConfigurationBuilder(DialogConfigurationBuilder.class)//弹窗
                .setResIcon(R.drawable.icon)
                .setResTheme(R.style.AppTheme)
                .setTitle("标题")//setResTitle
                .setText("内容

呵呵呵呵呵呵呵呵")//setResText
                .setCommentPrompt("CommentPrompt")//注释输入提示符的标签。setResCommentPrompt
                .setEmailPrompt("EmailPrompt")//    setResEmailPrompt
                .setNegativeButtonText("NegativeButtonText")//  setResNegativeButtonText
                .setPositiveButtonText("PositiveButtonText")//  setResPositiveButtonText
                //.setReportDialogClass(BaseCrashReportDialog.class)//自定义CrashReportDialog
                .setEnabled(true);
        
        builder.getPluginConfigurationBuilder(MailSenderConfigurationBuilder.class)//发邮件。测试失败
                .setMailTo("[email protected]")
                .setSubject("主题(崩溃日志)")//或者setResSubject
                .setReportAsFile(true)
                .setReportFileName("附件名称")
                .setEnabled(false);//是通过跳到系统邮箱中，在用户预览并确认后由用户发出去的，而不是在后台默默发送的
        
        builder.getPluginConfigurationBuilder(HttpSenderConfigurationBuilder.class)//HTTP请求。不知道怎么测试
                .setHttpMethod(HttpSender.Method.POST)
                .setConnectionTimeout(30 * 1000)
                .setSocketTimeout(30 * 1000)
                .setHttpHeaders(new HashMap<>())
                .setBasicAuthLogin("")//认证
                .setBasicAuthPassword("")
                .setCertificatePath("")//证书地址。或者setResCertificate
                .setCertificateType("")//证书类型
                .setDropReportsOnTimeout(false)//超时是否删除报告
                .setKeyStoreFactoryClass(KeyStoreFactory.class)//该类创建了可以包含可信证书的密钥库
                .setEnabled(false);
        
        builder.getPluginConfigurationBuilder(NotificationConfigurationBuilder.class)//通知栏。测试失败
                .setResIcon(R.drawable.icon)
                .setTitle("标题")//setResTitle
                .setText("内容

呵呵呵呵呵呵呵呵")
                .setResSendButtonIcon(R.drawable.icon)
                .setResSendButtonText(R.string.acra_crash_tips)
                .setEnabled(false);
        ACRA.init(this, builder);
    }
}

2018-6-8

来自为知笔记(Wiz)

以上是关于异常捕获 ACRA 崩溃报告的主要内容，如果未能解决你的问题，请参考以下文章

ACRA：如何将 ACRA 报告写入文件（在 SD 卡中）？

如何使用 ACRA 发送 Android 崩溃报告

如何在 webview 中禁用与 html5 视频的交互或正确捕获它们的异常？

防止android在崩溃后重新创建活动堆栈

TestFlight 崩溃报告

启动 ACRA 会导致凌空抽射的其他问题，可能的解决方案？