AndroidのBack Press Handling：本質、メカニズム、実装

Back Press Handlingとは

Back Press Handlingは、ユーザーがハードウェアまたはソフトウェアの戻るボタンを押したときに何が起こるかを決定するAndroidのシステムメカニズムです。コンテキストに応じて、押下は次のことを行います：現在の画面を閉じて前の画面に戻る、キーボードを隠す、DrawerまたはBottom Sheetを閉じる、ユーザーがルート画面にいる場合はアプリを終了する。

戻るボタンの動作はAndroidのバージョンごとに進化してきました。Android 10はジェスチャーナビゲーションを導入し、Android 11はOnBackPressedDispatcherを標準APIとして導入し、Android 13は拡張されたpredictive back gestureのサポートをもたらしました。これは、アクションが実際に実行される前にシステムが遷移アニメーションを表示するものです。Googleはすべてのデバイスで予測可能で一貫性のあるBack Press動作に向けて着実に進んでいます。

戻るボタンの適切な処理は、AndroidアプリにおいてUXの重要な要素です。ユーザーは、戻るを押すとナビゲーションスタックの前の画面に戻り、予期せずアプリが閉じないことを期待します。この期待に反することは、Google Playで否定的なレビューや低評価を受ける主な原因の一つです。

Back Press APIの進化：onBackPressedからOnBackPressedDispatcherへ

AndroidのBack Press APIの歴史は、プラットフォーム全体の進化を反映しています：Activityの単純なメソッドから、ライフサイクルサポートとComposeを備えた柔軟なコールバックシステムへ。開発の3つの段階を見てみましょう。

onBackPressedの時代（API Level 1–30）

最初のAndroid API以来、戻るボタンはActivityクラスのonBackPressedメソッドで処理されていました。開発者はこのメソッドをオーバーライドして独自のロジックを記述していました。問題は、FragmentとViewが押下をインターセプトできないことでした — すべての制御はActivityを通じて行われていました。これにより、肥大化したActivityと、誰が押下を処理すべきかを決定する複雑なif-elseチェーンが発生しました。

OnBackPressedDispatcherの登場（Activity 1.0.0）

Activity 1.0.0（AndroidX）で、GoogleはOnBackPressedDispatcherを導入しました。これは、Activity、Fragment、Dialog、カスタムViewなど、任意のコンポーネントからコールバックを受け入れる中央ディスパッチャです。コールバックは順序（priority経由）で登録され、動的に追加または削除できます。OnBackPressedDispatcherは古いonBackPressedより前に呼び出され、Activityが処理する前に押下をインターセプトできます。

Predictive Back Gesture（Android 13+）

Android 13はpredictive back gestureを導入しました — ユーザーがジェスチャーを完了する前に、戻る押下がどこにつながるかを示すシステムアニメーションです。このアニメーションをサポートするには、開発者はOnBackPressedDispatcherを使用し、isEnabledプロパティを通じてコールバックがシステムアニメーションをサポートするかどうかを示す必要があります。コールバックがpredictive animationをサポートしない場合、システムはアプリのコンテキストに一致しない可能性のあるデフォルトのアニメーションを表示します。

OnBackPressedDispatcher — アーキテクチャとコールバックチェーン

OnBackPressedDispatcherは、新しいBack Press APIの核心です。コールバックのチェーンを管理し、最初のコールバックがイベントを処理するまで順番に呼び出します。どのコールバックも押下を処理しない場合、ディスパッチャはデフォルトのアクションを実行します — Activityのfinish()またはNavigation ComponentのpopBackStack()を呼び出します。

優先順位付きコールバックの登録

コールバックは、LifecycleOwnerとOnBackPressedCallbackオブジェクトを指定してaddCallbackで登録します。コールバックにはisEnabledプロパティがあり、falseに設定するとコールバックはスキップされます。優先度には、0（最低）からInteger.MAX_VALUEまでの値を渡せます。Fragment Activity Result APIは、このメカニズムを使用してライフサイクルにバインドされたコールバックを自動登録します。

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val callback = object : OnBackPressedCallback(enabled = true) {
        override fun handleOnBackPressed() {
            if (isDrawerOpen) { closeDrawer() }
            else { isEnabled = false; onBackPressed() }
        }
    }
    onBackPressedDispatcher.addCallback(this, callback)
}

Lifecycle-awareなクリーンアップ

コールバックは、LifecycleOwnerがDESTROYED状態になると自動的に削除されます。これにより、画面回転時のコールバックリークという古い問題が解決されます。コールバックがFragmentに追加された場合、Fragmentが破棄されると削除されることが保証されます。コールバックを一時的に無効にするには、isEnabledプロパティを使用します — 削除と再登録なしで切り替えられます。

呼び出しチェーン

