Menggunakan Library Wear UI

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:

• BoxInsetLayout. Tata letak yang menerapkan sisipan untuk layar berbentuk lingkaran.
• SwipeDismissFrameLayout. Tata letak yang memungkinkan pengguna menutup semua tampilan dengan menggeser layar dari kiri ke kanan.
• WearableRecyclerView. Tampilan yang menyediakan tata letak melengkung, seperti yang digunakan untuk peluncur aplikasi Wear utama.
• AmbientModeSupport. Class yang digunakan dengan antarmuka AmbientModeSupport.AmbientCallbackProvider untuk menyediakan dukungan bagi mode standby.

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:

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

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

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

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.