יצירת הודעות מרחוק

יצירת הודעות מרחוק

  

הפניית API
androidx.compose.remote.creation
androidx.compose.remote.creation.compose.layout

‫Remote Compose הוא framework ליצירת ממשק משתמש לפלטפורמות מרוחקות

העדכון האחרון	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסת אלפא
‫1 ביולי 2026	-	-	-	‎1.0.0-alpha14

הצהרה על יחסי תלות

כדי להוסיף תלות ב-compose-remote, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

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")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גירסה 1.0

גרסה ‎1.0.0-alpha14

‫1 ביולי 2026

‫androidx.compose.remote:remote-*:1.0.0-alpha14 מופץ. גרסה ‎1.0.0-alpha14 מכילה את השמירות האלה.

שינויים ב-API

• ‫Constructors חשופים RemoteDensityBehavior ו-density-behavior-aware ב-RemoteCreationDisplayInfo בתור ממשקי API ציבוריים. ‫(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 מכילה את השמירות האלה.

שינויים ב-API

• שינינו את השם RemoteBitmap ל-RemoteImageBitmap כדי לשפר את העקביות בשמות. ‫(I4fde1, ‏ b/513228889)
• משנים את השם של RemoteBitmapShader ל-RemoteImageBrush וחושפים אותו ל-API ציבורי. (I7adaf, ‏ b/513228889)
• הצגת אופרטורים להשוואה RemoteInt. ‫(I5fe3d, b/513228889)
• הוספנו את captureRemoteDocument Flow API ואת captureSingleRemoteDocument overload החדש (שמקבל RemoteCreationDisplayInfo) כממשקי API ציבוריים. ‫(I87b0e, ‏ b/513228889)
• שינוי השם של אופרטורים להשוואה (eq, ‏ ne) ב-RemoteBoolean ל-isEqualTo, ‏ isNotEqualTo. (Ia05b9, ‏ b/513228889)
• חשיפת RemoteEnum ו-RemoteStateLayout כממשקי API ציבוריים (I5c6ec)
• המאפיין fontVariationSettings נחשף בממשק RemotePaint כ-API ציבורי. (Ic3c46, ‏ b/513228889)
• הסרת השיטות RemoteInt ו-RemoteFloat toRemoteString. (I62a6b, ‏ b/513228889)
• ‫API חשוף של RemoteTypeface. (Iadfdb, b/502907551)
• השם של פונקציות קיימות של ValueChange שונה לאותיות קטנות valueChange. (I812b9, ‏ b/513228889)
• הפכנו את PendingIntentAction לבטוח לתצוגות מקדימות של IDE על ידי דחיית הגישה ל-PendingIntent באמצעות lambda והחזרת פעולה ללא פעולה במצב תצוגה מקדימה. (I43b37, b/512403924)

תיקוני באגים

• הוספנו הפשטות פנימיות של TypefaceResolver ו-DefaultTypefaceResolver כדי ליצור מודולריות בפתרון בעיות שקשורות לגופנים. (Ia1df7, b/513228889)
• הסרנו את ממשקי ה-API 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 מכילה את השמירות האלה.

שינויים ב-API

• המשנים onTouchCancel(varargs action) ו-onTouchCancel(List<Action>) השתנו ל-onTouchCancel(action). אפשר להשתמש ב-CombinedAction כדי ליצור רשימה של פעולות. ‫(Ia7b5a, ‏ b/498881738)
• הוספת RemoteBoolean static factory. (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 מכילה את השמירות האלה.

שינויים ב-API

• הוספת RemoteInt static factory. (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.

שינויים ב-API

• נוספה ספריית בדיקה ל-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 מכילה את השמירות האלה.

שינויים ב-API

• המשנה clickable השתנה כך שהוא לא מקבל ערך null לפרמטר action. במקומו, צריך להשתמש ב-Action.Empty. (I21be9, b/498881738)
• הפרמטרים של משנה הריווח הפנימי השתנו מ-left/right (שמאל/ימין) ל-start/end (התחלה/סיום). (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)

שינויים ב-API

• מומלץ להשתמש ב-toRemoteString(DecimalFormat) בתור ה-API למפתחים. (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)

שינויים ב-API

• חשיפת RemoteSpacer כממשק API ציבורי (I1a540)
• הפיכת ה-API של הגופן RemoteBrush applyTo לציבורי (I87ce9, ‏ b/493249631)
• השמטת פרמטרים של יישור ומיקום מ-drawTextOnCircle (I7fd16, ‏ b/446824085)
• הצגת פונקציות לשינוי סמנטיקה (Ice73b)
• חשיפה של RemoteImageVector ושל painterRemoteVector (If8f38, ‏ b/446824085)
• חשיפת RemoteTimeDefaults כ-API ציבורי ב-remote-creation-compose (Iddc74, ‏ b/446824085)
• הגדרת ה-methods‏ RemoteArrangement.spacedBy כציבוריות (I36e86)
• חשיפה של עוד RemoteDrawScope API ‏ (I1dde7)
• הצגת סוגים ב-API‏ (I1ec8e)RemotePainter
• חשיפת RemoteBrush API ‏ (I4b074)
• ‫API ציבורי מינימלי ל-RemoteCanvas (I00853, b/446824085)
• הצגת משמעות של RC Modifiers (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)

שינויים ב-API

• הצגת מיזוג RemoteTextStyle (I971ce, b/446824085)
• הצגת RemotePainter כממשק API ציבורי (I252c1, ‏ b/446824085)
• חשיפת Border/Clip משנים וRemoteShape. ‫(Id26dd, ‏ b/446824085)
• חשיפת ממשקי API ב-RemoteColor‏ (remote-creation-composeI4ab00, ‏ b/446824085)
• חשיפת RemoteText API ‏ (I6b019)
• חשיפת RemoteImage API ‏ (Ided31)
• חשיפה של ממשקי API‏ RemoteBoolean, RemoteString ו-RemoteFloat (Id9ee6)
• ‫Remote Composable מתוך הערה WidthIn (I80784)

תיקוני באגים

• הספריות מועברות לשימוש ביעד Java 11. המשמעות היא שקוד הבייטים שיופק יהיה 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)

שינויים ב-API

• חשיפה של סוגים נפוצים של 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 כברירת מחדל, שמונעת שימוש בפונקציות לא מרוחקות של Remote Composable כשיוצרים ממשק משתמש מרוחק. אפשר להשבית את ההגדרה הזו על ידי שינוי isRemoteApplierEnabled בRemoteComposeCreationComposeFlags. (67a405f)
• הוספת ריווח בין גליפים לגופנים של מפת סיביות (0852657)
• סיבוב עם נקודת משען ב-RemoteCanvas (9a292b3)
• הוספה RemoteSpacer (12beb72)
• כדי להימנע מתלות ב-java.time, אפשר להוריד את הגרסה של ספריות היצירה ל-23 (59e30d0)minSdk
• FlowLayout (7efef02)

תיקוני באגים

• תיקון החישוב של ColorExpression שאינו גלובלי ושל מחרוזת מחושבת. (c08d0bd)

חישוב צריכת הנתונים

• האפשרות androidx.compose.ui.graphics.NativePaint typealias הוצאה משימוש. במקומה יש להשתמש ישירות ב-android.graphics.Paint (I6303c,‏ b/477394763)
• החלפת התוסף Paint.asFrameworkPaint() בתוסף Paint.nativePaint כדי למנוע חשיפה של סוג הפלטפורמה ב-sourceset‏ 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

שינויים ב-API

• העברנו את ממשקי ה-API של RemoteColor ושל RemoteBitmap לשימוש בסוגי Compose, במקום לחשוף ישירות סוגי Android a9bfbb8
• הוספנו RemoteDensity type, כדי לאפשר קביעה אם להעריך את הצפיפות בנגן (כשיוצרים מסמך למכשיר מרוחק), או להוסיף את הביטויים בשורה (כדי לייעל את גודל המסמך כשמדובר באותו מכשיר) 54352bb
• ‫RemoteState constantValueOrNull rename (I6ad5c, b/467050397)

גרסה ‎1.0.0-alpha02

‫14 בינואר 2026

‫androidx.compose.remote:remote-*:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• הוספת גודל גופן מינימלי ומקסימלי ל-CoreText. I7bd3c

שינויים ב-API

• חשיפת API ציבורי מינימלי לתשתית של 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 הוא framework ליצירת ממשק משתמש למשטחים מרוחקים.