Wear

إنشاء تطبيقات للساعات الذكية التي تعمل بنظام التشغيل "Wear OS من Google".

يعرض هذا الجدول كل العناصر في مجموعة androidx.wear.

العناصر الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
ارتداء 1.3.0 - - 1.4.0-alpha01
طريقة إدخال الارتداء 1.1.0 - - 1.2.0-alpha02
اختبار الاستهلاك 1.1.0 - - 1.2.0-alpha02
مستنِد إلى الارتداء 1.0.0 - - 1.1.0-alpha01
تفاعلات مرتكزة على ارتداء الهاتف 1.0.1 - - 1.1.0-alpha04
تفاعلات الارتداء عن بُعد 1.0.0 - 1.1.0-beta01 -
تم إجراء آخر تعديل لهذه المكتبة في 24 يوليو 2024.

إعلان التبعيات

لإضافة اعتمادية على Wear، يجب إضافة مستودع Google Maven إلى مشروعك. الاطّلاع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الملحقات التابعة للعناصر التي تحتاجها في ملف build.gradle لـ لتطبيقك أو الوحدة التي تستخدمها:

Groovy

dependencies {
    implementation "androidx.wear:wear:1.3.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.1.0"
    implementation "androidx.wear:wear-input-testing:1.1.0"

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.0.0"

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.0.1"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.wear:wear:1.3.0")

    // Add support for wearable specific inputs
    implementation("androidx.wear:wear-input:1.1.0")
    implementation("androidx.wear:wear-input-testing:1.1.0")

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.0.0")

    // Use to implement support for interactions from the Wearables to Phones
    implementation("androidx.wear:wear-phone-interactions:1.0.1")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.0.0")
}

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.

إنشاء عدد جديد

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل. لمزيد من المعلومات.

الإصدار 1.0 من Wear Core

الإصدار 1.0.0-alpha01

29 مايو 2024

تم طرح androidx.wear:wear-core:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة فئة جديدة WearApiVersionhelper للمساعدة في التحقّق من توافق واجهة برمجة التطبيقات في وقت التشغيل على Wear. يمكن للعملاء استخدام فئة المساعدة الثابتة هذه والطريقة المقدَّمة (#isApiVersionAtLeast(VERSION)) للتحقّق من التوافق.

الإصدار 1.0 من معاينة أداة Wearing

الإصدار 1.0.0

29 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.wear:wear-tooling-preview:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الالتزام هذه.

الميزات في الإصدار 1.0.0

  • يمكنك إضافة WearDevices إلى قائمة أجهزة Wear الصالحة التي يمكن استخدامها في معاينات واجهة المستخدم.

الإصدار 1.0.0-rc01

15 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.wear:wear-tooling-preview:1.0.0-rc01 بدون أي تغييرات. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.0.0-beta01

18 تشرين الأول (أكتوبر) 2023

تم طرح androidx.wear:wear-tooling-preview:1.0.0-beta01 بدون أي تغييرات. يحتوي الإصدار 1.0.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.0.0-alpha01

23 آب (أغسطس) 2023

تم طرح androidx.wear:wear-tooling-preview:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • إضافة WearDevices إلى قائمة أجهزة Wear الصالحة التي يمكن استخدامها في معاينات واجهة المستخدم (Ib036e)

الإصدار 1.4 من Wear

الإصدار 1.4.0-alpha01

15 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.wear:wear:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • توسيط رمز ConfirmationOverlay عموديًا عند عدم وجود رسالة (I496d8)

الإصدار 1.3 من Wear

الإصدار 1.3.0

9 آب (أغسطس) 2023

تم طرح androidx.wear:wear:1.3.0 بدون أي تغييرات منذ 1.3.0-rc01. يحتوي الإصدار 1.3.0 على هذه عمليات التنفيذ.

تغييرات مهمة منذ الإصدار 1.2.0

  • عليك نقل بيانات "AmbientModeSupport" لاستخدام "LifecycleObserver". يمكنك إيقاف AmbientModeSupport نهائيًا لصالح الفئات الجديدة الواعية لمراحل النشاط.
  • تعديل ConfirmationOverlay باستخدام رموز أو تنسيق وخطوط ومقاييس خطوط جديدة
  • تم تعديل "SwipeDismissTransitionHelper" لاستخدام خلفية قابلة للرسم بدلاً من رمز View الثاني لتصحيح الأخطاء عند استخدام "FragmentContainerView".
  • تم تعديل صور "SwipeDismissFrameLayout" المتحركة لتتوافق مع نظام التشغيل Wear OS وعمليات التنفيذ في Wear Compose.
  • إصلاح خطأ في SwipeDismissFrameLayout لتجنُّب إغلاق الأجزاء غير المقصودة من خلال الانتقال الرأسي
  • تتيح الدالة ArcLayout الآن استخدام ترجيحات التوسيع التي تعمل بطريقة مشابهة لأوزان التصميم العادية.
  • دعم layoutDirection على ArcLayout

الإصدار 1.3.0-rc01

‫21 حزيران (يونيو) 2023

تم طرح androidx.wear:wear:1.3.0-rc01 بدون أي تغييرات منذ 1.3.0-beta01. يحتوي الإصدار 1.3.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.3.0-beta01

7 حزيران (يونيو) 2023

تم طرح androidx.wear:wear:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تم تعديل AmbientLifecycleObserver بعد إضافة الملاحظات. تمت إعادة تسمية AmbientLifecycleObserverInterface إلى AmbientLifecycleObserver، ويمكن الحصول على مثيل من خلال الاتصال بـ AmbientLifecycleObserver(...). تم نقل isAmbient ليكون حقلاً بدلاً من طريقة. (I84b4f)

إصلاح الأخطاء

  • إضافة عمليات تحقُّق فارغة للتعامل مع الحالات التي تكون فيها طريقة العرض الرئيسية فارغة مع إعادة ضبط الإصدار الأولي والترجمة في SwipeToDismiss. (Ib0ec7)

الإصدار 1.3.0-alpha05

19 نيسان (أبريل) 2023

تم طرح androidx.wear:wear:1.3.0-alpha05. يحتوي الإصدار 1.3.0-alpha05 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • عليك نقل بيانات "AmbientModeSupport" لاستخدام "LifecycleObserver". يمكنك إيقاف AmbientModeSupport نهائيًا لصالح الفئات الجديدة الواعية لمراحل النشاط. (I1593b)

إصلاح الأخطاء

  • يجب تعديل أسلوب مسح الخلفية في SwipeDismissTransitionHelper لاستخدام العناصر القابلة للرسم بدلاً من إضافة عرض لإصلاح الأخطاء أثناء استخدام "FragmentContainerView". (I851cd)

الإصدار 1.3.0-alpha04

25 كانون الثاني (يناير) 2023

تم طرح androidx.wear:wear:1.3.0-alpha04. يحتوي الإصدار 1.3.0-alpha04 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تم تعديل الصورة المتحركة في SwipeDismissFrameLayout لتتوافق مع نظام Wear الأساسي وعمليات تنفيذ Wear Compose. (I7261b)

الإصدار 1.3.0-alpha03

24 آب (أغسطس) 2022

تم طرح androidx.wear:wear:1.3.0-alpha03. يحتوي الإصدار 1.3.0-alpha03 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تتيح الدالة ArcLayout الآن استخدام ترجيحات التوسيع التي تعمل بطريقة مشابهة لأوزان التصميم العادية. وهذا يعني أنه يمكنك تحديد الحجم النسبي للعناصر الفرعية بدون الحاجة إلى حساب زواياها مباشرةً. ولقد أضفنا أيضًا أفضل جهد MaxAngleDegrees تتم الالتزام به عند توسيع العناصر الثانوية باستخدام معاملات الترجيح. مثلاً: يمكنك تثبيت القوس مع العديد من العناصر الثانوية التي تصل وزنها إلى 90 درجة، وهذا سيحترم أيضًا المساحة التي تشغلها أي عناصر غير موسعة.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا ترجيحًا إلى ArcLayout.LayoutParams، ما يسمح بتوسيع الأداة لملء المساحة المتاحة. إذا كان هناك أكثر من تطبيق مصغّر، تكون حصته من المساحة المتاحة متناسبة مع حجمه. علاوة على ذلك، أضفنا ArcLayout.setMaxAngleDegrees، ومن ثم يمكنك على سبيل المثال تقييد التوسيع عند 90 درجة (ملاحظة: لا يؤثر ذلك في تنسيق أي تطبيقات مصغّرة ثابتة الحجم). وأخيرًا، أصبح لدى ArcLayout.Widget الآن setSweepAngleDegrees الذي يسمح لـ ArcLayout بإعلام الأداة بحجمها غير الصفري. (I75f24)
  • تم تعديل إمكانية قبول القيم الفارغة لـ setColorFilter(I99ddf، b/236498063)

الإصدار 1.3.0-alpha02

23 شباط (فبراير) 2022

تم طرح androidx.wear:wear:1.3.0-alpha02. يحتوي الإصدار 1.3.0-alpha02 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تقديم الدعم لـ "layoutDirection" على "ArcLayout" (I14d49)
  • رسالة وصف محتوى محسّنة لـ ControlOverlay (I0fdf8)
  • عدِّل ConfirmationOverlay باستخدام رموز أو تنسيق جديد. (If5b54)

إصلاح الأخطاء

  • تمت إضافة قواعد ProGuard لضمان الاحتفاظ بالرموز البرمجية المتعلّقة بالمحتوى المحيط (Idaa10)
  • تجنُّب إغلاق الأجزاء عن طريق الخطأ في التمرير السريع تخطى الإطار من خلال الانتقال الرأسي (Idb6d8)
  • إصلاح EnableconfirmationOverlay في حال عدم توفّر رسالة (I63e6f)

مساهمة خارجية

  • Dae Gyu LEE (Samsung) - تجنّب إغلاق الأجزاء بشكل عرضي في تمرير التمرير السريع في إطار تخطيط التمرير الرأسي (Idb6d8)

الإصدار 1.3.0-alpha01

29 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • يؤدي ConfirmationOverlay الآن إلى دفع الرمز إلى الأعلى لملاءمة حجم الشاشة. رسائل أطول بدون أن تدخل الرسالة حافة الجهاز (أو خارج الشاشة). (I54bff)

الوضع الحالي لارتداء الجهاز الإصدار 1.1.0 من التفاعلات

الإصدار 1.1.0-beta01

24 يوليو 2024

تم طرح androidx.wear:wear-remote-interactions:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه. يشير الإصدار 1.3.0-beta01 من تفاعلات Wear عن بُعد إلى أنّ هذه الميزات من المكتبة قد اكتملت وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء إذا تم وضع علامة عليها بأنّها تجريبية).

الإصدار 1.1.0-alpha04

10 يناير 2024

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha04. يحتوي الإصدار 1.1.0-alpha04 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا ميزة RemoteAuthClient.isRemoteAuthAvailable التي تتحقّق مما إذا كانت المصادقة عن بُعد متاحة. (Ibc10c)

الإصدار 1.1.0-alpha02

10 يناير 2024

تم طرح androidx.wear:wear-remote-interactions:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا خدمة RemoteActivityHelper.isRemoteActivityHelperAvailable التي تساعد في التحقّق مما إذا كانت وظيفة بدء نشاط عن بُعد متاحة. (I107a9)
  • عدّلنا الدالة الإنشائية RemoteActivityHelper لتصبح مَعلمة اختيارية متوافقة في Java. (I75554)

الإصدار 1.1.0-alpha01

‫21 حزيران (يونيو) 2023

تم طرح androidx.wear:wear-remote-interactions:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

إصلاح الأخطاء

  • تم تحسين كيفية إكمال المهام ومعالجة الأخطاء في "RemoteActivityHelper". (I60d60)

مساهمة خارجية

  • يمكنك إزالة تبعية Java من wear-remote-interactions واستخدام بدائل أصغر.

الإصدار 1.1.0-alpha03 من Wear-الهاتف

9 آذار (مارس) 2022

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تعرض الدالة redirectUrl من OAuthRequest الآن سلسلة فارغة إذا لم يتم ضبط عنوان URL لإعادة التوجيه في عنوان URL للطلب المحدَّد. (I44242)

الإصدار 1.1.0-alpha02 من Wear-الهاتف

