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.1.0 - - -
wear-remote-interactions 1.1.0 - - 1.2.0-alpha01
تم إجراء آخر تعديل على هذه المكتبة في: 2 يوليو 2025

تعريف التبعيات

لإضافة تبعية على 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.1.0"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.1.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.1.0")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.1.0")
}

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

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 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 OS الصالحة التي يمكن استخدامها لمعاينة واجهة المستخدم.

الإصدار 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 OS الصالحة التي يمكن استخدامها لمعاينة واجهة المستخدم (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 الآن استخدام أوزان التوسيع التي تعمل بطريقة مشابهة لأوزان التنسيق العادية. وهذا يعني أنّه يمكنك تحديد الحجم النسبي للعناصر الفرعية بدون الحاجة إلى احتساب زواياها مباشرةً. أضفنا أيضًا قيمة MaxAngleDegreesbest effortMaxAngleDegrees التي يتم احترامها عند توسيع العناصر الفرعية باستخدام الأوزان. على سبيل المثال، يمكنك تثبيت القوس بعدة عناصر فرعية بأوزان على 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)

الإصدار 1.2.0 من Wear-Remote-Interactions

الإصدار 1.2.0-alpha01

‫2 يوليو 2025

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

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

  • تم تعديل RemoteActivityHelper.startRemoteActivity لاستخدام واجهة برمجة تطبيقات Wear SDK عامة جديدة (startRemoteActivity) إذا كانت متاحة (من Wear 6 والإصدارات الأحدث). (Id1e77)

الإصدار 1.1.0 من Wear Ongoing & Interactions

الإصدار 1.1.0

‫26 فبراير 2025

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

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

  • يحتوي هذا الإصدار على إصلاح مهم للأخطاء في التطبيقات التي تعمل على Wear OS 5 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث وتستهدف المستوى 35 أو مستوى أحدث لواجهة برمجة التطبيقات.
  • يجب تحديث التطبيقات إلى هذا الإصدار من المكتبة قبل تحديث targetSdkVersion إلى 35 أو إصدار أحدث.
  • وفي حال عدم توفّرها، سيتم عرض خطأ وقت التشغيل.
  • تمت إضافة تعريف جديد لنوع الجهاز المقترن، وهو none، عندما لا يكون الجهاز مقترنًا بالهاتف.

الإصدار 1.1.0-rc01

‫12 فبراير 2025

تم إصدار androidx.wear:wear-phone-interactions:1.1.0-rc01 بدون أي تغييرات ملحوظة منذ آخر إصدار تجريبي. يحتوي الإصدار 1.1.0-rc01 على عمليات الدمج هذه.

الإصدار 1.1.0-beta01

‫29 يناير 2025

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

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

يشير الإصدار 1.1.0-beta01 من Wear Phone Interactions إلى أنّ هذا الإصدار من المكتبة يتضمّن جميع الميزات وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الأجزاء التي تمّت الإشارة إليها على أنّها تجريبية). يتضمّن الإصدار 1.1 من Wear Phone Interactions الوظائف وواجهات برمجة التطبيقات الجديدة التالية:

  • تمت إضافة الموقع redirectUrl إلى الحساب OAuthRequest.
  • إصلاحات المستندات
  • إضافة نوع إضافي في PhoneTypeHelper لتحديد متى لا يكون الجهاز مقترنًا بالهاتف، بدلاً من استخدام النوع غير المعروف الحالي

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

  • تمت إضافة تعريف جديد لنوع الجهاز المقترن - لا شيء، عندما لا يكون الجهاز مقترنًا بالهاتف. (I06cb8)

الإصدار 1.1.0-alpha05

‫11 ديسمبر 2024

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

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

  • إصلاح خطأ تعطُّل عند التشغيل على Wear OS 5 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث أثناء استهداف المستوى 35 لواجهة برمجة التطبيقات أو الإصدارات الأحدث يجب تحديث التطبيقات إلى هذا الإصدار من المكتبة قبل تحديث 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 Version 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)

الإصدار 1.0.0 من Wear Ongoing & Interactions

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 إكمال Future إذا لم تكن هناك عُقد مرتبطة أو إذا لم يتم العثور على nodeId المطلوب (I60d60)

Wear-Ongoing الإصدار 1.1

الإصدار 1.1.0-alpha01

‫23 أغسطس 2023

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

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

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

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

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

الإصدار 1.0.0 من Wear-Ongoing

‫1 سبتمبر 2021

