Compose Material 3 Adaptive

宣告依附元件

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

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

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

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

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

意見回饋

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

建立新問題

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

Compose Material3 Adaptive 1.1 版

1.1.0-alpha07 版本

2024 年 11 月 13 日

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

API 變更

• 移除自適應程式庫中的拖曳手柄實作項目，並鼓勵使用者使用 M3 版本。同時，我們也推出修飾符，為提供的拖曳手柄可組合函式提供窗格展開拖曳功能。您也可以將 DraggableState 隱藏為實作詳細資料，以便我們日後視需要變更。(Ib50cd)。
• 根據 UXR 意見回饋，將窗格動作自訂項目的進入點從架構函式移至 AnimatedPane。(I10f72)。
• 引入快速滑過支援功能，以及用於分頁展開的自訂動畫規格。(Ie207d、b/362584341)。

修正錯誤

• 修正取消預測回復問題。(36a3e0a)、(b/369899645)

1.1.0-alpha06 版本

2024 年 10 月 30 日

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

API 變更

• 在 PaneScaffoldTransitionScope.motionProgress 中新增 FloatRange。(Iac0dd)。
• 在可導覽的 Scaffold 中，將導覽器參數類型變更為一般類型。(I1da6e)

1.1.0-alpha05 版本

2024 年 10 月 16 日

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

API 變更

• 引入動畫規格類別，確保更一致的動作行為和日後的可擴充性。(I2d3cc)
• 提供動畫類型，並將 PaneMotionData 中的 currentXXXXX 重新命名為 originXXXX。(I7c61a)

1.1.0-alpha04 版本

2024 年 10 月 2 日

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

新功能

• 已在 NavigableListDetailPaneScaffold 和 NavigableSupportingPaneScaffold 中新增預測返回支援功能。(I4dc21、b/359616816)。

API 變更

• 將 ThreePaneScaffoldState 新增至 ThreePaneScaffoldNavigator 導覽方法已變更為 suspend，以便支援含有動畫的導覽。新增 seekBack 以支援部分導覽狀態 (例如預測返回)。(I5a651、b/359616816)。
• 新增 MutableThreePaneScaffoldState 以控管結構體值之間的轉換。現有的 ThreePaneScaffoldState 已變成唯讀。(Idb3c6)。
• 公開預設窗格動作實作 (I95a7b)
• 啟用設定窗格展開狀態的初始錨點 (Ie41b3、b/362350560)

修正錯誤

• 強制執行拖曳手把的 48x48dp 觸控目標大小 (7ce6635、b/366018217)
• 在設定變更後還原固定位置 (3c9fc6b、b/362353672)

1.1.0-alpha03 版本

2024 年 9 月 18 日

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

1.1.0-alpha02 版本

2024 年 9 月 4 日

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

新功能

• 創作者可透過動作自訂功能 (I0bf9c) 和 (I80e66) 在自適應架構狀態變更期間變更預設動作。創作者可以選擇一組預設的進入和離開轉場效果，或是透過新動畫範圍提供的資訊，實作純自訂轉場效果。
• 實作窗格展開拖曳手柄的淡出動畫 (46e3c69)
• 讓已記住的 PaneExpansionState 可儲存 (61ff76f)

API 變更

• 將缺少的窗格展開 API 新增至結構體 (Ic5bc0)
• ThreePaneScaffoldDestinationItem.content 已重新命名為 contentKey。rememberListDetailPaneScaffoldNavigator 和 rememberSupportingPaneScaffoldNavigator 的預設類型引數已從 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 版本包含這些修訂版本。

新功能

• 為自適應構架引進窗格展開功能支援。

API 變更

• 向大眾推出窗格展開 API (I301d6)
• 推出 ThreePaneScaffoldState 來控制窗格值轉換。新增可接受此狀態的 ListDetailPaneScaffold 和 SupportingPaneScaffold 超載。(I5db3b)。
• 引入窗格展開鍵和金鑰供應器介面 (Id621f)

修正錯誤

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

Compose Material3 Adaptive 1.0 版

1.0.0 版本

2024 年 9 月 4 日

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

1.0.0 的主要功能

• 一行式可組合函式 currentWindowSize()、collectFoldingFeaturesAsState() 和 currentWindowAdaptiveInfo()，可取得應用程式所需的視窗資訊，例如視窗大小和折疊功能。
• ListDetailPaneScaffold 和 SupportingPaneScaffold 提供兩種 Material3 標準版面配置，可根據不同的視窗設定自動調整。這兩個結構板也能完全自訂，以滿足創作者的不同需求。
• ThreePaneScaffoldNavigator 及其相關的記住函式 rememberListDetailPaneScaffoldNavigator() 和 rememberSupportingPaneScaffoldNavigator()，可在自適應架構中提供導覽解決方案，同時顯示多個導覽目的地，而非在非自適應環境中常見的一次一個目的地設定。
• 變更自適應鷹架狀態時，預設的內建 Material3 動畫。

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 變更

• 將 isFlat 資訊新增至 HingeInfo (Ie0516、b/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。(I62d73、b/332750742)。
• 讓 AdaptStrategy 保持封閉且穩定。(Ia28b2)
• 引入 PaneScaffoldDirective 的複製方法。(I9291f)。
• 將 ThreePaneScaffoldScope 標示為實驗性質。(I9d527)
• 提供易於使用的輔助結構 API，支援導覽功能。(I263f0、b/321010778)。

1.0.0-alpha10 版本

2024 年 4 月 3 日

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

API 變更

• 讓預設偏好寬度可自動調整及自訂。(Ic3abc)。
• 重新命名鷹架指令計算函式。(I10855)。
• 從結構體 API 中移除邊框間距和內嵌間距。(I786f8)。
• 新增不含泛型類型的導覽器記住方法。(I607c3)。

1.0.0-alpha09 版本

March 20, 2024

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

API 變更

• 將狀態轉換欄位新增至 ThreePaneScaffoldScope。(I3d917)。
• 重新排序結構體參數。(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 日