diff --git a/core/java/android/app/Activity.java b/core/java/android/app/Activity.java index acdab1b97599a..ae16e01b7788d 100644 --- a/core/java/android/app/Activity.java +++ b/core/java/android/app/Activity.java @@ -3925,15 +3925,32 @@ public class Activity extends ContextThemeWrapper * task will be moved to the back of the activity stack instead of being finished. * Other activities will simply be finished. * - *
If you target version {@link android.os.Build.VERSION_CODES#S} or later and - * override this method, it is strongly recommended to call through to the superclass + *
If you target version {@link android.os.Build.VERSION_CODES#S} and + * override this method, we strongly recommend to call through to the superclass * implementation after you finish handling navigation within the app. + * + *
If you target version {@link android.os.Build.VERSION_CODES#TIRAMISU} or later, + * you should not use this method but register an {@link OnBackInvokedCallback} on an + * {@link OnBackInvokedDispatcher} that you can retrieve using + * {@link #getOnBackInvokedDispatcher()}. You should also set + * {@code android:enableOnBackInvokedCallback="true"} in the application manifest. + *
Alternatively, you can use + * {@code androidx.activity.ComponentActivity#getOnBackPressedDispatcher()} + * for backward compatibility. * * * @see #moveTaskToBack(boolean) * * @deprecated Use {@link OnBackInvokedCallback} or * {@code androidx.activity.OnBackPressedCallback} to handle back navigation instead. + *
+ * Starting from Android 13 (API level 33), back event handling is + * moving to an ahead-of-time model and {@link Activity#onBackPressed()} and + * {@link KeyEvent#KEYCODE_BACK} should not be used to handle back events (back gesture or + * back button click). Instead, an {@link OnBackInvokedCallback} should be registered using + * {@link Activity#getOnBackInvokedDispatcher()} + * {@link OnBackInvokedDispatcher#registerOnBackInvokedCallback(int, OnBackInvokedCallback) + * .registerOnBackInvokedCallback(priority, callback)}. */ @Deprecated public void onBackPressed() { diff --git a/core/java/android/app/Dialog.java b/core/java/android/app/Dialog.java index f0af9bad28641..33cf71256d517 100644 --- a/core/java/android/app/Dialog.java +++ b/core/java/android/app/Dialog.java @@ -720,8 +720,27 @@ public class Dialog implements DialogInterface, Window.Callback, * key. The default implementation simply cancels the dialog (only if * it is cancelable), but you can override this to do whatever you want. * + *
+ * If you target version {@link android.os.Build.VERSION_CODES#TIRAMISU} or later, you + * should not use this method but register an {@link OnBackInvokedCallback} on an + * {@link OnBackInvokedDispatcher} that you can retrieve using + * {@link #getOnBackInvokedDispatcher()}. You should also set + * {@code android:enableOnBackInvokedCallback="true"} in the application manifest. + * + *
Alternatively, you + * can use {@code androidx.activity.ComponentDialog#getOnBackPressedDispatcher()} + * for backward compatibility. + * * @deprecated Use {@link OnBackInvokedCallback} or * {@code androidx.activity.OnBackPressedCallback} to handle back navigation instead. + *
+ * Starting from Android 13 (API level 33), back event handling is + * moving to an ahead-of-time model and {@link #onBackPressed()} and + * {@link KeyEvent#KEYCODE_BACK} should not be used to handle back events (back gesture or + * back button click). Instead, an {@link OnBackInvokedCallback} should be registered using + * {@link Dialog#getOnBackInvokedDispatcher()} + * {@link OnBackInvokedDispatcher#registerOnBackInvokedCallback(int, OnBackInvokedCallback) + * .registerOnBackInvokedCallback(priority, callback)}. */ @Deprecated public void onBackPressed() {