تم طرح androidx.wear:wear-ongoing:1.0.0. يتضمّن الإصدار 1.0.0 عمليات الدمج هذه.

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

  • واجهة برمجة التطبيقات "الأنشطة المستمرة على Wear" هي واجهة برمجة تطبيقات للمطوّرين، بما في ذلك المطوّرون الخارجيون، تُستخدَم لوضع علامة "نشاط مستمر" على أنشطتهم وتقديم المعلومات اللازمة.
  • تشير "الأنشطة الجارية" إلى الأنشطة التي يمكن تشغيلها في خلفية الساعة (مثل التمارين والمكالمات والوسائط). في نظام التشغيل 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 الإصدار 1.0.0-rc01

‫18 أغسطس 2021

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

Wear-Ongoing الإصدار 1.0.0-beta01

‫4 أغسطس 2021

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

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

  • تقبل بعض أدوات الضبط في OngoingActivity.Builder الآن وسيطة فارغة من أجل توفير التماثل والاتساق بين أدوات الضبط وأدوات الجلب (I17ee5)

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

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

  • لقد أوضحنا واجهة برمجة التطبيقات الخاصة بالمصادقة من خلال توفير المزيد من المَعلمات الموثّقة واستخدام السمات حيثما أمكن ذلك. (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 الإصدار 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 الإصدار 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 الإصدار 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 في Wearable Support Library) والتي يمكن استخدامها لفتح أغراض على أجهزة أخرى (أي من الساعة إلى الهاتف). (I1d7e0)

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

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

‫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" إلى 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 الآن على طريقة ثابتة لإنشاء حالات بسيطة تتضمّن جزءًا واحدًا فقط (نص أو مؤقّت)، وBuilder لإنشاء حالات أكثر تعقيدًا. (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)

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

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

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

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

إضافات Wear وWatchface 1.0.0

الإصدار 1.0.0-alpha22

‫15 سبتمبر 2021

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

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

  • تتضمّن EditorSession الآن أدوات مراقبة مراحل النشاط، لذا لم يعُد عليك إغلاقها بشكل صريح عند إيقاف نشاطك.

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

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

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

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

