Android 非 UI 執行緒更新 UI 的正確姿勢

在 Android 開發中，setClickable() 可在背景執行緒呼叫而不崩潰，但 setEnabled() 與 setVisibility() 卻會拋出 CalledFromWrongThreadException。根本原因在於後兩者會觸發 View 重繪，而 Android 規定只有 UI 執行緒（主執行緒）能操作 View 階層與觸發繪製。

為何 setClickable 不崩潰？

setClickable() 僅修改內部旗標（mClickable），不涉及佈局或繪製流程，因此不檢查執行緒。

正確的跨執行緒更新 UI 方式

1. runOnUiThread(Runnable)（Activity 專用）
2. View.post(Runnable) 或 View.postDelayed(Runnable, long)
3. Handler(Looper.getMainLooper()).post(Runnable)
4. AsyncTask.onProgressUpdate() / onPostExecute()（已棄用，不建議新專案使用）
5. Kotlin 協程：withContext(Dispatchers.Main) { view.visibility = View.VISIBLE }

程式碼範例

// 錯誤示範（會崩潰）
new Thread(() -> {
    button.setEnabled(true);        // 執行緒檢查失敗
    textView.setVisibility(View.VISIBLE);
}).start();

// 正確寫法
new Thread(() -> {
    // 背景運算...
    runOnUiThread(() -> {
        button.setEnabled(true);
        textView.setVisibility(View.VISIBLE);
    });
}).start();

最佳實務建議

• 所有觸發 UI 狀態變更（enabled、visibility、text、progress 等）的操作，統一包裝在主執行緒執行。
• 使用 View.post() 可避免持有 Activity 參考導致記憶體洩漏。
• 若需大量 UI 更新，考慮使用 RecyclerView + DiffUtil 或 Jetpack Compose 以減少主執行緒負擔。

掌握執行緒規則，能讓 Android App 更穩定、流暢。