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

החל מ-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);
    }
}