Skip to content

Add Adaptive Layout / Large Screen support demo - #211

Open
dipenpradhan wants to merge 14 commits into
Gurupreet:masterfrom
dipenpradhan:issue-190-adaptive
Open

Add Adaptive Layout / Large Screen support demo#211
dipenpradhan wants to merge 14 commits into
Gurupreet:masterfrom
dipenpradhan:issue-190-adaptive

Conversation

@dipenpradhan

Copy link
Copy Markdown

Summary

Adds an Adaptive Layout / Large Screen demo, as proposed in #190.

New "Adaptive UI (Large screens)" entry on the home screen launches AdaptiveUIActivity, which demonstrates:

  • NavigationSuiteScaffold (material3-adaptive-navigation-suite) — automatically renders a bottom NavigationBar on compact phones, a NavigationRail on medium windows, and adapts for expanded windows
  • ListDetailPaneScaffold (material3.adaptive:adaptive-layout + adaptive-navigation) — albums list/detail: single pane with back navigation on phones, two-pane side-by-side on tablets/foldables/desktop windows; rememberListDetailPaneScaffoldNavigator handles pane navigation and predictive back
  • currentWindowAdaptiveInfo().windowSizeClass — the Favorites/Profile destinations display the live window width/height size classes so resizing (multi-window, foldable posture) is observable

All four adaptive artifacts are version-managed by the Compose BOM (no new version constants). Dark mode follows the existing theme plumbing.

Acceptance criteria from #190

  • NavigationSuiteScaffold switches navigation component based on window size class
  • ListDetailPaneScaffold shows a two-pane layout on tablets
  • Works single-pane on phones (with back handling), two-pane on large/hinge-aware windows (pane logic delegated to the official adaptive library)
  • Dark mode support

Closes #190

Verification

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

Merge order

PR 11 of the stacked series. Depends on #195 → … → #210 — its diff includes their 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).
- 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.
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 Adaptive Layout / Large Screen support

1 participant