Se agregó a Privacy Sandbox de Android Tiramisu

Resumen: Clases anidadas | Constantes | Métodos | Métodos heredados

SdkSandboxManager

public final class SdkSandboxManager
extends Object

java.lang.Object
↳	android.app.sdksandbox.SdkSandboxManager

Proporciona las API para cargar SDKs en el proceso de la zona de pruebas del SDK y, luego, interactuar con ellas.

SdkSandbox es un proceso de Java que se ejecuta en otro rango de UID. Cada app tiene su propio proceso de la zona de pruebas del SDK.

La primera app debe declarar SDKs de la que depende en su AndroidManifest.xml con la etiqueta <uses-sdk-library>. La app solo puede cargar SDKs de la que depende en SdkSandbox.

Nota: Ninguna de las API definidas en esta clase es estable, y todas están sujetas a cambios.

También:

Resumen

Clases anidadas
`interface`	`SdkSandboxManager.LoadSdkCallback` Una devolución de llamada para realizar un seguimiento de los eventos relacionados con la carga de SDKs y la interacción con estos.
`interface`	`SdkSandboxManager.RequestSurfacePackageCallback` Una devolución de llamada para realizar el seguimiento de una solicitud de un paquete de superficie desde un SDK.
`interface`	`SdkSandboxManager.SendDataCallback` Una devolución de llamada para realizar un seguimiento del envío de datos a un SDK.

Constantes
`int`	`LOAD_SDK_ALREADY_LOADED` Ya se cargó el SDK.
`int`	`LOAD_SDK_INTERNAL_ERROR` Se produjo un error interno durante la carga del SDK.
`int`	`LOAD_SDK_NOT_FOUND` No se encontró el SDK.
`int`	`REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR` Se produjo un error interno cuando se solicitó `SurfacePackage`.
`String`	`SDK_SANDBOX_SERVICE` Úsalo con `Context#getSystemService(String)` a fin de recuperar `SdkSandboxManager` para interactuar con los SDK que pertenecen a esta aplicación cliente.
`int`	`SDK_SANDBOX_STATE_DISABLED` La zona de pruebas del SDK está inhabilitada.
`int`	`SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION` La zona de pruebas del SDK está habilitada.
`int`	`SEND_DATA_INTERNAL_ERROR` Se produjo un error interno cuando se realizaba `SdkSandboxManager#sendData(String, Bundle, Executor, SendDataCallback)`.

Métodos públicos
`static int`	`getSdkSandboxState()` Muestra el estado actual de `SdkSandbox`.
`void`	`loadSdk(String sdkName, Bundle params, Executor callbackExecutor, SdkSandboxManager.LoadSdkCallback callback)` Carga el SDK en el proceso de Java de la zona de pruebas del SDK.
`void`	`requestSurfacePackage(String sdkName, int displayId, int width, int height, Bundle params, Executor callbackExecutor, SdkSandboxManager.RequestSurfacePackageCallback callback)` Envía al SDK una solicitud para un paquete de superficie.
`void`	`sendData(String sdkName, Bundle data, Executor callbackExecutor, SdkSandboxManager.SendDataCallback callback)` Se envía un paquete de `data` al SDK.

Métodos heredados

Desde la clase



          java.lang.Object

`Object`	`clone()` Crea y muestra una copia de este objeto.
`boolean`	`equals(Object obj)` Indica si algún otro objeto es "igual a" este.
`void`	`finalize()` Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección determina que no hay más referencias al objeto.
`final Class<?>`	`getClass()` Muestra la clase del entorno de ejecución de este `Object`.
`int`	`hashCode()` Muestra un valor de código hash para el objeto.
`final void`	`notify()` Activa un solo subproceso que está esperando la supervisión de este objeto.
`final void`	`notifyAll()` Activa todos los subprocesos que están esperando la supervisión de este objeto.
`String`	`toString()` Muestra una representación de string del objeto.
`final void`	`wait(long timeout, int nanos)` Hace que el subproceso actual espere hasta que otro subproceso invoque el método `notify()` o `notifyAll()` para este objeto, que otro subproceso interrumpa el subproceso actual o que haya transcurrido un período específico en tiempo real.
`final void`	`wait(long timeout)` Hace que el subproceso actual espere hasta que otro subproceso invoque el método `notify()` o `notifyAll()` para este objeto, o que haya transcurrido un período específico.
`final void`	`wait()` Hace que el subproceso actual espere hasta que otro subproceso invoque el método `notify()` o `notifyAll()` para este objeto.

