Android Wear OS中ScrollView默认表冠滚动失效问题排查

问题描述 #

在Wear OS设备（如三星Watch6）上，表冠（bezel）默认应该可以滚动ScrollView，但在以下XML布局中，转动表冠时tvRules文本无法滚动：

<androidx.wear.widget.BoxInsetLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@drawable/backdrop"
android:orientation="vertical"
android:theme="@style/DotDashTheme">

<RelativeLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/lTitle"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="12dp"
        android:gravity="center_horizontal"
        android:shadowColor="#ff0000"
        android:shadowDx="2"
        android:shadowDy="2"
        android:shadowRadius="2"
        android:text="@string/rules"
        android:textColor="#aa0000"
        android:textSize="16sp"/>

    <ScrollView
        android:id="@+id/svRules"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_above="@id/bBack"
        android:layout_below="@id/lTitle"
        android:layout_marginStart="20dp"
        android:layout_marginTop="3dp"
        android:layout_marginEnd="20dp"
        android:layout_marginBottom="10dp">

        <TextView
            android:id="@+id/tvRules"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:gravity="center_horizontal"
            android:text="@string/rules_how_to_play"
            android:textColor="#1010D0"
            android:textSize="16sp"/>
    </ScrollView>

    <TextView
        android:id="@+id/bBack"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_centerHorizontal="true"
        android:layout_marginBottom="3dp"
        android:background="@drawable/textview_button"
        android:paddingStart="8dp"
        android:paddingEnd="8dp"
        android:text="@string/bBack"
        android:textColor="#FFFFFF"
        android:textSize="16sp"/>
</RelativeLayout>
</androidx.wear.widget.BoxInsetLayout>

目前已通过以下Java代码强制实现该功能：

//In activity onCreate()
ScrollView svRules = findViewById(R.id.svRules);
TextView tvRules = findViewById(R.id.tvRules);
svRules.post(() -> svRules.smoothScrollTo(0, tvRules.getTop()));
svRules.requestFocus();
svRules.setOnGenericMotionListener((v, event) -> {
  if (event.getAction() == MotionEvent.ACTION_SCROLL && event.isFromSource(InputDevice.SOURCE_ROTARY_ENCODER)) {
    float delta = -event.getAxisValue(MotionEvent.AXIS_SCROLL) * ViewConfiguration.get(Rules.this).getScaledVerticalScrollFactor();
    svRules.scrollBy(0, (int) delta);
    return true;
  }
  return false;
});

疑问 #

1. 默认情况下无法实现表冠滚动ScrollView的原因是什么？
2. 是否必须通过Java代码实现该功能，还是在配置中遗漏了什么？

项目依赖配置：
build.gradle中的依赖：

dependencies {
  implementation libs.appcompat
  implementation libs.material
  implementation libs.wear
  implementation libs.core
}

libs.versions.toml配置：

[versions]
appcompat = "1.7.0"
material = "1.12.0"
wear = "1.3.0"
core = "1.13.1"

[libraries]
appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
material = { group = "com.google.android.material", name = "material", version.ref = "material" }
wear = { group = "androidx.wear", name = "wear", version.ref = "wear" }
core = { group = "androidx.core", name = "core", version.ref = "core" }

原因分析及解决方案 #

核心原因 #

1. 焦点缺失：Wear OS的表冠旋转事件会优先发送给拥有焦点的视图。默认情况下ScrollView未获取焦点，若布局中其他可交互视图（比如底部设置了背景的bBack TextView，可能被识别为可点击元素）抢占了焦点，ScrollView就无法接收表冠事件。
2. 原生控件适配不足：Android原生ScrollView并未默认适配Wear OS的旋转编码器（表冠）事件，Wear OS的默认滚动支持更多针对系统组件或专属穿戴控件（如WearableRecyclerView），而非原生ScrollView。

替代方案（无需自定义代码） #

1. 替换为WearableRecyclerView：
   这是Wear OS官方推荐的滚动组件，默认支持表冠操作且针对穿戴设备做了体验优化。只需将布局中的ScrollView替换为WearableRecyclerView，并将内部TextView作为列表项加载即可：

   <androidx.wear.widget.WearableRecyclerView
       android:id="@+id/rvRules"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:layout_above="@id/bBack"
       android:layout_below="@id/lTitle"
       android:layout_marginStart="20dp"
       android:layout_marginTop="3dp"
       android:layout_marginEnd="20dp"
       android:layout_marginBottom="10dp"/>
   

   代码中设置简单适配器加载文本内容即可，无需额外处理表冠事件。

2. 确保ScrollView获取焦点：
   在XML中给ScrollView添加焦点属性，确保它能接收表冠事件：

   <ScrollView
       android:id="@+id/svRules"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:layout_above="@id/bBack"
       android:layout_below="@id/lTitle"
       android:layout_marginStart="20dp"
       android:layout_marginTop="3dp"
       android:layout_marginEnd="20dp"
       android:layout_marginBottom="10dp"
       android:focusable="true"
       android:focusableInTouchMode="true">
   

   同时在代码中调用svRules.requestFocus()，确保页面加载时焦点落在ScrollView上。部分场景下无需自定义事件监听即可实现表冠滚动。

3. 升级Wear依赖版本：
   当前使用的wear版本为1.3.0，尝试升级到最新稳定版（如1.4.0或更高），新版本可能修复了原生控件的表冠支持兼容性问题。

总结 #

如果想避免自定义代码，优先推荐使用WearableRecyclerView，它的表冠支持更完善且符合Wear OS交互规范。若坚持使用ScrollView，可尝试添加焦点属性并升级依赖，部分场景下无需自定义事件监听即可实现需求。

内容的提问来源于stack exchange，提问作者Jon