Compose Material3 自動調整

  
使用 Material 3 自動調整式程式庫建立自動調整式 UI 會根據目前的視窗自動調整 例如視窗大小類別或裝置型態這個程式庫提供 預設的 Scaffold 實作,以及必要的建構區塊可組合項 打造專屬體驗
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 9 月 4 日 1.0.0 - - 1.1.0-alpha02

宣告依附元件

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

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

Groovy

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 說明文件

Compose Material3 自動調整版本 1.1

1.1.0-alpha02 版本

2024 年 9 月 4 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02。1.1.0-alpha02 版包含這些修訂版本

新功能

  • 製造商支援動作自訂 (I0bf9c)、(I80e66),可在自動調整 Scaffold 狀態期間變更預設動作。製作者可以選用一組預設的進出轉場,或是以新的動態範圍所提供的資訊,導入純自訂轉場效果。
  • 實作窗格展開拖曳控點的淡出動畫 (46e3c69)
  • 將記憶的 PaneExpansionState 設為可儲存 (61ff76f)

API 變更

  • 將缺少的窗格展開 APis 新增至 Scaffolds (Ic5bc0)
  • ThreePaneScaffoldDestinationItem.content 已重新命名為 contentKeyrememberListDetailPaneScaffoldNavigatorrememberSupportingPaneScaffoldNavigator 預設類型引數已從 Nothing 變更為 Any。(I58749)。
  • ThreePaneScaffoldState 標示為穩定版 (I64aec)
  • 將拖曳控點參數限定範圍 (Ic0aa2)

1.1.0-alpha01 版本

2024 年 8 月 21 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01。1.1.0-alpha01 版包含這些修訂版本

新功能

  • 引入對適應性 Scaffold 的窗格展開支援。

API 變更

  • 將窗格擴充 API 引入公開 (I301d6)
  • 引入 ThreePaneScaffoldState 來控制窗格值轉換。新增了接受此狀態的 ListDetailPaneScaffoldSupportingPaneScaffold 超載。(I5db3b)。
  • 介紹窗格展開鍵和金鑰提供者介面 (Id621f)

修正錯誤

  • 修正排除轉軸時的錯誤分區計算錯誤。(9dfd483)。

Compose Material3 自動調整版本 1.0

1.0.0 版本

2024 年 9 月 4 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0。1.0.0 版包含這些修訂版本

1.0.0 的主要功能

1.0.0-rc01 版

2024 年 8 月 21 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01。1.0.0-rc01 版包含這些修訂版本

修正錯誤

  • 修正排除轉軸時的錯誤分區計算錯誤。(9dfd483)。

1.0.0-beta04 版

2024 年 6 月 26 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04。1.0.0-beta04 版包含這些修訂版本

修正錯誤

  • 修正在轉軸邊界更新時,版面配置不會跟著更新的問題。(71e9cf1)。

1.0.0-beta03 版

2024 年 6 月 12 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03。1.0.0-beta03 版包含這些修訂版本

修正錯誤

  • 修正 Beta02 中依附元件解決方案錯誤導致的當機問題。

1.0.0-beta02 版

2024 年 5 月 29 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02。1.0.0-beta02 版包含這些修訂版本

1.0.0-beta01 版

2024 年 5 月 14 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01。1.0.0-beta01 版包含這些修訂版本

1.0.0-alpha12 版

2024 年 5 月 1 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12。1.0.0-alpha12 版包含這些修訂版本

API 變更

  • HingeInfo 中新增 isFlat 資訊 (Ie0516b/333784198)
  • 將自動調整式 API 設為非實驗性質 (I1d038)
  • 將自動調整版面配置 API 設為非實驗性質 (Id23df)
  • BackNavigationBehavior 從列舉變更為值類別 (Id8757)

修正錯誤

  • 將轉場比例變更為 lambda (I6f5a9)
  • 修正 SizeTracker 的初始狀態問題 (18326a9)
  • Posture 等式檢查中加入轉軸清單 (6687137)

1.0.0-alpha11 版本

2024 年 4 月 17 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11。1.0.0-alpha11 版包含這些修訂版本

API 變更

  • 將範圍介面設為密封。(Iefa57)。
  • 導入 AnimatedPaneScope。(I62d73b/332750742)
  • AdaptStrategy 密封且保持穩定。(Ia28b2)。
  • 導入 PaneScaffoldDirective 的複製方法。(I9291f)。
  • ThreePaneScaffoldScope 標示為實驗功能。(I9d527)。
  • 提供易於使用的 Scaffold API,以便支援導覽功能。(I263f0b/321010778)

1.0.0-alpha10 版本

2024 年 4 月 3 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂版本

API 變更

  • 將預設寬度設為自動調整與可自訂。(Ic3abc)。
  • 重新命名 scaffold 指令計算函式。(I10855)。
  • 移除 scaffold API 中的邊框間距和插邊。(I786f8)。
  • 新增不含一般類型的導覽器 remember 方法。(I607c3)。

1.0.0-alpha09 版本

March 20, 2024

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09。1.0.0-alpha09 版包含這些修訂版本

API 變更

  • 將狀態轉換欄位新增至 ThreePaneScaffoldScope。(I3d917)。
  • 重新排序 Scaffold 參數。(I4dff5)。
  • 請提供 AnimatedPane 修飾符參數的預設值。(I77dd7)。

修正錯誤

  • 在窗格動作中加入空格字元大小。(a3174ca)。

1.0.0-alpha08 版本

2024 年 3 月 6 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂版本

新功能

  • 實作在切換窗格時延遲滑行的做法。(I1a38e)。

API 變更

  • 已移除 ThreePaneScaffoldState 介面。(I63f23)。

1.0.0-alpha07 版本

2024 年 2 月 21 日