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。

推薦閱讀: