萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 雙擊返回鍵退出 Activity 通用工具類

避免使用者誤觸返回鍵直接離開 App,主流應用採用「再按一次退出」的雙擊確認機制。本文提供一個輕量、無依賴、可自訂提示文字的 DoubleClickExitHelper 工具類,一行程式碼即可接入任意 Activity。

工具類實作

public class DoubleClickExitHelper {
    private static final long DOUBLE_CLICK_INTERVAL = 2000L; // 2 秒內
    private long lastBackPressTime = 0;
    private final Activity activity;
    private final String toastMessage;

    public DoubleClickExitHelper(Activity activity) {
        this(activity, "再按一次退出應用");
    }

    public DoubleClickExitHelper(Activity activity, String toastMessage) {
        this.activity = activity;
        this.toastMessage = toastMessage;
    }

    /**
     * 在 Activity.onBackPressed() 中呼叫
     * @return true 表示已處理 (不退出),false 表示執行退出
     */
    public boolean onBackPressed() {
        long currentTime = System.currentTimeMillis();
        if (currentTime - lastBackPressTime < DOUBLE_CLICK_INTERVAL) {
            // 間隔小於 2 秒,確認退出
            return false; // 讓 Activity 繼續執行 finish()/super.onBackPressed()
        } else {
            // 第一次按下,顯示提示
            lastBackPressTime = currentTime;
            Toast.makeText(activity, toastMessage, Toast.LENGTH_SHORT).show();
            return true; // 攔截,不退出
        }
    }
}

Activity 中接入 (一行程式碼)

public class MainActivity extends AppCompatActivity {
    private DoubleClickExitHelper exitHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        exitHelper = new DoubleClickExitHelper(this); // 可自訂提示文字
    }

    @Override
    public void onBackPressed() {
        if (!exitHelper.onBackPressed()) {
            super.onBackPressed(); // 真正退出
        }
    }
}

進階擴充:支援 Fragment/Navigation Component

// 在 BaseActivity 或使用 Navigation Component 的 Activity 中
@Override
public void onBackPressed() {
    // 1. 優先讓 Fragment 處理 (如彈窗關閉、WebView 回退)
    if (getSupportFragmentManager().getBackStackEntryCount() > 0) {
        getSupportFragmentManager().popBackStack();
        return;
    }
    // 2. 無 Fragment 回棧時,啟用雙擊退出邏輯
    if (!exitHelper.onBackPressed()) {
        super.onBackPressed();
    }
}

Kotlin 擴充函數版 (更簡潔)

private var lastBackPressTime = 0L
private val DOUBLE_CLICK_INTERVAL = 2000L

fun Activity.setupDoubleClickExit(message: String = "再按一次退出應用") {
    onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
        override fun handleOnBackPressed() {
            val currentTime = System.currentTimeMillis()
            if (currentTime - lastBackPressTime < DOUBLE_CLICK_INTERVAL) {
                isEnabled = false // 允許下一次回呼執行預設退出
                requireActivity().onBackPressed()
            } else {
                lastBackPressTime = currentTime
                Toast.makeText(this@setupDoubleClickExit, message, Toast.LENGTH_SHORT).show()
            }
        }
    })
}

// 使用
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setupDoubleClickExit()
}

設計要點

  • 無狀態洩漏: 僅持有 WeakReference 或直接由 Activity 持有 Helper 實例,生命週期自動綁定。
  • 可自訂間隔與提示: 建構子支援傳入間隔毫秒數與 Toast 文字。
  • 不干擾 Fragment 回棧: 搭配 OnBackPressedDispatcher (AndroidX) 正確處理巢狀導航。
copyright © 萬盛學電腦網 all rights reserved