privacysandbox sdkruntime

Declaring dependencies

To add a dependency on privacysandbox-sdkruntime, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

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"
}

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Version 1.0

Version 1.0.0-alpha18

July 16, 2025

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha18, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha18, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha18 are released. Version 1.0.0-alpha18 contains these commits.

API Changes

• SandboxedSdkProviderCompat.getView() completely removed. If the project also uses androidx.privacysandbox.tools, the latest version should be used.
• SdkSandboxControllerCompat migrated to sdkruntime-provider. SdkSandboxControllerCompat in sdkruntime-core is deprecated and will be removed next release.

Bug Fixes

• SandboxedSdkProviderCompat.onLoadSdk() now called from the main thread regardless of loadSdk() caller thread.

Version 1.0.0-alpha17

March 26, 2025

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha17, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha17, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha17 are released. Version 1.0.0-alpha17 contains these commits.

New Features

API Changes

• Deprecated SandboxedSdkProviderCompat.getView() with removal in next release. Please migrate to androidx.privacysandbox.tools 1.0.0-alpha13 before next release.
• Dropped support for 1.0-alpha13 libraries (both App and SDK should use more recent versions to work with counterpart libraries from this release)

Bug Fixes

• Migrated AppOwnedInterfaces to local implementation on API33 devices.

Version 1.0.0-alpha16

December 11, 2024

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha16, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha16, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha16 are released. Version 1.0.0-alpha16 contains these commits.

API Changes

• Introduce SdkSandboxClientImportanceListenerCompat for SDKs to getting notifications about changes in client's app importance (foreground status)

Bug Fixes

• Fixed a bug prevented client app with proguard from loading SDK in backcompat mode.

Version 1.0.0-alpha15

November 13, 2024

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha15, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha15, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha15 are released. Version 1.0.0-alpha15 contains these commits.

New Features

• Supported LayoutInflater creation from SdkContext in backcompat mode.
• Supported DisplayContext/WindowContext creation from SdkContext in backcompat mode.

Version 1.0.0-alpha14

July 24, 2024

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha14, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha14, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha14 are released. Version 1.0.0-alpha14 contains these commits.

New Features

• Introduce SdkSandboxControllerCompat#getClientPackageName for retrieving client app package name.

API Changes

• SandboxedSdkProviderAdapter from sdkruntime-core completely removed. Please use SandboxedSdkProviderAdapter from sdkruntime-provider library.

Version 1.0.0-alpha13

March 6, 2024

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha13, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha13, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha13 are released. Version 1.0.0-alpha13 contains these commits.

New Features

• Backcompat support for SDK-SDK loading (SdkSandboxControllerCompat#loadSdk) - now SDKs loaded locally (in Application process) could load other SDKs

Version 1.0.0-alpha12

January 24, 2024

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha12, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha12, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha12 are released. Version 1.0.0-alpha12 contains these commits.

New Features

• Introduce SdkSandboxControllerCompat#loadSdk for loading SDKs by other SDKs in sandbox (currently supported on API 34 Extension 10 only)

API Changes

• Remove sandbox support on API 33 devices - backcompat (in app) mode should be used before API 34.

Version 1.0.0-alpha11

November 15, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha11, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha11, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha11 are released. Version 1.0.0-alpha11 contains these commits.

New Features

• AppOwnedSdkSandboxInterfaceCompat supported on API34 Ext 8 devices (before worked only on PrivacySandbox Developer Preview builds)

Version 1.0.0-alpha10

October 18, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha10, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha10, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha10 are released. Version 1.0.0-alpha10 contains these commits.

Bug Fixes

• Fixed resource remapping for SDK loaded in app process.

Version 1.0.0-alpha09

October 4, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha09, androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha09, and androidx.privacysandbox.sdkruntime:sdkruntime-provider:1.0.0-alpha09 are released. Version 1.0.0-alpha09 contains these commits.

API Changes

• First release of sdkruntime-provider library that should be used instead of sdkruntime-core library for SDKs.
• SandboxedSdkProviderAdapter migrated to sdkruntime-provider. SandboxedSdkProviderAdapter in sdkruntime-core is deprecated and will be removed soon.

Bug Fixes

• Unregister all SdkSandboxActivityHandlerCompat when SDK unloaded.
• ActivityHolder Lifecycle events now matches behavior of ReportFragment

Version 1.0.0-alpha08

August 9, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha08 and androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha08 are released. Version 1.0.0-alpha08 contains these commits.

Bug Fixes

• Fix SharedPreferences migration fails when target context SharedPreferences didn't exist.

Version 1.0.0-alpha07

July 26, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha07 and androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha07 are released. Version 1.0.0-alpha07 contains these commits.

New Features

• Per-SDK SharedPreferences support for SDKs loaded locally (in Application process). SandboxedSdkProviderCompat#context customized to provide Per-SDK SharedPreferences support for SDKs in backcompat mode.

Version 1.0.0-alpha06

June 21, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha06 and androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha06 are released. Version 1.0.0-alpha06 contains these commits.

New Features

• Per-SDK Storage and Databases support for SDKs loaded locally (in Application process).
• SandboxedSdkProviderCompat#context customized to provide Per-SDK Storage and Database support for SDKs in backcompat mode.

Version 1.0.0-alpha05

June 7, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha05 and androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha05 are released. This version is developed in an internal branch.

New Features

• (PrivacySandbox Developer Preview 8+ only) Add support for App-Sandbox mediation (see SdkSandboxManagerCompat#registerAppOwnedSdkSandboxInterface + SdkSandboxControllerCompat#getAppOwnedSdkSandboxInterfaces)

Version 1.0.0-alpha04

May 10, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-client:1.0.0-alpha04 and androidx.privacysandbox.sdkruntime:sdkruntime-core:1.0.0-alpha04 are released. This version is developed in an internal branch.

New Features

• Initial support for starting Activities inside SDK sandbox (available for UDC+ devices): SDK need to register handler by calling SdkSandboxControllerCompat#registerSdkSandboxActivityHandler then App could start Activity for SDK by calling SdkSandboxManagerCompat#startSdkSandboxActivity.

Version 1.0.0-alpha03

April 5, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha03 is released.

New Features

• Added support for SandboxProcessDeathCallback
• Added support for SDK unloading

API Changes

• SandboxedSdkCompat#create(binder) removed, please use constructor SandboxedSdkCompat(binder)

Version 1.0.0-alpha02

March 22, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha02 is released.

New Features

• Added an API for fetching list of loaded SDKs - SdkSandboxControllerCompat.getSandboxedSdks().

Version 1.0.0-alpha01

January 11, 2023

androidx.privacysandbox.sdkruntime:sdkruntime-*:1.0.0-alpha01is released.

• This is a new Jetpack library that contains components for building and loading Runtime enabled SDKs (Privacy Sandbox) on old versions of Android Platform.