إستخدام مكتبة واجهة مستخدم الساعه

الإعلانات

إستخدام مكتبة واجهة مستخدم الساعه

 

 

إستخدام مكتبة واجهة مستخدم الساعه

مكتبات دعم الأندرويد تقوم بتمكين واجهات مستخدم ثابته ومحسّنة عبر التطبيقات.

مكتبة دعم اندرويد تحتوي على مكتبة واجهة مستخدم الساعه، والتي تحتوي على العديد من مكونات واجهة المستخدم المفضلة لتطبيقات الساعه.

تتضمن مكتبة واجهة مستخدم الساعه (على سبيل المثال لا الحصر) الفئات التالية.

تحتوي بعض الفئات على أسماء متشابهة، وتوفر فوائد عديدة عبر الفئات التي تم إيقافها ذات الصلة، في مكتبة دعم الساعه:

 

BoxInsetLayout. مخطط يطبق إدخالات للشاشات الدائرية.

SwipeDismissFrameLayout. مخطط يمكّن المستخدم من مغادرة أي معاينه بواسطة التمرير السريع على الشاشة من اليسار إلى اليمين.

WearableRecyclerView. معاينه توفرمخطط منحني، مثل المخطط المستخدم في مشغل تطبيقات الساعه الرئيسي.

AmbientModeSupport. فئة تستخدم مع واجهة AmbientModeSupport.AmbientCallbackProvider لتوفير الدعم للوضع المحيطي.

راجع أيضاً أدراج الإجراء والتنقل في مكتبة واجهة مستخدم الساعه.

 

 

 

 

 

إضافة إعتمادات إلى مكتبة واجهة مستخدم الساعه


لإستخدام مكتبة واجهة مستخدم الساعه، أضف الإعتماد التالي في ملف البناء build.gradle الخاص بنموذج الساعه:

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

 

إذا لزم الأمر، قم بتضمين إعتماد إلى مكتبة دعم الساعات (راجع إنشاء أو تحديث مشروع). راجع أيضاً إضافة مكتبات الدعم.

 

 

 

 

 

إستيراد فئات من حزمة مكتبة واجهة مستخدم الساعه


عندما تستخدم فئة من مكتبة واجهة مستخدم الساعه، قم بإستيراد تلك الفئة من حزمة android.support.wear.widget. راجع مثال على إستخدام فئة المكتبة.

 

 

 

 

إستخدم أسماء العناصر الصحيحة في ملفات المخطط


في ملفات المخطط، إستخدم أسماء مؤهلة تماماً والتي تتوافق مع مكتبة واجهة مستخدم الساعة (بدلاً من مكتبة دعم الساعات).

مثال، لإستخدام الفئة 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>

 

 

 

 

مثال على إستخدام فئة مكتبة واجهة مستخدم الساعه


تحتوي الفئات الموجودة في مكتبة واجهة مستخدم الساعه على وظيفة مماثلة أو مشابهة لتلك الموجودة في مكتبة دعم الساعات.

يتم تحديث بعض أسماء الفئات، الدوال، و السمات لتحسين التناسق مع مكتبة دعم الأندرويد.

مثال،النشاط الذي يستخدم الفئة WearableRecyclerView من مكتبة دعم الساعات يمكن أن يحتوي على الكود التالي:

KOTLIN

import android.support.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 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());
}

 

وبالمثل، النشاط الذي يستخدم الفئة WearableRecyclerView من مكتبة واجهة مستخدم الساعه يمكن أن يحتوي على الكود التالي.

الإختلافات عن الكود أعلاه مميزة بالخط العريض:

KOTLIN

import android.support.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 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());
}

 

 

 

 

أدراج الإجراء والتنقل في مكتبة واجهة مستخدم الساعه


تحتوي مكتبة واجهة مستخدم الساعة على مكونات لأدراج الإجراء والتنقل.

للحصول على معلومات إضافية، راجع الإجراء والتنقل في الساعه.

 

 

 

 

 

بدائل للفئات الموقوفة


يحتوي الجدول أدناه على بدائل، في مكتبة واجهة مستخدم الساعة وأماكن أخرى، للفئات التي تم إيقافها في مكتبة دعم الساعات.

 

