Android 自製鎖屏應用：解決鎖屏後螢幕立即亮起的問題

問題現象

自行開發的鎖屏應用在執行鎖屏操作後，螢幕隨即再次亮起（觸發 ACTION_SCREEN_ON），導致鎖屏失效。

根本原因

Android 系統中，螢幕喚醒（Intent.ACTION_SCREEN_ON）與鎖屏（Intent.ACTION_SCREEN_OFF）均會發送系統廣播。若應用未正確處理這兩個廣播的競爭關係，或在鎖屏邏輯中意外觸發了喚醒條件（如獲取 WakeLock、啟動 Activity 等），便會導致螢幕秒亮。

調試與解決思路

1. 註冊廣播接收器監聽：在 BroadcastReceiver 中同時監聽 ACTION_SCREEN_ON 和 ACTION_SCREEN_OFF，記錄觸發順序與堆疊追蹤，定位喚醒源頭。
2. 檢查 WakeLock 使用：確保鎖屏邏輯中未持有 PARTIAL_WAKE_LOCK 或未正確釋放，避免系統以為有任務需喚醒螢幕。
3. 使用 KeyguardManager：優先調用 KeyguardManager.requestDismissKeyguard() 或 KeyguardLock.disableKeyguard()（API 28+ 建議使用 KeyguardManager 新介面）實現系統級鎖屏，而非自行疊加 View。
4. 處理 Home 鍵與通知攔截：鎖屏應用需聲明 android.permission.DISABLE_KEYGUARD 並正確處理 onAttachedToWindow 中的旗標（FLAG_DISMISS_KEYGUARD | FLAG_SHOW_WHEN_LOCKED）。

最佳實踐建議

參考開源項目（如 Android-Lockscreen）的實現，優先使用系統提供的鎖屏擴展點（LockScreenService、Keyguard 插件機制），避免重造輪子導致兼容性問題。