الإصدار 1.0.0-alpha17

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

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

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

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

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

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

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

  • للتوضيح، أعدنا تسمية Complication إلى ComplicationSlot وcomplicationId إلى complicationSlotId أو complicationInstanceId حسب الاستخدام. تمت إعادة تسمية الفئات التي تستخدم 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)
  • إصلاح مشاكل "محرّر خلفيات شاشة الساعة" في الإصدارات السابقة للإصدار R (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 وDefaultComplicationType. وهذه الطريقة أسرع من إنشاء مثيل بدون واجهة مستخدم لأنّها لا تحتاج إلى تهيئة خلفية شاشة الساعة بالكامل لتنفيذ طلب البحث.

أخيرًا، يتم الآن إنشاء الإضافات باستخدام 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. سيتم حظر طلبات البيانات من واجهة برمجة التطبيقات اللاحقة إلى أن يكتمل إعداد watchFace. (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 الخاصة بـ Renderer. بالإضافة إلى ذلك، تمت إضافة accessibilityTraversalIndex إلى الإضافات للتحكّم في ترتيب ContentDescriptionLabels. يمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting.

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

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

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

  • أضفنا إمكانية استخدام اسم مكوّن فارغ في ComplicationProviderInfo، وهو أمر ضروري لتوافق التطبيق مع الإصدارات القديمة من Wear OS. (I744d2)
  • لقد نقلنا androidx.wear.complications.SystemProviders من Java إلى Kotlin. (Ia1f8b)
  • لقد أخفينا جميع الفئات من واجهة برمجة التطبيقات العامة التي تقع في android.support.wearable.complications وأنشأنا برامج تضمين مقابلة في AndroidX عند الحاجة. (I7bd50)
  • لقد أعدنا تسمية الطريقة في TimeDifferenceComplicationText.Builder من setMinimumUnit إلى setMinimalTimeUnit. (I20c64)
  • لقد جعلنا الحقول ShortTextComplicationData.Builder وLongTextComplicationData.Builder وRangedValueComplicationData.Builder contentDescription إلزامية عند إدخالها في الدالة الإنشائية. (I8cb69)
  • أعدنا تسمية ComplicationProviderService.onComplicationUpdate إلى onComplicationRequest، ووضعنا مَعلمتَي المعرّف والنوع لهذه الطريقة في بيانات ComplicationRequest. تمت إعادة تسمية أداة معالجة الأحداث المقابلة إلى ComplicationRequestListener، كما تمت إعادة تسمية طريقتها إلى ComplicationRequestListener.onComplicationData. (Iaf146)
  • لقد أزلنا الطريقة isActiveAt من ComplicationData واستبدلناها بالحقل validTimeRange. يمكن استبدال استدعاء الطريقة هذا بـ validTimeRange.contains. (I65936)
  • لقد غيّرنا وصف الطريقة ComplicationProviderService.onComplicationActivated لتلقّي ComplicationType بدلاً من عدد صحيح. (Idb5ff)
  • تم نقل ProviderUpdateRequester من Java إلى Koltin. (Ibce13)
  • أصبحت الدالة GlesRender.makeContextCurrent متاحة للجميع. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء طلبات gl خارج عملية العرض و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 Complications & Watchface

‫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 لدعم الإضافات على الحواف (المرسومة حول حافة الشاشة). يتم ترك عملية العرض واختبار الضغط لإضافات الحواف لخلفية شاشة الساعة. لا تتوفّر ميزة اختبار إصابة الحافة من المحرّر المصاحب.

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

  • تمت إضافة البادئة PROVIDER_ إلى الثوابت في SystemProviders. (I1e773)
  • لقد جعلنا الحقول PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder وSmallImageComplicationData.Builder contentDescription إلزامية ليتم تمريرها في الدالة الإنشائية. (I9643a)
  • تمت إعادة تسمية ProviderInfoRetriever.requestPreviewComplicationData إلى retrievePreviewComplicationData. (I911ee)
  • تم نقل ComplicationProviderService من Java إلى Kotlin. (I849f2)
  • أصبحت الطريقة ComplicationProviderService.onBind نهائية الآن (I39af5)
  • أعدنا واجهة CanvasComplication ونقلنا CanvasComplicaitonDrawable وGlesTextureComplication وComplicationHighlightRenderer إلى wear-watchface-complications-rendering. (I84670)
  • تمت إعادة تصميم RenderParameters لتتيح عرض التمييز الموسّع. يمكنك الآن طلب عرض اللحظات البارزة للأنماط، بالإضافة إلى جميع التطبيقات المصغّرة أو تطبيق مصغّر واحد. بالإضافة إلى ذلك، يتضمّن كل من CanvasRenderer وGlesRenderer طريقة renderHighlightLayer مجرّدة جديدة لعرض أي تمييز يطلبه المحرّر. تمت إعادة تسمية الطبقة إلى 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)
  • أزلنا عمليات التحويل المختلفة في Wear-watchface-client Binder، ومن المفترض أن تكون ضرورية. (Icc4c0)
  • لتحقيق الاتّساق، تمت إعادة تصميم EditorServiceClient لاستخدام أدوات معالجة الأحداث بدلاً من أدوات المراقبة. (Iec3a4)
  • أضفنا بعض التعليقات التوضيحية الناقصة من @Px إلى InteractiveWatchFaceSysUiClient وWatchFaceControlClient. (I3277a)
  • تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener للحفاظ على الاتساق. (Ie572d)
  • يقتصر استخدام EditorState.watchFaceInstanceId على المستوى 30 لواجهة برمجة التطبيقات في Android والإصدارات الأحدث، ولم يعُد يمكن أن تكون قيمته فارغة. (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 وواجهة الساعة. يمكن للمحرِّر الآن تحديد ما إذا كان تغيير النمط سيؤدي إلى تفعيل أو إيقاف إحدى الإضافات (مفعّلة = initiallyEnabled بالإضافة إلى أي تجاوز من ComplicationsUserStyleSetting). EditorService.closeEditorتسمح أيضًا لواجهة المستخدم الخاصة بالنظام بإغلاق أداة تعديل خلفية شاشة الساعة عن بُعد عند الحاجة.
  • بالإضافة إلى 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.

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

  • أزلنا إمكانية النقر مرّتين على الإضافات لتشغيل أداة اختيار مقدّم الخدمة، لأنّ هذه الميزة لم تكن شائعة في خلفيات شاشة الساعة وعقّدت عملية تنفيذ SysUI. (I3ef24)
  • قد تعرض طرق ProviderInfoRetriever الخطأ ServiceDisconnectedException إذا تم إغلاق الرابط بشكل غير متوقّع. (Ib2cc4)
  • بدءًا من الإصدار 11 من نظام التشغيل Android، هناك قيود على وقت تشغيل 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)
  • عرض validTimeRange الخاص بـ ComplicationData (I91366)
  • اجعل السمات المشابهة للصور أكثر وضوحًا. (I81700)
  • تمت إعادة تصميم wear-watchface-editor وwear-complications-data لاستخدام دوال تعليق بدلاً من الروتينات المشتركة. سيتم توفير برامج تضمين متوافقة مع Rx java وFuture. (If3c5f)
  • يُصدر ProviderInfoRetriever الآن الخطأ PreviewNotAvailableException إذا تعذّر على requestPreviewComplicationData عرض بيانات المعاينة بسبب مشاكل في الاتصال أو عدم توفّر دعم لواجهة برمجة التطبيقات. (I4964d)
  • أصبح WatchFaceControlService::createWatchFaceControlClient الآن دالة معلّقة، وأصبح اسم getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient هو getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync الذي يعرض Deferred<InteractiveWatchFaceWcsClient>. سيتم توفير برامج تضمين متوافقة مع RX java وFuture. (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 الآن اسم ComponentName الخاص بالمحرّر الذي تم ضبطه كمكوّن في 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 الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. ولإتاحة ذلك، أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يتيح لمحرّري خلفيات شاشة الساعة طلب معاينة ComplicationData. تتميّز معاينة ComplicationData بأنّك لست بحاجة إلى القلق بشأن عرض مربّعات حوار الأذونات عند عرض المحرّر (يُرجى العِلم أنّه إذا اختار المستخدم موفّرًا لديه إذن، سيُطلب منه منح الإذن).

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

  • يحتوي ComplicationProviderInfo الآن على حقل لاسم ComponentName الخاص بموفّر البيانات، وسيتم توفير دعم هذا الحقل في WearOS في وقت لاحق، وسيكون فارغًا في الوقت الحالي. (Id8fc4)
  • أضفنا ProviderInfoRetriever.requestPreviewComplicationData الذي يتيح لمحرّري خلفيات شاشة الساعة طلب معاينة ComplicationData. هذا الإجراء مفيد لأنّ المضاعفات المباشرة قد تتطلّب أذونات، ويمكنك الآن عرض بيانات المعاينة للمضاعفات غير النشطة. (I2e1df)
  • أصبحت ComplicationManager الآن مَعلمة اختيارية لدالة إنشاء WatchFace، وتمت إعادة ترتيب الوسيطات للسماح بذلك. (I66c76)
  • أضفنا حزمة اختيارية إلى "التعقيدات"، وفي حال ضبطها، يتم دمجها مع الغرض المُرسَل لتشغيل نشاط أداة اختيار مقدّم الخدمة. (Ifd4ad)
  • لقد أضفنا مكتبة wear-watchface-editor جديدة لتوفير الدعم لمحرّرات واجهة الساعة وSysUi المستضافة. ستطلق SysUI أدوات التعديل هذه عن طريق إرسال هدف. يمكن لخدمة نشاط خلفية شاشة الساعة استخدام فئة EditorSession الجديدة للوصول إلى تفاصيل WatchFace وتسجيل النتيجة من خلال Activity.setWatchRequestResult. (I2110d)
  • تمت إعادة تسمية LayerMode.DRAW_HIGHLIGHTED إلى LayerMode.DRAW_OUTLINED، كما تمت إعادة تسمية RenderParameters.highlightComplicationId إلى RenderParameters.selectedComplicationId، ما يؤدي إلى رسم تمييز على المضاعفات المحدّدة بالإضافة إلى مخطط تفصيلي. (I90a40)
  • يمكن الآن حلّ المشكلة في WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient's future باستخدام 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> بدلاً من مصفوفة عدد صحيح، ما يسهّل استخدامها. (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 على عمليات الإيداع هذه.

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

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

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

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

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

  • نعرض الآن ComplicationType الخاص بـ ComplicationData الحالي للعنصر Complication في 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)
  • تتضمّن الإضافة الآن compicationData الذي يتيح لخلفيات شاشة الساعة مراقبة تغييرات ComplicationData. يتضمّن العنصر Complication أيضًا استدعاءً جديدًا باسم isActiveAt يمكن استخدامه لمعرفة ما إذا كان يجب عرض أي شيء في التاريخ والوقت المحدّدين. (Ic0e2a)
  • لم يعُد SharedMemoryImage الفارغ متوفّرًا في واجهة برمجة التطبيقات العامة. (I7ee17)
  • يحتوي WatchFace.overridePreviewReferenceTimeMillis الآن على تعليق توضيحي IntRange، كما أنّ الدالتَين getter وsetter لهما أسماء متسقة. (Ia5f78)
  • تم الآن إنشاء Complication.Builder عبر Complication.createRoundRectComplicationBuilder أو Complication.createBackgroundComplicationBuilder للتوضيح (I54063)
  • تمت إضافة WatchFace.TapListener الذي يسمح لـ WatchFace بمراقبة النقرات التي لم تستخدمها الإضافات. (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 المتوافقة مع الأجهزة القابلة للارتداء إلى ComplicationType في androidx. (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 (I7c268)
  • يجب أن تبدأ الدوال التي تعرض قيمًا منطقية بـ "is" بدلاً من "get" (If36ff)
  • تنصح واجهة برمجة التطبيقات بتجنُّب استخدام protected، لذا تمت إعادة تصميم هذه الفئة لتلقّي المَعلمات من خلال الدالة الإنشائية. (I61644)
  • إعادة تسمية setBackgroundComplication لتوضيح معناها (I96fe3)
  • استخدام سمات Kotlin لـ ComplicationDrawable isHighlighted والبيانات (I4dcc8)
  • بدلاً من ComplicationRenderer.InvalidateCallback، نضيف Complication#invalidate() (I4f4c6).
  • سيتم إيقاف واجهات برمجة التطبيقات هذه نهائيًا في WearableSupport، وستتم إزالتها هنا. (Ib425c)
  • تمت إعادة تسمية بعض طرق إنشاء خلفيات شاشة الساعة للتأكيد على طبيعتها القديمة في Wear 2.0. (Idb775)
  • أول إصدار تجريبي من واجهة برمجة التطبيقات لتطبيقات Wear OS/خلفيات شاشة Wear OS (Id3981)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات (Ie9fe6)
  • إخفاء ComplicationDrawable.BorderStyle IntDef بشكل صحيح والانتقال إلى ComplicationStyle لتحقيق الاتساق (I27f7a)
  • إضافة التعليقات التوضيحية الناقصة لطُرق ComplicationStyle (I838fd)
  • لا تحتوي هذه المكتبة على مساحة واجهة برمجة تطبيقات عامة (I88e2b)
  • أصبحت جميع فئات الخيارات الخاصة بفئات الأنماط نهائية بشكل صحيح. (Ib8323)
  • أول إصدار تم تتبُّعه من واجهة برمجة التطبيقات (I27c85)

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

  • تم تغيير ComplicationProviderService لتضمين طريقة getComplicationPreviewData صريحة. (I4905f)
  • تم تفعيل فحص API lint للخطأ MissingGetterMatchingBuilder في androidx (I4bbea وb/138602561)
  • أعِد تسمية wear-complications-rendering. (Ifea02)
  • أصبحت أسماء العرض لفئات الأنماط الآن CharSequences (I28990)
  • استبدال "التجاهل" بـ "التراكب" ليتوافق مع اصطلاحات تسمية المظاهر والأنماط الحالية (I4fde9)
  • تمت إعادة تسمية UserStyle#getOptions لتوضيحها. (I695b6)

الإصدار 1.2.0

الإصدار 1.2.0

‫15 سبتمبر 2021

تم طرح androidx.wear:wear:1.2.0. يتضمّن الإصدار 1.2.0 عمليات الإيداع هذه.

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

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

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

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

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

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

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

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

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

  • تم نقل فئة WearableCalendarContract من Wearable Support Library. توفر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال 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" إلى AndroidX توفر واجهة برمجة التطبيقات هذه مجموعة فرعية من البيانات المتاحة من خلال CalendarContract، ولكن تتم مزامنتها تلقائيًا مع الأجهزة القابلة للارتداء. (I6f2d7)

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

  • إيقاف ميزة الإغلاق باستخدام زر الرجوع تلقائيًا في Dismissible FrameLayout لأنّ الإغلاق عن طريق التمرير السريع يظل الطريقة الرئيسية للرجوع إلى وضع ملء الشاشة على أجهزة Wearable (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 على عمليات الإيداع هذه.

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

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

  • واجهة برمجة تطبيقات جديدة للأنشطة الجارية، وهي لا تنفّذ أي عملية على "الأجهزة غير المتوافقة". (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" إلى 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 من Wearable Support Library إلى 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 الإصدار 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)

الإصدار 1.0.0-alpha01 من Wear-Input

‫2 سبتمبر 2020

تم طرح androidx.wear:wear-input:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.

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

نقل وظيفة WearableButtons من Wearable Support Library إلى 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" لهذه السمات. (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" لهذه السمات.

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