Constantes

LOAD_SDK_ALREADY_LOADED

Se agregó a Privacy Sandbox de Android Tiramisu

public static final int LOAD_SDK_ALREADY_LOADED

Ya se cargó el SDK.

Esto indica que la aplicación cliente intentó volver a cargar el mismo SDK mediante una llamada a loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.LoadSdkCallback) después de cargarse correctamente.

Valor constante: 101 (0x00000065)

LOAD_SDK_INTERNAL_ERROR

Se agregó a Privacy Sandbox de Android Tiramisu

public static final int LOAD_SDK_INTERNAL_ERROR

Se produjo un error interno durante la carga del SDK.

Esto indica que se produjo un error interno genérico cuando se aplicaba la llamada desde la aplicación cliente.

Valor constante: 500 (0x000001f4)

LOAD_SDK_NOT_FOUND

Se agregó a Privacy Sandbox de Android Tiramisu

public static final int LOAD_SDK_NOT_FOUND

No se encontró el SDK.

Esto indica que la aplicación cliente intentó cargar un SDK inexistente con una llamada a loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.LoadSdkCallback).

Valor constante: 100 (0x00000064)

REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Se agregó a Privacy Sandbox de Android Tiramisu

public static final int REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Se produjo un error interno cuando se solicitó SurfacePackage.

Esto indica que se produjo un error interno genérico cuando se solicitaba SurfacePackage.

Valor constante: 700 (0x000002bc)

SDK_SANDBOX_SERVICE

Se agregó a Privacy Sandbox de Android Tiramisu

public static final String SDK_SANDBOX_SERVICE

Úsalo con Context#getSystemService(String) a fin de recuperar SdkSandboxManager para interactuar con los SDK que pertenecen a esta aplicación cliente.

Valor constante: "sdk_sandbox"

SDK_SANDBOX_STATE_DISABLED

Se agregó en el nivel de API 33.

public static final int SDK_SANDBOX_STATE_DISABLED

La zona de pruebas del SDK está inhabilitada.

Se ocultaron las API de SdkSandboxManager. Los intentos de llamarlas generarán UnsupportedOperationException.

Valor constante: 0 (0x00000000)

SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Se agregó en el nivel de API 33.

public static final int SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

La zona de pruebas del SDK está habilitada.

La app puede usar las API de SdkSandboxManager para cargar SDKs de la que depende en el proceso SdkSandbox correspondiente.

Valor constante: 2 (0x00000002)

SEND_DATA_INTERNAL_ERROR

Se agregó a Privacy Sandbox de Android Tiramisu

public static final int SEND_DATA_INTERNAL_ERROR

Se produjo un error interno cuando se realizaba SdkSandboxManager#sendData(String, Bundle, Executor, SendDataCallback).

Esto indica que se produjo un error interno genérico cuando se solicitaba el envío de datos a un SDK.

Valor constante: 800 (0x00000320)

Métodos públicos

getSdkSandboxState

Se agregó en el nivel de API 33.

public static int getSdkSandboxState ()

Muestra el estado actual de SdkSandbox.

Resultado que se muestra
`int`	El valor es `SDK_SANDBOX_STATE_DISABLED` o `SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION`.

loadSdk

Se agregó a Privacy Sandbox de Android Tiramisu

public void loadSdk (String sdkName,
                Bundle params,
                Executor callbackExecutor,
                SdkSandboxManager.LoadSdkCallback callback)

Carga el SDK en el proceso de Java de la zona de pruebas del SDK.

De forma asíncrona, carga la biblioteca del SDK con sdkName en un proceso de zona de pruebas. El llamador debe recibir la notificación desde LoadSdkCallback callback.

