Wear

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
ارتداء 1.3.0 - - 1.4.0-alpha01
wear-input 1.1.0 - - 1.2.0-alpha02
wear-input-testing 1.1.0 - - 1.2.0-alpha02
wear-ongoing 1.0.0 - - 1.1.0-alpha01
wear-phone-interactions 1.0.1 - - 1.1.0-alpha05
wear-remote-interactions 1.1.0 - - -
تاريخ آخر تعديل على هذه المكتبة: 11 كانون الأول (ديسمبر) 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 من أداة معاينة أدوات Wear

الإصدار 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 وعمليات تنفيذ 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)
  • رسالة وصف المحتوى المحسّنة لعنصر ConfirmationOverlay (I0fdf8)
  • عدِّل ConfirmationOverlay باستخدام رموز أو تنسيق جديد. (If5b54)

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

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

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

  • Dae Gyu LEE (Samsung) - Avoid accidentally dismissing of fragments in SwipeDismissFrameLayout with a vertical fling (Idb6d8)

الإصدار 1.3.0-alpha01

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

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

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

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

Wear Ongoing & Interactions Version 1.1.0

الإصدار 1.1.0-alpha05

11 كانون الأول (ديسمبر) 2024

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-alpha05. يتضمّن الإصدار 1.1.0-alpha05 عمليات الربط هذه.

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

  • إصلاح خطأ يؤدي إلى حدوث أعطال عند التشغيل على نظام التشغيل Wear OS 5.1 (الإصدار 34 من واجهة برمجة التطبيقات) واستهداف إصدارات أحدث من حزمة تطوير البرامج (SDK) يجب تحديث التطبيقات إلى هذا الإصدار من المكتبة قبل تحديث targetSdkVersion إلى 35 أو إصدار أحدث.

الإصدار 1.1.0

11 كانون الأول (ديسمبر) 2024

تم إصدار androidx.wear:wear-remote-interactions:1.1.0. يتضمّن الإصدار 1.1.0 عمليات الربط هذه.

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

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

الإصدار 1.1.0-rc01

16 أكتوبر 2024

تم إصدار androidx.wear:wear-remote-interactions:1.1.0-rc01 بدون أي تغييرات منذ 1.1.0-beta01. يتضمّن الإصدار 1.1.0-rc01 عمليات الربط هذه.

الإصدار 1.1.0-beta01

24 تموز (يوليو) 2024

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

الإصدار 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)

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

  • أزِل الاعتماد على Guava من wear-remote-interactions واستخدِم بدائل أصغر حجمًا.

Wear-Phone-Interactions الإصدار 1.1.0-alpha03

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

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

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

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

Wear-Phone-Interactions الإصدار 1.1.0-alpha02

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

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

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

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

Wear-Phone-Interactions الإصدار 1.1.0-alpha01

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

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

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

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

Wear Ongoing & Interactions Version 1.0.0

Wear-Phone-Interactions الإصدار 1.0.1

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

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

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

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 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-Phone-Interactions Wear-Remote-Interactions Version 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)

Wear-Ongoing Version 1.1

الإصدار 1.1.0-alpha01

23 آب (أغسطس) 2023

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

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

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

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

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

Wear-Ongoing Version 1.0.0

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

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

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

  • ‫Wear Ongoing Activities API هي واجهة برمجة تطبيقات للمطوّرين، بما في ذلك المطوّرون التابعون لجهات خارجية، ويتم استخدامها لوضع علامة "نشاط جارٍ" على نشاطهم وتقديم المعلومات المطلوبة.
  • تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن أن تكون قيد التشغيل في الخلفية على الساعة (مثل التمارين والمكالمات والوسائط). في نظام التشغيل Wear 3، سيتم إبراز النشاط الذي تم الإعلان عنه على أنّه جارٍ من خلال رمز مصغّر مخصّص للتراكب على خلفية شاشة الساعة وعرض مختلف في مشغّل التطبيقات.
  • لمزيد من المعلومات، يُرجى الاطّلاع على دليل النشاط الجاري على Wear OS.

Wear-Phone-Interactions Wear-Remote-Interactions Version 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)

Wear-Ongoing Version 1.0.0-rc01

18 آب (أغسطس) 2021

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

Wear-Ongoing Version 1.0.0-beta01

4 آب (أغسطس) 2021

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

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

  • أصبحت بعض وظائف الإعداد في OngoingActivity.Builder تقبل الآن دالّة null من أجل توفير التناسق والاتساق لوظائف الإعداد والحصول (I17ee5).

Wear-Phone-Interactions الإصدار 1.0.0-alpha07

4 آب (أغسطس) 2021

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

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

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

Wear-Remote-Interactions الإصدار 1.0.0-alpha06

4 آب (أغسطس) 2021

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

Wear-Phone-Interactions الإصدار 1.0.0-alpha06

21 تموز (يوليو) 2021

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

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

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

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

  • لقد سهّلنا استخدام واجهة برمجة التطبيقات Authentication API من خلال إضافة المزيد من المَعلمات الموثَّقة واستخدام السمات كلما أمكن ذلك. (I12287)

Wear-Phone-Interactions الإصدار 1.0.0-alpha05

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

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

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

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

Wear-Ongoing Version 1.0.0-alpha06

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

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

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

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

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

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

Wear-Ongoing Version 1.0.0-alpha05

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

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

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

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

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

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

