跳转到相应内容

最常访问

最近访问

navigation

使用 Wear 界面库

Android 支持库可在不同应用中实现统一的最佳用户界面。Android 支持库的版本 26.0.0 包括 Wear 界面库,其包含许多适用于 Wear 应用的首选界面组件。

Wear 界面库包括(但不限于)以下。这些类的名称虽与穿戴式设备支持库已弃用的相关类的名称相似,但具有更多优势:

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

在 Android 支持库上添加依赖项

要使用 Wear 界面库,请在 Wear 模块的 build.gradle 文件中添加以下依赖项:

dependencies {
    ...
    compile 'com.android.support:wear:26.0.0'
}

如有必要,在穿戴式设备支持库上包含一个依赖项(请参阅创建或更新项目)。另请参阅添加支持库

从 Wear 界面库软件包导入类

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

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

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

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

<android.support.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." />
</android.support.wear.widget.SwipeDismissFrameLayout>

使用库类的示例

Wear 界面库中的类在功能上与穿戴式支持库中的类相同或相似。已对某些类、函数和属性名称进行更新,以提升与 Android 支持库的一致性。

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

import android.support.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 android.support.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 界面库和其他库中针对穿戴式设备支持库中已弃用的类的取代信息。

已弃用的类 取代信息
ActionChooserView AlertDialog
ActionLabel 针对导航使用 WearableActionDrawerView,针对确认操作使用 ConfirmationOverlay
ActionPage 针对导航使用 WearableActionDrawerView,针对确认操作使用 ConfirmationOverlay
BoxInsetLayout BoxInsetLayout
BoxInsetLayout.LayoutParams BoxInsetLayout.LayoutParams
CardFragment 使用 SnapHelperRecyclerView
CardFrame 使用 SnapHelperRecyclerView
CardScrollView 使用 SnapHelperRecyclerView
CircledImageView RoundedDrawable
CircularButton 请参阅 Material Design 库组件
CrossfadeDrawable AnimationSet
CurvedChildLayoutManager WearableLinearLayoutManager
DefaultOffsettingHelper WearableLinearLayoutManager
DelayedConfirmationView CircularProgressLayout
DismissOverlayView 不适用;对于全屏 Activity,不再建议通过长按来关闭应用。
DotsPageIndicator 不适用;对于应用,不再建议使用水平滚动。
FragmentGridPagerAdapter 使用 PageSnapHelperRecyclerView
GridPagerAdapter 使用 SnapHelperRecyclerView
GridViewPager 使用 SnapHelperRecyclerView
GridViewPager.LayoutParams 不适用;对于应用,不再建议使用双向空间模型。如果您实现垂直分页模式,请考虑使用 SnapHelperRecyclerView
ProgressSpinner ProgressBar
SwipeDismissFrameLayout SwipeDismissFrameLayout
SwipeDismissFrameLayout.Callback SwipeDismissFrameLayout.Callback
WatchViewStub 请参阅提供资源
WearableFrameLayout 请参阅提供资源
WearableFrameLayout.LayoutParams 请参阅提供资源
WearableListView WearableRecyclerView
WearableListView.Adapter 对于居中和对齐列表项,请考虑使用 SnapHelperLinearSnapHelper 支持的 WearableRecyclerView。要根据列表项在屏幕中的位置对其进行缩放和其他修改,请考虑使用 WearableLinearLayoutManager CurvingLayoutCallback
WearableListView.GenericAdapter 对于居中和对齐列表项,请考虑使用 SnapHelperLinearSnapHelper 支持的 WearableRecyclerView。要根据列表项在屏幕中的位置对其进行缩放和其他修改,请考虑使用 WearableLinearLayoutManager CurvingLayoutCallback
WearableListView.ViewHolder 对于居中和对齐列表项,请考虑使用 SnapHelperLinearSnapHelper 支持的 WearableRecyclerView。要根据列表项在屏幕中的位置对其进行缩放和其他修改,请考虑使用 WearableLinearLayoutManager CurvingLayoutCallback
WearableRecyclerView WearableRecyclerView
WearableRecyclerView.ChildLayoutManager WearableLinearLayoutManager
WearableRecyclerView.OffsettingHelper WearableLinearLayoutManager.LayoutCallback
WearableActionDrawer WearableActionDrawerView
WearableDrawerLayout WearableDrawerLayout
WearableDrawerLayout.DrawerStateCallback WearableDrawerLayout.DrawerStateCallback
WearableDrawerView WearableDrawerView
WearableNavigationDrawer WearableNavigationDrawerView
WearableNavigationDrawer.WearableNavigationDrawerAdapter WearableNavigationDrawerView.WearableNavigationDrawerAdapter
此网站会使用 Cookie 来存储您在此网站上指定的语言和显示选项偏好设置。

获取最新的 Android Developers 资讯和提示,助您在 Google Play 上取得成功。

* 必填字段

成功!

在微信上关注 Google Developers

要以浏览此网站吗?

您请求访问的是网页,但是您为此网站设置的语言偏好为

要更改您的语言偏好设置并以浏览此网站吗?如果以后您想要更改语言偏好设置,请使用每个页面底部的语言菜单。

该类需要 或更高的 API 级别

此文档已被隐藏,因为您为该文档选择的 API 级别是 。您可以使用左侧导航栏上方的选择器来更改文档的 API 级别。

要详细了解如何根据您的应用需求指定 API 级别,请参阅支持不同平台版本

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)