[Android]將應用崩潰信息匯報給開發者並重新啟動應用
https://blog.csdn.net/sodino/article/details/6540329
在開發過程中,雖然經過測試,但在發布後,在廣大用戶各種各樣的運行環境和操作下,可能會發生一些異想不到的錯誤導致程序崩潰。將這些錯誤信息收集起來並反饋給開發者,對於開發者改進優化程序是相當重要的。好了,下麵就來實現這種功能吧。
(更正:2012年2月9日18時42分07秒)
由於為曆史帖原因,以下做法比較浪費,但抓取異常的效果是一樣的。
1.對於UI線程(即Android中的主線程)拋出的未捕獲異常,將這些異常信息存儲起來然後關閉到整個應用程序。並再次啟動程序,則進入崩潰信息反饋界麵讓用戶將出錯信息以Email的形式發送給開發者。
2.對於非UI線程拋出的異常,則立即喚醒崩潰信息反饋界麵提示用戶將出錯信息發送Email。
效果圖如下[CSDN]:
過程了解了,則需要了解的幾個知識點如下:
1.攔截UncaughtException
Application.onCreate()是整個Android應用的入口方法。在該方法中執行如下代碼即可攔截UncaughtException:
- ueHandler = new UEHandler(this);
- // 設置異常處理實例
- Thread.setDefaultUncaughtExceptionHandler(ueHandler);
2.抓取導致程序崩潰的異常信息
UEHandler是Thread.UncaughtExceptionHandler的實現類,在其public void uncaughtException(Thread thread, Throwable ex)的實現中可以獲取崩潰信息,代碼如下:
- // fetch Excpetion Info
- String info = null;
- ByteArrayOutputStream baos = null;
- PrintStream printStream = null;
- try {
- baos = new ByteArrayOutputStream();
- printStream = new PrintStream(baos);
- ex.printStackTrace(printStream);
- byte[] data = baos.toByteArray();
- info = new String(data);
- data = null;
- } catch (Exception e) {
- e.printStackTrace();
- } finally {
- try {
- if (printStream != null) {
- printStream.close();
- }
- if (baos != null) {
- baos.close();
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
3.程序拋異常後,要關閉整個應用
悲催的程序員,唉,以下三種方式都無效了,咋辦啊!!!
3.1android.os.Process.killProcess(android.os.Process.myPid());
3.2ActivityManager am = (ActivityManager) getSystemService(ACTIVITY_SERVICE);
am.restartPackage("lab.sodino.errorreport");
3.3System.exit(0)
好吧,毛主席告訴我們:自己動手豐衣足食。
SoftApplication中聲明一個變量need2Exit,其值為true標識當前的程序需要完整退出;為false時該幹嘛幹嘛去。該變量在應用的啟動Activity.onCreate()處賦值為false。
在捕獲了崩潰信息後,調用SoftApplication.setNeed2Exit(true)標識程序需要退出,並finish()掉ActErrorReport,這時ActErrorReport退棧,拋錯的ActOccurError占據手機屏幕,根據Activity的生命周期其要調用onStart(),則我們在onStart()處讀取need2Exit的狀態,若為true,則也關閉到當前的Activity,則退出了整個應用了。此方法可以解決一次性退出已開啟了多個Activity的Application。詳細代碼請閱讀下麵的示例源碼。
好了,代碼如下:
lab.sodino.errorreport.SoftApplication.java
- package lab.sodino.errorreport;
- import java.io.File;
- import android.app.Application;
- /**
- * @author Sodino E-mail:sodinoopen@hotmail.com
- * @version Time:2011-6-9 下午11:49:56
- */
- public class SoftApplication extends Application {
- /** "/data/data/<app_package>/files/error.log" */
- public static final String PATH_ERROR_LOG = File.separator + "data" + File.separator + "data"
- + File.separator + "lab.sodino.errorreport" + File.separator + "files" + File.separator
- + "error.log";
- /** 標識是否需要退出。為true時表示當前的Activity要執行finish()。 */
- private boolean need2Exit;
- /** 異常處理類。 */
- private UEHandler ueHandler;
- public void onCreate() {
- need2Exit = false;
- ueHandler = new UEHandler(this);
- // 設置異常處理實例
- Thread.setDefaultUncaughtExceptionHandler(ueHandler);
- }
- public void setNeed2Exit(boolean bool) {
- need2Exit = bool;
- }
- public boolean need2Exit() {
- return need2Exit;
- }
- }
lab.sodino.errorreport.ActOccurError.java
- package lab.sodino.errorreport;
- import java.io.File;
- import java.io.FileInputStream;
- import android.app.Activity;
- import android.content.Intent;
- import android.os.Bundle;
- import android.util.Log;
- import android.view.View;
- import android.widget.Button;
- public class ActOccurError extends Activity {
- private SoftApplication softApplication;
- /** Called when the activity is first created. */
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- softApplication = (SoftApplication) getApplication();
- // 一開始進入程序恢複為"need2Exit=false"。
- softApplication.setNeed2Exit(false);
- Log.d("ANDROID_LAB", "ActOccurError.onCreate()");
- Button btnMain = (Button) findViewById(R.id.btnThrowMain);
- btnMain.setOnClickListener(new Button.OnClickListener() {
- public void onClick(View v) {
- Log.d("ANDROID_LAB", "Thread.main.run()");
- int i = 0;
- i = 100 / i;
- }
- });
- Button btnChild = (Button) findViewById(R.id.btnThrowChild);
- btnChild.setOnClickListener(new Button.OnClickListener() {
- public void onClick(View v) {
- new Thread() {
- public void run() {
- Log.d("ANDROID_LAB", "Thread.child.run()");
- int i = 0;
- i = 100 / i;
- }
- }.start();
- }
- });
- // 處理記錄於error.log中的異常
- String errorContent = getErrorLog();
- if (errorContent != null) {
- Intent intent = new Intent(this, ActErrorReport.class);
- intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
- intent.putExtra("error", errorContent);
- intent.putExtra("by", "error.log");
- startActivity(intent);
- }
- }
- public void onStart() {
- super.onStart();
- if (softApplication.need2Exit()) {
- Log.d("ANDROID_LAB", "ActOccurError.finish()");
- ActOccurError.this.finish();
- } else {
- // do normal things
- }
- }
- /**
- * 讀取是否有未處理的報錯信息。<br/>
- * 每次讀取後都會將error.log清空。<br/>
- *
- * @return 返回未處理的報錯信息或null。
- */
- private String getErrorLog() {
- File fileErrorLog = new File(SoftApplication.PATH_ERROR_LOG);
- String content = null;
- FileInputStream fis = null;
- try {
- if (fileErrorLog.exists()) {
- byte[] data = new byte[(int) fileErrorLog.length()];
- fis = new FileInputStream(fileErrorLog);
- fis.read(data);
- content = new String(data);
- data = null;
- }
- } catch (Exception e) {
- e.printStackTrace();
- } finally {
- try {
- if (fis != null) {
- fis.close();
- }
- if (fileErrorLog.exists()) {
- fileErrorLog.delete();
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- return content;
- }
- }
lab.sodino.errorreport.ActErrorReport.java
- package lab.sodino.errorreport;
- import android.app.Activity;
- import android.content.Intent;
- import android.os.Bundle;
- import android.util.Log;
- import android.view.View;
- import android.widget.Button;
- import android.widget.EditText;
- import android.widget.TextView;
- /**
- * @author Sodino E-mail:sodinoopen@hotmail.com
- * @version Time:2011-6-12 下午01:34:17
- */
- public class ActErrorReport extends Activity {
- private SoftApplication softApplication;
- private String info;
- /** 標識來處。 */
- private String by;
- private Button btnReport;
- private Button btnCancel;
- private BtnListener btnListener;
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.report);
- softApplication = (SoftApplication) getApplication();
- by = getIntent().getStringExtra("by");
- info = getIntent().getStringExtra("error");
- TextView txtHint = (TextView) findViewById(R.id.txtErrorHint);
- txtHint.setText(getErrorHint(by));
- EditText editError = (EditText) findViewById(R.id.editErrorContent);
- editError.setText(info);
- btnListener = new BtnListener();
- btnReport = (Button) findViewById(R.id.btnREPORT);
- btnCancel = (Button) findViewById(R.id.btnCANCEL);
- btnReport.setOnClickListener(btnListener);
- btnCancel.setOnClickListener(btnListener);
- }
- private String getErrorHint(String by) {
- String hint = "";
- String append = "";
- if ("uehandler".equals(by)) {
- append = " when the app running";
- } else if ("error.log".equals(by)) {
- append = " when last time the app running";
- }
- hint = String.format(getResources().getString(R.string.errorHint), append, 1);
- return hint;
- }
- public void onStart() {
- super.onStart();
- if (softApplication.need2Exit()) {
- // 上一個退棧的Activity有執行“退出”的操作。
- Log.d("ANDROID_LAB", "ActErrorReport.finish()");
- ActErrorReport.this.finish();
- } else {
- // go ahead normally
- }
- }
- class BtnListener implements Button.OnClickListener {
- @Override
- public void onClick(View v) {
- if (v == btnReport) {
- // 需要 android.permission.SEND權限
- Intent mailIntent = new Intent(Intent.ACTION_SEND);
- mailIntent.setType("plain/text");
- String[] arrReceiver = { "sodinoopen@hotmail.com" };
- String mailSubject = "App Error Info[" + getPackageName() + "]";
- String mailBody = info;
- mailIntent.putExtra(Intent.EXTRA_EMAIL, arrReceiver);
- mailIntent.putExtra(Intent.EXTRA_SUBJECT, mailSubject);
- mailIntent.putExtra(Intent.EXTRA_TEXT, mailBody);
- startActivity(Intent.createChooser(mailIntent, "Mail Sending..."));
- ActErrorReport.this.finish();
- } else if (v == btnCancel) {
- ActErrorReport.this.finish();
- }
- }
- }
- public void finish() {
- super.finish();
- if ("error.log".equals(by)) {
- // do nothing
- } else if ("uehandler".equals(by)) {
- // 1.
- // android.os.Process.killProcess(android.os.Process.myPid());
- // 2.
- // ActivityManager am = (ActivityManager)
- // getSystemService(ACTIVITY_SERVICE);
- // am.restartPackage("lab.sodino.errorreport");
- // 3.
- // System.exit(0);
- // 1.2.3.都失效了,Google你讓悲催的程序員情何以堪啊。
- softApplication.setNeed2Exit(true);
- // ////////////////////////////////////////////////////
- // // 另一個替換方案是直接返回“HOME”
- // Intent i = new Intent(Intent.ACTION_MAIN);
- // // 如果是服務裏調用,必須加入newtask標識
- // i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
- // i.addCategory(Intent.CATEGORY_HOME);
- // startActivity(i);
- // ////////////////////////////////////////////////////
- }
- }
- }
lab.sodino.errorreport.UEHandler.java
- package lab.sodino.uncaughtexception;
- import java.io.ByteArrayOutputStream;
- import java.io.File;
- import java.io.FileOutputStream;
- import java.io.PrintStream;
- import android.content.Intent;
- import android.util.Log;
- /**
- * @author Sodino E-mail:sodinoopen@hotmail.com
- * @version Time:2011-6-9 下午11:50:43
- */
- public class UEHandler implements Thread.UncaughtExceptionHandler {
- private SoftApplication softApp;
- private File fileErrorLog;
- public UEHandler(SoftApplication app) {
- softApp = app;
- fileErrorLog = new File(SoftApplication.PATH_ERROR_LOG);
- }
- @Override
- public void uncaughtException(Thread thread, Throwable ex) {
- // fetch Excpetion Info
- String info = null;
- ByteArrayOutputStream baos = null;
- PrintStream printStream = null;
- try {
- baos = new ByteArrayOutputStream();
- printStream = new PrintStream(baos);
- ex.printStackTrace(printStream);
- byte[] data = baos.toByteArray();
- info = new String(data);
- data = null;
- } catch (Exception e) {
- e.printStackTrace();
- } finally {
- try {
- if (printStream != null) {
- printStream.close();
- }
- if (baos != null) {
- baos.close();
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- long threadId = thread.getId();
- Log.d("ANDROID_LAB", "Thread.getName()=" + thread.getName() + " margin:0px;padding:0px;border:none;background-color:inherit;"> + threadId + " state=" + thread.getState());
- Log.d("ANDROID_LAB", "Error[" + info + "]");
- if (threadId != 1) {
- // 此處示例跳轉到匯報異常界麵。
- Intent intent = new Intent(softApp, ActErrorReport.class);
- intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
- intent.putExtra("error", info);
- intent.putExtra("by", "uehandler");
- softApp.startActivity(intent);
- } else {
- // 此處示例發生異常後,重新啟動應用
- Intent intent = new Intent(softApp, ActOccurError.class);
- // 如果<span >沒有NEW_TASK標識且</span>是UI線程拋的異常則界麵卡死直到ANR
- intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
- softApp.startActivity(intent);
- // write 2 /data/data/<app_package>/files/error.log
- write2ErrorLog(fileErrorLog, info);
- // kill App Progress
- android.os.Process.killProcess(android.os.Process.myPid());
- }
- }
- private void write2ErrorLog(File file, String content) {
- FileOutputStream fos = null;
- try {
- if (file.exists()) {
- // 清空之前的記錄
- file.delete();
- } else {
- file.getParentFile().mkdirs();
- }
- file.createNewFile();
- fos = new FileOutputStream(file);
- fos.write(content.getBytes());
- } catch (Exception e) {
- e.printStackTrace();
- } finally {
- try {
- if (fos != null) {
- fos.close();
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- }
- }
/res/layout/main.xml
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
- android:orientation="vertical"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"
- >
- <TextView
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="@string/hello"
- />
- <Button android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="Throws Exception By Main Thread"
- android:id="@+id/btnThrowMain"
- ></Button>
- <Button android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="Throws Exception By Child Thread"
- android:id="@+id/btnThrowChild"
- ></Button>
- </LinearLayout>
/res/layout/report.xml
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
- android:orientation="vertical" android:layout_width="fill_parent"
- android:layout_height="fill_parent">
- <TextView android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="@string/errorHint"
- android:id="@+id/txtErrorHint" />
- <EditText android:layout_width="fill_parent"
- android:layout_height="wrap_content" android:id="@+id/editErrorContent"
- android:editable="false" android:layout_weight="1"></EditText>
- <LinearLayout android:layout_width="fill_parent"
- android:layout_height="wrap_content" android:background="#96cdcd"
- android:gravity="center" android:orientation="horizontal">
- <Button android:layout_width="fill_parent"
- android:layout_height="wrap_content" android:text="Report"
- android:id="@+id/btnREPORT" android:layout_weight="1"></Button>
- <Button android:layout_width="fill_parent"
- android:layout_height="wrap_content" android:text="Cancel"
- android:id="@+id/btnCANCEL" android:layout_weight="1"></Button>
- </LinearLayout>
- </LinearLayout>
用到的string.xml資源為:
- <string name="errorHint">A error has happened %1$s.Please click <i><b>"REPORT"</b></i> to send the error information to us by email, Thanks!!!</string>
重要的一點是要在AndroidManifest.xml中對<application>節點設置android:name=".SoftApplication"
最後更新:2017-04-02 16:47:37