Skip to content

Add Predictive Back gesture demo (PredictiveBackHandler) - #220

Open
dipenpradhan wants to merge 21 commits into
Gurupreet:masterfrom
dipenpradhan:issue-200-predictive-back
Open

Add Predictive Back gesture demo (PredictiveBackHandler)#220
dipenpradhan wants to merge 21 commits into
Gurupreet:masterfrom
dipenpradhan:issue-200-predictive-back

Conversation

@dipenpradhan

Copy link
Copy Markdown

Summary

Adds a Predictive Back gesture demo for Android 15+, as proposed in #200.

New "Predictive Back gesture" entry on the home screen launches PredictiveBackActivity, which uses Compose's PredictiveBackHandler:

  • An in-app navigation drawer follows the back-swipe progress in real time — it translates, scales and fades in lock-step with BackEventCompat.progress as the user drags
  • Commit (gesture completes) closes the drawer instead of finishing the activity
  • Cancel (gesture released early) springs the drawer back open (re-throws CancellationException, per the API contract)
  • The handler is enabled only while the drawer is open, so once closed the system handles back normally
  • android:enableOnBackInvokedCallback="true" added to the manifest <application> so the predictive animation is shown on Android 13+ devices

This mirrors the official compose-samples JetLagged drawer pattern referenced in the issue. Dark mode supported.

Closes #200

Verification

  • ./gradlew ktfmtCheck assembleDebug testDebugUnitTest passes locally (JDK 17, SDK 35)
  • CI ./gradlew build on this PR

Merge order

Stacks on #219 (dep refresh) and the rest of the upgrade chain. Its diff includes those commits until they merge.

🤖 Generated with Claude Code

cc @Gurupreet for review

- Bump kotlin-gradle-plugin 1.9.22 -> 2.1.20 (root + buildSrc)
- Adopt the new Compose Compiler Gradle plugin
  (org.jetbrains.kotlin.plugin.compose) in app and convention plugins
- Drop composeCompiler version constant and composeOptions blocks
- Replace removed -Xopt-in flag with -opt-in
- Bump KSP to 2.1.20-1.0.31 to match Kotlin

Fixes Gurupreet#182
ktfmt-gradle 0.12.0 fails with 'Generic error during file processing'
once Kotlin 2.x is on the buildscript classpath. 0.22.0 supports
Kotlin 2.x and also formats *.kts build scripts, hence the repo-wide
reformat (no functional changes).
@dipenpradhan
dipenpradhan force-pushed the issue-200-predictive-back branch from 008db74 to 6194f67 Compare September 8, 2026 06:38
- AGP 8.2.2 -> 8.7.3 (compileSdk 35 supported from AGP 8.6)
- Gradle wrapper 8.5 -> 8.9 (required by AGP 8.7.x)
- PinLockView: removeLast() -> removeAt(lastIndex); at compileSdk 35 the
  call binds to java.util.List#removeLast (API 35) instead of the Kotlin
  stdlib extension, failing lint NewApi against minSdk 25

Fixes Gurupreet#185
- Replace compose/material3 version constants with composeBom
- Strip explicit versions from BOM-managed artifacts
- Import the BOM platform on every configuration that receives
  Compose artifacts (implementation, debugImplementation,
  androidTestImplementation, :data)
- Migrate API removals that come with Compose 1.7 / Material3 1.3:
  SmallTopAppBar -> TopAppBar, rememberRipple -> material3 ripple
- Update the outdated README Compose badge to the BOM version

Fixes Gurupreet#186
All lifecycle artifacts (viewmodel-compose, viewmodel-ktx,
livedata-ktx, runtime-ktx, viewmodel-savedstate) move together
via the shared androidLifecycleGrouped version.

Fixes Gurupreet#192
- navCompose 2.7.7 -> 2.8.9; add kotlinx-serialization-json 1.8.0
- Apply the Kotlin serialization plugin in gmail and tiktok demos
- Gmail: string routes -> @serializable route objects
- TikTok: TikTokScreen becomes a serializable sealed interface;
  the profile route carries a typed userId argument read via
  toRoute(), bottom bar selection uses NavDestination.hasRoute

Fixes Gurupreet#193
- Replace com.google.android.exoplayer:exoplayer with
  androidx.media3:media3-exoplayer and media3-ui