Wear-Ongoing Version 1.0.0-alpha04

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

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

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

  • في OngoingActivity، تمّ الآن استبدال الطرق من ExistingOngoingActivity باسم recoverOngoingActivity.
  • تتضمّن OngoingActivity الآن مجموعة كاملة من وظائف الحصول، وهي نفسها الوظائف التي كانت متاحة سابقًا في OngoingActivityData فقط. (I0ee4d)

Wear-Remote-Interactions الإصدار 1.0.0-alpha05

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)

Wear-Phone-Interactions الإصدار 1.0.0-alpha04

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

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

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

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

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

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

Wear-Remote-Interactions الإصدار 1.0.0-alpha03

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

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

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

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

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

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

Wear-Ongoing Wear-Phone-Interactions Version 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. يتم توفير فئات معالجات ومساعِدين إضافية للتواصل.
  • يمكن الآن ربط الأنشطة الجارية بإشعار يتضمّن علامة، وذلك باستخدام الدالة الإنشائية الجديدة OngoingActivity.Builder.

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

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

Wear-Remote-Interactions الإصدار 1.0.0-alpha02

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

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

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

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

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

  • نقل فئة PlayStoreAvailability من مكتبة Wearable Support Library إلى 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 على هذه المراجعات.

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

  • تمت إضافة دعم لحالات أكثر تعقيدًا. وتتألف من نموذج (أو عدة نماذج) وسلسلة من الأجزاء التي سيتم استخدامها لملء العناصر النائبة للنموذج. تتضمّن OngoingActivityStatus الآن طريقة ثابتة لإنشاء حالات بسيطة تتضمّن جزءًا واحدًا فقط (نص أو موقّت)، و"أداة إنشاء" لإنشاء حالات أكثر تعقيدًا. (I1fe81)
  • نقل فئتَي BridgingManager وBridgingConfig من مكتبة 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 على هذه المراجعات.

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

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

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

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

  • أنشئ مكتبة دعم جديدة تحتوي على فئات تتيح التفاعلات بين الأجهزة القابلة للارتداء والهواتف. تتم تعبئة هذا الحقل في البداية بفئات تم نقلها من مكتبة دعم الأجهزة القابلة للارتداء. (I9deb4)

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

Wear Complications and Watchface 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 لـ complicationSlotsState وComplicationsPreviewData وComplicationsDataSourceInfo. (I761d9)
  • EditorSession#userStyle هو الآن MutableStateFlow<UserStyle> (I32ca9).
  • يستخدم EditorSession.createOnWatchEditorSession الآن مراقبًا لمراحل النشاط ويتم إغلاقه تلقائيًا عند رصد onDestroy. بالإضافة إلى ذلك، لا تتطلّب createOnWatchEditorSession الآن سوى تمرير النشاط. تم أيضًا تطبيق تغييرات مماثلة على ListenableEditorSession. (Ic6b7f)
  • تمت إعادة إنشاء CustomValueUserStyleSetting كجزء من واجهة برمجة التطبيقات المتاحة للجميع. (I2e69a)
  • يكتسب UserStyle الآن القيمة من Map<UserStyleSetting, UserStyleSetting.Option> ويُعرِض MutableUserStyleSetting#put IllegalArgumentException إذا لم يكن الإعداد مضمّنًا في المخطّط أو إذا لم يتطابق الخيار مع الإعداد. (Iba40f)