15 كانون الأول (ديسمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات التنفيذ هذه.

إصلاح الأخطاء

  • إصلاح الأخطاء في مستندات RemoteAuthClient، بما في ذلك الخطأ في مقتطف نموذج الرمز والرابط المعطَّل إلى ErrorCode (I260e8)

الإصدار 1.1.0-alpha01 من Wear-الهاتف

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة الخاصية redirectUrl إلى OAuthRequest. (I98840، Ie684d)

الوضع الحالي لارتداء الجهاز الإصدار 1.0.0 من التفاعلات

الإصدار 1.0.1 من "تفاعلات Wear-الهاتف"

15 كانون الأول (ديسمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.1. يحتوي الإصدار 1.0.1 على عمليات الالتزام هذه.

إصلاح الأخطاء

  • تم طرح استثناء تم إصلاحه من BridgingManager عند محاولة إيقاف إشعارات الربط بدون excludedTags.

Wear-الهاتف-تفاعلات Wear-التفاعلات عن بُعد-الإصدار 1.0.0

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0 وandroidx.wear:wear-remote-interactions:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الالتزام هذه.

الميزات الرئيسية للإصدار 1.0.0

تحتوي مكتبة التفاعل عبر الهاتف على واجهات برمجة تطبيقات للتفاعلات من الأجهزة القابلة للارتداء إلى الهواتف. ويشتمل على ما يلي:

  • PhoneDeviceType: تتوفّر طرق مساعدة لتحديد نوع الهاتف الذي يتم إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط.
  • واجهات برمجة التطبيقات BridgingManager وBridgingManagerService وBridgingConfig لتفعيل الإشعارات أو إيقافها في وقت التشغيل، وضبط علامات اختياريًا للإشعارات المعفاة من وضع الربط.
  • RemoteAuthClient، يوفِّر إمكانية المصادقة عن بُعد على الأجهزة القابلة للارتداء مع إتاحة إدراج إضافة OAuth PKCE. ويتم توفير معالجات إضافية وفئات مساعد للاتصال.

تحتوي مكتبة التفاعل عن بُعد على واجهات برمجة تطبيقات للتفاعلات بين الأجهزة القابلة للارتداء والهواتف. ويشتمل على ما يلي:

  • WatchFaceConfigIntentHelper، توفّر وظائف مساعدة لتحديد رقم التعريف واسم المكوِّن في أنشطة إعداد خلفية شاشة الساعة للجهاز المصاحب على الهاتف.
  • فئة RemoteActivityHelper التي يمكن استخدامها لفتح الأهداف على الأجهزة الأخرى (أي من الساعة إلى الهاتف)

Wear-الهاتف-تفاعلات Wear-التفاعلات عن بُعد 1.0.0-rc01

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-rc01 وandroidx.wear:wear-remote-interactions:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • إصلاح الخطأ الذي يمنع نشر الأخطاء التي تظهر ضمن "خدمات Google Play" للمتصل عند استخدام RemoteActivityHelper (I60d60)
  • إصلاح الخطأ الذي لا يمكن أن يفي به RemoteActivityHelper مطلقًا في حال عدم وجود عُقد مرتبطة، أو في حال لم يتم العثور على نقطة الاتصال المطلوبة (I60d60)

الإصدار 1.1 من نظام التشغيل Wear OS

الإصدار 1.1.0-alpha01

23 آب (أغسطس) 2023

تم طرح androidx.wear:wear-ongoing:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • إضافة حقل وصف المحتوى إلى "النشاط الجاري". ستستخدم خدمات تسهيل الاستخدام ذلك لوصف النشاط الجاري. (I79fc6)

إصلاح الأخطاء

  • تمت إضافة @RequiresPermission إلى واجهات برمجة التطبيقات التي تتطلّب منح إذن POST_NOTIFICATIONS في الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. (Ie542e، b/238790278)

الإصدار 1.0.0 من نظام التشغيل Wear OS

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الالتزام هذه.

الميزات الرئيسية للإصدار 1.0.0

  • واجهة برمجة تطبيقات Wear On Streaming API هي واجهة برمجة تطبيقات لمطوّري البرامج، بما في ذلك المطوّرون التابعون لجهات خارجية، ويتم استخدامها لتصنيف نشاطهم على أنّه "نشاط مستمر" وتقديم المعلومات المطلوبة.
  • تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن أن تتم في خلفية الساعة (مثل التمارين والمكالمات والوسائط). على نظام التشغيل Wear 3، سيصبح النشاط المُعلَن عنه مستمرًا بشكل أكثر بروزًا من خلال رمز مركَّب مخصّص على خلفية شاشة الساعة وعرض مختلف في مشغّل التطبيقات.
  • لمزيد من المعلومات، يمكنك الاطّلاع على دليل النشاط الجاري على ارتداء الجهاز

Wear-هاتف-تفاعلات Wear-تفاعلات عن بُعد-الإصدار 1.0.0-beta01

18 آب (أغسطس) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-beta01 وandroidx.wear:wear-remote-interactions:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة تسمية الصف RemoteIntentHelper إلى RemoteActivityHelper. تمت إعادة تسمية الدالتَين RemoteIntentHelper#getRemoteIntentExtraIntent وRemoteIntentHelper#getRemoteIntentNodeId إلى RemoteActivityHelper#getTargetIntent وRemoteActivityHelper#getTargetNodeId على التوالي. (Id2042)

الإصدار 1.0.0-rc01 من Wear غير متصل

18 آب (أغسطس) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-rc01 بدون أي تغييرات منذ 1.0.0-beta01. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

الإصدار الحالي من Wear OS 1.0.0-beta01

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • يقبل بعض القائمين على On runningActivity.Builder الآن خالية من أجل منح التماثل والاتساق setters وgetters (I17ee5)

الإصدار 1.0.0-alpha07 من Wear-Phone

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة تسمية "WearTypeHelper.isChinaDevice" إلى "WearTypeHelper.isChinaBuild". (I47302)
  • لقد عدّلنا مكتبة RemoteAuthClient لاختيار "redirect_uri" تلقائيًا استنادًا إلى نوع الجهاز (RoW/الصين). (I38866)
  • تم إصلاح خطأ تسبّب في تعذُّر تحويل BridgingConfig إلى/من Bundle في ClassCastException. تمت إضافة اختبارات الوحدة لفئة BridgingManagerService. (I68ecb)

الإصدار 1.0.0-alpha06 من Wear-عن بُعد

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

الإصدار 1.0.0-alpha06 من Wear-Phone

21 يوليو 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • أصبحت الفئة BridgingManagerSeviceBinder الآن فئة فرعية من الخدمة وتمت إعادة تسميتها إلى BridgingManagerSevice. (I9fca2)
  • تم تغيير طريقة RemoteAuthClient.Callback.onAuthorizationError لتضمين معلمة OAuthRequest. تتطلب الطرق التي تتطلب معاودة الاتصال الآن أيضًا تنفيذًا لتنفيذ معاودة الاتصال. (I35e11)

إصلاح الأخطاء

  • لقد جعلنا واجهة برمجة تطبيقات المصادقة أكثر وضوحًا من خلال المزيد من المعلمات الموثقة وباستخدام الخصائص حيثما أمكن. (I12287)

الإصدار 1.0.0-alpha05 من Wear-Phone

30 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • المعلَمات الموثّقة التي يجب تمريرها في الدالة الإنشائية لـ BridgingConfig.Builder

الإصدار 1.0.0-alpha06 مستمرًا في نظام Wear OS

2 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • إضافة حقل العنوان إلى النشاط الجاري. (I7a405)

إصلاح الأخطاء

  • ينشئ SerializationHelper.copy() الآن نسخة دفاعية من المعلومات (I8b276)
  • وثائق setCategory المحسّنة (Iff01f)

الإصدار 1.0.0-alpha05 مستمرًا في نظام Wear OS

18 أيار (مايو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تتوفّر في "OngoingActivity" الآن رموز Gets لاسترداد كل القيم التي تم ضبطها مباشرةً من خلال "أداة إنشاء" (أو الإعدادات التلقائية المأخوذة من الإشعار المرتبط). (Id8ac8)

    • تُستخدَم الفئة الجديدة Status الآن لإنشاء حالة السمة OngoingActivity.
    • لم تعُد الواجهة OngoingActivityData وOngoingActivityStatus جزءًا من واجهة برمجة التطبيقات العامة.
  • لم تعُد الصفتان TextStatusPart وTimerStatusPart جزءًا من واجهة برمجة التطبيقات العامة. (I57fb6)

    • لإنشاء Part بنص ثابت، استخدِم Status.TextPart.
    • لإنشاء Part باستخدام ساعة إيقاف (العدّ العكسي)، استخدِم Status.Stopwatch.
    • لإنشاء Part باستخدام موقّت (العد التنازلي)، استخدِم Status.Timer.

الإصدار 1.0.0-alpha04 مستمرًا في نظام Wear OS

5 أيار (مايو) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • في OnthroughActivity، يطلق على الطرق الحالية fromExistingOnforwardActivity الآن اسم استردادOnDownActivity.
  • يحتوي OnGogoActivity الآن على مجموعة كاملة من Gets، وهي اللعبة نفسها التي كانت متوفّرة سابقًا فقط على OngressActivityData. (I0ee4d)

الإصدار 1.0.0-alpha05 من Wear-عن بُعد

21 يوليو 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا الفئة RemoteIntentHelper (المعروفة سابقًا باسم RemoteIntent في "مكتبة الدعم للأجهزة القابلة للارتداء") التي يمكن استخدامها لإتاحة الأهداف على الأجهزة الأخرى (أي من الساعة إلى الهاتف). (I1d7e0)

  • تمت إزالة فئة PlayStoreAvailability من مكتبة AndroidX. لرصد ما إذا كان "متجر Play" متاحًا على هاتف متّصل، يمكنك استخدام طريقة androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType لتحديد ما إذا كان الهاتف المتصل هو هاتف Android. بعد ذلك، استخدِم الطريقة androidx.wear.utils.WearTypeHelper.isChinaDevice لتحديد ما إذا كان الهاتف المتصل جهازًا صينيًا. إذا كان الهاتف يعمل بنظام التشغيل Android ولم يكن جهازًا صينيًا، سيكون "متجر Play" متاحًا. (Ie7dec)

الإصدار 1.0.0-alpha04 من Wear-Phone

7 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-phone-interactions:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تم تعديل ثوابت ErrorCode لجعل المكتبة الجديدة متوافقة مع الإصدارات القديمة مع التنفيذ في مكتبة الدعم القابل للارتداء.

إصلاح الأخطاء

  • تم إصلاح الاستثناء الناتج عن واجهة برمجة تطبيقات OAuth الجديدة عند بدء جلسة OAuth.

الإصدار 1.0.0-alpha03 من Wear-عن بُعد

7 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تم تغيير PlayStoreAvailability لتكون فئة تحتوي على كائن مصاحب بطرق ثابتة. ولن تتغيّر طريقة الاستخدام.

إصلاح الأخطاء

  • تم إصلاح مستند ملخّص لـ WatchFaceConfigIntentHelper لعرض نموذج الرمز البرمجي بشكل صحيح مع أحرف HTML الفعلية.

إصدار Wear المستمر على هواتف Wear OS 1.0.0-alpha03

10 آذار (مارس) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha03 وandroidx.wear:wear-phone-interactions:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه عمليات التنفيذ.

الميزات الجديدة

  • نقل OAuthClient من مكتبة الدعم القابل للارتداء إلى AndroidX. تمت إعادة تسمية هذه الفئة التي تم نقلها إلى RemoteAuthClient، وهي توفّر إمكانية المصادقة عن بُعد على الأجهزة القابلة للارتداء بالإضافة إلى إمكانية إدراج إضافة OAuth PKCE. ويتم توفير معالجات إضافية وفئات مساعد للاتصال.
  • يمكن الآن ربط الأنشطة الجارية بإشعار يحتوي على علامة، وذلك باستخدام الدالة الإنشائية الجديدة OnGettingActivity.Builder.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة إمكانية استخدام علامات الإشعارات في الأنشطة الجارية. Library (I653b4)
  • نقل بيانات OAuthClient من مكتبة دعم Wear إلى AndroidX وإتاحة إضافة OAuth PKCE (I3eaaa)

الإصدار 1.0.0-alpha02 من Wear-عن بُعد

10 آذار (مارس) 2021

تم طرح androidx.wear:wear-remote-interactions:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.

الميزات الجديدة

  • نقل فئة PlayStoreAvailability من مكتبة الدعم القابل للارتداء إلى AndroidX التي توفّر واجهة برمجة تطبيقات للتحقّق مما إذا كان "متجر Play" متاحًا على الهاتف

إصلاح الأخطاء

  • جارٍ نقل الصف الدراسي على PlayStoreAvailability من مكتبة الدعم القابل للارتداء إلى AndroidX. (I69bfe)

الإصدار 1.0.0-alpha02

10 شباط (فبراير) 2021

تم طرح androidx.wear:wear-ongoing:1.0.0-alpha02 وandroidx.wear:wear-phone-interactions:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة دعم للحالات الأكثر تعقيدًا. وهي تتألف من قالب محدد (أو أكثر) وسلسلة من الأجزاء التي سيتم استخدامها لملء والعناصر النائبة للقالب. يحتوي OnlaunchActivityStatus الآن على طريقة ثابتة لإنشاء حالات بسيطة باستخدام جزء واحد فقط (نص أو مؤقت)، وأداة إنشاء لإنشاء حالات أكثر تعقيدًا. (I1fe81)
  • يمكنك نقل فئتَي BridgingManager وBidgingConfig من Wear Support Library إلى AndroidX الذي يوفّر واجهات برمجة تطبيقات تتيح تفعيل الإشعارات أو إيقافها في وقت التشغيل وضبط علامات اختياريًا للإشعارات المستثناة من وضع "الجسر". (I3a17e)

الإصدار 1.0.0-alpha01

27 كانون الثاني (يناير) 2021

تم طرح الإصدارات androidx.wear:wear-ongoing:1.0.0-alpha01 وandroidx.wear:wear-phone-interactions:1.0.0-alpha01 وandroidx.wear:wear-remote-interactions:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: الأنشطة القابلة للارتداء تتوفّر الصفوف الآن في حزمة androidx.wear.oncomplete (وكانت سابقًا androidx.wear.onlaunchactivities) (I7c029).

  • أنشئ مكتبة دعم جديدة لتتضمّن الصفوف التي تدعم التفاعلات من الأجهزة القابلة للارتداء إلى الهواتف. وتتم تعبئته في البداية بالفئات التي تم نقلها من "مكتبة الدعم للأجهزة القابلة للارتداء". (Id5180)

  • نقل فئة PhoneDeviceType من مكتبة الدعم القابل للارتداء إلى AndroidX. تمت إعادة تسمية الفئة التي تم نقلها باسم PhoneTypeHelper الذي يوفّر طرقًا مساعدة لتحديد نوع الهاتف الذي يتم إقران الساعة الحالية به، وذلك للاستخدام على الأجهزة القابلة للارتداء فقط. (Ibd947)

  • أنشئ مكتبة دعم جديدة لتتضمّن الصفوف التي تدعم التفاعلات بين الأجهزة القابلة للارتداء والهواتف. وتتم تعبئته في البداية بالفئات التي تم نقلها من "مكتبة الدعم للأجهزة القابلة للارتداء". (I9deb4)

  • نقل فئة WatchFaceCompanion من مكتبة الدعم القابل للارتداء إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها باسم WatchFaceConfigIntentHelper، وهي توفّر وظائف مساعد لتحديد رقم التعريف واسم المكوِّن في أنشطة إعداد خلفية شاشة الساعة في التطبيق المصاحب على الهاتف. ويمكن استخدام هذه الفئة أيضًا على الجهاز لإعداد خلفية شاشة الساعة على الجهاز القابل للارتداء. (Ia455f)

إضافات Wear وخلفية شاشة الساعة 1.0.0

الإصدار 1.0.0-alpha22

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha22. يحتوي الإصدار 1.0.0-alpha22 على عمليات التنفيذ هذه.

الميزات الجديدة

  • تشترك جلسة EditorSession الآن في مراقبي مراحل النشاط لكي لا تضطر إلى إغلاقها بشكل صريح عند انتهاء نشاطك.

التغييرات في واجهة برمجة التطبيقات

  • يستخدم كل من EditorSession و ListenableEditorSession الآن kotlin StateFlows لـ complicateSlotsState وComplicationsPreviewData وComplicationsDataSourceInfo. (I761d9)
  • أصبحت EditorSession#userStyle الآن MutableStateFlow<UserStyle> (I32ca9).
  • يستخدم EditorSession.createOnWatchEditorSession الآن أداة مراقبة مراحل النشاط ويتم إغلاقه تلقائيًا عند رصد onDestroy. بالإضافة إلى ذلك، لا تتطلب ميزة "createOnWatchEditorSession" الآن سوى تمرير النشاط. تم أيضًا تطبيق التغييرات المتطابقة على ListenableEditorSession. (Ic6b7f)
  • تمت استعادة الدالة الإنشائية لـ CustomValueUserStylesetting كجزء من واجهة برمجة التطبيقات العامة. (I2e69a)
  • يكتسِب UserStyle الآن من Map<UserStyleSetting, UserStyleSetting.Option>، ويعرض الحقل MutableUserStyleSetting#put orgumentException إذا لم يكن الإعداد مدرجًا في المخطط أو إذا لم يتطابق هذا الخيار مع الإعداد. (Iba40f)

الإصدار 1.0.0-alpha21

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha21. يحتوي الإصدار 1.0.0-alpha21 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • أصبحت جميع واجهات برمجة التطبيقات العامة لخلفية شاشة الساعة والعميل والمحرر والإضافة تستخدم الآن java.time.عميل فوري بدلاً من طويل، ونتيجةً لذلك ارتفع الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 26. (I3cd48)
  • تستخدم الآن واجهات برمجة التطبيقات لخلفية شاشة الساعة وواجهات برمجة التطبيقات الإضافية تنسيق ZonedDateTime غير القابل للتغيير بدلاً من "تقويم Google". (I25cf8)
  • يتم الآن إعداد ComplicationSlots باستخدام NoDataComplicationData، وأصبح لدى ComplicationSlot.compliificationData دائمًا قيمة ولم يعد CanvasComplicationDrawable.comComplicData قيمة فارغة. (I4dfd6) يحدّ ذلك (ولكن لا يحدّ) من التعقيدات التي قد تحدث عند التبديل بين خلفيات شاشة الساعة.

الإصدار 1.0.0-alpha20

18 آب (أغسطس) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha20. يحتوي الإصدار 1.0.0-alpha20 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا createFallbackPreviewData إلى ComplicationDataSourceInfo ويمكن استخدامها عند عرض ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData بقيمة فارغة. (I38c4d)
  • تم تحويل ComplicationDataSourceUpdateRequester إلى واجهة للسماح بالمحاكاة في اختبارات الوحدة. يمكنك إنشاء ComplicationDataSourceUpdateRequester ملموسة باستخدام ComplicationDataSourceUpdateRequester.create(). (I7da22)
  • تم استبدال RenderPARAMs.pressComplicationSlotIds بـ Render ليس هادًا بالبكسل، والذي يعرض فئة TapEvent الجديدة التي تحتوي على إحداثيات ثلاثة من x وy للنقر بالبكسل والطابع الزمني. تم استبدال WatchFace.TapListener.onTap بـ onTapEvent(@TapType tapType: Int, tapEvent: TapEvent). بالإضافة إلى ذلك، تمت إزالة InteractiveWatchFaceClient.displayPressedAnimation. (Id87d2)
  • تمت إضافة تعليق توضيحي لسلاسل محادثات صريحة لـ setimportantForAccessibility (I990fa).
  • تم نقل ComplicationSlotBoundsType إلى androidx-wear-watchface.ComplicationSlotBoundsType in wear/wear-watchface. (I09420)
  • لقد أضفنا دعمًا لتمرير أرقام تعريف موارد السلاسل إلى UserStylesetting وOptions. وهذه هي الطريقة الموصى بها لإنشاء تلك الكائنات. (I03d5f)
  • تم فرض الحدود على الحد الأقصى لحجم الأسلاك في مخطط UserStyle. كما يجب ألا تكون الرموز في المخطط أكبر من 400x400 بكسل. (I3b65b)
  • أضفنا فئة MutableUserStyle لإتاحة التغييرات في مثيلات UserStyle (I95a40).
  • لقد أعدنا تسمية "ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient" إلى "ListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient". (I64ce2)
  • لقد عدّلنا EditorState.previewComplicationsData ليتضمن فقط بيانات الإضافات المفعّلة، وأضفنا EditorSession.DEFAULT_PREVIEW_TIME_MILLIS، في حال ضبطها على renderWatchFaceToBitmap، أو طلب PreviewScreenshotParams العرض باستخدام الوقت التلقائي للمعاينة في خلفية شاشة الساعة. (If7b3c)
  • أزلنا دوال إنشاء UserStyleSet التي تأخذ CharSequence من واجهة برمجة التطبيقات العامة. ويُنصَح باستخدام الدوال الإنشائية التي تتطلّب معرّفات StringResource بدلاً من ذلك. (I8537b)
  • ميزة "CurrentUserStyleRepository.UserStyleChangeListener" تتيح الآن التحويل إلى رسائل SAM. (I85989)

الإصدار 1.0.0-alpha19

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha19. يحتوي الإصدار 1.0.0-alpha19 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا السمة ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient التي توفّر برنامج تضمين ListenableFuture لـ WatchFaceMetadataClient.createWatchFaceMetadataClient. (I5fa37)
  • يقبل UserStyleOption.getOptionForId الآن UserStyleOption.Id بدلاً من مصفوفة بايت. (I469be)
  • تقديم القيم الثابتة BooleanOption.TRUE وBooleanOption.FALSE ومنع إنشاء المثيلات (I46e09)
  • وقد تمت الآن إضافة تعليقات توضيحية إلى الطرق المستخدمة في wear-watchface-client التي يمكنها طرح RemoteException. (Ib8438)
  • ولتحقيق الاتساق، أعدنا تسمية "EditorSession.createOnWatchEditingSession" إلى "createOnWatchEditorSession"، وأصبحت أيضًا "createHeadlessEditingSession" الآن createHeadlessEditorSession. كما تمت إعادة تسمية برامج تضمين الجوافة الخاصة بهم. (I1526b)
  • أصبحت EditorSession واجهة الآن وتم تفويض ListenableEditorSession.commitChangesOnClose بشكل صحيح. (I7dc3e)
  • نرفض الآن أي مخطط لنمط المستخدم يتضمن إعدادات أو خيارات بأرقام تعريف متعارضة (Ic2715).
  • لقد أضفنا UserStyle.get التي تم تحميلها بشكل زائد وتقبل UserStyleSetting.Id. (I2aa0f)

الإصدار 1.0.0-alpha18

21 يوليو 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha18. يحتوي الإصدار 1.0.0-alpha18 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تم نقل ComplicationHelperActivity إلى مكتبة androidx.wear:wear-watchface. (I39e76)
  • للحفاظ على الاتساق والوضوح، تمت إعادة تسمية "ComplicationProvider" إلى "ComplicationDataSource" وتم أيضًا إعادة تسمية جميع الصفوف التي تحمل اسم "مقدِّم الخدمة" باسمها. (Iaef0b)
  • تم نقل CanvasComplication.isHighlighted إلى RenderParameters.pressedComplicationSlotIds، وهذه خطوة نحو جعل CanvasComplication بدون حالة. لتطبيق هذا التغيير، يستخدم CanvasComplication.render أيضًا slotId كمَعلمة، ونمرر الآن ComplicationSlot إلى GlesTextureComplication. (I50e6e)
  • لقد أضفنا headlessDeviceConfig إلى EditorRequest، وإذا لم تكن فارغة، يتم استخدام هذه المعلمة لإنشاء مثيل بلا واجهة مستخدم رسومية للعودة إلى EditorSession بدلاً من العمل على المثيل التفاعلي. ويتيح ذلك استدعاء المحرّر لخلفية شاشة ساعة ليست الحالية. (I0a820)
  • لقد أضفنا WatchFaceMetadataClient تجريبي يتيح استرداد البيانات الوصفية الثابتة لخلفية شاشة الساعة بشكل فعّال، مثل UserStyleSchema والتفاصيل الثابتة حول ComplicationSlots. (I6bfdf)
  • لقد أعدنا تسمية CanvasRenderer.uiThreadInit لبدء الإعداد. (I6fff9)
  • لقد أضفنا مَعلمة PreviewCAPTCHAParams جديدة اختيارية لـ EditorRequest، وهي توجِّه إرشاد EditorSession لأخذ لقطة شاشة للمعاينة عند الالتزام بهذه المعلمة. يتم عرض صورة المعاينة في EditorState.previewImage. (Ic2c16)

إصلاح الأخطاء

  • لم يعُد المطوّرون بحاجة إلى إضافة ComplicationHelperActivity إلى ملف البيان الخاص بهم. (I6f0c2)

الإصدار 1.0.0-alpha17

30 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha17. يحتوي الإصدار 1.0.0-alpha17 على هذه عمليات التنفيذ.

الميزات الجديدة

  • في GlesRenderer، تم استبدال makeUiThreadContextCurrent وmakeBackgroundThreadContextCurrent بـ runUiThreadGlCommands وrunBackgroundThreadGlCommands، وكلاهما يقبلان Runnable. تضمن المكتبة تنفيذ أمر GL واحد فقط قابل للتشغيل في أي وقت محدد.

  • لتسهيل إعداد UiThread، أضفنا CanvasRenderer.uiThreadInit، والذي يتم استدعاؤه مرّة واحدة في UiThread قبل عرض أي طلبات. لقد أضفنا أيضًا onRendererCreated إلى CanvasComplication، ما يسهّل على Renderer وCanvasComplication مشاركة الحالة.

  • للتوضيح، تمت إعادة تسمية Complication إلى ComplicationSlot وcomplicationId إلى complicationSlotId أو complicationInstanceId بناءً على الاستخدام.

التغييرات في واجهة برمجة التطبيقات

  • وللتوضيح، تمت إعادة تسمية Complication إلى ComplicationSlot وcomplicationId إلى complicationSlotId أو complicationInstanceId بناءً على الاستخدام. وبالمثل، تمت إعادة تسمية الصفوف التي تستخدم الإضافة، على سبيل المثال: يُطلق الآن على ComplicationManager اسم ComplicationSlotsManager. (I4da44)
  • تم استبدال العنصرَين makeUiThreadContextCurrent وmakeBackgroundThreadContextCurrent في GlesRenderer بالعنوانين runUiThreadGlCommands وrunBackgroundThreadGlCommands اللذين يقبلان Runnable. هذه الدوال مطلوبة فقط إذا كنت بحاجة إلى إجراء استدعاءات GL خارج العرض، runBackgroundThreadGlCommands وonUiThreadGlSurfaceCreated. هذا الإجراء مطلوب لأنّه قد يتم عرض سلسلة GlesRenderers متعددة لكل منها سياقها الخاص في العملية نفسها، ومن المحتمل أن تكون تلك العروض من خلفيات مختلفة لشاشة الساعة. بالإضافة إلى ذلك، تتم مزامنة الوصول إلى سياق GL الحالي المشترك. (I04d59)
  • لقد أضفنا السمة CanvasRenderer.uiThreadInit التي يتم استدعاؤها مرة واحدة في UiThread قبل أن يتم عرض أي طلبات استدعاء. ولمزيد من التوضيح أيضًا في GlesRenderer، أعدنا تسمية onGlContextCreated إلى onBackgroundThreadGlContextCreated، وonGlSurfaceCreated إلى onUiThreadGlSurfaceCreated. (If86d0)
  • HeadlessWatchFaceClient و تمت إعادة تسمية InteractiveWatchFaceClient getComplicationsSlotState إلى getComplicationSlotsState. في ComplicationSlot: تمت إعادة تسمية createRoundRectComplicationBuilder وcreateBackgroundComplicationBuilder وcreateEdgeComplicationBuilder إلى createRoundRectComplicationSlotBuilder وcreateBackgroundComplicationSlotBuilder وcreateEdgeComplicationSlotBuilder على التوالي. (Ib9adc)
  • لقد أضفنا onRendererCreated إلى CanvasComplication، ما يسهّل على كل من Renderer وCanvasComplication مشاركة الحالة. (I5e1ac)

الإصدار 1.0.0-alpha16

16 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha16. يحتوي الإصدار 1.0.0-alpha16 على هذه عمليات التنفيذ.

الميزات الجديدة

  • أصلحنا عددًا من الأخطاء المتعلّقة بالتغييرات الأخيرة في نموذج سلاسل المحادثات بالإضافة إلى معالجة مشاكل أخرى في أداة تعديل خلفية شاشة الساعة.

إصلاح الأخطاء

  • منع NPE في onComplicationProviderChooserResult (b/189594557)
  • إصلاح المشاكل المتعلقة بالأسطح القديمة و drawBlack (b/189452267)
  • إصلاح السباق في الوصول إلى complicationsManager.watchState (b/189457893)
  • إصلاح الخطأ منذ إنشاء سلسلة المحادثات في الخلفية (b/189445428)
  • حلّ المشاكل المتعلّقة بأداة تعديل خلفية شاشة الساعة قبل إطلاقها (b/189126313)
  • عدم تعديل مَعلمات التمهيد المباشر لتغييرات نمط المحرِّر (b/187177307)

الإصدار 1.0.0-alpha15

2 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha15. يحتوي الإصدار 1.0.0-alpha15 على هذه عمليات التنفيذ.

الميزات الجديدة

تتم الآن معظم عمليات إعداد خلفية شاشة الساعة من خلال سلسلة محادثات في الخلفية، ولكن بعد تحميل كل عروض خلفية شاشة الساعة وغيرها، يتم تنفيذ ذلك من خلال شبكة UiThread. وهناك حاجز للذاكرة بين التحميل والعرض، لذلك لا يحتاج معظم خلفيات شاشة الساعة إلى اتخاذ أي إجراء. قد تكون خلفيات شاشة الساعة التي تستخدم تقنية GLES استثناءً لأنّ السياق مرتبط بسلسلة المحادثات ونحن ننشئ سياقَين مرتبطَين حتى يكون من الممكن تحميل موارد GL (مثل الزخارف وأدوات التظليل) على سلسلة الخلفية واستخدامها على UiThread.

لقد قسّمنا عملية إنشاء خلفيات شاشة الساعة إلى ثلاث دوال هي: createUserStyleSchema وcreateComplicationsManager وcreateWatchFace. نفترض أن createUserStyleSchema و createComplicationsManager سريع، وقد يستغرق createWatchFace بعض الوقت لتحميل الأصول. للاستفادة من هذه الميزة، قدّمنا WatchFaceControlClient.getDefaultProviderPoliciesAndType الذي يعرض خريطة لمعرّفات ComplicationProviderPolicies والنوع التلقائي ComplicationType. وتُعدّ هذه الطريقة أسرع من إنشاء مثيل بلا واجهة مستخدم رسومية لأنّه لا تحتاج إلى إعداد خلفية شاشة الساعة بالكامل لتنفيذ طلب البحث.

وأخيرًا، يتم الآن إنشاء إضافات باستخدام CanvasComplicationFile الذي يسمح بالإنشاء الكسول لبرامج عرض CanvasComplication.

التغييرات في واجهة برمجة التطبيقات

  • تم استبدال "@TargetApi" بـ "@RequiresApi". (I0184a، وb/187447093، وb/187447094)
  • لقد قدمنا WatchFaceControlClient.getDefaultProviderPoliciesAndType التي تعرض خريطة لمعرفات الإضافة إلى defaultComplicationProviderPolicies وComplicationType التلقائي. حيثما أمكن، يتم استخدام مسار سريع يتجنّب إنشاء خلفية شاشة ساعة بشكل كامل. لتسهيل هذا الأمر، اضطرت واجهة برمجة التطبيقات WatchFaceService إلى التغيير باستخدام طريقتين جديدتين وهما: createUserStyleSchema وcreateComplicationsManager، ويتم تمرير نتائجهما إلى createWatchFace. بالإضافة إلى ذلك، تم الآن إنشاء "Complications" (الإضافة) باستخدام CanvasComplication المصنع الذي يتيح الإنشاء الكسول لأجهزة عرض CanvasComplication. (Iad6c1)
  • تمت إزالة most_يت_APP من موفّري النظام. (I3df00)
  • أصبحت منصة ObMonitorableWatchData الآن فئة محدَّدة. (Ic940d)
  • يُطلق الآن على CanvasComplicationFound.create (مرتبطة عادةً بـ io) باسم سلسلة محادثات في الخلفية لكل إضافة قبل بدء عرض سلسلة محادثات واجهة المستخدم. هناك حاجز للذاكرة بين الإنشاء والعرض، وبالتالي لا يلزم استخدام أساسيات تسلسل خاصة. (Ia18f2)
  • يتم الآن إنشاء خلفية شاشة الساعة في سلسلة محادثات في الخلفية، على الرغم من إتمام كل عمليات العرض من خلال سلسلة واجهة المستخدم، يتيح GlesRenderer سياقَين مرتبطَين لدعم ذلك. قد يتم حلّ الخطأ من WatchFaceControlClient.createlessWatchFaceClient وWatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات من واجهة برمجة التطبيقات اللاحقة إلى أن تكتمل عملية إعداد WatchFace. (Id9f41)
  • لم يعد EXPANSION_DP وSTROKE_WIDTH_DP ظاهرتين في ملف api.txt. (I54801)
  • لقد قطعنا EditorSession.createOnWatchEditingSession نمنح مهلة الإلغاء الإذن إذا كان هناك خطأ بدلاً من إرسال جلسة فارغة. بالإضافة إلى ذلك، أصبحت القيمة المعروضة لـ EditorRequest.createFromIntent وEditorSession.createOnWatchEditingSession الآن NonNull. (I41eb4)

الإصدار 1.0.0-alpha14

18 أيار (مايو) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha14. يحتوي الإصدار 1.0.0-alpha14 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تعرض الدالة EditorSession.openComplicationProviderChooser الآن ChosenComplicationProvider الذي يحتوي على معرّف الإضافة ComplicationProviderInfo وحزمة تحتوي على أي إضافات إضافية يعرضها منتقي الموفِّر.
  • بالإضافة إلى ذلك، نحن نعمل باستمرار على نقل الرموز البرمجية إلى Kotlin، وأصبحت غالبية واجهة برمجة تطبيقات خلفية شاشة الساعة متوفّرة في لغة Kotlin.

التغييرات في واجهة برمجة التطبيقات

  • لم تعد سمتا GlesRenderer eglContext وeglDisplay قابلة للقيم الفارغة. يتم الآن الإبلاغ عن أي أخطاء في GL عبر GlesRenderer.GlesException بدلاً من RuntimeExceptions. (Ib1005)
  • لقد نقلنا androidx.wear.watchface.complications.rendering.ComplicationDrawable من Java إلى Kotlin (Ibc3eb).
  • لقد نقلنا androidx.wear.watchface.complications.rendering.ComplicationStyle من Java إلى Kotlin (I3375e).
  • أضفنا معلومات حول موفّر الإضافة لكل إضافة ضمن EditorSession. (I37f14)
  • تم توسيع نتيجة EditorSession.openComplicationProviderChooser لتشمل المعلومات التي يعرضها المستخدم الذي تم اختياره. (Iead6d)

إضافات Wear الإصدار 1.0.0-alpha13 من خلفية شاشة الساعة

5 أيار (مايو) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha13. يحتوي الإصدار 1.0.0-alpha13 على هذه عمليات التنفيذ.

الميزات الجديدة

  • يمكن أن تحتوي خلفيات شاشة الساعة على عناصر مرئية مهمة غير عرض الوقت والإضافات. لإتاحة استخدام قارئ الشاشة في تنفيذ هذا الإجراء، يمكن لخلفية شاشة الساعة الآن تحديد تصنيفات المحتوى في وصف المحتوى لتسهيل الاستخدام من خلال سمة additionalContentDescriptionLabel في العارض. بالإضافة إلى ذلك، للتحكّم في ترتيب ContentDescriptionDescription تمت إضافة accessTraversalIndex إلى الإضافات. ويمكن تعديله من خلال ComplicationsUserStylesetting.

  • ولتشجيع المطوّرين على التفكير بعناية في برامج قراءة الشاشة، جعلنا حقل contentDescription الخاص بـ ShortTextComplicationData.Builder وLongTextComplicationData.Builder وRangedValueComplicationData.Builder إلزاميًا لإدخاله إلى الدوال الإنشائية الخاصة بهم. إذا تم تمرير ComplicationText.EMPTY إلى contentDescription، سيتم إنشاء contentDescription تلقائيًا من النص والعنوان.

  • ستعرض WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن ServiceStartFailureException في حال طرحت خلفية شاشة الساعة استثناءً أثناء الإعداد، ما يسهّل تشخيص المشاكل أثناء بدء تشغيل خلفية شاشة الساعة.

التغييرات في واجهة برمجة التطبيقات

  • لقد أتحنا استخدام اسم مكوِّن فارغ في ComplicationProviderInfo، وهو أمر ضروري لدعم الإصدارات القديمة من نظام التشغيل Wear OS. (I744d2)
  • لقد نقلنا androidx.wear.complications.SystemProviders من Java إلى Kotlin. (Ia1f8b)
  • لقد أخفينا جميع الصفوف من واجهة برمجة التطبيقات العامة المتوفّرة في android.support.wearable.comمضاعفs وإنشاء محتوى مطابق في AndroidX عند الحاجة. (I7bd50)
  • لقد أعدنا تسمية الطريقة في TimeDifferenceComplicationText.Builder من setMinimumUnit إلى setMinimalTimeUnit (I20c64)
  • لقد صنعنا ShortTextComplicationData.Builder، LongTextComplicationData.Builder جهاز contentDescription لـ "RangedValueComplicationData.Builder" إلزاميًا ليتم تمريره في الدالة الإنشائية. (I8cb69)
  • لقد أعدنا تسمية ComplicationProviderService.onComplicationUpdate ليصبح onComplicationRequest و معرّف مغلف والمعلمة type الخاصة بهذه الطريقة في data ComplicationRequest. تمت إعادة تسمية المستمع المقابل إلى ComplicationRequestListener وطريقته ComplicationRequestListener.onComplicationData. (Iaf146)
  • أزلنا الطريقة isActiveAt من ComplicationData الحقل المكشوف validTimeRange بدلاً منه. هذا النمط يمكن استبدال طلب إجراء الطريقة بـ validTimeRange.contains. (I65936)
  • لقد غيّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من int. (Idb5ff)
  • تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
  • أصبحت GlesRender.makeContextCurrent متاحة للجميع الآن. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء استدعاءات gl خارج العرض وonGlContextCreated، لأنّه قد يكون من الضروري توفّر سياق تفاعلي وآخر بلا واجهة مستخدم رسومية. (I8a43c)
  • يطرح WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن ServiceStartFailureException في حال طرح خلفية شاشة الساعة أثناء الإعداد. بالإضافة إلى ذلك، تطرح WatchFaceService الآن استثناء إذا استغرق إنشاء createWatchFace أكثر من 6 ثوانٍ. (I59b2f)
  • لقد أزلنا سمة المعرّف غير المستخدَمة الخاصة بـ GlesTextureComplication. (I28958)
  • يمكن الآن لخلفية شاشة الساعة تحديد ContentDescriptionLabel لتسهيل الاستخدام من خلال السمة additionalContentDescriptionLabel في Renderer. بالإضافة إلى التحكم في ترتيب ContentDescriptionDescription تمت إضافة accessTraversalIndex إلى الإضافات. ويمكن تعديله من خلال ComplicationsUserStylesetting. (Ib7362)
  • توسيع المستندات حول التعامل مع حدث اللمس في خلفية شاشة الساعة (Iaf31e)

إصلاح الأخطاء

  • تعرض الدالة EditorSession.getComplicationsPreviewData() الآن خريطة لكل الإضافات غير الفارغة فقط. يتم استخدام مثيل BlankComplicationData للإضافات الفارغة. (I1ef7e)

إضافات Wear الإصدار 1.0.0-alpha12 من خلفية شاشة الساعة

21 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha12. يحتوي الإصدار 1.0.0-alpha12 على هذه عمليات التنفيذ.

الميزات الجديدة

يحتاج محرِّرو خلفية شاشة الساعة إلى تسليط الضوء على أجزاء من خلفية شاشة الساعة لتحديد الجانب الذي يتم إعداده من الساعة. لقد وسّعنا نطاق مَعلمات Render المناسبة لتسليط الضوء على الأنماط والإضافات. هناك ميزة HelloLayer الاختياري الجديدة التي تم إعدادها لتركيبها أعلى خلفية شاشة الساعة بشفافية ألفا (يمكن أن تقوم واجهات برمجة التطبيقات للقطات الشاشة بإجراء هذا الاقتصاص نيابةً عنك، أو توفير ميزة MarkLayer وحدها للحصول على أقصى قدر من المرونة). مثلاً: لنفترض أن لديك نمطًا يتيح لك تهيئة مظهر عقارب الساعة، فيمكن للعارض في RenderhighlightLayer الخاص به رسم مخطط حولهما.

لتشجيع دعم Complication Provider على تسهيل الاستخدام، قدّمنا ميزات PhotoImageComplicationData.Builder's وMonnochromaticImageComplicationData.Builder's حقل contentDescription في SmallImageComplicationData.Builder يكون وسيطة إنشائية إلزامية. تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لدعم إضافات الحواف (المرسومة حول حافة الشاشة). يتم الاحتفاظ بالعرض واختبار إضافات الحافة على خلفية شاشة الساعة. لا يتيح المحرّر المصاحب اختبار نتائج Edge.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة البادئة PROVIDER_ إلى الثوابت في SystemProviders. (I1e773)
  • لقد صنعنا PhotoImageComplicationData.Builder، MonochromaticImageComplicationData.Builder حقل contentDescription في SmallImageComplicationData.Builder إلزاميًا أن يتم تمريره في الدالة الإنشائية. (I9643a)
  • تمت إعادة تسمية "ProviderInfoRetriever.requestPreviewComplicationData" إلى "retrievePreviewComplicationData". (I911ee)
  • تم نقل بيانات ComplicationProviderService من Java إلى Koltin. (I849f2)
  • أصبحت الطريقة ComplicationProviderService.onBind نهائية (I39af5)
  • وقد أعدنا الواجهة CanvasComplication ونقلنا CanvasComplicaitonDrawable وGlesTextureComplication وComplicationHighlightRenderer إلى wear-watchface-complications-rendering. (I84670)
  • تمت إعادة هيكلة RenderParameters لإتاحة العرض الموسّع. أصبح من الممكن الآن طلب عرض أهم التفاصيل للأنماط بالإضافة إلى إضافة الكل أو إضافة واحدة. بالإضافة إلى ذلك، يمكن لكل من CanvasRenderer وGlesRenderer الحصول على طريقة عرض مجرَّد جديدة لطبقة العرض التجريدية لعرض أي تظليل يطلبه المحرر. تمت إعادة تسمية الطبقة إلى WatchFaceLayer. (Ic2444)
  • تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لدعم إضافات الحدّ. يتم الاحتفاظ بالعرض واختبار إضافات الحافة على خلفية شاشة الساعة. لا تتوفّر ميزة اختبار النتائج من داخل المحرِّرين. (Ia6604)
  • معلومات تسجيل الدخول إلى DoubleRangeUserStyleSetting و LongRangeUserStyleSetting: أصبحت defaultValue وmaximumValue وminimumValue الآن مواقع بلغة kotlin. بالإضافة إلى ذلك، تمت إزالة دوال UserStyleSetting.Option مثل toBooleanOption وtoCopliizationOptions وtoListOption وغيرها. (I52899)
  • يمكنك إضافة حجم الذقن إلى خصائص الجهاز المتاح لخلفية شاشة الساعة. (I76e1e)
  • تقبل الدالة الإنشائية ComplicationHighlightRenderer الآن المعلمتَين outlineExpansion وoutlineStrokeWidth. (I87009)
  • أصبحت واجهة برمجة التطبيقات ComplicationDrawable.getNoDataText الآن جزءًا من واجهة برمجة التطبيقات العامة. (I00598)

الإصدار 1.0.0-alpha11

7 نيسان (أبريل) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha11. يحتوي الإصدار 1.0.0-alpha11 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تم تطبيق تحسينات إضافية على واجهات برمجة تطبيقات خلفية شاشة الساعة. معظم التغييرات عبارة عن إعادة تسمية بسيطة، ولكن تم دمج InteractiveWatchFaceWcsClient وInteractiveWatchFaceSysUiClient في InteractiveWatchFaceClient.

التغييرات في واجهة برمجة التطبيقات

  • أصبح ContentDescriptionLabel.text الآن ComplicationText بدلاً من مكتبة الدعم القديمة القابلة للارتداء TimeDependentText. (I80c03)
  • لا نضمن توفُّر تطبيق SystemProviders.GOOGLE_PAY على جميع أجهزة Android R، لذا تمت إزالته من القائمة. لا يزال من الممكن استخدام مقدّم الخدمة هذا عبر DefaultComplicationProviderPolicy (If01b5)
  • لقد أعدنا تسمية ComplicationUpdateCallback لتصبح ComplicationUpdateListener لتحقيق الاتساق. (I61ec7)
  • تم تغيير خريطة تنسيق السلك لـ UserStyle إلى Map<String, byte[]>، ولتسهيل الأمر، تمت إضافة فئة UserStyleData إلى واجهة برمجة التطبيقات العامة، ويتم استخدامها الآن من قِبل wear-watchface-client وwear-watchface-editor. بالإضافة إلى ذلك، أصبحت CustomValueUserStyleSet.CustomValueOption.value الآن byte[] بدلاً من String. (Iaa103)
  • يستخدم كل من UserStyleSetting وUserStyleSetting.Option الآن UserStyleSetting.Id وUserStyleSetting.Option.Id على التوالي لتخزين أرقام التعريف الخاصة بهما بدلاً من سلسلة. (I63f72)
  • تمت إعادة تسمية "InteractiveWatchFaceClient.SystemState" إلى "WatchUiState". (I6a4e0)
  • تم دمج InteractiveWatchFaceWcsClient وInteractiveWatchFaceSysUiClient لأنّه كان من الصعب توضيح تقسيم المسؤولية (Iff3fa).
  • تمت إعادة تسمية قيم تعداد الطبقات لمزيد من الوضوح. تغيّر اسم Layer#TOP_LAYER ليصبح الآن Layer#COMPLICATIONS_OVERLAY وLayer#BASE_LAYER هو Layer#BASE (Ia144e).
  • تمت إعادة تسمية "UserStyleListener" إلى "UserStyleChangeListener" (I18524).
  • تمت إعادة تسمية "UserStyleRepository" إلى "CurrentUserStyleRepository" (I6ea53).
  • تمت إعادة تسمية "InteractiveWatchFaceWcsClient.updateInstance" إلى "updateWatchfaceInstance". (I321dc)
  • تمّت إعادة تسمية أحداث WatchFace TapType لتتوافق مع Motionevents / Compose. (I0dfd0)
  • تمت إعادة تسمية TakeWatchfacecache إلى RenderWatchFaceToBitmap، وتم تغيير اسم TakeComplicationلقطة الشاشة إلى renderComplicationToBitmap (Ie0697).
  • تمت إزالة واجهة CanvasComplication لصالح فئة CanvasComplicationDrawable المفتوحة. (I1f81f)
  • تمت إزالة WatcfaceControlServiceFactory من واجهة برمجة التطبيقات العامة. (I1f8d3)
  • لقد أعدنا تسمية "CanvasComplication.setData" إلى "CanvasComplication.loadData". (If1239)
  • تمت إعادة تسمية "ComplicationsManager.bringAttentionToComplication" إلى "displayPressedAnimation". (Ic4297)
  • تشتمل WatchFaceService.createWatchFace الآن على تعليق توضيحي @UiThread. (Ib54c2)
  • تم تغيير اسم مَعلمة CanvasComplicationDrawable لإصلاح خطأ. (I50dac)
  • لقد أضفنا HeadlessWatchFaceClient.toBundle() وHeadlessWatchFaceClient.createFromBundle لإتاحة إرسال HeadlessWatchFaceClient من خلال AIDL. (I07c35)
  • يتوفر لدى HeadlessWatchFaceClient و InteractiveWatchFaceClient الآن ClientConnectedListener وisConnectionAlive() للسماح لك بملاحظة ما إذا كان الاتصال معطّلاً لسبب ما (على سبيل المثال، تعرض واجهة الساعة للإغلاق). (Ie446d)
  • أصبحت WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الآن دالة تعليق وتمت إعادة تسميته إلى getOrCreateInteractiveWatchFaceClient. (Ib745d)
  • تمت إعادة تسمية EditorState.commitChanges وhasCommitChanges() إلى shouldCommitChanges(). (I06e04)
  • تمت إعادة تسمية previewComplicationData إلى previewComplicationsData للإشارة إلى أنّ هناك (عادةً) أكثر من إضافة واحدة في الخريطة. (I56c06)
  • تمت إعادة تسمية InteractiveWatchFaceWcsClient.bringAttentionToComplication إلى displayPressedAnimation لتحقيق الاتساق مع ComplicationsManager.displayPressedAnimation. (Ic9999)
  • تم تضمين جميع مثيلات رقم تعريف خلفية شاشة الساعة في فئة WatchFaceId جديدة (I45fdf).
  • تمت إعادة تسمية السمة complicationState إلى complicationsState للإشارة إلى التعدد. (Ided07)
  • لقد أزلنا العديد من الإحالات الناجحة لأداة الربط بين خلفيات شاشة الساعة الذكية، لذا من المفترض أن تكون ضرورية. (Icc4c0)
  • لتحقيق الاتساق، تمت إعادة ضبط "EditorServiceClient" لاستخدام المستمعين بدلاً من المراقبين. (Iec3a4)
  • لقد أضفنا بعض تعليقات @Px التوضيحية غير المتوفّرة إلى InteractiveWatchFaceSysUiClient وWatchFaceControlClient. (I3277a)
  • تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener لتحقيق الاتساق. (Ie572d)
  • يقتصر EditorState.watchFaceInstanceId على مستوى واجهة برمجة تطبيقات Android R والمستويات الأعلى ولم يعد قابلاً للقيم الفارغة. (Id52bb)
  • تمت إعادة تسمية "EditorSession.launchComplicationProviderChooser" إلى "openComplicationProviderChooser". (I9d441)
  • تمت إعادة تسمية EditorSession.createOnWatchEditingSessionAsync إلى createOnWatchEditingSession وأصبحت الآن دالة تعليق. (Id257b)
  • تمت إضافة العديد من تعليقات @UiThread التوضيحية غير المتوفّرة في EditorSession. (I6935c)
  • تمت إعادة تسمية "UserStyleSetting.affectsLayers" إلى "affectedLayers". (I6e22b)

الإصدار 1.0.0-alpha10

24 آذار (مارس) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha10. يحتوي الإصدار 1.0.0-alpha10 على هذه عمليات التنفيذ.

الميزات الجديدة

  • أصبح من الممكن الآن إنشاء كائنات gl مفتوحة (مثل الزخارف) أثناء WatchFaceService.createWatchFace، نظرًا لأن GlesRenderer يتطلب الآن استدعاءًا صريحًا لـ initOpenGLContext الذي يمكن تنفيذه داخل createWatchFace.

التغييرات في واجهة برمجة التطبيقات

  • كانت واجهة برمجة التطبيقات IdAndComplicationData محرجة بعض الشيء وتمت إزالتها من Public API. صفوف و وإعادة هيكلة الواجهات التي استخدمتها. (I4c928)
  • لقد استبدلنا ReferenceTime بـ CountUpTimeReference وCountDownTimeReference، وهما أكثر وضوحًا. (Ib66c6)
  • تمت إضافة بعض تعليقات @Px و@ColorInt التوضيحية غير المتوفّرة. (I9bbc3)
  • أصبحت الدالة Complication.complicationConfigExtras الآن غير قابلة للإلغاء وتم ضبطها تلقائيًا على Bundle.EMPTY. (Iad04f)
  • يتطلّب تطبيق "GlesRenderer" الآن الاتصال بـ "initOpenGLContext" بعد البناء. كانت هذه الدالة من التفاصيل الداخلية ولكنها الآن على واجهة برمجة التطبيقات العامة للسماح باستدعاءات GL في وقت سابق داخل createWatchFace. (I726c2)
  • لقد أزلنا Complication.setRenderer لأنّه غير ضروري. (Ie992f)
  • لم تعُد الإضافة Complicaiton.setComplicationBounds جزءًا من واجهة برمجة التطبيقات العامة. إذا كنت بحاجة إلى تعديل موضع إضافة، يمكن إجراء ذلك من خلال ComplicationsUserStyleSetting. (Ibd9e5)
  • تمت إعادة تسمية "ComplicationsManager.TapCallback.onComplicationSingleTapped" إلى "onComplicationTapped". (I3a55c)
  • تمت إعادة تسمية "ComplicationOutlineRenderer.drawComplicationSelectOutline" إلى "drawComplicationOutline". (I14b88)

الإصدار 1.0.0-alpha09

10 آذار (مارس) 2021

تم طرح androidx.wear:wear-complications-*:1.0.0-alpha09 وandroidx.wear:wear-watchface-*:1.0.0-alpha09. يحتوي الإصدار 1.0.0-alpha09 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تم تطوير الواجهة بين مضيف WCS/SysUI وخلفية الساعة. أصبح من الممكن الآن للمحرِّر تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل إضافة أو إيقافها (التفعيل = alreadyEnabled بالإضافة إلى أي عملية إلغاء من ComplicationsUserStyleSet). ويسمح EditorService.closeEditor أيضًا لـ SysUI بإغلاق محرّر خلفية شاشة الساعة عن بُعد إذا لزم الأمر.
  • بالإضافة إلى ذلك، يمكنك استخدام InteractiveWatchFaceWcsClient.setUserStyle باستخدام الأمر updateInstance الأكثر فعالية الذي يغيّر معرّف المثيل وتحديد النمط ومحو جميع الإضافات في آنٍ واحد.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة Trace Events إلى مكتبات خلفيات شاشة الساعة. (I1a141)
  • تتضمّن ComplicationState الآن السمة الجديدة initiallyEnabled، وهي مفيدة لتوقُّع النتائج المترتبة على تبديل الأنماط. (I8c905)
  • لقد استبدلنا InteractiveWatchFaceWcsClient.setUserStyle بأمر أكثر فعالية updateInstance وهو: يغيّر معرّف المثيل وتحديد النمط ومحو الإضافات. (Ife6f6)
  • لم تعُد واجهات برمجة التطبيقات للقطات الشاشة من WatchFaceClient تضغط لقطات الشاشة لأنّ ذلك كان بطيئًا، بدلاً من ذلك نترك معالجة أي مشاركة للمتصل. (Id35af)
  • أصبح بالإمكان الآن إغلاق محرّر خلفية شاشة الساعة عن بُعد من خلال تطبيق "EditorService.closeEditor". (Ic5aa4)
  • تمت إضافة تعليقات توضيحية تشير إلى إمكانية قبول القيم الفارغة (Ic16ed).

الإصدار 1.0.0-alpha08

24 شباط (فبراير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تم تصميم بعض خلفيات شاشة الساعة لتتوافق مع إضافة واحدة أو أكثر تحديدًا. ولتوفير هذه الإضافة، أضفنا Complication.Builder#setFixedComplicationProvider الذي تم ضبطه على "صحيح" لمنع المستخدم من تغيير الإضافة في هذه الخانة.
  • مكتبات خلفية شاشة الساعة هي لغة Kotlin أولاً وتستخدم الكوروتينات (مثل دوال التعليق). قدّمنا لمستخدمي Java برامج تضمين ListenableFuture لتحسين إمكانية التشغيل التفاعلي في المكتبات التالية: wear/wear-watchface-guava وwear/wear-watchface-client-guava Wear/wear-watchface-editor-guava.

التغييرات في واجهة برمجة التطبيقات

  • لقد أزلنا ميزة النقر المزدوج على الإضافات التي تعمل على إطلاق أداة اختيار الموفّر، ولم تكن هذه الميزة شائعة في خلفيات شاشة الساعة وأعقّدت عملية تنفيذ SysUI. (I3ef24)
  • قد تؤدي طرق ProviderInfoRetriever إلى ظهور Service مساعدتك على وجه الاستثناء في حال إغلاق المثبت بشكل غير متوقع. (Ib2cc4)
  • بدءًا من نظام التشغيل Android 11 فصاعدًا، هناك قيود على وقت تفعيل أداة ProviderChooser، بالإضافة إلى ذلك، نودّ إنشاء أدوات تحرير باستخدام wear-watchface-editor الجديد، لذلك ستتم إزالة ComplicationHelperActivity من واجهة برمجة التطبيقات المتاحة للجميع. (Ib19c1)
  • إزالة طرق ComplicationText الثابتة لصالح أدوات الإنشاء. (Ibe399)
  • لقد قدّمنا برامج تضمين guava ListenableFuture لمختلف طرق تعليق مكتبة خلفيات شاشة الساعة. (I16b2c)
  • لتوضيح آلية عمل واجهة برمجة التطبيقات، أضفنا دالة إنشاء ثانوية إلى Render أموال على النحو الذي لا يتطلب تلوينًا خفيفًا لاستخدامها مع LayerModes غير LayerMode.DRAW_OUTLINED. (I497ea)
  • في السابق، كانت ListUserStyleSet مختلفًا عن الأخرى لأنّها كانت تتضمن وسيطة تلقائية. الآن تأخذ جميع دوال إنشاء الفئة الفرعية StyleSet القيمة الافتراضية في النهاية. (I9dbfd)
  • تمت إعادة هيكلة CanvasComplication لاستخدامها بطريقة مخفية، ما يسهِّل تنفيذ فئة فرعية (I5b321).
  • لقد أعدنا تصميم أداة EditorResult للاستفادة من خدمة EditorService جديدة وEditorSession.broadcastState() لبث التحديثات إلى المراقب (عادةً ما يكون نظام التشغيل SysUI). (Ic4370)
  • تم تصميم بعض خلفيات شاشة الساعة استنادًا إلى إضافة معيّنة باعتبارها جزءًا لا يتجزأ من خلفية شاشة الساعة حيث لا يمكن للمستخدم ضبط إعدادات التطبيق. ولدعم ذلك، أضفنا Complication.Builder#setFixedComplicationProvider. (I4509e)
  • يحدد EditorRequest الآن اسم الحزمة بدلاً من ComponentName لأنه لم يكن من الملائم لـ SysUI البحث عن اسم فئة المحرر، ونحتاج حقًا إلى اسم الحزمة فقط. (Ib6814)

الإصدار 1.0.0-alpha07

10 شباط (فبراير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على هذه عمليات التنفيذ.

الميزات الجديدة

  • أصبحت WatchFaceService.createWatchFace الآن وظيفة تعليق، ما يعني أن خلفية شاشة الساعة لم تعد بحاجة إلى حظر سلسلة واجهة المستخدم أثناء انتظار طلب الإدراج. وبالمثل، فإن أداة تعديل خلفية شاشة الساعة وبيانات تعقيدات الارتداء

التغييرات في واجهة برمجة التطبيقات

  • إزالة فئة PhotoImage واستخدام رمز Icon مباشرةً (I8a70b)
  • اعرِض قيمة validTimeRange في ComplicationData. (I91366)
  • اجعل السمات التي تشبه الصور أكثر وضوحًا. (I81700)
  • تمت إعادة هيكلة أداة تعديل خلفية شاشة الساعة الذكية وبيانات مضاعفات الارتداء من أجل استخدام وظائف التعليق بدلاً من الكوروتينات. Rx java & برامج تضمين متوافقة مستقبلية سيتم متابعتها. (If3c5f)
  • تعرض أداة ProviderInfoRetriever الآن أداة PreviewNot availableException في حال تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو نقص في الدعم من خلال واجهة برمجة التطبيقات. (I4964d)
  • WatchFaceControlService::createWatchFaceControlClient الآن غير مفعَّل، أصبحت ميزة getOrCreateLayerServiceBackedInteractiveWatchFaceWcsClient الآن تُعرف الآن باسم getOrCreateFeatureServiceBackedInteractiveWatchFaceWcsClientAsync عرض Deferred<InteractiveWatchFaceWcsClient>. برامج تضمين RX java و Future compat to للاشتراك. (I5d461)
  • إعادة تسمية "CATEGORY_PROVIDER_CONFIG_ACTION" إلى "CATEGORY_PROVIDER_CONFIG" (I7c068)
  • تجدر الإشارة إلى أنّ createOnWatchEditingSession أصبح الآن دالة معلّقة لأنّ خلفية شاشة الساعة لا تكون متاحة أحيانًا إلا بعد فترة وجيزة من بدء نشاط المحرّر. (Ida9aa)
  • أصبحت WatchFaceService.createWatchFace الآن وظيفة تعليق تسمح بالتهيئة غير المتزامنة، كان عليك في السابق حظر سلسلة التعليمات الرئيسية. (If076a)
  • أصبح لـ UserStyle الآن عامل تشغيل صفيف، وأضفنا مساعدات البث إلى UserStyle.Option. (I35036)
  • أصلحنا خطأً تنظيميًا يغيِّر تنسيقات شبكة UserStyle التي تغيّر بعض واجهات برمجة التطبيقات المخفية غير المستقرة. (I8be09)
  • لقد أضفنا إعدادات CustomValueUserStylesetting التي تتيح لك تخزين سلسلة خاصة بتطبيق واحد ضمن نمط المستخدم. وستتجاهل أدوات التحرير التلقائية لخلفية شاشة الساعة هذه القيمة. (Ic04d2)
  • لا يتم إدخال InstanceID في عناصر intent الإضافية لـ R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. لإتاحة ذلك، نسمح الآن بأن يكون InstancID فارغًا. (Id8b78)
  • يتضمن EditorRequest الآن المحرِّر ComponentName الذي يتم ضبطه كمكوّن في WatchFaceEditorCreation.createIntent (I3cd06)
  • تتضمن أداة EditorResult لخلفية شاشة الساعة الآن معاينة ComplicationData للسماح للمتصل بأخذ لقطة شاشة لخلفية شاشة الساعة بعد تعديلها. (I2c561)

إصلاح الأخطاء

  • تؤدي إضافة toString() إلى UserStyle وUserStylesetting وUserStyleSchema، ما يجعل العمل مع هذه الفئات أكثر سلاسة. (I9f5ec)

الإصدار 1.0.0-alpha06

27 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha06. يحتوي الإصدار 1.0.0-alpha06 على هذه عمليات التنفيذ.

الميزات الجديدة

  • أطلقنا إصدارًا جديدًا من أدوات تعديل خلفية شاشة الساعة القابلة للارتداء أو الارتداء، وهو ما يتيح لمطوّري خلفيات شاشة الساعة والمصنّعين الأصليين المُحتمَلين إنشاء تصميم رائع للتصميم وإضافة خلفيات شاشة ساعة. سيرسل SysUI رسالة Intent إلى خلفية شاشة الساعة وتستخدم فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة عبر Activity.setWatchRequestResult. ولدعم ذلك، أضفنا ProviderInfoRetriever.requestPreviewComplicationData. بهذه الطريقة، يمكن لمحرّري خلفية شاشة الساعة طلب معاينة ComplicationData. تتشابه ميزة معاينة ComplicationData مع البيانات المباشرة، فلا داعي للقلق بشأن عرض مربعات حوار الأذونات عند عرض المحرر (يُرجى العلم أنه إذا اختار المستخدم مقدم خدمة لديه إذن، فسيظل عليه منح الإذن).

التغييرات في واجهة برمجة التطبيقات

  • يتضمّن ComplicationProviderInfo الآن حقلاً لـ ComponentName لدى مقدّم الخدمة، وستتم إضافة إمكانية استخدام هذا الحقل إلى نظام التشغيل WearOS في وقت لاحق، وسيكون فارغًا إلى حين ذلك. (Id8fc4)
  • لقد أضفنا ProviderInfoRetriever.requestPreviewComplicationData تتيح لمحرّري خلفية شاشة الساعة طلب معاينة ComplicationData. يفيدك ذلك لأنّ الإضافات المباشرة قد تتطلّب أذونات. ويمكنك الآن عرض بيانات المعاينة للإضافات غير النشطة. (I2e1df)
  • أصبح ComplicationManager الآن معلَمة اختيارية في الدالة الإنشائية لـ WatchFace، وقد تمت إعادة ترتيب الوسيطات للسماح بذلك. (I66c76)
  • لقد أضفنا حِزمة اختيارية إلى "الإضافات"، والتي في حال تم دمجها بهدف إرسال نشاط أداة اختيار الموفّر. (Ifd4ad)
  • لقد أضفنا مكتبة جديدة من "wear-watchface-editor" لتوفيرها على خلفية شاشة الساعة وأدوات التحرير التي تستضيفها SysUi. سيشغِّل SysUI هذه المحرِّرين من خلال إرسال هدف. يمكن لخدمة نشاط خلفية شاشة الساعة استخدام فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة عبر Activity.setWatchRequestResult. (I2110d)
  • تُعرف LayerMode.DRAW_HIGHLIGHTED الآن باسم LayerMode.DRAW_OUTLINED ويُطلق عليها الآن Renderparameters.highlightComplicationId ويُسمى Renderparams.selectedComplicationId والتي تبرز الإضافة المحددة بالإضافة إلى المخطط. (I90a40)
  • يمكن الآن حلّ مستقبل WatchFaceControlClient.getOrCreateLayerServiceBackedInteractiveWatchFaceWcsClient باستخدام ServiceStartFailureException في حال توقف الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
  • أصبحت أداة EditorSession.compliactionPreviewData الآن ListenableFuture نظرًا لأن جلب هذه البيانات هو عملية غير متزامنة. (Iead9d)

إصلاح الأخطاء

  • نعمل على إزالة الحقول غير المستخدمة من ComplicationOverlay وتركها مفعَّلة و ComplicationsBounds. (I17b71)

الإصدار 1.0.0-alpha05

13 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear-*:1.0.0-alpha05. يحتوي الإصدار 1.0.0-alpha05 على هذه عمليات التنفيذ.

الميزات الجديدة

غالبًا ما تتوافق خلفيات شاشة الساعة مع عدد من إعدادات الإضافات مع عرض أعداد مختلفة من الإضافات. لتسهيل عملية الإعداد، نتيح الآن الإضافات التي تم إيقافها في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. ويمكن تفعيلها لاحقًا من خلال الإعداد ComplicationsUserStyleSet.

التغييرات في واجهة برمجة التطبيقات

  • يقبل ComplicationHelperActivity الآن استخدام Collection<ComplicationType> بدلاً من مصفوفة int، ما يسهّل استخدامه. (I1f13d)
  • تعرض ميزة "ProviderInfoRetriever.retrieveProviderInfo" الآن ListenableFuture<ProviderInfo[]> بشكل صحيح. (If2710)
  • يمكنك الآن إنشاء إضافة تم إيقافها في البداية من خلال استدعاء setEnabled(false) في أداة الإنشاء. (Idaa53)
  • تتضمّن WatchFaceState الآن سمة "بدون واجهة مستخدم رسومية" لا ينطبق ذلك إلا على الحالات التي بلا واجهة مستخدم رسومية. (Ifa900)
  • يتيح تطبيق ComplicationDrawable الآن اختياريًا التحميل المتزامن للمواد القابلة للرسم. ويتم استخدام ذلك من خلال واجهات برمجة التطبيقات للقطات الشاشة. (I34d4a)

الإصدار 1.0.0-alpha04

16 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear-*:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على عمليات التنفيذ هذه.

الميزات الجديدة

  • تتيح مكتبة خلفيات شاشة ساعة Wear الآن ضبط الحدود لكل نوع. مثلاً: يمكنك التبديل إلى مربع إحاطة عريض لـ ComplicationType.long_TEXT مع استخدام مربع حدود أصغر لأنواع أخرى.

التغييرات في واجهة برمجة التطبيقات

  • تستخدم الإضافات حاليًا دالة ComplicationBounds التي تُغلف Map<ComplicationType, RectF> للتوافق مع أحجام أنواع الإضافات. (I1ebe7)
  • تتيح لك Render توجيهات الآن تحديد درجة اللون الخفيف لاستخدامها في لقطات الشاشة. (Iff42b)
  • باستثناء الحدود، يجب عليك الآن استخدام ComplicationsUserStyleSet لتعديل الإضافات لضمان مزامنة نظام التشغيل. (I8dc5d)
  • أصبح العارض الآن فئة مختومة. يعني هذا أنّ CanvasRenderer وGlesRenderer أصبحا الآن فئتَين داخليتَين في Renderer. (Iab5d4، b/173803230)
  • تمت إعادة تسمية CanvasComplicationDrawable.Drawتمييز إلى drawOutline. هناك الآن بعض تعليقات UiThread غير التوضيحية التي لا تتوفّر في أداة ObserableWatchData. تمت الآن إزالة ScreenState بالكامل من WatchState. (If1393)
  • الحد الأدنى لمستوى واجهة برمجة التطبيقات لخلفية شاشة الساعة الذكية هو 25 الآن. لاستخدام لوحة ملاحظة، يجب توفّر واجهة برمجة التطبيقات من المستوى 26 أو أعلى. (Ic9bbd)
  • يتضمّن InteractiveWatchFaceWcsClient الآن مساعد getComplicationIdAt. (I05811)
  • تم خفض مستوى واجهة برمجة التطبيقات لـ "Wear-watchface-client" إلى 25، غير أنّ واجهات برمجة التطبيقات الخاصة بلقطات الشاشة تتطلب المستوى 27 من واجهة برمجة التطبيقات. (Id31c2)

إصلاح الأخطاء

  • نعرض الآن ComplicationData الحالي للمكوّن الإضافي ComplicationData في ComplicationState. (I9b390)
  • تضم InteractiveWatchFaceWcs الآن طريقة "bringAttentionToComplication" لتسليط الضوء بإيجاز على الإضافة المحددة. (I6d31c)
  • تتضمن InteractiveWatchFaceWcsClient#setUserStyle الآن حِملًا زائدًا يتم قبول الخريطة<string, string=""> مما قد يؤدي إلى تجنب إرسال البيانات ذهابًا وإيابًا إضافية من IPC لإنشاء UserStyle. (I24eec)</string,>

الإصدار 1.0.0-alpha03

2 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear-*:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه عمليات التنفيذ.

الميزات الجديدة

تحتوي فئة الإضافة الآن على خاصية compicationData التي تسمح لخلفيات شاشة الساعة بملاحظة التغييرات في ComplicationData. يتيح ذلك تغيير أبعاد الإضافة بناءً على نوع الإضافة.

يمكن الآن تغيير عدد اللقطات في الثانية من خلال التعيين إلى Renderer.interactiveDrawModeUpdateDelayMillis. بالنسبة إلى خلفيات شاشة الساعة التي تحتوي على رسوم متحركة قصيرة كل ثانية، يمكن أن يؤدي هذا إلى توفير الطاقة بشكل جيد من خلال الانتقال إلى وضع السكون عند عدم استخدام الصور المتحركة.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة تسمية "BACKGROUND_IMAGE" إلى "PHOTO_IMAGE" مع الصفوف ذات الصلة. لا يتم استخدام هذا النوع من الإضافات حصريًا للخلفيات، وبالتالي تم تغيير اسمها. (I995c6)
  • تم التعليق بشكل صحيح باستخدام defaultComplicationProviderPolicy باستخدام IntDefs. (I3b431)
  • لم تعُد فئة TimeDependentText المخفية تظهر من خلال ContentDescriptionLabel، بدلاً من ذلك نضيف أداة وصول للحصول على النص في وقت محدّد. (Ica692)
  • أصبحت الدالة الإنشائية لـ ObserverableWatchData داخلية الآن. (I30121، b/173802666)
  • تحتوي الإضافات الآن على بيانات compication تتيح لخلفيات شاشة الساعة ملاحظة التغييرات في ComplicationData. تتضمّن الإضافة أيضًا استدعاء isActiveAt جديد يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي شيء في التاريخ والوقت المقدم. (Ic0e2a)
  • لم تعُد قيمة SharedMemoryImage الفارغة متوفّرة في واجهة برمجة التطبيقات العامة. (I7ee17)
  • تشتمل WatchFace.overridePreviewReferenceTimeMillis الآن على تعليق توضيحي IntRange ، ويكون لكل من get وsetter أسماء متسقة. (Ia5f78)
  • تم إنشاء تطبيق "Complication.Builder" الآن من خلال Complication.createRoundRectComplicationBuilder أو Complication.createBackgroundComplicationBuilder لتوضيحه (I54063).
  • تمت إضافة WatchFace.TapListener الذي يسمح بمراقبة النقرات التي لا تستخدمها الإضافات بواسطة WatchFace. (Ic2fe1، b/172721168)
  • تتيح WatchFace الآن إمكانية تغيير عدد اللقطات في الثانية من خلال الضبط على Renderer.interactiveDrawModeUpdateDelayMillis. يمكن أن يساعد ذلك في الحفاظ على عمر البطارية عن طريق الانتقال إلى وضع السكون في حال عدم الحركة. (I707c9)
  • لم تعُد هناك حاجة إلى WatchFace.Builder، وتم نقل validate() و InteractiveUpdateRateMillis إلى Renderer. (I329ea)
  • لتحسين إمكانية التشغيل التفاعلي في Java
  • أُعيدت تسمية TapListener إلى TapCallback وواجهة validateCallback بدلاً من validateListener لتحقيق التناسق. (I9414e)
  • تم نقل خيارات نمط خلفية شاشة الساعة التي تعمل بالإصدار 2.0 من نظام التشغيل Wear إلى فئتها الخاصة لمزيد من الوضوح. تتوفّر الآن أدوات التصنيف المتماثلة في فئة WatchFace. (Iefdfc)
  • تمت إضافة InteractiveWatchFaceWcsClient وWatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient اللذَين يحصلان على مثيل حالي أو ينشئونه بعد اتصال خدمة wallaper وإنشاء المحرّك. (Id666e)
  • أصبحت WatchFaceControlClient الآن واجهة للسماح للاختبارات بمحاكاةها. (I875d9)
  • وتتوفر الآن واجهات لتيسير الاختبار بشكل أفضل، مثل HeadlessWatchFaceClient و InteractiveWatchFaceSysUiClientImpl و InteractiveWatchFaceWcsClient. (I7cdc3)
  • تمت إضافة تعليقات توضيحية إلى الطرق في wear-watchface-complications-rendering (I0d65c)

إصلاح الأخطاء

  • إزالة شكل الشاشة من DeviceConfig الذي كان يتكرر android.content.res.Configuration#isScreenRound() (Ifadf4)
  • تم تغيير WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient لقبول Map<String, String> بدلاً من UserStyle لأنه من الصعب إنشاء UserStyle بدون معرفة المخطط الذي لا يمكنك الحصول عليه إلا بعد إنشاء البرنامج. (Iea02a)
  • يجب حلّ المشكلة في "InteractiveWatchFaceWcsClient" لاستخدام ComplicationState بدلاً من تنسيق السلك. (Icb8a4)
  • تم تحويل UserStyleSettings إلى صف مغلق لأنّ محرّري خلفية شاشة الساعة لا يفهمون سوى الصفوف المضمَّنة. (I2d797)

الإصدار 1.0.0-alpha02

11 تشرين الثاني (نوفمبر) 2020

تم طرح androidx.wear:wear-*:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • أصبح اسم ComplicationDetails الآن باسم ComplicationState وتم التفافه بشكل صحيح، وتم نقل استخدامات الدعم القابل للارتداء @ComplicationData.ComplicationType إلى androidx ComplicationType. (I4dd36)
  • أضِف مَعلمة highlightedComplicationId اختيارية إلى Render مسافة على معاملات معيّنة تسمح لك بطلب تمييز إضافة واحدة في لقطات الشاشة. (I66ce9)
  • ComplicationProviderService استخدام واجهة برمجة تطبيقات إضافة النمط الجديد من أجل تحقيق الاتساق (Id5aea)
  • تحصل getPreviewReferenceTimeMillis الآن على أوقات مرجعية من DeviceConfig. (I779fe)
  • بدلاً من ذلك، يمكنك تبسيط واجهة برمجة التطبيقات الخاصة بـ Renderer، ويمكن استخدام SurfaceHolder.Callback لرصد التغييرات. (I210db)
  • لا يمتد CanvasComplicationRenderer من Renderer، لذا تمت إعادة تسميته لتوضيحه. (Ibe880)

إصلاح الأخطاء

  • الإصدار الأول من androidx.wear:wear-watchface-client (I1e35e)
  • تم تغيير اسم GlesTextureComplication#renderer للإيضاح (Ib78f7).
  • إعادة تسمية "StyleCategory" إلى "StyleSetting" لمزيد من التوضيح (I488c7)
  • إضافة UserStyleSchema لواجهة برمجة تطبيقات أكثر وضوحًا (If36f8)

الإصدار 1.0.0-alpha01

28 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear-complications-*:1.0.0-alpha01 وandroidx.wear:wear-watchface-*:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إزالة بعض البيانات التي لم نعتزم عرضها في واجهة برمجة التطبيقات العامة. (I41669)
  • إنشاء مكتبة androidx.wear:wear-complications-provider (I77f1f)
  • ComplicationsUserStyleCategory: الفئة الجديدة الموصى بها لإعداد الإضافات (I96909)
  • إضافة واجهة برمجة تطبيقات Wear-complieration-data (I7c268)
  • الدوال التي تتضمّن قيمًا منطقية للعرض يجب أن تسبقها "is" بدلاً من "get" (If36ff)
  • نصيحة واجهة برمجة التطبيقات هي تجنب استخدام الحماية، ولذلك تمت إعادة ضبط هذه الفئة لأخذ المعلمات عبر الدالة الإنشائية. (I61644)
  • أعد تسمية setBackgroundComplication لمزيد من الوضوح. (I96fe3)
  • استخدام خصائص Kotlin لعرض تمييز ComplicationDrawable البيانات (I4dcc8)
  • بدلاً من ComplicationRenderer.InappropriateateCallback
  • يتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport وتتم إزالتها هنا. (Ib425c)
  • تمت إعادة تسمية بعض طرق إنشاء واجهة WatchFace للتأكيد على طبيعتها القديمة لـ Wear 2.0. (Idb775)
  • أول مرشح لواجهة برمجة التطبيقات للإصدار التجريبي من واجهة برمجة التطبيقات للارتداء/الارتداء (Id3981)
  • أول إصدار يتم تتبّعه من واجهة برمجة التطبيقات (Ie9fe6)
  • إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle لتحقيق الاتساق (I27f7a)
  • إضافة تعليقات توضيحية مفقودة لطرق ComplicationStyle (I838fd)
  • لا تحتوي هذه المكتبة على واجهة برمجة تطبيقات عامة (I88e2b)
  • أصبحت جميع فئات خيارات فئات الأنماط نهائية بشكل صحيح. (Ib8323)
  • أول إصدار يتم تتبّعه من واجهة برمجة التطبيقات (I27c85)

إصلاح الأخطاء

  • تم تغيير ComplicationProviderService بحيث تتضمن طريقة getComplicationPreviewData بشكل صريح. (I4905f)
  • تم تفعيل "فحص أداة Lint API" لـ LostGetterMatchingBuilder لنظام التشغيل androidx (I4bbea، b/138602561).
  • أعِد تسمية عرض تعقيدات الارتداء. (Ifea02)
  • أصبحت الأسماء المعروضة لفئة الأنماط الآن CharSequences (I28990).
  • استبدال "الإلغاء" بـ "تراكب" لمطابقة المظاهر الحالية اصطلاحات تسمية الأنماط. (I4fde9)
  • تمت إعادة تسمية UserStyle#getOptions لمزيد من الوضوح. (I695b6)

الإصدار 1.2.0

الإصدار 1.2.0

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear:1.2.0. يحتوي الإصدار 1.2.0 على عمليات الالتزام هذه.

تغييرات مهمة منذ الإصدار 1.1.0

  • تمت إضافة مكوّن CurvedText لكتابة النص المنحني بسهولة بعد انحناء أكبر دائرة يمكن نقشها في العرض. مثال على الاستخدام:

    <androidx.wear.widget.CurvedText
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="example curved text"
            app:anchorAngleDegrees="180"
            app:anchorPosition="center"
            app:clockwise="false"
            style="@android:style/TextAppearance.Large"
    />
    

    مثال على نص منحني في Android Wear

  • تمت إضافة حاوية ArcLayout لوضع عناصرها الفرعية واحدًا تلو الآخر على قوس في اتجاه عقارب الساعة أو عكس عقارب الساعة. يمكن أن تكون عناصر Android المصغّرة عادية أو "منحنية" التطبيقات المصغّرة التي تنفّذ واجهة ArcLayout.Widget. (I536da) مثال على الاستخدام:

    <androidx.wear.widget.ArcLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:anchorPosition="center">
          <ImageView
                  android:layout_width="20dp"
                  android:layout_height="20dp"
                  android:src="@drawable/ic_launcher"
          />
          <androidx.wear.widget.CurvedText
                  android:layout_width="match_parent"
                  android:layout_height="match_parent"
                  android:text="Curved Text"
                  style="@android:style/TextAppearance.Small"
                  android:padding="2dp"
           />
      </androidx.wear.widget.WearArcLayout>
    

    مثال على النص القوسي في Android Wear

  • تمت إضافة حاوية تنسيق جديدة، وهي SuccessibleFrameLayout، وهي تعالج وظيفة زر الرجوع و/أو إغلاق الشاشة و/أو التمرير سريعًا للإغلاق، وهي مخصصة للاستخدام في نشاط معيّن. يجب إضافة مستمع واحد على الأقل لاتخاذ إجراء بشأن رفض الطلب. يزيل المستمع عادةً طريقة عرض كاملة أو جزءًا من النشاط الحالي. setSquickErrorible(منطقية) & يتم توفير setBackButtonErrorible(منطقية) للتحكم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال تنسيق التصفّح السريع الحالي.

  • تمت إضافة إمكانية الإشارة إلى إمكانية "استئناف النشاط" تلقائيًا عند خروج الجهاز من وضع الاستراحة في الفئة AmbientModeSupport. كانت هذه الوظيفة متاحة في السابق في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)

  • تم نقل فئة Wearable Calendarيمكنك من مكتبة الدعم القابل للارتداء. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال calendarEntity، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)

  • تمت إضافة واجهة برمجة تطبيقات WearTypeHelper جديدة في androidx.wear.utils لتحديد ما إذا كان جهاز Wear المقدَّم مخصّصًا الصين. (Ib01a9)

  • تمت إضافة ميزات تسهيل الاستخدام إلى تطبيق androidx.wear.widget.ConfirmationOverlay لتقرأ الرسائل بصوت عالٍ في حال ضبطها متبوعة بوصف الرسوم المتحركة. (I524dd)

  • تم إصلاح الخطأ الذي تسبّب في تعطُّل {8/}Activity إذا لم تظهر أي رسائل التي حصلت عليها. (Ie6055)

  • تم إصلاح الخطأ الذي تسبَّب فيه التمرير الأفقي في RecyclerViews. WearableDrawerLayout للاطّلاع على كل التفاعلات (I24c7f)

الإصدار 1.2.0-rc01

1 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear:1.2.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يحتوي الإصدار 1.2.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.2.0-beta01

18 آب (أغسطس) 2021

تم طرح androidx.wear:wear:1.2.0-beta01. يحتوي الإصدار 1.2.0-beta01 على عمليات التنفيذ هذه.

إصلاح الأخطاء

  • إصلاح الخطأ الذي تسبّب في تعطُّل {8/}Activity إذا لم تظهر أي رسائل التي حصلت عليها. (Ie6055)

الإصدار 1.2.0-alpha13

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear:1.2.0-alpha13. يحتوي الإصدار 1.2.0-alpha13 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة تسمية "WearTypeHelper.isChinaDevice" إلى "WearTypeHelper.isChinaBuild". (I47302)

إصلاح الأخطاء

  • وقد أضفنا ميزات تسهيل الاستخدام إلى تطبيق "androidx.wear.widget.ConfirmationOverlay" لتقرأ الرسائل بصوت عالٍ في حال ضبطها متبوعة بوصف الصورة المتحركة. (I524dd)

الإصدار 1.2.0-alpha12

21 يوليو 2021

تم طرح androidx.wear:wear:1.2.0-alpha12. يحتوي الإصدار 1.2.0-alpha12 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا واجهة برمجة تطبيقات WearTypeHelper جديدة في androidx.wear.utils لتحديد ما إذا كان جهاز Wear المعني مخصّصًا للصين. (Ib01a9)

الإصدار 1.2.0-alpha11

30 حزيران (يونيو) 2021

تم طرح androidx.wear:wear:1.2.0-alpha11. يحتوي الإصدار 1.2.0-alpha11 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي تسبَّب فيه التمرير الأفقي في RecyclerViews. WearableDrawerLayout للاطّلاع على كل التفاعلات (I24c7f)

الإصدار 1.2.0-alpha10

2 حزيران (يونيو) 2021

تم طرح androidx.wear:wear:1.2.0-alpha10. يحتوي الإصدار 1.2.0-alpha10 على هذه عمليات التنفيذ.

الميزات الجديدة

  • يساعد إصدار Alpha10 على تحسين إتاحة إمكانية الوصول في ميزتَي "النصوص المنحنية" و"تنسيقات ArcLayouts". كما أنها تضيف بعض إعادة التسمية البسيطة في RejectibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.

التغييرات في واجهة برمجة التطبيقات

  • لقد أعدنا تسمية الطرق التالية في DismissibleFrameLayout (Ib195e):
    • Callback#onDismissed -> Callback#onDismissedFinished
    • isSwipeDismissible -> isDismissableBySwipe
    • isBackButtonDismissible -> isDismissableByBackButton
  • جعلنا الطرق التالية نهائية (Ib195e):
    • setBackButtonDismissible
    • setSwipeDismissible
    • registerCallback
    • unregisterCallback

إصلاح الأخطاء

  • استخدام محتوى CurvedTextView في Talkback. (I05798)
  • تسهيل وصول أفضل للعروض العادية في ArcLayout. (I4418d)

الإصدار 1.2.0-alpha09

18 أيار (مايو) 2021

تم طرح androidx.wear:wear:1.2.0-alpha09. يحتوي الإصدار 1.2.0-alpha09 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة دالة جديدة CurvedTextView.setTypeface() (مشابهة لدالة TextView)، لضبط الخط الطباعي للنص ونمط الخط الغامق أو المائل. (I4653c)
  • تمت إعادة تسمية "WearArcLayout" إلى "ArcLayout"، و"WearCurvedText" إلى "CurvedText"، و"WearArcLayout.ArcLayoutWidget" إلى "ArcLayout.Widget". (I6e5ce)
    • في ArcLayout.Widget، تمت إعادة تسمية getThicknessPx إلى getThickness.
    • أصبحت ثوابت المحاذاة العمودية على ArcLayout.LayoutParams الآن. تبدأ بـ VERTICAL_ALIGN_ (بدلاً من VALIGN_ السابقة)
  • في CurvedTextView، تم استبدال الطريقتَين setMinSweepDegrees وsetMaxSweepDegrees بالطريقتَين setSweepRangeDegrees (I7a9d9).

الإصدار 1.2.0-alpha08

5 أيار (مايو) 2021

تم طرح androidx.wear:wear:1.2.0-alpha08. يحتوي الإصدار 1.2.0-alpha08 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • لتحسين وضوح الرموز، أضفنا تعليقات @FloatRange التوضيحية إلى بعض مَعلمات الزاوية وأنواع الإرجاع. (I430dd)
  • في الواجهة WearArcLayout.ArcLayoutWidget، يُطلق الآن على الطريقة insideClickArea اسم isPointInsideClickArea. (Ia7307)

الإصدار 1.2.0-alpha07

24 آذار (مارس) 2021

تم طرح androidx.wear:wear:1.2.0-alpha07. يحتوي الإصدار 1.2.0-alpha07 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • إصلاح أخطاء العناصر الثانوية غير المنحنية داخل WearArcLayout الناتجة عن استخدام حجم شاشة أكبر من العرض. تم وضع هذه العناصر الثانوية غير المنحنية الآن بشكل صحيح داخل قوس في جميع أنواع الشاشات.

الإصدار 1.2.0-alpha06

27 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear:1.2.0-alpha06. يحتوي الإصدار 1.2.0-alpha06 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: الأنشطة القابلة للارتداء تتوفّر الصفوف الآن في حزمة androidx.wear.oncomplete (وكانت سابقًا androidx.wear.onlaunchactivities) (I7c029).
  • يمكنك نقل فئة Wearable Calendarيمكنك من مكتبة الدعم القابل للارتداء إلى AndroidX. توفّر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال calendarEntity، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)

إصلاح الأخطاء

  • إيقاف ميزة الإغلاق باستخدام زر الرجوع بشكل تلقائي في تنسيق الإطار القابل للرفض، وذلك لأنّ ميزة التمرير السريع للإغلاق تظل الطريقة الرئيسية للرجوع في وضع ملء الشاشة على الأجهزة القابلة للارتداء (Ic24e3)
  • تم إصلاح بعض المشاكل المتعلقة بالتعامل مع ظهور الأطفال على WearArcLayout (Icf912).

الإصدار 1.2.0-alpha05

13 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear:1.2.0-alpha05. يحتوي الإصدار 1.2.0-alpha05 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • حدِّث javadoc لفئة AmbientModeSupport لتقديم مقتطفات كعيّنة لتوضيح الاستخدام العام لهذه الفئة بشكل أفضل.

الإصدار 1.2.0-alpha04

16 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear:1.2.0-alpha04. يحتوي الإصدار 1.2.0-alpha04 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة إمكانية الإشارة إلى إمكانية "استئناف النشاط" تلقائيًا عند خروج الجهاز من وضع الاستراحة في الفئة AmbientModeSupport. كانت هذه الوظيفة متاحة في السابق في فئة WearableActivity المتوقّفة نهائيًا من WearableSupportLibrary. (I336ab)
  • نشاط مستمر
    • يمكن الآن تعيين الفئة عند إنشاء OnlaunchActivity، على سبيل المثال OngoingActivitiy.Builder.getCategory(String)
    • إنّ الطابع الزمني لوقت إنشاء OnugActivityData الآن عبارة عن وقت إنشاء النشاط: OngoingActivityData.getTimestamp().
    • (I91cb4)
  • تمت إضافة إمكانية ضبط الهوامش على العناصر الثانوية لتطبيق WearArcLayout من خلال تغيير مَعلمات التنسيق لتوسيع نطاق MarginLayoutParams، أي WearArcLayout.LayoutParams لتوسيع نطاق android.view.ViewGroup.MarginLayoutParams. (I2cd88)
  • تغيير نوع الارتساء التلقائي في WearCurvedTextView إلى WearArcLayout.ANCHOR_CENTER (كان WearArcLayout.ANCHOR_START) ويعمل ذلك على تبسيط العقد بين تصميم القوس والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في الجزء العلوي من الشاشة، ويمكن لتخطيط القوس الرئيسي تدويره إلى الموضع المطلوب. (I105ff)

الإصدار 1.2.0-alpha03

2 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear:1.2.0-alpha03. يحتوي الإصدار 1.2.0-alpha03 على هذه عمليات التنفيذ.

الميزات الجديدة

حاوية تنسيق جديدة RejectibleFrameLayout لمعالجة زر الرجوع و/أو التمرير سريعًا للرفض، مخصصة للاستخدام ضمن نشاط يجب إضافة مستمع واحد على الأقل لاتخاذ إجراء بشأن رفض الطلب. يزيل المستمع عادةً طريقة عرض كاملة أو جزءًا من النشاط الحالي. setSquickErrorible(منطقية) & يتم توفير setBackButtonErrorible(منطقية) للتحكم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال تنسيق التصفّح السريع الحالي.

تتعامل التطبيقات المصغّرة المنحنية الآن مع أحداث اللمس. ستتلقى التطبيقات المصغّرة العادية داخل WearArcLayout جميع أحداث اللمس، التي يتم ربطها بمساحة الإحداثيات. يمكن أن يضبط WearCurvedTextView (داخل WearArcLayout أو لا) معالجات onClick وonLongClick.

أصبحت فئات الأنشطة الجارية الآن "إصدارات ذات إصدارات مميّزة" بدلاً من استخدام تسلسل أو إلغاء تسلسل مخصّص. أصبح الرمز الثابت ونية اللمس مطلوبَين الآن.

التغييرات في واجهة برمجة التطبيقات

  • السمة "sweepDegrees" في WearCurvedTextView، يتم فصلها إلى minSweepDegrees وmaxSweepDegrees لتوفير تنسيق أكثر مرونة لهذا التطبيق المصغّر.

الإصدار 1.2.0-alpha02

11 تشرين الثاني (نوفمبر) 2020

تم طرح androidx.wear:wear:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على عمليات التنفيذ هذه.

يضيف هذا الإصدار "واجهة برمجة تطبيقات الأنشطة الجارية" الجديدة للمرة الأولى. يمكن للمطوّرين استخدام واجهة برمجة التطبيقات هذه للإشارة إلى أنّ الأنشطة التي تمارسها لفترة طويلة، مثل تمرين لياقة بدنية أو جلسة تشغيل وسائط جارية. يتيح هذا الإصدار للمطوّرين تقديم إشعارات دورية للحالة، مثل "المسافة والوقت الذي يتم تشغيله" أو "تشغيل المقطع الصوتي الحالي" لعرضه على خلفية شاشة الساعة أو في مشغّل التطبيقات. وتستهدف هذه الوظيفة الأجهزة المستقبلية التي يتم تفعيل وظيفة النشاط المستمر فيها.

التغييرات في واجهة برمجة التطبيقات

  • واجهة برمجة تطبيقات جديدة للأنشطة الجارية، لا يمكن استخدامها على "الأجهزة غير المتوافقة". (I69a31)

الإصدار 1.2.0-alpha01

28 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تمت إضافة مكوّن WearCurvedTextView لكتابة النص المنحني بسهولة بعد انحناء أكبر دائرة يمكن تضمينها في العرض. مثال على الاستخدام:
<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

مثال على نص منحني في Android Wear

  • تمت إضافة حاوية WearArcLayout لتصميم عناصرها الفرعية واحدًا تلو الآخر على قوس في اتجاه عقارب الساعة أو عكس عقارب الساعة. يمكن أن تكون عناصر Android المصغّرة عادية أو "منحنية" التي تنفذ واجهة ArcLayoutWidget. مثال على الاستخدام:
<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

مثال على النص القوسي في Android Wear

(I536da)

إصدار Wear-Input 1.2

الإصدار 1.2.0-alpha02

29 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-input:1.2.0-alpha02 وandroidx.wear:wear-input-testing:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إعادة تسمية "disallowEmoji" إلى "setEmojisAllowed" في WearableRemoteInputExtender لاستخدامها لضبط ما إذا كان سيتم عرض خيار رسم الرموز التعبيرية. (I28393)

الإصدار 1.2.0-alpha01

15 أيلول (سبتمبر) 2021

تم طرح androidx.wear:wear-input:1.2.0-alpha01 وandroidx.wear:wear-input-testing:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • تم إظهار جميع ثوابت موقع الزر من WearableButtons. (Ibb12c)
  • تمت إضافة فئة WearableRemoteInputExtender التي يمكن استخدامها لإضافة تطبيقات Wear إضافية إلى android.app.RemoteInput. (I01903)

إصدار Wear-Input 1.1.0

الإصدار 1.1.0

18 آب (أغسطس) 2021

تم طرح androidx.wear:wear-input:1.1.0 وandroidx.wear:wear-input-testing:1.1.0. يحتوي الإصدار 1.1.0 على هذه عمليات التنفيذ.

تغييرات مهمة منذ الإصدار 1.0.0

  • تمت إضافة "RemoteInputIntentHelper".
    • يمكن استخدام هذه الفئة لإنشاء رسالة Intent للإدخال عن بُعد. ويمكن بعد ذلك استخدام ذلك لطلب إدخالات من المستخدمين في نشاط قابل للتخصيص.

الإصدار 1.1.0-rc01

4 آب (أغسطس) 2021

تم طرح androidx.wear:wear-input:1.1.0-rc01 وandroidx.wear:wear-input-testing:1.1.0-rc01. يحتوي الإصدار 1.1.0-rc01 على هذه عمليات التنفيذ.

ما مِن تغييرات في واجهة برمجة التطبيقات منذ androidx.wear:wear-input:1.1.0-beta01 وandroidx.wear:wear-input-testing:1.1.0-beta01

الإصدار 1.1.0-beta01

21 يوليو 2021

تم طرح androidx.wear:wear-input:1.1.0-beta01 وandroidx.wear:wear-input-testing:1.1.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha03. يحتوي الإصدار 1.1.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.1.0-alpha03

30 حزيران (يونيو) 2021

تم طرح androidx.wear:wear-input:1.1.0-alpha03 وandroidx.wear:wear-input-testing:1.1.0-alpha03. يحتوي الإصدار 1.1.0-alpha03 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي تسبَّب في رفض عمليات نوايا الإدخال عن بُعد، والتي تمت إضافة RemoteInput إليها من خلال RemoteInputHelper.putRemoteInputsExtra.

الإصدار 1.1.0-alpha02

18 أيار (مايو) 2021

تم طرح androidx.wear:wear-input:1.1.0-alpha02 وandroidx.wear:wear-input-testing:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • إنّ طُرق RemoteInputIntentHelper المُستخدَمة للحصول على محتوى إضافي أو إدراجه تمثّل العنوان والإلغاء والتأكيد والتصنيفات قيد التقدّم، تستخدم الآن CharSequence بدلاً من String لهذه التصنيفات. (I0e71f)

الإصدار 1.1.0-alpha01

27 كانون الثاني (يناير) 2021

تم طرح androidx.wear:wear-input:1.1.0-alpha01 وandroidx.wear:wear-input-testing:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • نقل فئة RemoteInputIntent من مكتبة الدعم القابل للارتداء إلى AndroidX وتتم إعادة تسمية الفئة التي تم نقلها لتصبح RemoteInputIntentHelper، وهي توفّر وظائف مساعدة لدعم الإدخالات عن بُعد من خلال بدء هدف. (I47cee)

إصدار Wear-Input 1.0.0

الإصدار 1.0.0

2 كانون الأول (ديسمبر) 2020

تم طرح androidx.wear:wear-input:1.0.0 وandroidx.wear:wear-input-testing:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الالتزام هذه.

هذا الإصدار مماثل للإصدار 1.0.0-rc01.

الميزات الرئيسية للإصدار 1.0.0

  • نقل وظائف WearableButtons من مكتبة الدعم القابل للارتداء إلى Jetpack

  • تمت إضافة androidx.wear.input.test.TestWearableButtonsProvider لتنفيذ androidx.wear.input.WearableButtonsProvider للمساعدة في تطبيقات الاختبار التي تم تطويرها باستخدام مكتبة androidx.wear:wear-input.

الإصدار 1.0.0-rc01

11 تشرين الثاني (نوفمبر) 2020

تم طرح androidx.wear:wear-input:1.0.0-rc01 وandroidx.wear:wear-input-testing:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

هذا الإصدار مماثل للإصدار 1.0.0-beta01.

الإصدار 1.0.0-beta01

28 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear-input:1.0.0-beta01 وandroidx.wear:wear-input-testing:1.0.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha01. يحتوي الإصدار 1.0.0-beta01 على عمليات التنفيذ هذه.

إصدار اختبار Wear-Input 1.0.0-alpha01

14 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear-input-testing:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة androidx.wear.input.test.TestWearableButtonsProvider لتنفيذ androidx.wear.input.WearableButtonsProvider للمساعدة في تطبيقات الاختبار التي تم تطويرها باستخدام مكتبة androidx.wear:wear-input. (I0ed0c)

إصدار Wear-Input 1.0.0-alpha01

2 أيلول (سبتمبر) 2020

تم طرح androidx.wear:wear-input:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

الميزات الجديدة

نقل وظائف WearableButtons من مكتبة الدعم القابل للارتداء إلى Jetpack سيتم توفير دعم إضافي للاختبار في مكتبة androidx.wear:wear-input-testing ضمن إصدار Jetpack التالي.

الإصدار 1.1.0

الإصدار 1.1.0

14 تشرين الأول (أكتوبر) 2020

تم طرح androidx.wear:wear:1.1.0. يحتوي الإصدار 1.1.0 على هذه عمليات التنفيذ.

التغييرات الرئيسية منذ الإصدار 1.0.0

  • تمت إضافة بادئة layout_ إلى سمة boxedEdges (الآن layout_BoxedEdges) للسمة BoxInsetLayout للالتزام باصطلاح التسمية في Android. سيؤدي ذلك إلى إزالة خطأ linter في "استوديو Android" لهذه السمات. (I4272f)
  • تمت إضافة السمة EXTRA_ANIMATION_DURATION_MILLIS الاختيارية إلى ConfirmationActivity للسماح بالمدة التي يتم فيها عرض مربّع حوار التأكيد. (adb83ce، b/143356547)
  • تم التعديل WearableActionDrawViewلتأخير تضخيم درج الإجراءات إلى أن يتم فتح الدرج لأول مرة. (I01026، b/163870541)

الإصدار 1.1.0-rc03

2 أيلول (سبتمبر) 2020

تم طرح androidx.wear:wear:1.1.0-rc03. يحتوي الإصدار 1.1.0-rc03 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تم حل مشكلة عدم عرض "درج الإجراءات" للمحتوى عند فتحه. (I01026، b/163870541)

الإصدار 1.1.0-rc02

24 حزيران (يونيو) 2020

تم طرح androidx.wear:wear:1.1.0-rc02. يحتوي الإصدار 1.1.0-rc02 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تمت إضافة بادئة layout_ إلى سمة boxedEdges (الآن layout_boxedEdges) للسمة BoxInsetLayout للالتزام باصطلاح التسمية في Android. سيؤدي ذلك إلى إزالة خطأ linter في "استوديو Android" لهذه السمات.

الإصدار 1.1.0-rc01

14 أيار (مايو) 2020

تم طرح androidx.wear:wear:1.1.0-rc01 بدون أي تغييرات منذ .1.0-beta01. يحتوي الإصدار 1.1.0-rc01 على هذه عمليات التنفيذ.

الإصدار 1.1.0-beta01

29 نيسان (أبريل) 2020

تم طرح androidx.wear:wear:1.1.0-beta01 بدون أي تغييرات منذ androidx.wear:wear:1.1.0-alpha01. يحتوي الإصدار 1.3.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.1.0-alpha01

نيسان (أبريل) 2020

تم طرح androidx.wear:wear:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة السمة EXTRA_ANIMATION_DURATION_MILLIS الاختيارية إلى ConfirmationActivity للسماح بالمدة التي يتم فيها عرض مربّع حوار التأكيد. (adb83ce و134523c وb/143356547)

إصلاح الأخطاء

  • تم التعديل WearableActionDrawViewلتأخير تضخيم درج الإجراءات إلى أن يتم فتح الدرج لأول مرة. (5cd32f7)