Accéder aux ensembles de données partagés

À partir d'Android 11 (niveau d'API 30), le système met en cache des grands ensembles de données auxquels plusieurs applications peuvent accéder pour des cas d'utilisation tels que le machine learning et la lecture de contenus multimédias. Cette fonctionnalité permet de réduire la redondance des données sur le réseau et sur le disque.

Lorsque votre application a besoin d'accéder à un ensemble de données volumineux partagé, elle peut d'abord rechercher les ensembles de données mis en cache, appelés blobs de données partagées, avant de déterminer si une nouvelle copie doit être téléchargée. Les applications peuvent accéder à cette fonctionnalité d'ensembles de données partagés à l'aide des API disponibles dans BlobStoreManager.

Le système gère les blobs des données partagées et contrôle les applications qui peuvent y accéder. Lorsque votre application fournit des blobs de données, vous pouvez indiquer les autres applications auxquelles l'accès doit être accordé en appelant l'une des méthodes suivantes :

  • Pour accorder l'accès à un ensemble d'applications spécifique sur un appareil, transmettez les noms de package de ces applications dans allowPackageAccess().
  • Pour autoriser uniquement les applications dont les certificats sont signés à l'aide de la même clé que celle utilisée pour votre application, telle qu'une suite d'applications que vous gérez, appelez allowSameSignatureAccess().
  • Pour accorder l'accès à toutes les applications d'un appareil, appelez allowPublicAccess().

Accéder aux blobs de données partagées

Le système représente chaque blob de données partagées à l'aide d'un objet BlobHandle. Chaque instance de BlobHandle contient un hachage sécurisé de manière cryptographique et des informations d'identification de l'ensemble de données.

Pour accéder aux blobs des données partagées, téléchargez les informations d'identification à partir du serveur. À l'aide de ces informations, vérifiez si l'ensemble de données est déjà disponible sur le système.

L'étape suivante varie selon que des données sont disponibles ou non.

Ensemble de données disponible

Si l'ensemble de données est déjà disponible sur l'appareil, accédez-y à partir du système, comme indiqué dans l'extrait de code suivant :

Kotlin

val blobStoreManager =
        getSystemService(Context.BLOB_STORE_SERVICE) as BlobStoreManager
// The label "Sample photos" is visible to the user.
val blobHandle = BlobHandle.createWithSha256(sha256DigestBytes,
        "Sample photos",
        System.currentTimeMillis() + TimeUnit.DAYS.toMillis(1),
        "photoTrainingDataset")
try {
    val input = ParcelFileDescriptor.AutoCloseInputStream(
            blobStoreManager.openBlob(blobHandle))
    useDataset(input)
}

Java

BlobStoreManager blobStoreManager =
        ((BlobStoreManager) getSystemService(Context.BLOB_STORE_SERVICE));
if (blobStoreManager != null) {
    // The label "Sample photos" is visible to the user.
    BlobHandle blobHandle = BlobHandle.createWithSha256(
            sha256DigestBytes,
            "Sample photos",
            System.currentTimeMillis() + TimeUnit.DAYS.toMillis(1),
            "photoTrainingDataset");
    try (InputStream input = new ParcelFileDescriptor.AutoCloseInputStream(
            blobStoreManager.openBlob(blobHandle))) {
        useDataset(input);
    }
}

Ensemble de données non disponible

Si l'ensemble de données n'est pas disponible, téléchargez-le à partir du serveur et ajoutez-le au système, comme indiqué dans l'extrait de code suivant :

Kotlin

val sessionId = blobStoreManager.createSession(blobHandle)
try {
    val session = blobStoreManager.openSession(sessionId)
    try {
        // For this example, write 200 MiB at the beginning of the file.
        val output = ParcelFileDescriptor.AutoCloseOutputStream(
                session.openWrite(0, 1024 * 1024 * 200))
        writeDataset(output)

        session.apply {
            allowSameSignatureAccess()
            allowPackageAccess(your-app-package,
                    app-certificate)
            allowPackageAccess(some-other-app-package,
                    app-certificate)
            commit(mainExecutor, callback)
        }
    }
}

Java

long sessionId = blobStoreManager.createSession(blobHandle);
try (BlobStoreManager.Session session =
        blobStoreManager.openSession(sessionId)) {
    // For this example, write 200 MiB at the beginning of the file.
    try (OutputStream output = new ParcelFileDescriptor.AutoCloseOutputStream(
            session.openWrite(0, 1024 * 1024 * 200)))
        writeDataset(output);
        session.allowSameSignatureAccess();
        session.allowPackageAccess(your-app-package,
                    app-certificate);
        session.allowPackageAccess(some-other-app-package,
                    app-certificate);
        session.commit(getMainExecutor(), callback);
    }
}