本頁面由 Cloud Translation API 翻譯而成。

Privacysandbox UI

待辦事項

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2024 年 5 月 14 日	-	-	-	1.0.0-alpha08

宣告依附元件

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

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

Groovy

dependencies {
    // Use to implement privacysandbox ui
    implementation "androidx.privacysandbox.ui:ui:1.0.0-alpha08"

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha08"
   
    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08"
}

Kotlin

dependencies {
    // Use to implement privacysandbox ui
    implementation("androidx.privacysandbox.ui:ui:1.0.0-alpha08")

    // Use to implement privacysandbox ui-core
    implementation("androidx.privacysandbox.ui:ui-core:1.0.0-alpha08")

    // Use to implement privacysandbox ui-provider
    implementation("androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08")

    
}

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

意見回饋

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

建立新問題

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

1.0 版

1.0.0-alpha08 版

2024 年 5 月 14 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha08、androidx.privacysandbox.ui:ui-core:1.0.0-alpha08 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂版本。

新功能

開始支援在 PoolingContainer 中使用 SandboxedSdkView，例如 RecyclerView。當 SandboxedSdkView 含有 PoolingContainer 的父項時，其 UI 工作階段的生命週期會與 PoolingContainer 的生命週期保持一致，以確保工作階段可透過卸離視窗的方式持續存在。

API 變更

已淘汰 Privacy Sandbox Activity API。這些 API 現已改為顯示在專屬的 Activity 程式庫 androidx.privacysandbox.activity 中。(I68beb)。

修正錯誤

修正在集區容器內顯示遠端內容時發生的轉譯錯誤。(I804df)。
修正在回溯相容性模式中導致 ViewGroups 顯示問題的錯誤。(I8de92)。
當 SandboxedSdkView 的其中一個父項為 PoolingContainer 時，當 PoolingContainer 指出資源可以釋放時，而非在視窗卸離時關閉 UI 工作階段。(I2046b)。

外部貢獻

GestureDetectorCompat 現已淘汰，因為 minSdk 有 GestureDetector 可用。(Icc4cd)。

1.0.0-alpha07 版

2023 年 10 月 18 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha07、androidx.privacysandbox.ui:ui-core:1.0.0-alpha07 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07。1.0.0-alpha07 版包含此連結所列的修訂項目。

新功能

為程式庫新增回溯相容性支援。在 API 33 以下版本中，供應器的檢視畫面會顯示在應用程式程序內的不同類別載入器中。(If0b7a)。
新增邏輯，允許在同一個頁框中提交主機和提供者容器的大小調整作業，避免出現 UI 資源浪費的情形。(Ic2cd9)。

API 變更

程式庫的 MinSdk 已升級為 API 21。(I474b8)。

1.0.0-alpha06 版

2023 年 9 月 20 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha06、androidx.privacysandbox.ui:ui-core:1.0.0-alpha06 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06。1.0.0-alpha06 版包含此連結所列的修訂項目。

新功能

將片段 SandboxedSdkView 新增至其可能會捲動的「定界父項」檢視畫面。這可確保 SandboxedSdkView 的內容，不會在根內容檢視畫面以外的其他檢視畫面或任何 UI 元件中遮住。(I9ea94)。

API 變更

將 SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction 重新命名為 orderProviderUiAboveClientUi (Iecb7e)

修正錯誤

將正確的 Z 順序值傳送至主機。(Ib0ddf)。
僅在垂直捲動/快速滑動時轉移觸控焦點。(I0528c)。

1.0.0-alpha05 版

2023 年 8 月 9 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha05、androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05。查看 1.0.0-alpha05 版的修訂項。

新功能

新增邏輯，將觸控焦點移至來自 SandboxedSdkView 的捲動和快速滑過手勢。如此一來，用戶端的可捲動容器代管供應商 UI 就能正確回應捲動和快速滑過動作。

API 變更

在 SandboxedUiAdapter 中新增 windowInputToken 參數 (Ief578)

修正錯誤

在第一次繪圖後將工作階段狀態設為「Active」(I36f3f)
修正 SandboxedSdkView 的版面配置問題。(I09cb8)。
新增將觸控焦點轉移至主機的邏輯。(I33b54)。
在 SandboxedUiAdapter 中新增 windowInputToken 參數。這麼做可確保 SurfaceControlViewHost 的權杖與嵌入階層的主機正確關聯。(Ief578)。
在主執行緒中執行 notifyResized。(I62440)。
修正 Session.close() 流程中的當機問題。(I5392e)。

1.0.0-alpha04 版

2023 年 6 月 21 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha04、androidx.privacysandbox.ui:ui-core:1.0.0-alpha04 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04。1.0.0-alpha04 版包含以下修訂項目。

新功能

加入 SdkActivityLauncher。這個介面允許支援執行階段的 SDK 啟動活動。(I5b3dc)。

修正錯誤

修正 notifyZOrderChanged 競爭狀況。確保所有 Z 順序變更都會通知 UI 提供者。如果在叫用 openSession 前變更 SandboxedSdkView 的 Z 順序，UI 供應商就不會明確收到通知。

1.0.0-alpha03 版本

2023 年 5 月 24 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha03、androidx.privacysandbox.ui:ui-core:1.0.0-alpha03 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。

新功能

StateChangedListener 會通知套用 UI 工作階段變更

API 變更

新增了 StateChangedListener 以取代 ErrorConsumer (Icd5d3)

修正錯誤

修正 notifyZOrderChanged 競爭狀況，讓 UI 供應商在所有 Z 順序變更時收到通知

1.0.0-alpha02 版

2023 年 4 月 19 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha02、androidx.privacysandbox.ui:ui-core:1.0.0-alpha02 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02。1.0.0-alpha02 版本包含以下修訂項目。

修正錯誤

已停用扁平測試測試變更 SandboxedSdkViewLayoutChangesChildLayout 測試

1.0.0-alpha01 版

2023 年 3 月 8 日

發布 androidx.privacysandbox.ui:ui-client:1.0.0-alpha01、androidx.privacysandbox.ui:ui-core:1.0.0-alpha01 和 androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01。1.0.0-alpha01 版本包含這些修訂版本。

新功能

應用程式和支援執行階段的 SDK (Privacy Sandbox) 會使用這些新的 Jetpack 程式庫，讓應用程式 (用戶端) 代管 SDK (供應商) 提供的任何 UI。