Wear

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
ارتداء 1.4.0 - - -
wear-input 1.2.0 - - -
wear-input-testing 1.2.0 - - -
wear-ongoing 1.1.0 - - -
wear-phone-interactions 1.1.1 - - -
wear-remote-interactions 1.2.0 - 1.3.0-beta01 -
تمّ إجراء آخر تعديل على هذه المكتبة في: 23 سبتمبر 2026

تحديد الاعتماديات

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

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

Groovy

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

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

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

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

Kotlin

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

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

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

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

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

الملاحظات

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

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

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

Wear-Core

الإصدار 1.2

الإصدار 1.2.0-alpha01

‫23 سبتمبر 2026

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

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

  • تمت إضافة الثابتَين WEAR_CINNAMON_BUN_1 وWEAR_CINNAMON_BUN_2 للإصدارات الجديدة من Wear OS إلى WearApiVersionHelper. (Ifec88)

الإصدار 1.1

الإصدار 1.1.0

‫3 يونيو 2026

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

الميزات الرئيسية للإصدار 1.1.0: * تمت إضافة CINNAMON_BUN في WearApiVersionHelper لإجراء عمليات التحقّق من توافق واجهة برمجة التطبيقات مع حزمة تطوير البرامج (SDK) 37.

الإصدار 1.1.0-rc01

‫19 مايو 2026

تم إصدار androidx.wear:wear-core:1.1.0-rc01 بدون أي تغييرات عن الإصدار السابق. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

الإصدار 1.1.0-beta01

‫6 مايو 2026

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

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

  • تمت إضافة CINNAMON_BUN في WearApiVersionHelper لإجراء عمليات التحقّق من توافق واجهة برمجة التطبيقات مع حزمة تطوير البرامج (SDK) الإصدار 37.

الإصدار ‎1.1.0-alpha02

‫8 أبريل 2026

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

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

  • إضافة VersionCodes جديد إلى WearApiVersionHelper (I86bc1، b/487264133)

الإصدار 1.1.0-alpha-01

‫25 مارس 2026

تم طرح androidx.wear:wear-core:1.1.0-alpha-01. يتضمّن الإصدار 1.1.0-alpha-01 هذه التعديلات.

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

  • تمت إضافة CINNAMON_BUN (حزمة SDK 37) في WearApiVersionHelper. (Id1ee0، b/487264133)

الإصدار 1.0

الإصدار 1.0.0

‫17 ديسمبر 2025

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

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

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

الإصدار ‎1.0.0-rc01

‫8 أكتوبر 2025

تم إصدار androidx.wear:wear-core:1.0.0-rc01 بدون أي تغييرات. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار ‎1.0.0-beta02

‫10 سبتمبر 2025

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

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

  • منع WearApiVersionHelper من عرض استثناءات على الأجهزة القديمة عند التحقّق من واجهات برمجة التطبيقات الأحدث

الإصدار 1.0.0-beta01

‫30 يوليو 2025

تم إصدار androidx.wear:wear-core:1.0.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

الإصدار ‎1.0.0-alpha02

‫16 يوليو 2025

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

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

  • تعديل WearApiVersionHelper ليشمل VIC/Baklava (I4676d)

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

الإصدار ‎1.0.0-alpha01

‫29 مايو 2024

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

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

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

Wear

الإصدار 1.4

الإصدار 1.4.0

‫25 فبراير 2026

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

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

  • تم إصلاح الخطأ الذي كان يؤدي إلى توسيط الرمز ConfirmationOverlay عموديًا عندما لا تكون هناك رسالة. I496d8

الإصدار 1.4.0-rc01

‫28 يناير 2026

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

  • لم يتم إجراء أي تغييرات جديدة بين الإصدار beta01 والإصدار rc01.

الإصدار 1.4.0-beta01

‫17 ديسمبر 2025

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

  • لم يتم إجراء أي تغييرات جديدة مهمة منذ إصدار الإصدار الأولي السابق.

الإصدار 1.4.0-alpha02

