remote compose

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

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

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

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

أنيق

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

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

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

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

Kotlin

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

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

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

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

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

الملاحظات

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

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

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

الإصدار 1.0

الإصدار ‎1.0.0-alpha14

‫01 يوليو 2026

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

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

  • تم عرض طُرق وضع التصميم RemoteDensityBehavior التي تراعي الكثافة والسلوك في RemoteCreationDisplayInfo كواجهات برمجة تطبيقات عامة. (Iafca2، b/524921038)
  • تم عرض densityBehavior في RemoteCreationDisplayInfo وRemoteComposeCreationState. (Iae938، b/524921038)
  • تمت إتاحة RemoteComposeCreationComposeFlags للجميع. (I1f899، b/467532762)

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

  • تمت إضافة عملية فحص lint للتحذير من استخدام CompositionLocals العادي في ‎ @RemoteComposable. (Ic12ba)
  • إزالة شرط compileSdk 37 (If78b4)
  • تمت إزالة مستندات rememberRemoteStringList القديمة. (I99722)
  • تم إصلاح مشكلة عرض تعديل وزن الخط عندما يكون التعديل غير محدّد. (I16704، b/522050705)
  • تمت محاذاة BorderModifier مع سلوك Compose للرسم داخل حدود المكوّن. (Iae36c)
  • تم إصلاح RemoteComposeWriter لتسلسل DOC_PROFILES في الدالة الإنشائية. (I3bbea)
  • تم إصلاح مشكلة عدم توفّر RemoteModifier.background بشكلٍ أصلي للألوان الديناميكية. (If4f04، b/499049643)

الميزات - تمت إضافة المَعلمة typefaceResolver إلى RemoteDocumentPlayer. (Ie7cda، b/524621320) - تمت إضافة إمكانية استخدام مكوّنات مخصّصة في مشغّل Compose. (Ic0559) - تم تحسين عمليات الاختيار التي يكون فيها كلا البديلين متماثلين. (I55b9e، b/390355362)

الإصدار ‎1.0.0-alpha13

‫17 يونيو 2026

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

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

  • أعِد تسمية RemoteBitmap إلى RemoteImageBitmap لتحسين اتساق التسمية. (I4fde1، b/513228889)
  • تمّت إعادة تسمية RemoteBitmapShader إلى RemoteImageBrush وإتاحتها لواجهة برمجة التطبيقات العامة. (I7adaf، b/513228889)
  • عرض عوامل تشغيل RemoteInt المقارنة (I5fe3d، b/513228889)
  • تم عرض captureRemoteDocument Flow API وcaptureSingleRemoteDocument overload جديد (يستقبل RemoteCreationDisplayInfo) كواجهات برمجة تطبيقات عامة. (I87b0e، b/513228889)
  • إعادة تسمية عوامل تشغيل المقارنة (eq وne) في RemoteBoolean إلى isEqualTo وisNotEqualTo (Ia05b9، b/513228889)
  • إتاحة RemoteEnum وRemoteStateLayout كواجهات برمجة تطبيقات عامة (I5c6ec)
  • تم عرض السمة fontVariationSettings في واجهة RemotePaint كواجهة برمجة تطبيقات متاحة للجميع. (Ic3c46، b/513228889)
  • تمّت إزالة الدالتين RemoteInt وRemoteFloat toRemoteString. (I62a6b، b/513228889)
  • RemoteTypeface API المعروض (Iadfdb، b/502907551)
  • تمت إعادة تسمية دوال المصنع الحالية ValueChange إلى valueChange بأحرف صغيرة. (I812b9، b/513228889)
  • تمت إتاحة معاينات PendingIntentAction في بيئات التطوير المتكاملة (IDE) من خلال تأجيل الوصول إلى PendingIntent باستخدام تعبير lambda وإرجاع إجراء لا يؤدي إلى أي عملية في وضع المعاينة. (I43b37، b/512403924)

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

  • إضافة تجريدات داخلية TypefaceResolver وDefaultTypefaceResolver لتقسيم عملية تحديد الخط إلى وحدات (Ia1df7، b/513228889)
  • تمت إزالة واجهتَي برمجة التطبيقات القديمتَين RemoteIntReference وRemoteStringList، وتمت إضافة RemoteStringArray لتوفير الدعم لمصفوفات السلاسل البعيدة. (I12931)
  • نقل LocalInspectionMode إلى مرحلة الالتقاط في ميزة "الكتابة الذكية" عن بُعد (I6a56b، b/512403924)

الإصدار ‎1.0.0-alpha12

‫3 يونيو 2026

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

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

  • تم تغيير المعدِّلَين onTouchCancel(varargs action) وonTouchCancel(List<Action>) إلى onTouchCancel(action). استخدِم CombinedAction لعرض قائمة بالإجراءات. (Ia7b5a، b/498881738)
  • عرض المصنع الثابت RemoteBoolean (Ifedb6، b/484137042)
  • تم عرض الدالتَين hostAction وcombinedAction للسماح بالاستخدام الخارجي. (I78002)
  • إضافة الدوال RemoteContentPreview وRemoteDocumentPreview وRemotePreviewWrapper لمعاينة محتوى Remote Compose (I706ae، b/507379403)

الإصدار ‎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)
  • تمت إضافة المعدّلات alpha وrotate وscale. (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 إجراء عمليات تحويل على النص، مثل تحويله إلى أحرف كبيرة.
  • عرض العناصر بترتيب عكسي في التصميم الأفقي عندما تكون جهة التصميم من اليمين إلى اليسار وعدم استخدام الترتيب الأفقي المطلق (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).
    • تأكَّد من تعديل الطول وtextlookup بشكل صحيح. في السابق، كان يتم احتساب طول 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 هو إطار عمل لإنشاء واجهة مستخدم لمساحات عرض عن بُعد.