Android 的默認崩潰機制是 APP 閃退,然後顯示一個【xxx 已停止運行】的對話框或 Toast,而崩潰的詳情只有開發者在 Logcat 裏才能看到,用戶看到發生了這樣的情況肯定一頭霧水,的確,這樣默認的異常處理方式很不友好,容易造成用戶流失。我們現在要做的是,程序發生異常時,新開一個 Activity 向用戶致歉,輸出詳細的異常信息,並提供將異常信息提交給開發者的功能。
首先,在 BaseActivity 裏封裝方法:
/**
* BaseActivity: 該抽象類定義所有活動均擁有的共同屬性。
* 本 APP 中所有活動對象均繼承此類。
*/
public abstract class BaseActivity extends AppCompatActivity {
private static final AppManager MANAGER = AppManager.get();
/**
* onCreate(): 重寫父類的 onCreate() 方法,嚮應用管理器中添加本活動。
*/
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
MANAGER.addActivity(this);
} // onCreate()
/**
* onDestroy(): 重寫父類的 onDestroy() 方法,從應用管理器中移除本活動。
*/
@Override
protected void onDestroy() {
super.onDestroy();
MANAGER.removeActivity(this);
} // onDestroy()
/**
* crash(): 捕獲到非預期的異常後強制令程序崩潰。
*
* @param e 傳入造成崩潰的異常對象。
*/
protected void crash(Exception e) {
Intent i;
String dump;
PrintWriter pw;
StringWriter sw;
sw = new StringWriter();
pw = new PrintWriter(sw);
e.printStackTrace(pw);
pw.flush();
dump = sw.toString();
i = new Intent(this, CrashActivity.class);
i.putExtra("dump", dump);
startActivity(i);
MANAGER.finishAllExcept(CrashActivity.class);
} // crash()
/**
* getCrashDump(): 僅限 CrashActivity 調用。
* 獲得傳入的 dump 信息。
*
* @return 傳入的 dump 信息。
*/
String getCrashDump() {
return getIntent().getStringExtra("dump");
} // getCrashDump()
} // BaseActivity Abstract Class
// E.O.F
BaseActivity 裏用到了兩個自定義類,AppManager 和 CrashActivity。後面添加的這兩個類請確保和 BaseActivity 在同一包下。
添加 AppManager 類:
/**
* AppManager: 用於對活動進行管理。該模塊僅限 base 包內使用。
* 該模塊爲單一實例,您需要調用 AppManager.get() 獲取實例後再調用方法。
* <p>
* 爲確保應用管理器正常工作,請新建一個繼承 Activity 的抽象類 BaseActivity,
* 然後重寫 BaseActivity 類的 onCreate() 和 onDestroy() 方法。
* 請給 BaseActivity 類的 onCreate() 方法添加如下代碼:
* AppManager.get().addActivity(this);
* 請給 BaseActivity 類的 onDestroy() 方法添加如下代碼:
* AppManager.get().removeActivity(this);
* 最後,確保本 APP 內的所有活動類均繼承於 BaseActivity 類。
*/
class AppManager {
private static final AppManager MANAGER = new AppManager();
private Stack<BaseActivity> mStack;
private AppManager() {
// 將作用域關鍵字設置爲 private 以隱藏該類的構造器。
mStack = new Stack<>();
} // AppManager() (Class Constructor)
/**
* get(): 獲得 AppManager 類的單例。
*
* @return 該類的單例 MANAGER。
*/
static AppManager get() {
return MANAGER;
} // get()
/**
* addActivity(): 向堆棧中添加一個活動對象。
*
* @param activity 要添加的活動對象。
*/
void addActivity(BaseActivity activity) {
mStack.add(activity);
Log.i("AppManager", "[+] Created: " + activity.getClass().getName());
} // addActivity()
/**
* removeActivity(): 從堆棧中移除一個活動對象。
*
* @param activity 要移除的活動對象。
*/
void removeActivity(BaseActivity activity) {
mStack.remove(activity);
Log.i("AppManager", "<-> Removed: " + activity.getClass().getName());
} // removeActivity()
/**
* finishAllExcept(): 除一個特定活動外,結束堆棧中其餘所有活動。
* 結束活動時會觸發 BaseActivity 類的 onDestroy()方法,
* 堆棧中的活動對象會同步移除。
*
* @param cls 要保留的活動的類名(xxxActivity.class)
*/
void finishAllExcept(Class<?> cls) {
int i, len;
BaseActivity[] activities;
// 結束活動時會調用活動的 onDestroy() 方法,堆棧的內容會實時改變
// 爲避免因此引起的引用錯誤,先將堆棧的內容複製到一個臨時數組裏
activities = mStack.toArray(new BaseActivity[0]);
len = activities.length;
for (i = 0; i < len; ++i) {
if (activities[i].getClass() != cls) {
// 從數組裏引用活動對象並結束,堆棧內容的改變不影響數組
activities[i].finish();
} // if (activities[i].getClass() != cls)
} // for (i = 0; i < len; ++i)
} // finishAllExcept()
/**
* finishAllActivities(): 結束堆棧中的所有活動。
* 結束活動時會觸發 BaseActivity 類的 onDestroy()方法,
* 堆棧中的活動對象會同步移除。
*/
void finishAllActivities() {
int i, len;
BaseActivity[] activities;
// 結束活動時會調用活動的 onDestroy() 方法,堆棧的內容會實時改變
// 爲避免因此引起的引用錯誤,先將堆棧的內容複製到一個臨時數組裏
activities = mStack.toArray(new BaseActivity[0]);
len = activities.length;
for (i = 0; i < len; ++i) {
// 從數組裏引用活動對象並結束,堆棧內容的改變不影響數組
activities[i].finish();
} // for (i = 0; i < len; ++i)
} // finishAllActivities()
} // AppManager Class
// E.O.F
新建 CrashActivity 活動。
活動的佈局文件 activity_crash.xml
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#1A237E"
tools:context=".base.CrashActivity">
<!-- 請自行設置 background 和 textColor -->
<TextView
android:id="@+id/lblCrashMsg"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="8dp"
android:layout_marginLeft="8dp"
android:layout_marginTop="8dp"
android:layout_marginEnd="8dp"
android:layout_marginRight="8dp"
android:layout_marginBottom="8dp"
android:gravity="center"
android:text="@string/lblCrashMsg"
android:textAppearance="?android:attr/textAppearanceMedium"
android:textColor="#EEEEEE"
app:layout_constraintBottom_toTopOf="@+id/lblCrashDetail"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<TextView
android:id="@+id/lblCrashDetail"
android:layout_width="0dp"
android:layout_height="0dp"
android:layout_marginStart="8dp"
android:layout_marginLeft="8dp"
android:layout_marginTop="8dp"
android:layout_marginEnd="8dp"
android:layout_marginRight="8dp"
android:layout_marginBottom="8dp"
android:textColor="#EEEEEE"
android:typeface="monospace"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/lblCrashMsg" />
</android.support.constraint.ConstraintLayout>
字符串資源 strings.xml 裏添加
<string name="lblCrashMsg">
程序發生了非預期錯誤
\n非常抱歉給您造成不便
\n以下是錯誤詳情
</string>
CrashActivity.java 代碼:
/**
* CrashActivity: 該活動由任意活動調用 crash() 方法激活。輸出拋出的異常信息。
*/
public class CrashActivity extends BaseActivity { // 注意此處是繼承 BaseActivity
/**
* onCreate(): 活動創建時觸發。
*/
@Override
protected void onCreate(Bundle savedInstanceState) {
String dump;
TextView lblDetail;
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_crash);
dump = getCrashDump();
lblDetail = findViewById(R.id.lblCrashDetail);
lblDetail.setText(dump);
lblDetail.setMovementMethod(ScrollingMovementMethod.getInstance());
} // onCreate()
/**
* onKeyDown(): 按下回退鍵時觸發。
* 直接退出程序。
*/
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_BACK) {
AppManager.get().finishAllActivities();
return true;
} // if (keyCode == KeyEvent.KEYCODE_BACK)
else {
return super.onKeyDown(keyCode, event);
} // else
} // onKeyDown()
/**
* onUserLeaveHint(): 按下 HOME 鍵退回桌面時觸發。直接退出程序。
*/
@Override
protected void onUserLeaveHint() {
AppManager.get().finishAllActivities();
} // onUserLeaveHint()
} // CrashActivity Class
// E.O.F
下面我們要做的就是,在程序拋出異常時捕獲它,並將異常內容帶入 CrashActivity 中。要實現這樣的操作,我們需要在 Activity 中的所有 public 和 protected 方法裏添加 try/catch 語句塊。(private 方法不用添加,因爲 private 方法也必然是由某個 public 或 protected 方法調用的,而調用它的 public/protected 方法已經在抓捕異常了)
我們在 MainActivity 裏添加一個按鈕。activity_main.xml 佈局代碼如下:
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:onClick="onBtnCrashTestTapped"
android:text="@string/btnMainCrashTest"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</android.support.constraint.ConstraintLayout>
strings.xml 裏添加:
<string name="btnMainCrashTest">崩潰測試</string>
MainActivity.java 代碼:
public class MainActivity extends BaseActivity { // 注意此處是繼承 BaseActivity
@Override
protected void onCreate(Bundle savedInstanceState) {
// protected 方法必須以 try/catch 包裹
// 在 catch 中加入 crash(e); 語句實現友好崩潰
try {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
} // try
catch (Exception e) {
crash(e);
} // catch (Exception e)
} // onCreate()
public void onBtnCrashTestTapped(View v) {
int[] arr;
// public 方法必須以 try/catch 包裹
// 在 catch 中加入 crash(e); 語句實現友好崩潰
try {
arr = new int[4];
crashTest(arr);
} // try
catch (Exception e) {
crash(e);
} // catch (Exception e)
} // onBtnCrashTestTapped()
private void crashTest(int[] arr) {
// private 方法不用以 try/catch 包裹
// 除非調用了帶 throws 關鍵字的方法強制要求捕獲異常
arr[4] = 4; // 因爲傳入的 arr 數組長度爲 4,所以此處會拋出數組越界異常
} // crashTest()
} // MainActivity Class
// E.O.F
安裝到手機上測試一下
點擊【崩潰測試】按鈕
這裏的演示程序並沒有添加向開發者提交錯誤報告的功能,當然本文的重點在於實現友好的崩潰界面,在此基礎上的更多功能請讀者自行實現。