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

privacysandbox-tools

運用 Android 版 Privacy Sandbox 功能的程式庫

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 3 月 26 日	-	-	-	1.0.0-alpha13

宣告依附元件

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

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

Groovy

dependencies {
    // Use to implement privacysandbox libraries

    implementation "androidx.privacysandbox.tools:tools:1.0.0-alpha13"
    Implementation "androidx.privacysandbox.tools:tools-apicompiler:1.0.0-alpha13"
    implementation "androidx.privacysandbox.tools:tools-apigenerator:1.0.0-alpha13"
    implementation "androidx.privacysandbox.tools:tools-core:1.0.0-alpha13"
    implementation "androidx.privacysandbox.tools:tools-testing:1.0.0-alpha13"
    implementation "androidx.privacysandbox.tools:tools-apipackager:1.0.0-alpha13"
    
    
}

Kotlin

dependencies {
    // Use to implement privacysandbox libraries
    
    implementation("androidx.privacysandbox.tools:tools:1.0.0-alpha13")
    implementation("androidx.privacysandbox.tools:tools-apicompiler:1.0.0-alpha13")
    implementation("androidx.privacysandbox.tools:tools-apigenerator:1.0.0-alpha13")
    implementation("androidx.privacysandbox.tools:tools-core:1.0.0-alpha13")
    implementation("androidx.privacysandbox.tools:tools-testing:1.0.0-alpha13")
    implementation("androidx.privacysandbox.tools:tools-apipackager:1.0.0-alpha13")

}

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

意見回饋

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

建立新問題

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

1.0 版本

1.0.0-alpha13 版

2025 年 3 月 26 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha13。1.0.0-alpha13 版包含這些修訂項目。

新功能

在 openSession 中新增 SessionData 參數支援，取代 SessionConstants。
已移除 SandboxedSdkProviderCompat.getView() 的產生作業，該作業現已淘汰。

1.0.0-alpha12 版

2025 年 2 月 26 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha12。1.0.0-alpha12 版包含這些修訂項目。

新功能

@PrivacySandboxInterface-annotated 介面現在可以擴充 androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 中導入的 SharedUiAdapter 介面，類似於 SandboxedUiAdapter。介面只能擴充一種 UI 轉接器類型。

1.0.0-alpha11 版本

2025 年 1 月 29 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha11。1.0.0-alpha11 版包含這些修訂項目。

新功能

新增對 SandboxedUiAdapter.openSession 中更新版 SessionConstants 參數的支援。(I65886)。

1.0.0-alpha10 版本

2024 年 10 月 2 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂項目。

新功能

在註解介面和註解值中使用 const val，新增對 SDK 定義常數的支援。

API 變更

禁止在 apicompiler 中使用物件 (這些物件先前會以無訊息模式忽略)

修正錯誤

修正當來源目錄結尾為 .class 時發生的當機問題

1.0.0-alpha09 版本

2024 年 6 月 26 日

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

新功能

新增對以 @PrivacySandboxValue 註解的列舉類別支援。
支援 Privacy Sandbox UI alpha 09。

1.0.0-alpha08 版本

March 20, 2024

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

新功能

標記為 @PrivacySandboxCallback 的介面現在可以包含在方法暫停時傳回值的方法。(I16063)
在帶有註解的介面和值中，現在可接受套件做為有效的參數和傳回類型。(I52995)。

1.0.0-alpha07 版本

2024 年 2 月 7 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha07。查看 1.0.0-alpha07 版的修訂項。

API 變更

支援新的 SDK 活動啟動器介面。新的介面位於 androidx.privacysandbox.activity.core 中。系統不再支援 androidx.privacysandbox.ui.core 中的舊版。(Ia9079)

1.0.0-alpha06 版本

2023 年 9 月 6 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha06。查看 1.0.0-alpha06 版的修訂項。

修正錯誤

使用非 Android Guava 依附元件，避免在 Bazel 中發生 classpath 衝突。
修正從 Bazel 呼叫 API 編譯器時發生的當機問題。(I24c9d)。

1.0.0-alpha05 版本

2023 年 8 月 9 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha05。1.0.0-alpha05 版包含此連結所列的修訂項目。

新功能

產生的 SandboxedUiAdapters 現在已設有新的 windowInputToken。這個版本與 androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 相容。

1.0.0-alpha04 版本

2023 年 5 月 24 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha04。1.0.0-alpha04 版本包含以下修訂項目。

新功能

CancellationExceptions 現在會傳播至應用程式，因此 SDK 可以如預期取消其協同程式。
SdkActivityLaunchers 現在可用於 SDK API，因此應用程式可將啟動器傳送至 Privacy Sandbox 中的 SDK。請注意，這項功能目前僅適用於開發人員預覽版。

修正錯誤

根據預設，SDK 宣告的非暫停函式會在主執行緒中執行。這些執行緒原本會在 Binder 執行緒中執行。
服務無法再從 UI 介面轉接程式繼承。
修正在資料類別中定義 UI 轉接器屬性會導致編譯錯誤的問題。

1.0.0-alpha03 版本

2023 年 3 月 8 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha03。1.0.0-alpha03 版包含以下修訂項目。

新功能

新增對 Privacy Sandbox UI API 整合功能的支援

API 變更

將目標 Kotlin 版本變更為 1.8.0

1.0.0-alpha02 版

2022 年 12 月 7 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

這些工具旨在增強與 Privacy Sandbox SDK Runtime API 的整合狀況。這些工具將有助於自動產生樣板程式碼，以便定義和啟用執行階段 SDK 的用戶端介面並進行互動。

新功能 - 新增定義用戶端介面 (SDK) 介面，可接受回呼及資料值物件做為參數和傳回類型 - 為用戶端提供 SDK 例外狀況 - 支援產生 SDK 執行階段回溯相容性

API 變更

新增 @JvmDefaultWithCompatibility 註解 (I8f206)

1.0.0-alpha01 版

2022 年 11 月 9 日

發布 androidx.privacysandbox.tools:tools-*:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

這是新的 Jetpack 程式庫，內含可運用 Privacy Sandbox 功能的 API。如要回報錯誤，請使用 Issue Tracker 元件。