remote compose

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

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

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

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

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

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

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

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

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

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

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

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

الملاحظات

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

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

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

الإصدار 1.0

الإصدار ‎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 هو إطار عمل لإنشاء واجهة مستخدم لمساحات عرض عن بُعد.