‫16 يوليو 2025

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

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

الإصدار 1.4.0-alpha01

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

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

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

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

الإصدار 1.3

الإصدار 1.3.0

‫9 أغسطس 2023

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

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

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

الإصدار 1.3.0-rc01

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

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

الإصدار 1.3.0-beta01

‫7 يونيو 2023

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

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

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

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

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

الإصدار 1.3.0-alpha05

‫19 أبريل 2023

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

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

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

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

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

الإصدار 1.3.0-alpha04

‫25 يناير 2023

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

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

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

الإصدار 1.3.0-alpha03

‫24 أغسطس 2022

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

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

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

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

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

الإصدار 1.3.0-alpha02

‫23 فبراير 2022

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

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

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

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

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

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

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

الإصدار 1.3.0-alpha01

‫29 سبتمبر 2021

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

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

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

الإصدار 1.2

الإصدار 1.2.0

‫15 سبتمبر 2021

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • تم إصلاح الخطأ الذي كان يتسبّب في ظهور WearableDrawerLayout في جميع التفاعلات عند التمرير سريعًا أفقيًا في RecyclerViews. (I24c7f)

الإصدار 1.2.0-rc01

‫1 سبتمبر 2021

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

الإصدار 1.2.0-beta01

‫18 أغسطس 2021

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

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

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

الإصدار ‎1.2.0-alpha13

‫4 أغسطس 2021

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

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

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

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

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

الإصدار ‎1.2.0-alpha12

‫21 يوليو 2021

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

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

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

الإصدار 1.2.0-alpha11

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

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

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

  • تم إصلاح الخطأ الذي كان يتسبّب في ظهور WearableDrawerLayout في جميع التفاعلات عند التمرير أفقيًا في RecyclerViews. (I24c7f)

الإصدار 1.2.0-alpha10

‫2 يونيو 2021

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

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

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

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

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

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

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

الإصدار ‎1.2.0-alpha09

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

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

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

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

الإصدار ‎1.2.0-alpha08

‫5 مايو 2021

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

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

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

الإصدار 1.2.0-alpha07

‫24 مارس 2021

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

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

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

الإصدار ‎1.2.0-alpha06

‫27 يناير 2021

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

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

  • نقل مكتبة "الأنشطة الجارية" إلى مكتبة فرعية جديدة: wear-ongoing أصبحت الفئات متاحة الآن في حزمة androidx.wear.ongoing (كانت سابقًا androidx.wear.ongoingactivities) (I7c029)
  • نقل فئة WearableCalendarContract من "مكتبة دعم الأجهزة القابلة للارتداء" إلى 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)، ما يسهّل العقد بين التصميم المنحني والنص المنحني، لأنّ النص المنحني يرسم نفسه تلقائيًا في المنتصف على المحور السيني في الأعلى، ويمكن أن يدوّره التصميم المنحني الأصلي إلى المكان المطلوب. (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)

الإصدار 1.1

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

Wear-Remote-Interactions

الإصدار 1.3.0

الإصدار 1.3.0-beta01

‫23 سبتمبر 2026

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

  • تمت إضافة startRemoteActivityAttemptUnlock وstartPhoneActivityWithUnlock إلى RemoteActivityHelper، ما يسمح لتطبيقات Wear OS ببدء نشاط على الهاتف المرتبط بعد فتح قفله، وذلك وفقًا لمدى توفّر الميزة وإمكانات النظام الأساسي للمستخدم. يمكن أن يعود startRemoteActivityAttemptUnlock إلى startRemoteActivity الحالي عندما لا تكون الميزة متاحة.

الإصدار 1.3.0-alpha01

‫19 مايو 2026

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

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

  • تمت إضافة startRemoteActivityAttemptUnlock وstartPhoneActivityWithUnlock إلى RemoteActivityHelper، ما يسمح لتطبيقات Wear OS ببدء نشاط على الهاتف المرتبط بعد فتح قفله، وذلك وفقًا لمدى توفّر الميزة وإمكانات النظام الأساسي للمستخدم. يمكن أن يعود startRemoteActivityAttemptUnlock إلى startRemoteActivity الحالي عندما لا تكون الميزة متاحة. (Ic23ae، b/468374830)

