כתיבה מרחוק

כתיבה מרחוק

  

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

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

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

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

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

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

Groovy

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

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

משוב

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

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

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

גירסה 1.0

גרסה ‎1.0.0-alpha11

‫19 במאי 2026

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

שינויים ב-API

• הצגת מפעל סטטי של 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.

שינויים ב-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)
• הגדרת שיטות RemoteArrangement.spacedBy כציבוריות (I36e86)
• חשיפה של עוד RemoteDrawScope API ‏ (I1dde7)
• חשיפת סוגים ב-API ‏ (I1ec8e)RemotePainter
• חשיפת RemoteBrush API ‏ (I4b074)
• Minimal public API for 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. המשמעות היא שבייטקוד (bytecode) שנוצר יהיה 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)

External Contribution

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