呼び出し順序は追加順序の逆です：最後に追加されたコールバックが最初に制御を受け取ります。これは、最もネストされたUI要素（例えば、Fragment内のBottom Sheet）が親Fragmentより先に押下を処理すべきであるため理にかなっています。最も深いコールバックが押下を処理しない場合（isEnabled = false）、制御はチェーンの次のコールバックに渡されます。

FragmentとダイアログでのBack Press

Fragment APIは、requireActivity().onBackPressedDispatcherメソッドを介してOnBackPressedDispatcherとの独自の統合を提供します。Fragment 1.2.0以降、各Fragmentは独自のコールバックを登録でき、これは自動的にFragmentのライフサイクルにバインドされ、破棄時に削除されます。

Fragmentでのコールバック

Fragmentでのコールバックの登録は、onCreate、onViewCreated、またはView自体で行われます — 重要なのは、LifecycleOwner（Fragment）がアクティブであることです。FragmentがSTARTED状態に移行するとコールバックが有効になり、STOPPEDになると無効になります。これにより、非表示のFragment（ViewPager内）が戻る押下を処理しないことが保証されます。

class EditorFragment : Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val callback = object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                showDiscardDialog()
            }
        }
        requireActivity().onBackPressedDispatcher.addCallback(this, callback)
    }
}

DialogとBottomSheetDialog

ダイアログとBottomSheetは、閉じるために戻る押下を自動的にインターセプトします。閉じる前に追加のアクションを実行する必要がある場合は、より高い優先度のコールバックを登録してください。重要：DialogでsetCancelable(false)を設定した場合、コールバックは起動しません — これはシステムの動作です。

Jetpack ComposeでのBack Press Handling

Jetpack Composeは、BackHandlerコンポーザブル関数を介して戻るボタンを処理する宣言的APIを提供します。BackHandlerはenabled（ブール状態）とonBack — 押下時に呼び出されるコールバックを受け入れます。enabled = falseの場合、押下はチェーンのさらに先に渡されます。

ComposeでのBackHandler

BackHandlerは、親ActivityのOnBackPressedDispatcherに自動的にOnBackPressedCallbackを登録します。コンポーザブルのライフサイクルを尊重します：コンポジションを離れると、コールバックは削除されます。enabledは状態にバインドできます — 例えば、フォームに未保存の変更がある場合のみ確認ダイアログを表示するなど。

@Composable
fun EditScreen(hasUnsavedChanges: Boolean) {
    BackHandler(enabled = hasUnsavedChanges) {
        // Show confirmation dialog
    }

    Column {
        TextField(value = ..., onValueChange = ...)
    }
}

ComposeでのPredictive Back

ComposeでのPredictive back gestureはCompose 1.5.0以降でサポートされています。BackHandlerは、デバイスで有効になっている場合、システムの遷移アニメーションを自動的に処理します。カスタムのpredictiveアニメーションには、predictiveBackHandlerモディファイアを使用します。これはジェスチャーの進行状況を0から1で返します。

よくあるエラーとベストプラクティス

Back Press Handlingは単純に見えますが、実際には開発者は系統だったエラーを数多く犯します。Googleの推奨事項とコミュニティの経験に基づいて、最も一般的な問題とその解決策を見てみましょう。

エラー：ナビゲーションスタックを確認せずにfinish()を呼び出す

handleOnBackPressedで直接finish()を呼び出すと、ナビゲーションスタックにバックグラウンド画面がある場合、予期せぬアプリ終了につながる可能性があります。Activityを閉じる前に、必ずNavigation ComponentまたはCoordinatorを介してNavController.backStackを確認してください。

エラー：コールバック登録時にライフサイクルを無視する

LifecycleOwnerなしでコールバックを登録すると（パラメータなしの古いaddCallbackを使用）、コールバックは永久に存続し、Activityが既に破棄されている場合にNullPointerExceptionを引き起こす可能性があります。必ずLifecycleOwnerを指定してaddCallback(this, callback)を使用してください。

ベストプラクティス：モーダルウィンドウのチェーンを中断する

モーダルウィンドウ（Bottom Sheet、Dialog）の場合、ウィンドウが表示されているときのみisEnabled = trueに設定してください。ウィンドウの状態をチェックするラムダを指定してaddCallbackを使用します。Navigation ComponentはNavHostに対してこれを自動的に管理します。

ベストプラクティス：ダブルプレス処理

戻るボタンの高速ダブルプレスは、finish()の二重呼び出しにつながる可能性があります。フラグまたはthrottleLastを使用して、500ms以内の繰り返し呼び出しから保護してください。Navigation Componentはこの状況をネイティブに処理しますが、カスタムシナリオでは手動で保護を実装する必要があります。

private var lastBackPressTime = 0L

override fun handleOnBackPressed() {
    val currentTime = System.currentTimeMillis()
    if (currentTime - lastBackPressTime > 500) {
        lastBackPressTime = currentTime
        navigateBack()
    }
}