الإصدار 1.2

الإصدار 1.2.0

‫25 فبراير 2026

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

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

  • تم تعديل RemoteActivityHelper.startRemoteActivity لاستخدام واجهة برمجة تطبيقات Wear SDK عامة جديدة (startRemoteActivity) إذا كانت متاحة (من Wear 6 والإصدارات الأحدث). Id1e77
  • تم تعديل الاعتمادية على إصدار Play Basement الذي كان يتضمّن الثغرة الأمنية CVE-2022-2390.

الإصدار 1.2.0-rc01

‫28 يناير 2026

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

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

  • تم تعديل الاعتمادية على إصدار Play Basement الذي كان يتضمّن الثغرة الأمنية CVE-2022-2390.

الإصدار 1.2.0-beta01

‫17 ديسمبر 2025

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

  • لم يتم إجراء أي تغييرات جديدة مهمة منذ إصدار الإصدار الأولي السابق.

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

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

الإصدار 1.2

الإصدار 1.2.0

‫10 سبتمبر 2025

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

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

  • ثوابت الموقع الجغرافي للأزرار الخارجية المكشوفة
  • تمت إضافة WearableRemoteInputExtender لإعداد إضافات خاصة بأجهزة Wear على android.app.RemoteInput (على سبيل المثال، تفعيل إدخال رموز الإيموجي)

الإصدار 1.2.0-rc01

‫27 أغسطس 2025

تم إصدار androidx.wear:wear-input:1.2.0-rc01 وandroidx.wear:wear-input-testing:1.2.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.2.0-rc01 هذه التعديلات.

الإصدار 1.2.0-beta01

‫30 يوليو 2025

تم إصدار الإصدارَين androidx.wear:wear-input:1.2.0-beta01 وandroidx.wear:wear-input-testing:1.2.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدارات ألفا. يتضمّن الإصدار 1.2.0-beta01 هذه التعديلات.

الإصدار ‎1.2.0-alpha04

‫16 يوليو 2025

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

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

  • يجب مراعاة تدوير الشاشة عند احتساب موضع الأزرار الخارجية بالنسبة إلى الشاشة. (87a57e)

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

  • أعِد تسمية LOC* إلى LOCATION* في wear-input. (I5e879)

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

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

الإصدار 1.1

الإصدار 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 من مكتبة دعم الأجهزة القابلة للارتداء إلى AndroidX تمت إعادة تسمية الفئة التي تم نقلها إلى RemoteInputIntentHelper، وهي توفّر دوال مساعِدة لدعم عمليات الإدخال عن بُعد من خلال بدء هدف. (I47cee)

الإصدار 1.0

الإصدار 1.0.0

‫2 ديسمبر 2020

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

هذا الإصدار مطابق للإصدار 1.0.0-rc01.

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

  • نقل وظيفة WearableButtons من مكتبة دعم الأجهزة القابلة للارتداء إلى Jetpack

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

الإصدار ‎1.0.0-rc01

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

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

هذا الإصدار مطابق للإصدار 1.0.0-beta01.

الإصدار 1.0.0-beta01

‫28 أكتوبر 2020

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

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

‫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 من مكتبة دعم الأجهزة القابلة للارتداء إلى Jetpack سيتم توفير إمكانية إجراء اختبارات إضافية في مكتبة androidx.wear:wear-input-testing في إصدار Jetpack التالي.

Wear-Ongoing

الإصدار 1.1

الإصدار 1.1.0

‫10 سبتمبر 2025

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

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

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

الإصدار 1.1.0-rc01

‫27 أغسطس 2025

تم إصدار androidx.wear:wear-ongoing:1.1.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

الإصدار 1.1.0-beta01

‫30 يوليو 2025

تم إصدار androidx.wear:wear-ongoing:1.1.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

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

الإصدار 1.0.0

