feat(wear): add One-Handed Gestures demo snippet - #1001
Draft
ithinkihaveacat wants to merge 12 commits into
Draft
Conversation
Add self-contained Wear OS One-Handed Gestures demo snippet to com.example.wear.snippets.m3.gestures. Gate SNAPSHOT dependencies (compose-material3 and foundation) on isUsingSnapshot in wear/build.gradle.kts to avoid modifying shared catalog versions in libs.versions.toml. Update CI workflows to pass -PsnapshotVersion=1.7.0-SNAPSHOT during PR validation builds.
Move the KDoc note about -PsnapshotVersion=1.7.0-SNAPSHOT below the package declaration so that ktlint does not report multiple header blocks above package.
Pin third-party GitHub Actions to immutable commit SHAs and define explicit job-level permissions blocks in build.yml and apply_spotless.yml to remediate mandatory Zizmor security analysis findings.
Namespace Wear snapshot gating property to wearSnapshotVersion so that passing -PwearSnapshotVersion=1.7.0-SNAPSHOT in CI workflows does not trigger snapshot builds in the xr module.
Rename wearSnapshotVersion to wearComposeOverride to match the wearCompose prefix convention used in libs.versions.toml.
Add concise 5-6 line snippet examples for scrollable and button one-handed gestures so they can be included cleanly in developer documentation without embedding an entire screen.
Include compose.foundation in the isUsingSnapshot override block so that -PwearComposeOverride=1.7.0-SNAPSHOT also updates Wear Compose Foundation to 1.7.0-SNAPSHOT during CI builds.
Remove priority setting from ButtonGestureSnippet so the initial interactive button example in documentation is minimal and simple.
Update ButtonGestureSnippet to show a clean Button composable with Modifier.oneHandedGesture without unnecessary conditional modifiers or indicator state boilerplate.
Declare remember { MutableInteractionSource() } inside
ButtonGestureSnippet so the documentation example is self-contained and
runnable, and add an inline comment explaining why interactionSource
is shared.
Make ScrollGestureSnippet self-contained and runnable without priority, and add highlight region tags around .oneHandedGesture in both snippets.
Remove nested highlight region tags from ButtonGestureSnippet and ScrollGestureSnippet.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR Description
Overview
This PR adds a standalone, self-contained demonstration snippet for Wear OS One-Handed Gestures (Wear OS 7+, API 35+) using Jetpack Compose on Wear OS. It demonstrates both scrollable container gestures and interactive button click gestures (Double Pinch and Wrist Turn).
Note that this PR currently depends on SNAPSHOT versions of
androidx.wear.compose:compose-material3. (See below for how this is handled.)Key Changes
OneHandedGestures.kt):OneHandedGestureScreen()undercom.example.wear.snippets.m3.gestures.rememberOneHandedGestureConfiguration,Modifier.oneHandedGesture,OneHandedGestureScrollIndicator, andOneHandedGestureClickIndicator.[START android_wear_one_handed_gesture_screen]) for embedding in official developer documentation ondeveloper.android.com(DAC).MainActivity.kt):WearApp()to invokeOneHandedGestureScreen()for local testing.How to Test
# Build the Wear OS debug APK locally ./gradlew :wear:assembleDebug -PwearComposeOverride=1.7.0-SNAPSHOT --stacktraceWhy is
-PwearComposeOverride=1.7.0-SNAPSHOTneeded?To test unreleased One-Handed Gesture APIs without disrupting shared catalog versions across other samples in
libs.versions.toml, this PR adopts the exact scoped snapshot-gating pattern established by thexrmodule in this repository.By defining an
isUsingSnapshotcheck and a.toSnapshotDependency(...)helper withinwear/build.gradle.kts, the SNAPSHOT override is strictly scoped to the:wearmodule and is only activated when-PwearComposeOverrideis explicitly provided. When building standard samples without this flag,:wearcontinues using the stable library version fromlibs.versions.toml.This implementation directly mirrors the canonical approach used in
xr/build.gradle.kts:xr/build.gradle.kts#L41-L42(val isUsingSnapshot = wearComposeOverride != null).xr/build.gradle.kts#L60-L67(if (isUsingSnapshot) { ... } else { ... }).xr/build.gradle.kts#L137-L144(fun Provider<MinimalExternalModuleDependency>.toSnapshotDependency()).