remote compose

  
‫Remote Compose هو إطار عمل لإنشاء واجهة مستخدم لمساحات عرض عن بُعد
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫19 مايو 2026 - - - 1.0.0-alpha11

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

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

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

أنيق

dependencies {
    implementation "androidx.compose.remote:remote-core:1.0.0-alpha11"

    // Use to create Remote Compose documents
    implementation "androidx.compose.remote:remote-creation:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-core:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-android:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-jvm:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-compose:1.0.0-alpha11"

    // Use to render a Remote Compose document
    implementation "androidx.compose.remote:remote-player-core:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-player-view:1.0.0-alpha11"

    implementation "androidx.compose.remote:remote-tooling-preview:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.compose.remote:remote-core:1.0.0-alpha11")

    // Use to create Remote Compose documents
    implementation("androidx.compose.remote:remote-creation:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-core:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-android:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-jvm:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-compose:1.0.0-alpha11")

    // Use to render a Remote Compose document
    implementation("androidx.compose.remote:remote-player-core:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-player-view:1.0.0-alpha11")

    implementation("androidx.compose.remote:remote-tooling-preview:1.0.0-alpha11")
}

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

الملاحظات

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

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

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

الإصدار 1.0

الإصدار ‎1.0.0-alpha11

‫19 مايو 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

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

  • عرض مصنع ثابت RemoteInt (Ic0096، b/484137042)
  • عرض مصانع RemoteState الثابتة (I544f0، b/484137042)
  • يتيح RemoteLong الآن مجموعة فرعية محدودة من العوامل الحسابية (الجمع والطرح والضرب والتحويل إلى RemoteInt مع اقتطاع الجزء العشري). (I1d416)
  • تعديل RemoteText لاستخدام RemoteFontFamily بدلاً من FontFamily (Ib76b6، b/502907551)
  • تمت إضافة معدِّلات ألفا والتدوير والتوسيع. (I5d682، b/505427444)

الإصدار ‎1.0.0-alpha010

‫6 مايو 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha010. يتضمّن الإصدار ‎1.0.0-alpha010 هذه التعديلات.

الميزات

  • إضافة علامة EnforceCleanRecomposition (I6e4408) كخطوة نحو إتاحة إعادة التركيب في RemoteCompose، منعنا أي شيء من الكتابة إلى المستند قبل اكتمال التركيب. يمنع ذلك كتابة المستندات بشكل جزئي أثناء إعادة التركيب. إذا تسبّب هذا السلوك في حدوث مشاكل في الرمز الحالي، يمكن إيقافه عن طريق ضبط isEnforceCleanRecompositionEnabled على false.

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

  • تمت إضافة مكتبة اختبار لـ Remote Compose. (I78746، b/504687418)

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

  • إصلاح مشكلة اقتصاص الخلفية عند استخدام RemoteColor (بدلاً من لون ثابت) كلون الخلفية (If70842، b/505116577)
  • إتاحة توفير حجم صريح لخرائط البتات التي يتم تحميلها من معرّف الموارد المنتظم (URI) في السابق، كان يتم احتساب الحجم على أنّه 1x1، ويتم تغيير حجم وحدة البكسل هذه إلى حجم الحاوية (Id4fff، b/487936996).
  • منع حدوث خطأ تعطل على الأجهزة التي لا تتضمّن SensorManager (I1fc947،b/498302479)
  • إصلاح المشكلة التي تمنع استخدام الساعة المتوفّرة في تعبيرات TIME_FROM (ما يمنع إجراء اختبارات موثوقة لتعبيرات المدة) (I5f816، b/501405389)

الإصدار ‎1.0.0-alpha09

‫22 أبريل 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha09. يتضمّن الإصدار ‎1.0.0-alpha09 هذه التعديلات.

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

  • تم تغيير إمكانية النقر على المعدِّل لكي لا يقبل قيمة فارغة لمَعلمة الإجراء، ويجب استخدام Action.Empty بدلاً من ذلك. (I21be9، b/498881738)
  • تم تغيير مَعلمات معدِّل المساحة المتروكة من يسار/يمين إلى بداية/نهاية. (Id781c، b/500760020)
  • تم تغيير المعدِّلَين onTouchDown(varargs action) وonTouchUp(varargs action) إلى onTouchDown/onTouchUp(action). استخدِم CombinedAction للاطّلاع على قائمة بالإجراءات. (I8af9d، b/498881738)
  • تم تغيير المعدِّل clickable(varargs action) إلى clickable(action). استخدِم CombinedAction للاطّلاع على قائمة بالإجراءات. (I8432d، b/498881738)

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

  • حلّ المشكلة MatrixExpression.write (Id3c52)

الإصدار ‎1.0.0-alpha08

