避免使用者誤觸返回鍵直接離開 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; // 攔截,不退出
}
}
}
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(); // 真正退出
}
}
}
// 在 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();
}
}
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 實例,生命週期自動綁定。OnBackPressedDispatcher (AndroidX) 正確處理巢狀導航。