Remote Compose

  
Remote Compose 是一種框架，可為遠端途徑建立 UI
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 5 月 6 日 - - - 1.0.0-alpha010

宣告依附元件

如要新增 compose-remote 的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

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

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

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

Kotlin

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

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

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

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版本

1.0.0-alpha010 版

2026 年 5 月 6 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha010。1.0.0-alpha010 版包含這些修訂項目。

功能

  • 新增 EnforceCleanRecomposition 旗標 (I6e4408)。為支援 RemoteCompose 中的重組作業，我們已禁止在組合完成前將任何內容寫入文件。這可避免文件在重組期間只寫入部分內容。如果這項行為導致現有程式碼發生問題，您可以將 isEnforceCleanRecompositionEnabled 設為 false，停用這項行為。

API 變更

修正錯誤

  • 修正使用 RemoteColor (而非靜態顏色) 做為背景顏色時的背景剪裁問題 (If70842、b/505116577)
  • 支援為從 URI 載入的點陣圖提供明確大小。先前系統會將大小計算為 1x1，並將該像素縮放至容器大小 (Id4fff、b/487936996)
  • 防止沒有 SensorManager 的裝置發生當機錯誤 (I1fc947、b/498302479)
  • 修正 TIME_FROM 運算式未使用提供的時鐘，導致無法針對時間長度運算式進行可靠的測試 (I5f816、b/501405389)

1.0.0-alpha09 版本

2026 年 4 月 22 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha09。1.0.0-alpha09 版包含這些修訂項目。

API 變更

  • 修飾符可點擊已變更，不再接受動作參數的空值。請改用 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 版本

2026 年 4 月 8 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂項目。

新功能

  • 將 CoreText、TextStyle、TextTransform 和 ColorTheme 作業升級為基準 AndroidX 和 Widgets 設定檔 (I69671、b/494482597)
    • CoreText 可提供更豐富的文字算繪能力，包括自動調整文字大小，以及改善對文字版面配置功能 (例如換行和溢位行為) 的控制。
    • TextStyle 可讓您在文件中擷取常見的文字樣式屬性一次，並由多個文字執行個體參照。
    • TextTransform 可轉換文字，例如將文字轉換為大寫。
  • 如果版面配置方向為 RTL，且未使用絕對水平排列方式，則會反向算繪水平版面配置中的項目。(I2d38e)

API 變更

  • 建議使用 toRemoteString(DecimalFormat) 做為開發人員 API。(Ia4925、b/493924433)
  • 已移除修飾符 clip(shape, size)。請改用修飾符 clip(shape)。(I76301)

修正錯誤

  • 更新 TextLookup，追蹤陣列元素變更。這樣一來，如果運算式在陣列中查詢的元素已變更 (I162c7)，系統就會重新評估運算式

1.0.0-alpha07 版本

2026 年 3 月 25 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha07。1.0.0-alpha07 版包含這些修訂項目。

新功能

  • 實作非線性字型縮放 (73b23c0)
  • 讓版面配置瞭解 LayoutDirection (81f984b)

API 變更

1.0.0-alpha06 版本

2026 年 3 月 11 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

新功能

  • 為 TextStyle 新增實驗性作業。TextStyle 可讓您將常用的字體排版樣式寫入文件一次，並由多個文字執行 (bfc6487) 重複使用。

API 變更

修正錯誤

  • 將程式庫移至 Java 11 目標。也就是說，產生的位元碼會是 Java 11 (類別檔案版本 55)，可能需要進行脫糖處理才能使用程式庫 (If4c2a、b/457821470)
    • 確認長度和 textlookup 更新正確無誤。先前系統會在第一個影格計算 RemoteStrings 的長度，之後不會更新 (e49cb53)
    • 支援分數部分較大的數字。TextFromFloat先前「digitsAfter」值過大可能會導致浮點數評估為 0 (5080bc54)

1.0.0-alpha05 版本

2026 年 2 月 25 日

發布 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 版本

2026 年 2 月 11 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

  • 預設啟用 RemoteApplier，這樣在建立遠端 UI 時，就不會使用非遠端可組合函式。如要停用這項功能，請變更 RemoteComposeCreationComposeFlags 中的 isRemoteApplierEnabled。(67a405f)
  • 為點陣圖字型新增字元間距 (0852657)
  • 在 RemoteCanvas 中以樞紐旋轉 (9a292b3)
  • 新增 RemoteSpacer (12beb72)
  • 避免 java.time 依附元件，將建立程式庫的 minSdk 降低至 23 (59e30d0)
  • FlowLayout (7efef02)

修正錯誤

  • 修正非全域 ColorExpression 和計算字串的評估。(c08d0bd)

外部貢獻

  • androidx.compose.ui.graphics.NativePaint 型別別名已淘汰，請改為直接使用 android.graphics.Paint (I6303c、b/477394763)
  • 將 Paint.asFrameworkPaint() 擴充功能替換為 Paint.nativePaint，避免透過 typealias 將平台類型公開至 commonMain 來源集 (I6303c、b/477394763)

1.0.0-alpha03 版本

2026 年 1 月 28 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

新功能

  • 支援 BorderModifier 中的不同形狀和 RemoteColors BorderModifier 0afd343
  • 新增 CombinedAction，支援點擊事件的多個動作 10e16a2

API 變更

  • 已將 RemoteColor 和 RemoteBitmap 的 API 遷移至使用 Compose 型別，而非直接公開 Android 型別 a9bfbb8
  • 導入 RemoteDensity 型別，以便判斷是否要在 Player 上評估 Density (為遠端裝置產生文件時)，或內嵌運算式 (在同一部裝置上時，可最佳化文件大小) 54352bb
  • RemoteState constantValueOrNull 重新命名 (I6ad5c、b/467050397)

1.0.0-alpha02 版

2026 年 1 月 14 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

新功能

  • 為 CoreText 新增最小/最大字型大小。I7bd3c

API 變更

修正錯誤

  • 修正重新配置後的捲動位置，並新增邊緣效果支援 (6d4551)

1.0.0-alpha01 版

2025 年 12 月 17 日

發布 androidx.compose.remote:remote-*:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

  • Remote Compose 是一種架構，可為遠端介面建立 UI。