Menggunakan Library Wear UI

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Android Jetpack memungkinkan antarmuka pengguna yang dioptimalkan dan konsisten di seluruh aplikasi. Android Jetpack menyertakan Library Wear UI, yang berisi banyak komponen UI pilihan untuk aplikasi Wear OS Anda.

Library Wear UI menyertakan (tetapi tidak terbatas pada) class berikut. Beberapa class memiliki nama yang mirip dengan class terkait yang sudah tidak digunakan lagi dan menawarkan beberapa manfaat yang lebih besar darinya dalam Wearable Support Library:

Lihat juga Panel Tindakan dan Panel Navigasi di Library Wear UI.

Menambahkan dependensi pada Library Wear UI

Untuk menggunakan Library Wear UI, tambahkan dependensi berikut dalam file build.gradle modul Wear Anda:

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

Mengimpor class dari paket Library Wear UI

Saat Anda menggunakan class dari Library Wear UI, impor class tersebut dari paket androidx.wear.widget. Lihat Contoh Penggunaan Class Library.

Menggunakan nama elemen yang tepat dalam file tata letak

Dalam file tata letak, gunakan nama yang sepenuhnya memenuhi syarat, yang sesuai dengan Library Wear UI (bukan Wearable Support Library).

Misalnya, untuk menggunakan class SwipeDismissFrameLayout dari Library Wear UI, Anda dapat menetapkan kode berikut dalam file tata letak:

    <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>
    

Contoh penggunaan class Library Wear UI

Class dalam Library Wear UI memiliki fungsionalitas yang sama atau mirip dengan yang ada dalam Wearable Support Library. Beberapa nama class, metode, dan atribut diupdate untuk meningkatkan konsistensi dengan Android Support Library.

Misalnya, aktivitas yang menggunakan class WearableRecyclerView dari Wearable Support Library dapat menyertakan kode berikut:

Kotlin

    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()
        }
    }
    

Java

    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());
    }
    

Demikian pula, aktivitas yang menggunakan class WearableRecyclerView dari Library Wear UI dapat menyertakan kode berikut. Perbedaan dengan kode di atas ditulis dalam font tebal:

Kotlin

    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()
        }
    }
    

Java

    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());
    }
    

Panel tindakan dan panel navigasi di Library Wear UI

Library Wear UI memiliki komponen untuk panel tindakan dan navigasi.

Untuk informasi tambahan, lihat Navigasi dan tindakan Wear.

Penggantian untuk class yang tidak digunakan lagi

Tabel di bawah ini berisi penggantian untuk class yang tidak digunakan lagi, di Library Wear UI dan di lokasi lainnya, dalam Wearable Support Library.

Class yang tidak digunakan lagi Informasi penggantian
ActionChooserView AlertDialog
ActionLabel Gunakan WearableActionDrawerView untuk navigasi, dan ConfirmationOverlay untuk tindakan konfirmasi.
ActionPage Gunakan WearableActionDrawerView untuk navigasi, dan ConfirmationOverlay untuk tindakan konfirmasi.
BoxInsetLayout BoxInsetLayout
BoxInsetLayout.LayoutParams BoxInsetLayout.LayoutParams
CardFragment Gunakan SnapHelper dan RecyclerView.
CardFrame Gunakan SnapHelper dan RecyclerView.
CardScrollView Gunakan SnapHelper dan RecyclerView.
CircledImageView RoundedDrawable
CircularButton Lihat Komponen library desain material.
CrossfadeDrawable AnimationSet
CurvedChildLayoutManager WearableLinearLayoutManager
DefaultOffsettingHelper WearableLinearLayoutManager
DelayedConfirmationView CircularProgressLayout
DismissOverlayView Tidak berlaku; menekan lama untuk menutup aplikasi tidak lagi disarankan untuk aktivitas imersif.
DotsPageIndicator Tidak berlaku; scroll horizontal tidak lagi disarankan untuk aplikasi.
FragmentGridPagerAdapter Gunakan PageSnapHelper dan RecyclerView.
GridPagerAdapter Gunakan SnapHelper dan RecyclerView.
GridViewPager Gunakan SnapHelper dan RecyclerView.
GridViewPager.LayoutParams Tidak berlaku; model spasial bidireksional tidak lagi dianjurkan untuk aplikasi. Jika Anda mengimplementasikan pola pembagian halaman vertikal, pertimbangkan penggunaan SnapHelper dan RecyclerView.
ProgressSpinner ProgressBar
SwipeDismissFrameLayout SwipeDismissFrameLayout
SwipeDismissFrameLayout.Callback SwipeDismissFrameLayout.Callback
WatchViewStub Lihat Menyediakan Resource.
WearableFrameLayout Lihat Menyediakan Resource.
WearableFrameLayout.LayoutParams Lihat Menyediakan Resource.
WearableListView WearableRecyclerView
WearableListView.Adapter Untuk menengahkan dan menyematkan item daftar, pertimbangkan penggunaan WearableRecyclerView, yang didukung oleh SnapHelper atau LinearSnapHelper. Untuk menskalakan dan sebaliknya mengubah item daftar berdasarkan lokasinya di layar, pertimbangkan penggunaan WearableLinearLayoutManager atau CurvingLayoutCallback.
WearableListView.GenericAdapter Untuk menengahkan dan menyematkan item daftar, pertimbangkan penggunaan WearableRecyclerView, yang didukung oleh SnapHelper atau LinearSnapHelper. Untuk menskalakan dan sebaliknya mengubah item daftar berdasarkan lokasinya di layar, pertimbangkan penggunaan WearableLinearLayoutManager atau CurvingLayoutCallback.
WearableListView.ViewHolder Untuk menengahkan dan menyematkan item daftar, pertimbangkan penggunaan WearableRecyclerView, yang didukung oleh SnapHelper atau LinearSnapHelper. Untuk menskalakan dan sebaliknya mengubah item daftar berdasarkan lokasinya di layar, pertimbangkan penggunaan WearableLinearLayoutManager atau 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