‫1 سبتمبر 2021

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

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

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

الإصدار ‎1.0.0-rc01

‫18 أغسطس 2021

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

الإصدار 1.0.0-beta01

‫4 أغسطس 2021

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

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

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

الإصدار ‎1.0.0-alpha06

‫2 يونيو 2021

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

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

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

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

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

الإصدار ‎1.0.0-alpha05

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

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

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

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

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

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

الإصدار ‎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-Phone-Interactions

الإصدار 1.1

الإصدار 1.1.1

‫15 يوليو 2026

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

إصلاحات الثغرات الأمنية

  • أضفنا عملية التحقّق من صحة مَعلمة الحزمة redirect_uri في RemoteAuthService. يضمن ذلك تطابق جزء الحزمة من مَعلمة طلب البحث redirect_uri في عنوان URL للطلب مع اسم حزمة الاتصال الذي تم التحقّق منه، وذلك عند إرسال طلب مصادقة إلى الهاتف وعند تلقّي الرمز المميز مرة أخرى. (I19da5، b/510833682)

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

‫10 يناير 2024

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

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

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

الإصدار ‎1.1.0-alpha03

‫9 مارس 2022

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

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

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

الإصدار ‎1.1.0-alpha02

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

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

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

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

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

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

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

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

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

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

Wear-Phone-Interactions Wear-Remote-Interactions

الإصدار 1.0

الإصدار 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 التي يمكن استخدامها لفتح أغراض على أجهزة أخرى (أي من الساعة إلى الهاتف).

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

الإصدار 1.0.0-beta01

‫18 أغسطس 2021

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

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

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

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

‫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)

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

‫4 أغسطس 2021

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

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

‫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)

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

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

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

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

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

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

‫21 يوليو 2021

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

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

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

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

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

‫7 أبريل 2021

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

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

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

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

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

‫Wear-Ongoing Wear-Phone-Interactions الإصدار 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، وإتاحة استخدام إضافة مفتاح حماية تبادل الرموز (PKCE) في OAuth (I3eaaa)

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

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

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

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

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

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

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

Wear-Tooling-Preview

الإصدار 1.0

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

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

