ساختن رابط‌های کاربری مبتنی بر نما در Wear OS

امتحان کردن روش Compose
‫Jetpack Compose در Wear OS جعبه‌ابزار میانای کاربر توصیه‌شده برای Wear OS است.
امتحان کردن Compose در Wear OS ←

Android Jetpack شامل «کتابخانه واسط کاربر Wear OS» است. کتابخانه میانای کاربر Wear OS شامل کلاس‌های زیر است:

  • ‫ CurvedTextView: مؤلفه‌ای برای نوشتن آسان نوشتار که از انحنای بزرگ‌ترین دایره‌ای که می‌تواند در نما درج شود پیروی می‌کند.
  • DismissibleFrameLayout: چیدمانی که به کاربر اجازه می‌دهد با فشار دادن دکمه برگشت یا تند کشیدن روی صفحه از چپ به راست، هر نمایی را ببندد. کاربران Wear OS انتظار دارند که تند کشیدن از چپ به راست برای کنش برگشت باشد.
  • WearableRecyclerView: نمایی که منطق جبران‌سازی پایه را برای به‌روزرسانی چیدمان‌های فرزند بااستفاده از WearableLinearLayoutManager ارائه می‌دهد.
  • ‫ AmbientLifecycleObserver: میانایی که با میانای AmbientLifecycleObserver.AmbientLifecycleCallback استفاده می‌شود تا پشتیبانی آگاه از چرخه حیات را برای حالت محیطی ارائه دهد.

برای مشاهده فهرست کامل، یادداشت‌های انتشار را بخوانید.

افزودن وابستگی به کتابخانه میانای کاربر Wear OS

برای شروع ساختن برنامه، پروژه‌ای مختص Wear OS ایجاد کنید. سپس وابستگی‌های زیر را به فایل build.gradle برنامه‌تان اضافه کنید: 

dependencies {
    ...
  // Standard Wear OS libraries
  implementation "androidx.wear:wear:1.4.0"
  // includes support for wearable specific inputs
  implementation "androidx.wear:wear-input:1.1.0"
}

وارد کردن کلاس‌ها از بسته Wear OS UI Library

برای استفاده از مؤلفه‌های «واسط کاربر» از «کتابخانه واسط کاربر Wear OS»، آن‌ها را از بسته androidx.wear.widget یا از androidx.wear.ambient برای پشتیبانی از حالت محیطی وارد کنید.

استفاده از نام‌های عنصر درست در فایل‌های چیدمان

در فایل‌های چیدمان، از نام‌های کاملاً واجدشرایطی استفاده کنید که با «کتابخانه واسط کاربر Wear OS» مطابقت داشته باشند.

برای مثال، برای استفاده از کلاس DismissibleFrameLayout از «کتابخانه میانای کاربری Wear OS»، می‌توانید موارد زیر را در فایل چیدمان مشخص کنید: 

<androidx.wear.widget.DismissibleFrameLayout
    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.DismissibleFrameLayout>