‫8 أبريل 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha08. يتضمّن الإصدار ‎1.0.0-alpha08 هذه التعديلات.

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

  • ترقية عمليات CoreText وTextStyle وTextTransform وColorTheme إلى ملفات AndroidX وWidgets الأساسية (I69671 وb/494482597)
    • توفّر السمة CoreText إمكانات أفضل لعرض النصوص، بما في ذلك تغيير حجم النص بشكلٍ متكيّف، وتحسين التحكّم في ميزات تنسيق النصوص، مثل تقسيم الأسطر وسلوك تجاوز السعة.
    • تسمح السمة TextStyle بتسجيل سمات تنسيق النص الشائعة في المستند مرة واحدة، والإشارة إليها من خلال عدة مقاطع نصية.
    • تتيح السمة TextTransform إجراء عمليات تحويل على النص، مثل تحويله إلى أحرف كبيرة.
  • عكس ترتيب عرض العناصر في التنسيق الأفقي عندما يكون اتجاه التنسيق من اليمين إلى اليسار وعدم استخدام الترتيب الأفقي المطلق (Absolute horizontal arrangement) (I2d38e)

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

  • يُفضّل استخدام toRemoteString(DecimalFormat) كواجهة برمجة تطبيقات للمطوّرين. (Ia4925، b/493924433)
  • تمت إزالة المعدِّل clip(shape, size). يجب استخدام المعدِّل clip(shape) بدلاً من ذلك. (I76301)

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

  • عدِّل TextLookup لتتبُّع التغييرات في عناصر المصفوفة. يضمن ذلك إعادة تقييم التعبيرات إذا تغيّر عنصر يتم البحث عنه في مصفوفة (I162c7).

الإصدار ‎1.0.0-alpha07

‫25 مارس 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha07. يتضمّن الإصدار ‎1.0.0-alpha07 هذه التعديلات.

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

  • تنفيذ الضبط غير الخطي لحجم الخط (73b23c0)
  • إتاحة التنسيقات للتعرّف على LayoutDirection (81f984b)

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

  • عرض RemoteSpacer كواجهة برمجة تطبيقات عامة (I1a540)
  • إتاحة واجهة برمجة التطبيقات RemoteBrush applyTo وواجهة برمجة التطبيقات الخاصة بالخطوط للجميع (I87ce9، b/493249631)
  • إزالة مَعلمات المحاذاة والموضع من drawTextOnCircle (I7fd16، b/446824085)
  • عرض دوال معدِّل الدلالات (Ice73b)
  • الكشف عن RemoteImageVector وpainterRemoteVector (If8f38، b/446824085)
  • عرض RemoteTimeDefaults كواجهة برمجة تطبيقات عامة في remote-creation-compose (Iddc74، b/446824085)
  • إتاحة طرق RemoteArrangement.spacedBy للجميع (I36e86)
  • توفير المزيد من واجهات برمجة التطبيقات RemoteDrawScope (I1dde7)
  • عرض أنواع RemotePainter في واجهة برمجة التطبيقات (I1ec8e)
  • عرض واجهة برمجة التطبيقات RemoteBrush (I4b074)
  • واجهة برمجة تطبيقات عامة بسيطة لـ RemoteCanvas (I00853، b/446824085)
  • عرض معدِّلات دلالات RC (I8b175، b/446824085)
  • Expose RemoteFloat.asRemoteDp() (I28b36، b/446824085)
  • عرض عمليات RemoteFloat (I85fb5، b/446824085)
  • تمت إزالة RemoteArrangement.CenterHorizontally واستبدالها بـ RemoteArrangement.Center. (I2f907 وb/471212869 وb/471153933)
  • غيِّر محاذاة RemoteBox لقبول RemoteAlignment واحد. (I0bfbf، b/471212869)

الإصدار ‎1.0.0-alpha06

‫11 مارس 2026

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

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

  • إضافة عملية تجريبية جديدة لـ TextStyle تتيح TextStyle كتابة نمط الخط المستخدم بشكل شائع في المستند مرة واحدة، وإعادة استخدامه من خلال عدة عمليات تشغيل نصية (bfc6487)

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

  • عرض عملية الدمج RemoteTextStyle (I971ce، b/446824085)
  • عرض RemotePainter كواجهة برمجة تطبيقات عامة (I252c1، b/446824085)
  • عرض Border/Clip المعدِّلات وRemoteShape (Id26dd، b/446824085)
  • عرض واجهات برمجة التطبيقات RemoteColor في remote-creation-compose (I4ab00، b/446824085)
  • عرض واجهة برمجة التطبيقات RemoteText (I6b019)
  • عرض واجهة برمجة التطبيقات RemoteImage (Ided31)
  • عرض واجهات برمجة التطبيقات RemoteBoolean وRemoteString وRemoteFloat (Id9ee6)
  • Remote Composable من التعليق التوضيحي WidthIn (I80784)

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

  • نقل المكتبات لاستخدام الإصدار 11 من Java وهذا يعني أنّ الرمز الثانوي الذي تم إنتاجه سيكون Java 11 (إصدار ملف الفئة 55) وقد يتطلّب إزالة التكرار لاستخدام المكتبة (If4c2a وb/457821470).
    • يجب التأكّد من تعديل طول RemoteStrings وعملية البحث عن النص بشكلٍ صحيح. في السابق، كان يتم احتساب طول RemoteStrings في الإطار الأول، ولا يتم تعديله بعد ذلك (e49cb53).
    • إتاحة TextFromFloat للأرقام التي تتضمّن أجزاء كسرية كبيرة، إذ إنّ قيم "digitsAfter" الكبيرة كانت تؤدي سابقًا إلى تقييم العدد العشري إلى 0 (5080bc54)

