使用 Wear 界面库

Android Jetpack 可在各种应用中实现经过优化的一致界面。 Android Jetpack 包括 Wear 界面库，该界面库包含许多适用于 Wear OS 应用的首选界面组件。

Wear 界面库包括（但不限于）以下类。其中某些类的名称与穿戴式设备支持库中相关的已弃用类的名称相似，但与其相比具备诸多优势：

• BoxInsetLayout。此布局可对圆形屏幕应用边衬区。
• SwipeDismissFrameLayout。使用此布局，用户可通过在屏幕上从左向右滑动关闭任何视图。
• WearableRecyclerView。此视图可提供曲线布局，如用于主 Wear 应用启动器的布局。
• AmbientModeSupport。与 AmbientModeSupport.AmbientCallbackProvider 接口一起使用的类，共同为微光模式提供支持。

另请参阅 Wear 界面库中的操作和抽屉式导航栏。

添加 Wear 界面库的依赖项

如需使用 Wear 界面库，请在 Wear 模块的 build.gradle 文件中添加以下依赖项：

    dependencies {
        ...
        compile 'androidx.wear:wear:1.0.0'
    }
    

从 Wear 界面库软件包导入类

使用 Wear 界面库中的某个类时，可从 androidx.wear.widget 软件包导入该类。请参阅使用库类的示例。

在布局文件中使用正确的元素名称

在布局文件中，应使用与 Wear 界面库（而不是穿戴式设备支持库）对应的完全限定名称。

例如，要使用 Wear 界面库中的 SwipeDismissFrameLayout 类，您可以在布局文件中指定以下内容：

    <androidx.wear.widget.SwipeDismissFrameLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/swipe_dismiss_root" >

        <TextView
            android:id="@+id/test_content"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:text="Swipe the screen to dismiss me." />
    </androidx.wear.widget.SwipeDismissFrameLayout>
    

使用 Wear 界面库类的示例

Wear 界面库中的类在功能上与穿戴式设备支持库中的类相同或相似。为了与 Android 支持库更加一致，某些类、方法和属性名称已经过更新。

例如，使用穿戴式设备支持库中的 WearableRecyclerView 类的 Activity 可能包含以下代码：

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = ChildLayoutManager()
            adapter = TestAdapter()
        }
    }
    

    import androidx.wearable.view.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new ChildLayoutManager());
        wrv.setAdapter(new TestAdapter());
    }
    

同样，使用 Wear 界面库中的 WearableRecyclerView 类的 Activity 可能包含以下代码。该代码与上述代码的不同之处显示为粗体：

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = WearableLinearLayoutManager(this@MainActivity)
            adapter = TestAdapter()
        }
    }
    

    import androidx.wear.widget.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new WearableLinearLayoutManager(this));
        wrv.setAdapter(new TestAdapter());
    }
    

Wear 界面库中的操作和抽屉式导航栏

Wear 界面库包含操作和抽屉式导航栏组件。

如需了解详情，请参阅 Wear 导航和操作。.

已弃用类的替代类

下表列出了 Wear 界面库和其他库中穿戴式设备支持库中已弃用的类的替代类。