الإصدار 1.0.0-alpha21

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

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

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

  • تستخدم الآن جميع واجهات برمجة التطبيقات العامة لخلفيات شاشة الساعة والعملاء والمحرِّرين والعناصر المخصّصة واجهة java.time.Instant للوقت بدلاً من Long، ونتيجةً لذلك، ارتفع الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 26. (I3cd48)
  • تستخدم واجهات برمجة التطبيقات الخاصة بخلفية شاشة الساعة والعناصر المخصّصة الآن واجهة برمجة التطبيقات ZonedDateTime غير القابلة للتغيير بدلاً من Calendar. (I25cf8)
  • تم الآن إعداد ComplicationSlots باستخدام NoDataComplicationData، وأصبحت ComplicationSlot.complicationData تحتوي دائمًا على قيمة، ولم تعُد CanvasComplicationDrawable.complicationData قابلة للحذف. (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)
  • تم استبدال RenderParameters.pressedComplicationSlotIds بـ RenderParameters.lastComplicationTapDownEvents الذي يعرِض فئة TapEvent الجديدة التي تحتوي على ثلاثية من إحداثيات x وy للنقرة بالبكسل والطابع الزمني. تم استبدال WatchFace.TapListener.onTap بـ onTapEvent(@TapType tapType: Int, tapEvent: TapEvent). بالإضافة إلى ذلك، تمت إزالة InteractiveWatchFaceClient.displayPressedAnimation. (Id87d2)
  • تمت إضافة تعليق توضيحي لسلاسل المحادثات الصريحة لـ setImportantForAccessibility (I990fa)
  • تم نقل ComplicationSlotBoundsType إلى androidx-wear-watchface.ComplicationSlotBoundsType في wear/wear-watchface. (I09420)
  • لقد أضفنا إمكانية تمرير أرقام تعريف موارد السلاسل إلى UserStyleSetting وOptions. وهذه هي الطريقة المُقترَحة الآن لإنشاء هذه العناصر. (I03d5f)
  • تم فرض حدود على الحد الأقصى لحجم الأسلاك في مخطّط UserStyle. يجب أيضًا ألا يزيد حجم الرموز في المخطّط عن 400 × 400 بكسل. (I3b65b)
  • أضفنا فئة MutableUserStyle للسماح بإجراء تغييرات على نُسخ UserStyle (I95a40).
  • تمت إعادة تسمية ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient إلى ListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient. (I64ce2)
  • لقد عدّلنا EditorState.previewComplicationsData لكي لا يحتوي إلا على بيانات الملحقات المفعّلة، وأضفنا EditorSession.DEFAULT_PREVIEW_TIME_MILLIS الذي يطلب عند تمريره إلى renderWatchFaceToBitmap أو PreviewScreenshotParams عرض المعاينة باستخدام وقت المعاينة التلقائي لخلفية شاشة الساعة. (If7b3c)
  • لقد أزلنا وظائف إنشاء UserStyleSetting التي تأخذ 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، وتمّت إعادة تسمية جميع الصفوف التي تحتوي على Provider في اسمها بالطريقة نفسها. (Iaef0b)
  • تم نقل CanvasComplication.isHighlighted إلى RenderParameters.pressedComplicationSlotIds، وهذه خطوة نحو جعل CanvasComplication بدون حالة. لدعم هذا التغيير، يقبل العنصر CanvasComplication.render الآن أيضًا العنصر slotId كمَعلمة، ونقوم الآن بإرسال العنصر ComplicationSlot إلى العنصر GlesTextureComplication. (I50e6e)
  • أضفنا headlessDeviceConfig إلى EditorRequest، وإذا لم تكن هذه المَعلمة فارغة، يتم استخدامها لإنشاء مثيل بدون واجهة مستخدم لدعم EditorSession بدلاً من التصرّف في المثيل التفاعلي. يتيح ذلك استخدام المحرِّر لخلفية شاشة ساعة غير الخلفية الحالية. (I0a820)
  • أضفنا WatchFaceMetadataClient تجريبيًا يتيح استرجاع البيانات الوصفية الثابتة لخلفية شاشة الساعة بكفاءة، مثل UserStyleSchema والتفاصيل الثابتة عن ComplicationSlots. (I6bfdf)
  • لقد أعادنا تسمية CanvasRenderer.uiThreadInit إلى init. (I6fff9)
  • أضفنا مَعلمة PreviewScreenshotParams وهي مَعلمة جديدة اختيارية لطلب المحرِّر تُوجّه جلسة المحرِّر لأخذ لقطة شاشة لمعاينة عند الحفظ باستخدام هذه المَعلمة. تظهر صورة المعاينة على 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 حسب الاستخدام. تمت إعادة تسمية الفئات التي تستخدم Complication بالطريقة نفسها، مثل ComplicationsManager التي أصبحت الآن تُعرف باسم ComplicationSlotsManager. (I4da44)
  • في GlesRenderer، تم استبدال makeUiThreadContextCurrent وmakeBackgroundThreadContextCurrent بـ runUiThreadGlCommands وrunBackgroundThreadGlCommands اللذان يقبلان Runnable. لا تكون هذه الدوالّ مطلوبة إلا إذا كنت بحاجة إلى إجراء طلبات GL خارج عمليات التقديم وrunBackgroundThreadGlCommands وonUiThreadGlSurfaceCreated. هذا مطلوب لأنّه يمكن أن يكون هناك عدة عناصر GlesRenderer لكل منها سياقاتها الخاصة في العملية نفسها، والتي قد تكون من خلفيات شاشة ساعة مختلفة. بالإضافة إلى ذلك، تتم الآن مزامنة الوصول إلى سياق 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 الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. وهذا أسرع من إنشاء مثيل بدون واجهة مستخدم لأنّه لا يحتاج إلى بدء تشغيل خلفية شاشة الساعة بالكامل لتنفيذ الطلب.

