自定义崩溃界面 CustomActivityOnCrash
- 可以在app崩溃的时候显示自定义的页面,对用户来说非常友好
- 可以非常方便用户再次启动我们的app,或者直接在崩溃后重启
- 还可以定制重启动后的Activity
- 还有一个隐藏的大功能:可以收集崩溃日志,非常方便我们调试。比如测试同事在测试时,有时候很难重现那些崩溃的bug,而这个库可以非常方便的把崩溃日志提取出来,这样对于我们定位bug大有裨益!
public class MyApp extends Application {
@Override
public void onCreate() {
super.onCreate();
//Install CustomActivityOnCrash
CustomActivityOnCrash.install(this);
CustomActivityOnCrash.setLaunchErrorActivityWhenInBackground(true);
CustomActivityOnCrash.setShowErrorDetails(true);
CustomActivityOnCrash.setDefaultErrorActivityDrawable(R.mipmap.ic_launcher);
CustomActivityOnCrash.setEnableAppRestart(true);
//The EventListener you provide can not be an anonymous or non-static inner class
CustomActivityOnCrash.setEventListener(new MyEventListener());
CustomActivityOnCrash.setRestartActivityClass(Activity2.class);
//CustomActivityOnCrash.setErrorActivityClass(Activity2.class);
//Now initialize your error handlers as normal. i.e., ACRA.init(this);or Fabric.with(this, new Crashlytics())
}
private static class MyEventListener implements CustomActivityOnCrash.EventListener {
@Override
public void onLaunchErrorActivity() {
Log.i("bqt", "onLaunchErrorActivity");
}
@Override
public void onRestartAppFromErrorActivity() {
Log.i("bqt", "onRestartAppFromErrorActivity");
}
@Override
public void onCloseAppFromErrorActivity() {
Log.i("bqt", "onCloseAppFromErrorActivity");
}
}
}
How to use
Optional: Customization
Custom behavior
CustomActivityOnCrash.setLaunchErrorActivityWhenInBackground(boolean);
This method defines if the error activity should be launched when the app crashes while on background. By default, this is true. On API<14, it's always true since there is no way to detect查明 if the app is in foreground. If you set it to false, a crash while in background won't launch the error activity nor the system dialog, so it will be a silent crash. The default is true.
CustomActivityOnCrash.setShowErrorDetails(boolean);
This method defines if the error activity must show a button with error details. If you set it to false, the button on the default error activity will disappear, thus disabling the user from seeing the stack trace. The default is true.
CustomActivityOnCrash.setDefaultErrorActivityDrawable(int);
This method allows changing the default upside-down颠倒的 bug image with an image of your choice. You may pass a resource id for a drawable or a mipmap. The default is R.drawable.customactivityoncrash_error_image.
CustomActivityOnCrash.setEnableAppRestart(boolean);
This method defines if the error activity must show a "Restart app" button or a "Close app" button. If you set it to false, the button on the default error activity will close the app instead of restarting. The default is true.
CustomActivityOnCrash.setEventListener(EventListener);
This method allows you to specify an event listener in order to get notified when the library shows the error activity, restarts or closes the app. The EventListener you provide can not be an anonymous or non-static inner class, because it needs to be serialized连载 by the library. The library will throw an exception if you try to set an invalid class. If you set it to null, no event listener will be invoked. The default is null.
CustomActivityOnCrash.setRestartActivityClass(Class<? extends Activity>);
This method sets the activity that must be launched by the error activity when the user presses the button to restart the app. If you don't set it (or set it to null), the library will use the first activity on your manifest that has an intent-filter with action cat.ereza.customactivityoncrash.RESTART, and if there is none, the default launchable activity on your app. If no launchable activity can be found and you didn't specify any, the "restart app" button will become a "close app" button, even if setEnableAppRestart is set to true.
<intent-filter>
<action android:name="cat.ereza.customactivityoncrash.RESTART" />
</intent-filter>
CustomActivityOnCrash.setErrorActivityClass(Class<? extends Activity>);
<activity
android:name="cat.ereza.sample.customactivityoncrash.activity.CustomErrorActivity"
android:label="@string/error_title"
android:process=":error_activity" />
As noted, you can also use the following intent-filter to specify the error activity:
<intent-filter>
<action android:name="cat.ereza.customactivityoncrash.ERROR" />
</intent-filter>
Customization of the default activity
<string name="customactivityoncrash_error_activity_error_occurred_explanation">An unexpected error occurred.</string>
<string name="customactivityoncrash_error_activity_unknown_exception">Unknown exception</string>
<string name="customactivityoncrash_error_activity_restart_app">Restart app</string>
<string name="customactivityoncrash_error_activity_close_app">Close app</string>
<string name="customactivityoncrash_error_activity_error_details">Error details</string>
<string name="customactivityoncrash_error_activity_error_details_title">Error details</string>
<string name="customactivityoncrash_error_activity_error_details_close">Close</string>
<string name="customactivityoncrash_error_activity_error_details_copy">Copy to clipboard</string>
<string name="customactivityoncrash_error_activity_error_details_copied">Copied to clipboard</string>
<string name="customactivityoncrash_error_activity_error_details_clipboard_label">Error information</string>
Completely custom error activity
CustomActivityOnCrash.getStackTraceFromIntent(getIntent());
Returns the stack trace that caused the error as a string.
CustomActivityOnCrash.getAllErrorDetailsFromIntent(getIntent());
Returns several error details including the stack trace that caused the error, as a string. This is used in the default error activity error details dialog.
CustomActivityOnCrash.getRestartActivityClassFromIntent(getIntent());
Returns the class of the activity you have to launch to restart the app, or null if not set.
CustomActivityOnCrash.getEventListenerFromIntent(getIntent());
Returns the event listener that you must pass to restartApplicationWithIntent(activity, intent, eventListener) or closeApplication(activity, eventListener).
CustomActivityOnCrash.restartApplicationWithIntent(activity, intent, eventListener);
Kills the current process and restarts the app again with an startActivity() to the passed intent. You MUST call this to restart the app, or you will end up having several Application class instances and experience multiprocess issues in API<17.
CustomActivityOnCrash.closeApplication(activity, eventListener);
Closes the app and kills the current process. You MUST call this to close the app, or you will end up having several Application class instances and experience multiprocess issues in API<17.
Using Proguard? 混淆
Inner workings 工作原理
- Captures捕获 the stack trace that caused the crash
- Launches a new intent to the error activity passing the stacktrace as an extra.
- Kills the current process.
The inner workings are based on ACRA's dialog reporting mode with some minor tweaks小的调整. Look at the code if you need more detail about how it works.
Incompatibilities 兼容性
- CustomActivityOnCrash will not work in these cases:
- With any custom UncaughtExceptionHandler set after initializing初始化 the library, that does not call back to the original handler.
- With ACRA enabled and reporting mode set to TOAST or DIALOG.
- If you use a custom UncaughtExceptionHandler, it will not be called if you initialize it before the library initialization (so, Crashlytics or ACRA initialization must be done after CustomActivityOnCrash initialization).
- On some rare特殊的 cases on devices with API<14, the app may enter a restart loop when a crash occurs. Therefore, using it on API<14 is not recommended.
- If your app initialization or error activity crash, there is a possibility of entering an infinite无限的 restart loop (this is checked by the library for the most common cases, but could happen in rarer cases).
- The library has not been tested with multidex enabled. It uses Class.forName() to load classes, so maybe that could cause some problem in API<21. If you test it with such configuration, please provide feedback反馈!
- The library has not been tested with multiprocess多进程 apps. If you test it with such configuration, please provide feedback too!
Disclaimers 免责声明
- This will not avoid ANRs from happening.
- This will not catch native errors.
- There is no guarantee保证 that this will work on every device.
- This library will not make you toast for breakfast早餐 :) 这估计是老美的冷笑话
Contributing & license
自定义崩溃界面 CustomActivityOnCrash的更多相关文章
- 以前编写的inno setup脚本,涵盖了自定义安装界面,调用dll等等应用 (转)
以前编写的inno setup脚本,涵盖了自定义安装界面,调用dll等等应用 (转) ; Script generated by the Inno Setup 脚本向导. ; SEE THE DOCU ...
- Wix 安装部署教程(三)自定义安装界面和行为
接上一篇自定义安装界面,这篇继续探索,首先介绍下,Wix为我们定义了五种风格,每种风格的UI都是有一定顺序的.我们可以改变安装顺序,也可以完全自定义一个Dialog插入其中.比如Wix_Mondo 风 ...
- linux启动后自动登录并运行自定义图形界面程序
在<Ubuntu CTRL+ALT+F1~F6 进入命令模式后不支持中文显示的解决办法>一文中提到linux启动在以后运行一个独占显示器的图形程序的两种办法. 1.不启动xserver,使 ...
- iOS开发——UI_swift篇&TableView自定义聊天界面
TableView自定义聊天界面 1,下面是一个放微信聊天界面的消息展示列表,实现的功能有: (1)消息可以是文本消息也可以是图片消息 (2)消息背景为气泡状图片,同时消息气泡可根据内容自适应大小 ...
- InstallShield自定义安装界面
原文:InstallShield自定义安装界面 版权声明: 可以任意转载,转载时请务必以超链接形式标明文章原始出处和作者信息. 前言: 对于一些InstallShield用户或企业,对于安装包界面除了 ...
- swift3.0自定义相机界面
这是公司上上上一个项目的自定义相机界面,原来是swift2.0写的,今天改为swift3.0,记录一下. 效果图如下: ...
- andriod 自定义来电界面功能
由于近期所做一个项目需要做类似于“来电秀”的功能,所以上网搜索了一些相关资料,加上自己的一些想法,做了一个Demo.一下是我对该功能实现的一些想法,不对的地方欢迎各位指出.最后我会给出Demo 的源代 ...
- FineReport中如何自定义登录界面
在登录平台时,不希望使用FR默认的内置登录界面,想通过自定义登录界面实现登录操作,内置登录界面如下图: 登录界面,获取到用户名和密码的值,发送到报表系统,报表服务带着这两个参数访问认证地址进行认证. ...
- ThinkPHP自定义成功界面、失败界面、异常界面
在ThinkPHP的手册中,附录里边的配置参考,有一个模板引擎设置. 或者在手册里面的控制器,跳转和重定向里面. 紧接着,就讲到了如何自定义这些界面. 将上诉的配置参数写到到配置文件里,修改路径到自己 ...
随机推荐
- PHP之数组(遍历顺序)
作者: Laruence( ) 本文地址: http://www.laruence.com/2009/08/23/1065.html PHP的数组, 如果用foreach来访问, 遍历的顺序是固定 ...
- vars 变量预解析
JavaScript中,你可以在函数的任何位置声明多个var语句,并且它们就好像是在函数顶部声明一样发挥作用,这种行为称为 hoisting(悬置/置顶解析/预解析).当你使用了一个变量,然后不久在函 ...
- fastadmin: layer.open 弹出层如何在表单提交之后自动关闭?
需要在控制器对应的js文件中添加 Form.api.bindevent($("form[role=form]")); define(['jquery', 'bootstrap' ...
- 《java虚拟机》----java内存模型与线程
No1. No2. java内存模型规定了所有的变量都存储在主内存中(Main Memory)中 每条线程还有自己的工作内存(Working Memory) 线程的工作内存中保存了被该线程使用到的变量 ...
- java变量的命名使用规则
1.环境变量通常是指在操作系统中,用来指定操作系统运行时需要的一些参数 2.变量名以字母.下划线或者美元符(4上面的¥)开头,不能以数字开头,后面跟字母.下划线.美元符.数字,变量名对大小写敏感,无长 ...
- Unity 游戏开发技巧集锦之制作一个望远镜与查看器摄像机
Unity 游戏开发技巧集锦之制作一个望远镜与查看器摄像机 Unity中制作一个望远镜 本节制作的望远镜,在鼠标左键按下时,看到的视图会变大:当不再按下的时候,会慢慢缩小成原来的视图.游戏中时常出现的 ...
- 【BZOJ 3676】 3676: [Apio2014]回文串 (SAM+Manacher+倍增)
3676: [Apio2014]回文串 Time Limit: 20 Sec Memory Limit: 128 MBSubmit: 2343 Solved: 1031 Description 考 ...
- 【BZOJ 2323】 2323: [ZJOI2011]细胞 (DP+矩阵乘法+快速幂*)
2323: [ZJOI2011]细胞 Description 2222年,人类在银河系外的某颗星球上发现了生命,并且携带了一个细胞回到了地球.经过反复研究,人类已经完全掌握了这类细胞的发展规律: 这种 ...
- 51nod1437 迈克步 单调栈
考虑一个点作为最小值的区间$[L[i], R[i]]$ 那么这个区间的所有含$i$的子区间最小值都是$v[i]$ 因此,用单调栈求出$L[i], R[i]$后,对$R[i] - L[i] + 1$这个 ...
- [MVC4]Data Annotations Extensions:无法使用EmailAddress等验证特性的解决方法
本文地址:http://www.cnblogs.com/egger/p/3404159.html 欢迎转载 ,请保留此链接๑•́ ₃•̀๑! 数据注解(Data Annotations) Web应用 ...