החל מ-Android 11 (רמת API 30), המערכת שומרת במטמון מערכי נתונים גדולים עשויות לגשת לאפליקציות רבות לצורך תרחישים לדוגמה כמו למידת מכונה ומדיה להפעלה. הפונקציונליות הזו עוזרת לצמצם יתירות נתונים, גם ברשת ובדיסק.
כשהאפליקציה צריכה גישה למערך נתונים גדול משותף, היא יכולה לחפש קודם
מערכי הנתונים השמורים במטמון, שנקראים blobs של נתונים משותפים, לפני שנקבע אם
מורידים עותק חדש. האפליקציות יכולות לגשת לפונקציונליות של מערכי הנתונים המשותפים האלה באמצעות
ממשקי ה-API ב-BlobStoreManager
.
המערכת שומרת את ה-blobs המשותפים של הנתונים וקובעת לאילו אפליקציות יש גישה אותם. כשהאפליקציה שלך תורמת 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); } }