privacysandbox sdkruntime

宣告依附元件

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

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

dependencies {

    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18"
    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18"
}

dependencies {
    implementation("androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18")
    implementation "androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18"
}

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

意見回饋

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

建立新問題

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

1.0 版本

1.0.0-alpha18 版本

2025 年 7 月 16 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha18。1.0.0-alpha18 版包含這些修訂項目。

API 變更

• SandboxedSdkProviderCompat.getView()完全移除。如果專案也使用 androidx.privacysandbox.tools，則應使用最新版本。
• SdkSandboxControllerCompat已遷移至 sdkruntime-provider。sdkruntime-core 中的 SdkSandboxControllerCompat 已淘汰，並將在下一個版本中移除。

修正錯誤

• 現在無論 loadSdk() 呼叫端執行緒為何，都會從主執行緒呼叫 SandboxedSdkProviderCompat.onLoadSdk()。

1.0.0-alpha17 版本

2025 年 3 月 26 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha17、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha17 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha17。1.0.0-alpha17 版包含這些修訂項目。

新功能

API 變更

• 已淘汰 SandboxedSdkProviderCompat.getView()，並會在下一個版本中移除。請在下一個版本發布前遷移至 androidx.privacysandbox.tools 1.0.0-alpha13。
• 已停止支援 1.0-alpha13 程式庫 (應用程式和 SDK 都應使用較新版本，才能與這個版本中的對應程式庫搭配使用)

修正錯誤

• 已在 API33 裝置上遷移至本機實作。AppOwnedInterfaces

1.0.0-alpha16 版本

2024 年 12 月 11 日

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

API 變更

• 導入 SdkSandboxClientImportanceListenerCompat，讓 SDK 接收用戶端應用程式重要性 (前景狀態) 變更的通知

修正錯誤

• 修正錯誤，避免使用 Proguard 的用戶端應用程式無法在回溯相容模式中載入 SDK。

1.0.0-alpha15 版本

2024 年 11 月 13 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha15、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha15 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha15。1.0.0-alpha15 版包含這些修訂項目。

新功能

• 在回溯相容模式下，支援從 SdkContext 建立 LayoutInflater。
• 在回溯相容模式下，支援從 SdkContext 建立 DisplayContext/WindowContext。

1.0.0-alpha14 版本

2024 年 7 月 24 日

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

新功能

• 導入 SdkSandboxControllerCompat#getClientPackageName，用於擷取用戶端應用程式套件名稱。

API 變更

• SandboxedSdkProviderAdapter 從 sdkruntime-core 完全移除。請使用 sdkruntime-provider 程式庫中的 SandboxedSdkProviderAdapter。

1.0.0-alpha13 版

2024 年 3 月 6 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha13、androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha13 和 androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha13。1.0.0-alpha13 版包含這些修訂項目。

新功能

• Backcompat 支援 SDK 對 SDK 載入 (SdkSandboxControllerCompat#loadSdk) - 現在本機載入的 SDK (在應用程式程序中) 可以載入其他 SDK

1.0.0-alpha12 版

2024 年 1 月 24 日

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

新功能

• 推出 SdkSandboxControllerCompat#loadSdk，供沙箱中的其他 SDK 載入 SDK (目前僅支援 API 34 擴充功能 10)

API 變更

• 在 API 33 裝置上移除沙箱支援功能 - 應在 API 34 之前使用回溯相容性 (應用程式內) 模式。

1.0.0-alpha11 版本

2023 年 11 月 15 日

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

新功能

• AppOwnedSdkSandboxInterfaceCompat 支援 API34 Ext 8 裝置 (先前僅適用於 PrivacySandbox 開發人員預先發布版本)

1.0.0-alpha10 版本

2023 年 10 月 18 日

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

修正錯誤

• 修正應用程式程序中載入的 SDK 資源重新對應問題。

1.0.0-alpha09 版本

2023 年 10 月 4 日

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

API 變更

• sdkruntime-provider 程式庫的第一個版本，適用於 SDK，應取代 sdkruntime-core 程式庫。
• SandboxedSdkProviderAdapter已遷移至 sdkruntime-provider。SandboxedSdkProviderAdapter 已在 sdkruntime-core 中淘汰，並將在近期內移除。

修正錯誤

• 卸載 SDK 時，取消註冊所有 SdkSandboxActivityHandlerCompat。
• ActivityHolder 生命週期事件現在符合 ReportFragment 的行為

1.0.0-alpha08 版本

2023 年 8 月 9 日

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

修正錯誤

• 修正目標內容 SharedPreferences 不存在時，SharedPreferences 遷移作業失敗的問題。

1.0.0-alpha07 版本

2023 年 7 月 26 日

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

新功能

• 針對在本機載入的 SDK (在應用程式程序中)，提供個別 SDK 的 SharedPreferences 支援。 SandboxedSdkProviderCompat#context，為處於回溯相容模式的 SDK 提供個別 SDK SharedPreferences 支援。

1.0.0-alpha06 版本

2023 年 6 月 21 日

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

新功能

• 針對在本機載入 (應用程式程序中) 的 SDK，支援個別 SDK 儲存空間和資料庫。
• SandboxedSdkProviderCompat#context，為回溯相容模式的 SDK 提供個別 SDK 儲存空間和資料庫支援。

1.0.0-alpha05 版本

2023 年 6 月 7 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha05 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha05。這個版本是在內部分支版本中開發而成。

新功能

• (僅限 PrivacySandbox 開發人員預覽版 8 以上版本) 新增對 App-Sandbox 中介服務的支援 (請參閱 SdkSandboxManagerCompat#registerAppOwnedSdkSandboxInterface + SdkSandboxControllerCompat#getAppOwnedSdkSandboxInterfaces)

1.0.0-alpha04 版本

2023 年 5 月 10 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha04 和 androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha04。這個版本是在內部分支版本中開發而成。

新功能

• 初步支援在 SDK 沙箱內啟動活動 (適用於 UDC+ 裝置)：SDK 需呼叫 SdkSandboxControllerCompat#registerSdkSandboxActivityHandler 註冊處理常式，然後應用程式可呼叫 SdkSandboxManagerCompat#startSdkSandboxActivity 為 SDK 啟動活動。

1.0.0-alpha03 版本

2023 年 4 月 5 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha03。

新功能

• 新增對 SandboxProcessDeathCallback 的支援
• 新增 SDK 卸載支援

API 變更

• 已移除 SandboxedSdkCompat#create(binder)，請改用建構函式 SandboxedSdkCompat(binder)

1.0.0-alpha02 版

2023 年 3 月 22 日

發布 androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha02。

新功能

• 新增 API，用於擷取已載入的 SDK 清單 - SdkSandboxControllerCompat.getSandboxedSdks()。

1.0.0-alpha01 版

2023 年 1 月 11 日

androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha01 發布。

• 這是新的 Jetpack 程式庫，其中所含元件可在舊版 Android 平台上建構及載入支援 Runtime 的 SDK (Privacy Sandbox)。