La app ya debe declarar SDKs de la que depende en su AndroidManifest con la etiqueta <use-sdk-library>. La app solo puede cargar SDKs de la que depende en SdkSandbox.

Cuando la aplicación cliente cargue el primer SDK, se creará un nuevo proceso SdkSandbox; de lo contrario, otros SDKs se cargarán en la misma zona de pruebas que ya se creó para la aplicación cliente.

Parámetros
`sdkName`	`String`: nombre del SDK que se cargará. Este valor no puede ser `null`.
`params`	`Bundle`: los parámetros que la app pasa al SDK. Este valor no puede ser `null`.
`callbackExecutor`	`Executor`: el `Executor` en el que se invoca la devolución de llamada. Este valor no puede ser `null`.
`callback`	`SdkSandboxManager.LoadSdkCallback`: el `LoadSdkCallback` que recibirá los eventos de los SDK de carga. Este valor no puede ser `null`.

requestSurfacePackage

Se agregó a Privacy Sandbox de Android Tiramisu

public void requestSurfacePackage (String sdkName,
                int displayId,
                int width,
                int height,
                Bundle params,
                Executor callbackExecutor,
                SdkSandboxManager.RequestSurfacePackageCallback callback)

Envía al SDK una solicitud para un paquete de superficie.

Después de que la aplicación cliente reciba un indicador sobre la carga correcta de un SDK por parte de SdkSandboxManager.LoadSdkCallback.onLoadSdkSuccess(android.os.Bundle), este puede solicitar, de forma asíncrona, un SurfacePackage para renderizar la vista desde el SDK.

El SurfacePackage solicitado se muestra a la aplicación cliente a través de SdkSandboxManager.RequestSurfacePackageCallback.onSurfacePackageReady(android.view.SurfaceControlViewHost.SurfacePackage, int, android.os.Bundle).

Parámetros
`sdkName`	`String`: nombre del SDK que se cargó en la zona de pruebas del SDK. Este valor no puede ser `null`.
`displayId`	`int`: el ID de la pantalla lógica para mostrar el paquete de superficie.
`width`	`int`: el ancho del paquete de superficie.
`height`	`int`: la altura del paquete de superficie.
`params`	`Bundle`: los parámetros que la aplicación cliente pasa al SDK. Este valor no puede ser `null`.
`callbackExecutor`	`Executor`: el `Executor` en el que se invoca la devolución de llamada. Este valor no puede ser `null`.
`callback`	`SdkSandboxManager.RequestSurfacePackageCallback`: el `RequestSurfacePackageCallback` que recibirá los resultados de la solicitud de paquetes de superficie de los SDKs. Este valor no puede ser `null`.

sendData

Se agregó a Privacy Sandbox de Android Tiramisu

public void sendData (String sdkName,
                Bundle data,
                Executor callbackExecutor,
                SdkSandboxManager.SendDataCallback callback)

Se envía un paquete de data al SDK.

Después de que la aplicación cliente reciba un indicador sobre la carga correcta de un SDK por parte de SdkSandboxManager.LoadSdkCallback.onLoadSdkSuccess(android.os.Bundle), puede solicitar de forma asíncrona que se envíen datos al SDK en la zona de pruebas. Si no se carga el SDK, se genera SecurityException.

Parámetros
`sdkName`	`String`: nombre del SDK que se cargó en la zona de pruebas del SDK. Este es el mismo nombre que se usa en `loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.LoadSdkCallback)`. Este valor no puede ser `null`.
`data`	`Bundle`: los datos que se enviarán al SDK representado en forma de un `Bundle`. Este valor no puede ser `null`.
`callbackExecutor`	`Executor`: el `Executor` en el que se invoca la devolución de llamada. Este valor no puede ser `null`.
`callback`	`SdkSandboxManager.SendDataCallback`: el `SendDataCallback` que recibirá eventos de carga e interacción con SDK. El SDK también puede enviar datos a través de `SendDataCallback#onSendDataSuccess(Bundle)`. Este valor no puede ser `null`.