أخيرًا، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح إنشاء عناصر عرض CanvasComplication بشكل غير متزامن.

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

  • تم استبدال @TargetApi بـ @RequiresApi. (I0184a وb/187447093 وb/187447094)
  • لقد طرحنا WatchFaceControlClient.getDefaultProviderPoliciesAndType الذي يعرض خريطة لرموز Complication Ids إلى DefaultComplicationProviderPolicies وComplicationType التلقائي. يتم استخدام مسار سريع قدر الإمكان لتجنُّب إنشاء خلفية شاشة الساعة بالكامل. لتسهيل ذلك، كان علينا تغيير واجهة برمجة التطبيقات WatchFaceService API باستخدام طريقتَين جديدتَين هما createUserStyleSchema وcreateComplicationsManager، ويتم تمرير نتائجهما إلى createWatchFace. بالإضافة إلى ذلك، يتم الآن إنشاء الإضافات باستخدام CanvasComplicationFactory الذي يتيح إنشاء عناصر عرض CanvasComplication بشكل غير متزامن. (Iad6c1)
  • لقد أزلنا MOST_RECENT_APP من SystemProviders. (I3df00)
  • أصبحت ObservableWatchData الآن فئة مختومة. (Ic940d)
  • يتم الآن استدعاء CanvasComplicationFactory.create (الذي يكون مرتبطًا عادةً بعمليات الإدخال/الإخراج) في سلسلة مهام في الخلفية لكلّ شاشة معلومات مصغّرة قبل بدء عرض سلسلة مهام واجهة المستخدم. هناك حاجز ذاكرة بين الإنشاء والعرض، لذا لا يلزم استخدام عناصر أساسية خاصة لإنشاء مؤشرات الترابط. (Ia18f2)
  • يتم الآن إنشاء خلفية شاشة الساعة في سلسلة مهام في الخلفية على الرغم من أنّه يتم تنفيذ جميع عمليات التقديم في سلسلة مهام واجهة المستخدم، ويتوافق GlesRenderer مع سياقَين مرتبطَين لدعم ذلك. قد يتم حلّ WatchFaceControlClient.createHeadlessWatchFaceClient وWatchFaceControlClient.getOrCreateInteractiveWatchFaceClient قبل اكتمال WatchFaceService.createWatchFace. سيتم حظر طلبات البيانات اللاحقة من واجهة برمجة التطبيقات إلى أن تكتمل عملية إعداد خلفية شاشة الساعة. (Id9f41)
  • لم تعُد السمتَان EXPANSION_DP وSTROKE_WIDTH_DP مرئيتَين في api.txt. (I54801)
  • لقد جعلنا EditorSession.createOnWatchEditingSession يُرسِل TimeoutCancellationException في حال حدوث خطأ بدلاً من إرسال جلسة فارغة. بالإضافة إلى ذلك، أصبحت القيمة المعروضة في 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.

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

  • أصبحت السمتَان eglContext وeglDisplay في GlesRenderer غير قابلتَين للحذف. يتم الآن الإبلاغ عن أي أخطاء في 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)

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

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

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

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

  • يمكن أن تتضمّن خلفيات شاشة الساعة عناصر مرئية مهمة غير الوقت والعناصر المعقدة. لتوفير إمكانية استخدام قارئ الشاشة لهذه الميزة، يمكن الآن لخلفية شاشة الساعة تحديد تصنيفات ContentDescriptionLabels لتسهيل الاستخدام من خلال سمة additionalContentDescriptionLabels في عنصر العرض. بالإضافة إلى ذلك، تمّت إضافة accessibilityTraversalIndex إلى التعقيدات للتحكّم في ترتيب ContentDescriptionLabels. ويمكن تعديل ذلك باستخدام 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.comComputes وأنشأنا برامج تضمين مقابلة في AndroidX حسب الحاجة. (I7bd50)
  • تمت إعادة تسمية الطريقة في TimeDifferenceComplicationText.Builder من setMinimumUnit إلى setMinimalTimeUnit. (I20c64)
  • لقد جعلنا حقل contentDescription في ShortTextComplicationData.Builder وLongTextComplicationData.Builder وRangedValueComplicationData.Builder إلزاميًا ليتم تمريره في أداة الإنشاء. (I8cb69)
  • لقد أعادنا تسمية ComplicationProviderService.onComplicationUpdate إلى onComplicationRequest و أدرجنا مَعلمتَي id وtype لهذه الطريقة في بيانات ComplicationRequest. تمت إعادة تسمية المستمع المقابل إلى ComplicationRequestListener وطريقة ComplicationRequestListener.onComplicationData. (Iaf146)
  • لقد أزلنا الطريقة isActiveAt من ComplicationData و عرضنا الحقل validTimeRange بدلاً منها. يمكن استبدال دعوة الأسلوب هذه بـ validTimeRange.contains. (I65936)
  • لقد غيّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ملف ComplicationType بدلاً من ملف int. (Idb5ff)
  • تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
  • أصبحت GlesRender.makeContextCurrent علنية الآن. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء مكالمات gl خارج render وonGlContextCreated، ولأنّه قد يكون هناك سياق تفاعلي وسياق بدون رأس، من الضروري إجراء هذه المكالمات. (I8a43c)
  • يُعرِض WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient الآن ServiceStartFailureException إذا تعرّضت خلفية شاشة الساعة لخطأ أثناء الإعداد. بالإضافة إلى ذلك، تُرسِل WatchFaceService الآن استثناءً إذا استغرقت createWatchFace أكثر من 6 ثوانٍ. (I59b2f)
  • لقد أزلنا سمة id غير المستخدَمة للموقع الإلكتروني GlesTextureComplication. (I28958)
  • يمكن الآن لخلفية شاشة الساعة تحديد ContentDescriptionLabels لسهولة الاستخدام من خلال خاصية additionalContentDescriptionLabels في Renderer. بالإضافة إلى التحكّم في ترتيب ContentDescriptionLabels، تمت إضافة accessibilityTraversalIndex إلى التعقيدات. ويمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting. (Ib7362)
  • توسيع المستندات حول معالجة أحداث اللمس في خلفية شاشة الساعة (Iaf31e)

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

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

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

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

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

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

على محرِّري خلفيات شاشة الساعة إبراز أجزاء من خلفية شاشة الساعة للمساعدة في توضيح جانب الساعة الذي يتم ضبطه. لقد وسّعنا نطاق RenderParameters للسماح بتمييز الأنماط والإضافات. هناك طبقة اختيارية جديدة من HighlightLayer مخصّصة لتطبيق تأثير التمويه على خلفية شاشة الساعة مع شفافية ألفا (يمكن أن تُجري واجهات برمجة التطبيقات لأخذ لقطات الشاشة هذا التمويه نيابةً عنك، أو يمكنك توفير طبقة HighlightLayer بنفسك للحصول على أقصى قدر من المرونة). على سبيل المثال، لنفترض أنّ لديك نمطًا يتيح لك ضبط مظهر عقارب الساعة، ويمكن لبرنامج الربط في renderHighlightLayer رسم مخطط حولها.

