Android Predictive Back Support

[syleishere]

Description

https://docs.flutter.dev/release/breaking-changes/android-predictive-back

Without Predictive back support, the Google TV Streamer Flet app will just crash hitting back button on remote, a much better way to do this is confirm with user they want to exit app by simply telling them to hit the back button again with a simple snackbar message, and kill Flet app at that point. This will be default disabled, but anyone can enable it in their app with 2 new page variables, making it a nice addition to control back button behavior.

Test Code

page.back_exit_enabled = True
page.back_exit_message = f"Press back again to exit"

Type of change

• [ x ] New feature (non-breaking change which adds functionality)
• [ x ] This change requires a documentation update

Checklist

• [ x ] I signed the CLA.
• [ x ] My code follows the style guidelines of this project
• [ x ] I have performed a self-review of my own code
• [ x ] I have commented my code, particularly in hard-to-understand areas
• [ x ] My changes generate no new warnings
• [ x ] New and existing tests pass locally with my changes
• I have made corresponding changes to the documentation (if applicable)

Additional details

Solves another Google TV issue.

Summary by Sourcery

Implement Android predictive back support to prevent app crashes on Google TV when using the back button. Introduce new page variables to enable and customize back button behavior, allowing users to confirm app exit with a snackbar message.

New Features:

• Introduce Android predictive back support to enhance user experience by allowing users to confirm app exit with a snackbar message.

Enhancements:

• Add new page variables 'back_exit_enabled' and 'back_exit_message' to control back button behavior, providing flexibility for app developers.

Documentation:

• Update documentation to reflect the new feature of Android predictive back support and the associated page variables.

[syleishere]

Android back button event capture and use in routing and exit solved and proved with other people here: #4495 (reply in thread)

You cannot trap the back button on the remote on Google tv, this is only way.

[FeodorFitsner]

The functionality in this PR is now achievable with View.can_pop and View.on_confirm_pop.

A working example: https://github.com/flet-dev/flet/blob/main/sdk/python/examples/apps/routing_navigation/pop_view_confirm.py

It works with a system Back button on Android too.