الإصدار ‎1.0.0-alpha05

‫25 فبراير 2026

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

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

  • تمت إضافة fillParentMaxWidth وfillParentMaxHeight. (4c6d77c)

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

  • عرض الأنواع الشائعة من Remote Composable وModifier (Id1d40)
  • عرض أنواع RemoteState (I22429، b/465453482)

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

  • إصلاحات للتنقّل (0a25299)
  • إصلاحات لمشكلة عدم استجابة الشاشة للمس (0192b69)
  • ضبط الكثافة في وقت مبكر من عملية العرض، حتى يتم تطبيقها بشكل صحيح على الإطار الأول (الذي يتم التقاطه غالبًا في اختبارات لقطات الشاشة) (f775399)

الإصدار ‎1.0.0-alpha04

‫11 فبراير 2026

تم طرح androidx.compose.remote:remote-*:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

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

  • فعِّل استخدام RemoteApplier تلقائيًا، ما يمنع استخدام الدوال غير المركّبة عن بُعد عند إنشاء واجهة مستخدم عن بُعد. يمكن إيقاف هذه الميزة من خلال تغيير isRemoteApplierEnabled في RemoteComposeCreationComposeFlags. (67a405f)
  • إضافة مسافة بين الرموز الرسومية لخطوط الصور النقطية (0852657)
  • تدوير باستخدام نقطة الارتكاز في RemoteCanvas (9a292b3)
  • إضافة RemoteSpacer (12beb72)
  • تجنُّب الاعتماد على java.time، ما يسمح بخفض minSdk لمكتبات الإنشاء إلى 23 (59e30d0)
  • FlowLayout (7efef02)

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

  • إصلاح التقييم للسلسلة ColorExpression غير العامة والسلسلة المحسوبة (c08d0bd)

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

  • تم إيقاف androidx.compose.ui.graphics.NativePaint typealias نهائيًا، استخدِم android.graphics.Paint مباشرةً بدلاً من ذلك (I6303c، b/477394763)
  • استبدِل الإضافة Paint.asFrameworkPaint() بالإضافة Paint.nativePaint لتجنُّب عرض نوع النظام الأساسي في مجموعة المصادر commonMain من خلال typealias (I6303c، b/477394763)

الإصدار ‎1.0.0-alpha03

‫28 يناير 2026

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

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

  • إتاحة أشكال مختلفة وRemoteColors في BorderModifier 0afd343
  • إضافة CombinedAction لدعم إجراءات متعددة في أحداث النقر 10e16a2

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

  • تم نقل واجهات برمجة التطبيقات RemoteColor وRemoteBitmap لاستخدام أنواع Compose بدلاً من عرض أنواع Android مباشرةً a9bfbb8
  • تمت إضافة النوع RemoteDensity للسماح بتحديد ما إذا كان سيتم تقييم الكثافة على "المشغّل" (عند إنشاء مستند لجهاز بعيد)، أو تضمين التعبيرات (لتحسين حجم المستند عند استخدامه على الجهاز نفسه) 54352bb
  • RemoteState constantValueOrNull إعادة التسمية (I6ad5c، b/467050397)

الإصدار ‎1.0.0-alpha02

‫14 يناير 2026

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

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

  • إضافة الحد الأدنى/الأقصى لحجم الخط في CoreText I7bd3c

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

  • عرض الحد الأدنى من واجهة برمجة التطبيقات العامة لبنية Glance Wear الأساسية (I7b4b9، b/467532762)
  • إرجاع CapturedDocument من captureSingleRemoteDocument (I5a283، b/467532762)

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

  • إصلاح موضع التمرير بعد إعادة التخطيط + إضافة إمكانية استخدام تأثيرات الحواف (6d4551)

الإصدار ‎1.0.0-alpha01

‫17 ديسمبر 2025

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

  • ‫Remote Compose هو إطار عمل لإنشاء واجهة مستخدم لمساحات عرض عن بُعد.