- Rewrite TikTokPlayer against the Media3 API (SimpleExoPlayer was
  removed; default media source factory handles asset URIs)
- Removes the last Jetifier warning produced by ExoPlayer 2.x

Fixes Gurupreet#183
- Move to the io.coil-kt.coil3 artifact group
- Add coil-network-okhttp (network fetching is a separate artifact
  in Coil 3, self-registered via ServiceLoader)
- Migrate call sites: rememberImagePainter(data=) ->
  rememberAsyncImagePainter(model=), coil.* -> coil3.* imports

Fixes Gurupreet#191
PullRefreshList was a fully commented-out stub (TODO revisit pull
refresh). It now demonstrates the first-party PullToRefreshBox with
a simulated 1.5s reload that prepends an item to the list.

Fixes Gurupreet#187
Covers the new composables added here so the feature ships with its own
verification rather than relying on a later change in the stack.
…undo

The Swipeable Lists tab rendered SwipeToDismissBox items but swipes
never removed anything. Now:
- swipe left deletes (red background), swipe right archives
- items are actually removed from the keyed LazyColumn
- an Undo snackbar restores the item at its original position
- positionalThreshold set to half the item width

Fixes Gurupreet#188
Adds UI tests for the composables introduced here so the feature ships with
its own verification.

The undo test surfaced a real defect: tapping Undo re-added the album to the
backing list, but LazyColumn keeps the first visible item anchored, so a row
re-inserted above it silently landed off-screen and the user saw nothing
happen. The list now holds a LazyListState and scrolls the restored row back
into view.
- NavigationSuiteScaffold switches bottom bar / rail / drawer by
  window size class
- ListDetailPaneScaffold gives single-pane on phones, two-pane on
  tablets and foldables, with predictive-back-aware pane navigation
- Favorites/Profile destinations display the live window size classes
- All adaptive artifacts are version-managed by the Compose BOM

Fixes Gurupreet#190
Covers the new composables added here so the feature ships with its own
verification rather than relying on a later change in the stack.
InfiniteCarousel builds on foundation's HorizontalPager with a large
virtual page count starting in the middle, so it loops endlessly in
both directions. Auto-advances every 3s and pauses while dragging.
Showcased at the top of the Carousel demo screen.

Fixes Gurupreet#13
Adds InfiniteCarouselTest so the carousel ships with its own verification
instead of relying on a later change in the stack. The convention plugin now
sets testInstrumentationRunner so library modules can host androidTests.

Swipe gestures target the root rather than the Text node inside a page: a
gesture is dispatched over the bounds of the node it is performed on, and a
Text node is far too narrow to cross the pager's paging threshold.
- InterestTagTest: text, click action, onClick callback
- LoginScreenTest: fields, button, text input

The carousel's test ships alongside the carousel itself, so this change covers
the components that already existed without any test coverage.

Refs Gurupreet#68
- gradle/libs.versions.toml is the single source of truth for all
  versions, libraries and plugins; bundles mirror the old grouped
  dependency helpers
- All module build files use libs.* accessors
- Root build script uses the plugins DSL (ktfmt via alias); AGP,
  Kotlin, KSP and serialization reach the classpath via buildSrc,
  whose own dependencies are catalog-driven through a new
  buildSrc/settings.gradle.kts
- Delete Versions.kt, Dependencies.kt, GroupedDependencies.kt and
  DependencyHandlerExtensions.kt; keep convention plugins and
  ProjectConfigs.kt

Fixes Gurupreet#189
activity-compose 1.10.1, core-ktx 1.16.0, appcompat 1.7.1,
material 1.12.0, room 2.7.1, paging 3.3.6, coroutines 1.10.2,
retrofit 2.11.0. Versions newer than these require compileSdk 36
and are deferred.

Fixes Gurupreet#199
PredictiveBackActivity uses Compose's PredictiveBackHandler to drive
an in-app drawer that follows the back-swipe progress (translate +
scale + fade), commits closed on completion and springs back on
cancel. Adds enableOnBackInvokedCallback to the manifest.

Fixes Gurupreet#200
Covers the new composables added here so the feature ships with its own
verification rather than relying on a later change in the stack.
@dipenpradhan
dipenpradhan force-pushed the issue-200-predictive-back branch from 6194f67 to 64d2877 Compare September 8, 2026 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature: Add Predictive Back gesture demo for Android 15+

1 participant