异常捕获 ACRA 崩溃报告

时间：2018-06-08 22:04:23 阅读：1375 评论：0 收藏：0 [点我收藏+]

标签：打开发送 automatic font ice -o mpi 接收 net

介绍

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("内容\n\n呵呵呵呵呵呵呵呵")//setResText
				.setCommentPrompt("CommentPrompt")//注释输入提示符的标签。setResCommentPrompt
				.setEmailPrompt("EmailPrompt")//	setResEmailPrompt
				.setNegativeButtonText("NegativeButtonText")//	setResNegativeButtonText
				.setPositiveButtonText("PositiveButtonText")//	setResPositiveButtonText
				//.setReportDialogClass(BaseCrashReportDialog.class)//自定义CrashReportDialog
				.setEnabled(true);
		
		builder.getPluginConfigurationBuilder(MailSenderConfigurationBuilder.class)//发邮件。测试失败
				.setMailTo("0909082401@163.com")
				.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("内容\n\n呵呵呵呵呵呵呵呵")
				.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("内容\n\n呵呵呵呵呵呵呵呵")//setResText
                .setCommentPrompt("CommentPrompt")//注释输入提示符的标签。setResCommentPrompt
                .setEmailPrompt("EmailPrompt")//    setResEmailPrompt
                .setNegativeButtonText("NegativeButtonText")//  setResNegativeButtonText
                .setPositiveButtonText("PositiveButtonText")//  setResPositiveButtonText
                //.setReportDialogClass(BaseCrashReportDialog.class)//自定义CrashReportDialog
                .setEnabled(true);
        
        builder.getPluginConfigurationBuilder(MailSenderConfigurationBuilder.class)//发邮件。测试失败
                .setMailTo("0909082401@163.com")
                .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("内容\n\n呵呵呵呵呵呵呵呵")
                .setResSendButtonIcon(R.drawable.icon)
                .setResSendButtonText(R.string.acra_crash_tips)
                .setEnabled(false);
        ACRA.init(this, builder);
    }
}

2018-6-8

来自为知笔记(Wiz)

异常捕获 ACRA 崩溃报告

标签：打开发送 automatic font ice -o mpi 接收 net

原文地址：https://www.cnblogs.com/baiqiantao/p/9157524.html

踩

(0)

(1)

评论一句话评论（0）

分享档案

更多>

2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)

周排行