גישה למערכי נתונים משותפים

החל מ-Android 11 (רמת API 30), המערכת שומרת במטמון מערכי נתונים גדולים שיכולים להיות נגישים למספר אפליקציות בתרחישי שימוש כמו למידת מכונה והפעלת מדיה. הפונקציונליות הזו עוזרת לצמצם יתירות נתונים, גם ברשת ובדיסק.

כשהאפליקציה צריכה גישה למערך נתונים גדול משותף, היא יכולה לחפש תחילה מערכי הנתונים השמורים במטמון, שנקראים blobs של נתונים משותפים, לפני שנקבע אם מורידים עותק חדש. האפליקציות יכולות לגשת לפונקציונליות של מערכי הנתונים המשותפים האלה באמצעות ממשקי ה-API ב-BlobStoreManager.

המערכת שומרת את הנתונים המשותפים ומחליטה לאילו אפליקציות תהיה גישה אליהם. כשהאפליקציה שלך תורמת blobs של נתונים, אפשר לציין אילו אפליקציות אחרות צריכה להיות גישה באמצעות אחת מהשיטות הבאות:

• כדי להעניק גישה לקבוצה ספציפית של אפליקציות במכשיר, צריך להעביר את שמות החבילות מהאפליקציות האלה בתוך allowPackageAccess()
• כדי לאפשר רק לאפליקציות שהאישורים שלהן חתומים באמצעות אותו מפתח שמשמש את האפליקציה שלכם – כמו חבילת אפליקציות שאתם מנהלים – צריך להפעיל את הפונקציה allowSameSignatureAccess().
• כדי להעניק גישה לכל האפליקציות במכשיר, צריך להתקשר allowPublicAccess()

גישה ל-blobs של נתונים משותפים

המערכת מייצגת כל blob של נתונים משותפים באמצעות אובייקט BlobHandle. כל מופע של BlobHandle שמכיל גיבוב (hash) מאובטח מבחינה קריפטוגרפית וכמה פרטים מזהים של של הכיתובים.

כדי לגשת ל-blobs משותפים של נתונים, צריך להוריד מהשרת את הפרטים המזהים. באמצעות יש לבדוק אם מערך הנתונים כבר זמין במערכת.

השלב הבא תלוי בזמינות של הנתונים.

מערך הנתונים זמין

אם מערך הנתונים כבר זמין במכשיר, ניגשים אליו מהמערכת, כפי שמוצג בקטע הקוד הבא:

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);
    }
}

מערך הנתונים לא זמין

אם מערך הנתונים לא זמין, צריך להוריד אותו מהשרת ולתרום אותו למערכת, כפי שמוצג בקטע הקוד הבא:

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);
    }
}