لتعزيز إتاحة ميزة "موفِّر المكوّنات الإضافية" للوصول، جعلنا حقل contentDescription في PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder و SmallImageComplicationData.Builder مَعلمة واجبة في أسلوب الإنشاء. تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة المضاعفات على الحواف (المرسومة حول حافة الشاشة). تُترك عملية عرض الإضافات على الحواف واختبار مدى توفّرها لخلفية شاشة الساعة. لا يتوفّر اختبار نتائج الإعلانات على Edge من "أداة التعديل المصاحبة".

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

  • تمت إضافة البادئة PROVIDER_ إلى الثوابت في SystemProviders. (I1e773)
  • لقد جعلنا حقل contentDescription في PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder و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 طريقة جديدة مجردة لعرض الطبقة المميّزة لعرض أي تمييز يطلبه المحرِّر. تمت إعادة تسمية Layer إلى WatchFaceLayer. (Ic2444)
  • تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة الإضافات على الحواف. تُترك عملية عرض الإضافات على الحواف واختبار مدى توفّرها لخلفية شاشة الساعة. لا يتوفّر اختبار النتائج من داخل المحرّرات. (Ia6604)
  • بالنسبة إلى DoubleRangeUserStyleSetting وLongRangeUserStyleSetting: أصبحت defaultValue وmaximumValue وminimumValue الآن سمات kotlin. بالإضافة إلى ذلك، تمّت إزالة دوال UserStyleSetting.Option مثل toBooleanOption وtoCoplicationOptions و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. بالإضافة إلى ذلك، أصبحت القيمة CustomValueUserStyleSetting.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)
  • تمت إعادة تسمية takeWatchfaceScreenshot ليصبح renderWatchFaceToBitmap، وتمت إعادة تسمية takeComplicationScreenshot ليصبح 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 الآن ClientDisconnectListener و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)
  • لقد أزلنا عمليات تحويل Binder المختلفة الخاصة بتطبيق Wear وWatchface وClient، ومن المفترض أن تكون ضرورية. (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 على هذه المراجعات.

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

  • أصبح من الممكن الآن إنشاء عناصر open gl (مثل الأشكال) أثناء WatchFaceService.createWatchFace لأنّ GlesRenderer يتطلّب الآن طلبًا صريحًا لـ initOpenGLContext يمكن تنفيذه داخل createWatchFace.

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

  • كان IdAndComplicationData غير ملائم بعض الشيء، لذا تمت إزالته من واجهة برمجة التطبيقات المتاحة للجميع. وتمّت إعادة صياغة الفئات والواجهات التي استخدمتها. (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 وشاشة الساعة. أصبح بإمكان المحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل ميزة أو إيقافها (enabled = initiallyEnabled بالإضافة إلى أي إلغاء من ComplicationsUserStyleSetting). بالإضافة إلى ذلك، EditorService.closeEditorيسمح لـ SysUI بإغلاق محرِّر خلفية شاشة الساعة عن بُعد إذا لزم الأمر.
  • بالإضافة إلى ذلك، InteractiveWatchFaceWcsClient.setUserStyle مع أمر أكثر فعالية updateInstance الذي: يغيّر رقم تعريف المثيل ويضبط النمط ويزيل التعقيدات دفعة واحدة.

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

  • تمت إضافة TraceEvents إلى مكتبات خلفيات شاشة الساعة. (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.

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

  • لقد أزلنا إمكانية النقر مرّتين على التطبيقات المصغّرة لتشغيل أداة اختيار مقدّم الخدمة، لأنّ هذه الميزة لم تكن شائعة في خلفيات الشاشة ولم تكن تُسهّل تنفيذ واجهة المستخدم. (I3ef24)
  • قد تُعرِض طرق ProviderInfoRetriever استثناء ServiceDisconnectedException في حال إغلاق الرابط بشكل غير متوقّع. (Ib2cc4)
  • اعتبارًا من Android 11 فصاعدًا، هناك قيود على حالات تشغيل ProviderChooser، بالإضافة إلى أنّنا نريد إنشاء المحرّرين باستخدام wear-watchface-editor الجديد، لذا تتم إزالة ComplicationHelperActivity من واجهة برمجة التطبيقات المتاحة للجميع. (Ib19c1)
  • أزِل الطرق الثابتة ComplicationText واستخدِم أدوات الإنشاء. (Ibe399)
  • لقد طرحنا لفائف guava ListenableFuture للطرق المعلّقة المختلفة في مكتبة خلفيات شاشات الساعة. (I16b2c)
  • لتوضيح واجهة برمجة التطبيقات، أضفنا عنصر إنشاء ثانويًا إلى RenderParameters لا يتطلّب درجة لون، وذلك لاستخدامه مع LayerModes بخلاف LayerMode.DRAW_OUTLINED. (I497ea)
  • في السابق، كان ListUserStyleSetting مختلفًا عن العنصر الآخر لأنّه كان يحتوي على مَعلمة تلقائية. الآن، تأخذ جميع الدوالّ الإنشائية لفئة فرعية StyleSetting القيمة التلقائية في آخر خطوة. (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 الآن دالة تعليق، ما يعني أنّه لم يعُد على خلفية شاشة الساعة حظر سلسلة مهام واجهة المستخدم أثناء انتظار عمليات الإدخال والإخراج. وبالمثل، wear-watchface-editor وwear-complications-data

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

  • أزِل فئة PhotoImage واستخدِم Icon مباشرةً. (I8a70b)
  • اعرض النطاق الزمني الصالح لـ ComplicationData. (I91366)
  • اجعل السمات التي تشبه الصور أكثر وضوحًا. (I81700)
  • تمّت إعادة صياغة wear-watchface-editor وwear-complications-data لاستخدام دوالّ التعليق بدلاً من الدوالّ المتعدّدة المهام. ستتوفّر لاحقًا حِزم Rx java وFuture compat. (If3c5f)
  • يُعرِض ProviderInfoRetriever الآن PreviewNotAvailableException إذا تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو عدم توفّر واجهة برمجة التطبيقات. (I4964d)
  • أصبحت WatchFaceControlService::createWatchFaceControlClient الآن وظيفة معلّقة، وتم استبدال getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باسم getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الذي يعرض القيمة Deferred<InteractiveWatchFaceWcsClient>. ستتوفّر لاحقًا حِزم RX java وFuture compat. (I5d461)
  • أعِد تسمية CATEGORY_PROVIDER_CONFIG_ACTION إلى CATEGORY_PROVIDER_CONFIG. (I7c068)
  • يُرجى العِلم أنّ createOnWatchEditingSession أصبحت الآن وظيفة معلّقة لأنّ خلفية شاشة الساعة لا تكون متاحة أحيانًا إلا بعد وقت قصير من بدء نشاط المحرِّر. (Ida9aa)
  • أصبحت WatchFaceService.createWatchFace الآن دالة تعليق تتيح الإعداد غير المتزامن، وكان عليك في السابق حظر سلسلة التعليمات الرئيسية. (If076a)
  • يتضمّن UserStyle الآن عامل تشغيل مصفوفة، وقد أضفنا أدوات مساعدة لتحويل البيانات إلى UserStyle.Option. (I35036)
  • لقد أصلحنا خطأ في تنسيقات بيانات UserStyle التي تؤدي إلى تغيير بعض واجهات برمجة التطبيقات المخفية غير المستقرة. (I8be09)
  • أضفنا CustomValueUserStyleSetting الذي يتيح لك تخزين سلسلة واحدة خاصة بالتطبيق ضمن UserStyle. سيتجاهل محرّرو خلفيات شاشة الساعة التلقائية هذه القيمة. (Ic04d2)
  • لا يتم تمرير InstanceID في إضافات النية لنظام التشغيل R والإصدارات الأقدم من Android WearOS التي لا يمكننا ترقيتها. ولتفعيل ذلك، نسمح الآن بأن يكون InstancID فارغًا. (Id8b78)
  • يتضمّن EditorRequest الآن اسم مكوّن المحرِّر الذي تم ضبطه كمكوّن في WatchFaceEditorContract.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 على هذه المراجعات.

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

  • لقد طرحنا مكتبة جديدة باسم wear/wear-watchface-editor تتيح لمطوّري خلفيات شاشات الساعة والمصنّعين الأصليين للأجهزة إمكانية إنشاء محرِّر للأنماط والإضافات. سيرسل SysUI طلبًا إلى خلفية شاشة الساعة التي ستستخدم فئة EditorSession الجديدة للوصول إلى تفاصيل خلفية شاشة الساعة وتسجيل النتيجة من خلال 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 إلى RenderParameters.selectedComplicationId الذي يرسم تمييزًا على المقياس المخصّص بالإضافة إلى مخطط. (I90a40)
  • يمكن الآن حلّ مستقبل WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient باستخدام ServiceStartFailureException إذا توقّفت الخدمة أثناء انتظار إنشاء خلفية شاشة الساعة. (I0f509)
  • أصبحت EditorSession.complicationPreviewData الآن عنصر ListenableFuture لأنّ جلب هذه البيانات عملية غير متزامنة. (Iead9d)

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

  • سنزيل الحقول غير المستخدَمة من ComplicationOverlay مع إبقاء enabled وcomplicationBounds. (I17b71)

الإصدار 1.0.0-alpha05

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

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

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

غالبًا ما تتيح خلفيات الشاشة على الساعة عددًا من عمليات ضبط التطبيقات المصغّرة مع أعداد مختلفة من التطبيقات المصغّرة المعروضة. لتسهيل عملية الإعداد، أصبح بإمكانك الآن استخدام ميزة "التطبيقات المصغّرة" المتوقفة عن العمل في البداية من خلال الاتصال بـ setEnabled(false) في أداة الإنشاء. ويمكن تفعيلها لاحقًا من خلال ComplicationsUserStyleSetting.

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

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

الإصدار 1.0.0-alpha04

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

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

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

  • تتيح الآن مكتبة خلفيات شاشة الساعة على WearOS ضبط الحدود لكل نوع. على سبيل المثال، يمكنك التبديل إلى مربّع حدود واسع لـ ComplicationType.LONG_TEXT مع استخدام مربّع حدود أصغر للأنواع الأخرى.

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

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

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

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

الإصدار 1.0.0-alpha03

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

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

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

تحتوي فئة Complication الآن على سمة compicationData تتيح لوجوه الساعة مراقبة تغييرات ComplicationData. يتيح ذلك تغيير سمات المقياس المضمّن استنادًا إلى نوعه.

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

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

  • تمّت إعادة تسمية BACKGROUND_IMAGE إلى PHOTO_IMAGE مع الصفوف ذات الصلة. لا يتم استخدام هذا النوع من التعقيدات حصريًا للخلفيات، لذا تم تغيير الاسم. (I995c6)
  • تم التعليق التوضيحي على DefaultComplicationProviderPolicy بشكل صحيح باستخدام IntDefs. (I3b431)
  • لم تعُد فئة TimeDependentText المخفية معروضة من خلال ContentDescriptionLabel، وبدلاً من ذلك، نضيف وسيط وصول للحصول على النص في وقت محدّد. (Ica692)
  • أصبح المُنشئ ObservableWatchData داخليًا الآن. (I30121، b/173802666)
  • تحتوي إضافة Complication الآن على compicationData التي تتيح لخلفيات شاشة الساعة مراقبة تغييرات ComplicationData. يحتوي المكوّن أيضًا على طلب isActiveAt جديد يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي محتوى في التاريخ والوقت المقدَّمين. (Ic0e2a)
  • لم تعُد القيمة الفارغة SharedMemoryImage متوفّرة في واجهة برمجة التطبيقات المتاحة للجميع. (I7ee17)
  • يحتوي WatchFace.overridePreviewReferenceTimeMillis الآن على تعليق توضيحي IntRange وتحمل دالتا الحصول على القيمة وضبطها اسمَين متّسقَين. (Ia5f78)
  • تم إنشاء Complication.Builder الآن من خلال Complication.createRoundRectComplicationBuilder أو Complication.createBackgroundComplicationBuilder للتوضيح (I54063)
  • تمت إضافة WatchFace.TapListener الذي يسمح لخلفية شاشة الساعة برصد النقرات التي لا تستهلكها الإضافات. (Ic2fe1، b/172721168)
  • تتيح ميزة WatchFace الآن عددًا متغيرًا من اللقطات في الثانية من خلال ضبطها على Renderer.interactiveDrawModeUpdateDelayMillis. يمكن أن يساعد ذلك في الحفاظ على عمر البطارية من خلال وضع السكون عندما لا تكون الصورة متحركة. (I707c9)
  • لم تعُد WatchFace.Builder مطلوبة، وتم نقل invalidate() وinteractiveUpdateRateMillis إلى Renderer. (I329ea)
  • لتحسين إمكانية التشغيل التفاعلي مع Java، تمت إعادة تسمية وظائف الحصول على السمات المنطقية في WatchState (I6d2f1).
  • تمت إعادة تسمية TapListener إلى TapCallback وInvalidateCallback إلى InvalidateListener من أجل الاتساق. (I9414e)
  • تم نقل خيارات أسلوب خلفية شاشة الساعة في Wear 2.0 إلى فئة خاصة بها من أجل الوضوح. تتضمّن الآن أدوات الضبط في WatchFace.Builder أدوات الحصول على فئة WatchFace متناظرة. (Iefdfc)
  • تمت إضافة InteractiveWatchFaceWcsClient وWatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient اللذان يحصلان على مثيل حالي أو ينشئانه بعد أن تتصل خدمة خلفية الشاشة وتُنشئ المحرّك. (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 لنظام التشغيل WearOS إلى androidx ComplicationType. (I4dd36)
  • أضِف مَعلمة highlightedComplicationId اختيارية إلى RenderParameters تتيح لك طلب تمييز شاشة معلومات واحدة في لقطات الشاشة. (I66ce9)
  • ComplicationProviderService لاستخدام واجهة برمجة التطبيقات الجديدة لتطبيق الملحقات من أجل الاتساق (Id5aea)
  • تحصل "getPreviewReferenceTimeMillis" الآن على أوقات مرجعية من "DeviceConfig". (I779fe)
  • تبسيط سطح Renderer API، يمكن استخدام 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-complication-data API. (I7c268)
  • يجب إضافة البادئة is بدلاً من get إلى الدوال التي تعرض قيمًا منطقية (If36ff).
  • تنصح واجهة برمجة التطبيقات بتجنُّب استخدام العنصر protected، لذا تم إعادة صياغة هذه الفئة لقبول المَعلمات من خلال الدالة الإنشائية. (I61644)
  • أعِد تسمية setBackgroundComplication لزيادة الوضوح. (I96fe3)
  • استخدام سمات Kotlin لواجهة ComplicationDrawable التي تم تمييزها وبياناتها (I4dcc8)
  • بدلاً من ComplicationRenderer.InvalidateCallback، نضيف Complication#invalidate()‎ (I4f4c6).
  • يتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport، وتمّت إزالتها هنا. (Ib425c)
  • تمت إعادة تسمية بعض طرق إنشاء خلفية شاشة الساعة للتأكيد على طبيعتها القديمة في Wear OS 2.0. (Idb775)
  • أول إصدار تجريبي من واجهة برمجة التطبيقات المعنيّة بواجهة wear/wear-watchface (Id3981)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (Ie9fe6)
  • إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle للحفاظ على الاتساق (I27f7a)
  • إضافة تعليقات توضيحية غير متوفّرة لطرق ComplicationStyle (I838fd)
  • لا تتضمّن هذه المكتبة واجهة برمجة تطبيقات عامة (I88e2b).
  • أصبحت الآن جميع فئات خيارات فئة الأنماط نهائية بشكل صحيح. (Ib8323)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات. (I27c85)

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

  • تم تغيير ComplicationProviderService لتوفير طريقة getComplicationPreviewData صريحة. (I4905f)
  • تم تفعيل فحص lint لواجهة برمجة التطبيقات لـ MissingGetterMatchingBuilder في androidx (I4bbea، b/138602561)
  • إعادة تسمية wear-complications-rendering (Ifea02)
  • أصبحت أسماء فئات الأنماط الآن سلاسل علامات (I28990).
  • استبدال Override (إلغاء) بـ Overlay (تراكب) لمطابقة اصطلاحات تسمية المظاهر والأنماط الحالية (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

  • تمت إضافة حاوية تنسيق جديدة، وهي DismissibleFrameLayout، التي تتعامل مع إغلاق التطبيق باستخدام زر الرجوع و/أو التمرير سريعًا للأعلى أو للأسفل، وهي مخصّصة للاستخدام داخل نشاط. يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. سيزيل المستمع عادةً عرضًا أو جزءًا يحتويان على العنصر من النشاط الحالي. يتم توفير setSwipeDismissible(boolean) وsetBackButtonDismissible(boolean) للتحكّم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.

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

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

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

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

  • تم إصلاح الخطأ الذي كان يتسبب في تعطُّل ConfirmationActivity في حال عدم تقديم رسالة. (Ie6055)

  • تم إصلاح خطأ كان يؤدي إلى اطّلاع WearableDrawerLayout على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (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 على هذه المراجعات.

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

  • تم إصلاح الخطأ الذي كان يتسبب في تعطُّل ConfirmationActivity في حال عدم تقديم رسالة. (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 على هذه المراجعات.

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

  • تم إصلاح خطأ كان يؤدي إلى اطّلاع WearableDrawerLayout على جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (I24c7f)

الإصدار 1.2.0-alpha10

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

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

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

  • يُحسِّن الإصدار Alpha10 من إمكانية الوصول إلى النص المنحني وArcLayouts. تمت أيضًا إضافة بعض عمليات إعادة التسمية البسيطة في DismissibleFrameLayout للمساعدة في توضيح واجهة برمجة التطبيقات.

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

  • تمت إعادة تسمية الطرق التالية في الإصدار 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 على هذه المراجعات.

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

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

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

  • إيقاف ميزة إغلاق المحتوى باستخدام زر الرجوع تلقائيًا في Dismissible FrameLayout لأنّ التمرير سريعًا لإغلاق المحتوى يظلّ هو الطريقة الرئيسية للرجوع إلى شاشة ملء الشاشة على الأجهزة القابلة للارتداء (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)
  • OngoingActivity
    • يمكن الآن ضبط الفئة عند إنشاء OngoingActivity، مثل OngoingActivitiy.Builder.getCategory(String).
    • تتضمّن OngoingActivityData الآن طابعًا زمنيًا لوقت إنشاء OngoingActivity‏: OngoingActivityData.getTimestamp()
    • (I91cb4)
  • تمت إضافة إمكانية ضبط الهوامش على عناصر WearArcLayout من خلال تغيير مَعلمات التنسيق لتوسيع MarginLayoutParams، أي أنّ WearArcLayout.LayoutParams يتوسّع إلى android.view.ViewGroup.MarginLayoutParams. (I2cd88)
  • يمكنك تغيير نوع الربط التلقائي لـ WearCurvedTextView إلى WearArcLayout.ANCHOR_CENTER (كان WearArcLayout.ANCHOR_START). يؤدي ذلك إلى تبسيط التفاعل بين تنسيق القوس والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في أعلى الصفحة على محور x، ويمكن لتنسيق القوس الرئيسي تدويره إلى المكان الذي يجب أن يكون فيه. (I105ff)

الإصدار 1.2.0-alpha03

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

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

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

حاوية تنسيق جديدة DismissibleFrameLayout، التي تتعامل مع إغلاق الزر "رجوع" و/أو التمرير سريعًا لإغلاق الشاشة، والمخصّصة للاستخدام داخل نشاط يجب إضافة مستمع واحد على الأقل لتنفيذ إجراء الإغلاق. سيزيل المستمع عادةً عرضًا أو جزءًا يحتويان على العنصر من النشاط الحالي. يتم توفير setSwipeDismissible(boolean) وsetBackButtonDismissible(boolean) للتحكّم المباشر في الميزات. يهدف هذا التنسيق الجديد إلى استبدال SwipeDismissFrameLayout الحالي.

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

أصبحت فئات الأنشطة الجارية الآن من فئة VersionedParcelables بدلاً من استخدام التسلسل/التسلسل العكسي المخصّص. أصبح الرمز الثابت وهدف اللمس مطلوبَين الآن.

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

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

الإصدار 1.2.0-alpha02

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

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

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

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

  • واجهة برمجة تطبيقات جديدة للأنشطة الجارية، وهي غير متاحة على "الأجهزة غير المتوافقة". (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".
    • يمكن استخدام هذه الفئة لإنشاء RemoteInput 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 التي تمت إضافة 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 من مكتبة Wearable Support Library إلى 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-Testing Version 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 Version 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. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات. (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. سيؤدي ذلك إلى إزالة خطأ أداة التدقيق في Android Studio لهذه السمات.

الإصدار 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)