Skip to content

Most visited

Recently visited

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
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)