Android實現友好崩潰界面
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
安裝到手機上測試一下
點擊【崩潰測試】按鈕
這裡的演示程序並沒有添加向開發者提交錯誤報告的功能,當然本文的重點在於實現友好的崩潰界面,在此基礎上的更多功能請讀者自行實現。
以上就是本文的全部內容,希望對大傢的學習有所幫助,也希望大傢多多支持WalkonNet。
推薦閱讀:
- Android四大組件之Activity深入解讀生命周期
- Android實現顯示和隱藏密碼功能的示例代碼
- 詳解Android內存泄露及優化方案
- Android app會crash的原因及解決方法
- Android實現跑馬燈效果的兩種簡單方式