فئة موقوفهمعلومات الإستبدال
ActionChooserViewAlertDialog
ActionLabelإستخدم WearableActionDrawerView للتنقل

و ConfirmationOverlay لتأكيد الإجراءات.
ActionPageإستخدم WearableActionDrawerView للتنقل

و ConfirmationOverlay لتأكيد الإجراءات.
BoxInsetLayoutBoxInsetLayout
BoxInsetLayout.LayoutParamsBoxInsetLayout.LayoutParams
CardFragmentإستخدم SnapHelper و RecyclerView.
CardFrameإستخدم SnapHelper و RecyclerView.
CardScrollViewإستخدم SnapHelper و RecyclerView.
CircledImageViewRoundedDrawable 
CircularButtonراجع مكونات مكتبة تصميم الأدوات
CrossfadeDrawableAnimationSet
CurvedChildLayoutManagerWearableLinearLayoutManager
DefaultOffsettingHelperWearableLinearLayoutManager
DelayedConfirmationViewCircularProgressLayout
DismissOverlayViewلا يمكن تطبيقها؛ الضغط المطول لرفض التطبيق لم يعد مقترحاً، للأنشطة التفاعليه.
DotsPageIndicatorلا يمكن تطبيقها؛ التمرير الأفقي للتطبيقات، لم يعد مقترحاً.
FragmentGridPagerAdapterإستخدم PageSnapHelper و RecyclerView.
GridPagerAdapterإستخدم SnapHelper و RecyclerView.
GridViewPagerإستخدم SnapHelper و RecyclerView.
GridViewPager.LayoutParamsلا يمكن تطبيقها؛ نماذج الحيز ثنائية الإتجاه لم تعد مقترحه للتطبيقات.

إذا كنت تقوم بتطبيق نمط ترحيل رأسي للصفحات فإستخدم

SnapHelper و RecyclerView.
ProgressSpinnerProgressBar
SwipeDismissFrameLayoutSwipeDismissFrameLayout
SwipeDismissFrameLayout.CallbackSwipeDismissFrameLayout.Callback
WatchViewStubراجع توفير المصادر
WearableFrameLayoutراجع توفير المصادر
WearableFrameLayout.LayoutParamsراجع توفير المصادر
WearableListViewWearableRecyclerView
WearableListView.Adapterمن أجل توسيط و إلتقاط عناصر القائمه، إستخدم WearableRecyclerView 

المدعومة بواسطة SnapHelper أو LinearSnapHelper.

لتحجيم و تعديل عناصر القائمه، بناءً على موقعهم في الشاشه إستخدم

WearableLinearLayoutManager

أو 

CurvingLayoutCallback
WearableListView.GenericAdapterمن أجل توسيط و إلتقاط عناصر القائمه، إستخدم WearableRecyclerView 

المدعومة بواسطة SnapHelper أو LinearSnapHelper.

لتحجيم و تعديل عناصر القائمه، بناءً على موقعهم في الشاشه إستخدم

WearableLinearLayoutManager

أو 

CurvingLayoutCallback
WearableListView.ViewHolderمن أجل توسيط و إلتقاط عناصر القائمه، إستخدم WearableRecyclerView 

المدعومة بواسطة SnapHelper أو LinearSnapHelper.

لتحجيم و تعديل عناصر القائمه، بناءً على موقعهم في الشاشه إستخدم

WearableLinearLayoutManager

أو 

CurvingLayoutCallback
WearableRecyclerViewWearableRecyclerView
WearableRecyclerView.ChildLayoutManagerWearableLinearLayoutManager
WearableRecyclerView.OffsettingHelperWearableLinearLayoutManager.LayoutCallback
WearableActionDrawerWearableActionDrawerView
WearableDrawerLayoutWearableDrawerLayout
WearableDrawerLayout.DrawerStateCallbackWearableDrawerLayout.DrawerStateCallback
WearableDrawerViewWearableDrawerView
WearableNavigationDrawerWearableNavigationDrawerView
WearableNavigationDrawer.WearableNavigationDrawerAdapterWearableNavigationDrawerView.WearableNavigationDrawerAdapter

 

 


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات

11 thoughts on “إستخدام مكتبة واجهة مستخدم الساعه”

اترك رد