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

privacysandbox-tools

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

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 12 月 17 日	-	-	-	1.0.0-alpha14

宣告依附元件

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

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

Groovy

dependencies {
    // Use to implement privacysandbox libraries

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

Kotlin

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

}

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

意見回饋

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

建立新問題

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

1.0 版本

1.0.0-alpha14 版本

2025 年 12 月 17 日

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

這個程式庫已淘汰，不會再收到任何更新。

API 異動 - 淘汰 privacysandbox.tools API。(Ieb66c、b/452878636) - 已淘汰的 privacysandbox.sdkruntime API (Ibe81a、b/452878636) - 已淘汰的 privacysandbox.ui API (I858d5、b/452878636) - 使用 Kotlin 2.0 發布的專案必須使用 KGP 2.0.0 以上版本 (Idb6b5、b/344563182)

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 中的類別路徑衝突。
修正從 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 現在可以如預期取消其協同程式。
現在 SDK API 中可以使用 SdkActivityLaunchers，因此應用程式可以將啟動器傳送至 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 執行階段 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 元件。