الإصدار 1.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 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، كما تمت إعادة تسمية جميع الفئات التي تتضمّن كلمة "موفّر" في اسمها بشكل مماثل. (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 قبل أي طلبات عرض. للتوضيح أيضًا، أعدنا تسمية onGlContextCreated إلى onBackgroundThreadGlContextCreated، وonGlSurfaceCreated إلى onUiThreadGlSurfaceCreated في GlesRenderer. (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 وComplicationType التلقائي. وهذه الطريقة أسرع من إنشاء مثيل بلا واجهة مستخدم رسومية لأنّها لا تحتاج إلى إعداد خلفية شاشة الساعة بالكامل لتنفيذ طلب البحث.

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

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

  • تم استبدال @TargetApi بـ @RequiresApi. (I0184a، b/187447093، b/187447094)
  • لقد أضفنا WatchFaceControlClient.getDefaultProviderPoliciesAndType التي تعرض خريطة لمعرّفات Complication Ids إلى DefaultComplicationProviderPolicies وDefaultComplicationType. يتم استخدام مسار سريع حيثما أمكن لتجنُّب إنشاء خلفية شاشة ساعة بشكل كامل. لتسهيل ذلك، كان من الضروري تغيير واجهة برمجة التطبيقات WatchFaceService وإضافة طريقتَين جديدتَين هما: 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 Complications & Watchface

‫5 مايو 2021

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

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

  • يمكن أن تتضمّن خلفيات شاشة الساعة عناصر مرئية مهمة بالإضافة إلى عرض الوقت والبيانات. لتوفير إمكانية استخدام قارئ الشاشة في هذه الحالة، يمكن لساعة Wear OS الآن تحديد ContentDescriptionLabels لتسهيل الاستخدام من خلال السمة additionalContentDescriptionLabels في Renderer. بالإضافة إلى ذلك، تمت إضافة ContentDescriptionLabels accessibilityTraversalIndex إلى الإضافات للتحكّم في ترتيبها. يمكن تعديل ذلك باستخدام ComplicationsUserStyleSetting.

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

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

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

  • أضفنا إمكانية استخدام اسم مكوّن فارغ في ComplicationProviderInfo، وهو أمر ضروري لتوفير التوافق مع الإصدارات القديمة من Wear OS. (I744d2)
  • لقد نقلنا androidx.wear.complications.SystemProviders من Java إلى Kotlin. (Ia1f8b)
  • أخفينا جميع الفئات من واجهة برمجة التطبيقات العامة التي تقع في android.support.wearable.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 إلى Kotlin. (Ibce13)
  • أصبحت الدالة GlesRender.makeContextCurrent متاحة للجميع. قد يحتاج رمز خلفية شاشة الساعة إلى إجراء طلبات gl خارج عملية العرض وonGlContextCreated، وبما أنّه قد يكون هناك سياق تفاعلي وسياق بلا واجهة مستخدم رسومية، من الضروري إجراء هذا الطلب. (I8a43c)
  • يُصدر الآن WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient استثناء ServiceStartFailureException إذا حدث خطأ في watchface أثناء عملية التهيئة. بالإضافة إلى ذلك، يعرض 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 رسم مخطط تفصيلي حولها.

لتشجيع استخدام &quot;موفّر التعقيدات&quot; في تسهيل الاستخدام، جعلنا حقل contentDescription في PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder وSmallImageComplicationData.Builder وسيطًا إلزاميًا في الدالة الإنشائية. تمت إضافة ComplicationTapFilter وComplication.createEdgeComplicationBuilder لإتاحة الإضافات على الحواف (المرسومة حول حافة الشاشة). يتم ترك عملية عرض الإضافات على الحواف واختبارها لخلفية شاشة الساعة. لا تتوفّر ميزة "اختبار إصابة الحافة" من "محرّر المستندات المصاحب".

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

  • تمت إضافة البادئة PROVIDER_ إلى الثوابت في SystemProviders. (I1e773)
  • لقد جعلنا الحقل contentDescription الخاص بـ PhotoImageComplicationData.Builder وMonochromaticImageComplicationData.Builder وSmallImageComplicationData.Builder إلزاميًا ليتم تمريره في الدالة الإنشائية. (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)
  • لقد أزلنا عمليات تحويل Binder المختلفة في wear-watchface-client، ومن المفترض ألا تكون ضرورية. (Icc4c0)
  • لتحقيق الاتساق، تمت إعادة تصميم EditorServiceClient لاستخدام أدوات الاستماع بدلاً من أدوات المراقبة. (Iec3a4)
  • أضفنا بعض التعليقات التوضيحية الناقصة @Px إلى InteractiveWatchFaceSysUiClient وWatchFaceControlClient. (I3277a)
  • تمت إعادة تسمية EditorObserverCallback إلى EditorObserverListener للحفاظ على الاتساق. (Ie572d)
  • يقتصر استخدام EditorState.watchFaceInstanceId على المستوى R لواجهة برمجة التطبيقات في نظام التشغيل 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.

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

  • أزلنا إمكانية النقر مرّتين على الإضافات لتشغيل أداة اختيار مقدّم الخدمة، لأنّ هذه الميزة لم تكن شائعة في خلفيات شاشة الساعة وكانت تعقّد عملية تنفيذ واجهة المستخدم الخاصة بالنظام. (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 من خلال 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)
  • أصبح Renderer الآن فئة محكمة الإغلاق. وهذا يعني أنّ 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. تتضمّن الإضافة أيضًا استدعاء 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، ويمكن استخدام 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)
  • تمت إعادة تسمية بعض طرق إنشاء خلفيات الساعة للتأكيد على طبيعتها القديمة في الإصدار 2.0 من نظام التشغيل Wear. (Idb775)
  • أول إصدار تجريبي من واجهة برمجة التطبيقات لتطبيقات Wear/Wear-watchface (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)