الوصول إلى مجموعات البيانات المشتركة

بدءًا من الإصدار 11 من نظام التشغيل Android (المستوى 30 من واجهة برمجة التطبيقات)، يخزّن النظام مؤقتًا مجموعات البيانات الكبيرة التي يمكن أن تصل إليها تطبيقات متعددة لحالات استخدام مثل تعلُّم الآلة وتشغيل الوسائط. تساعد هذه الوظيفة في تقليل تكرار البيانات، سواء عبر الشبكة أو على القرص.

عندما يحتاج تطبيقك إلى الوصول إلى مجموعة بيانات كبيرة مشترَكة، يمكنه أولاً البحث عن مجموعات البيانات المخزّنة مؤقتًا هذه، والتي تُسمى كائنات ثنائية كبيرة مشترَكة، قبل تحديد ما إذا كان سيتم تنزيل نسخة جديدة. يمكن للتطبيقات الوصول إلى وظيفة مجموعات البيانات المشتركة هذه باستخدام واجهات برمجة التطبيقات في BlobStoreManager.

يحتفظ النظام بمجموعات البيانات المشترَكة ويتحكّم في التطبيقات التي يمكنها الوصول إليها. عندما يساهم تطبيقك في إنشاء كتل بيانات، يمكنك تحديد التطبيقات الأخرى التي يجب أن يكون لديها إذن الوصول إليها من خلال استدعاء إحدى الطرق التالية:

• لمنح إذن الوصول إلى مجموعة معيّنة من التطبيقات على جهاز، مرِّر أسماء حِزم هذه التطبيقات إلى allowPackageAccess().
• للسماح فقط للتطبيقات التي تم توقيع شهاداتها باستخدام المفتاح نفسه المستخدَم لتطبيقك، مثل مجموعة تطبيقات تديرها، استخدِم الدالة allowSameSignatureAccess().
• لمنح إذن الوصول إلى جميع التطبيقات على جهاز، استخدِم الدالة allowPublicAccess().

الوصول إلى كائنات البيانات المشتركة

يمثّل النظام كل كائن ثنائي كبير مشترك باستخدام كائن BlobHandle. يحتوي كل مثيل من BlobHandle على تجزئة آمنة تشفيرًا وبعض التفاصيل التعريفية لمجموعة البيانات.

للوصول إلى وحدات البيانات الثنائية الكبيرة المشترَكة، نزِّل تفاصيل التعريف من الخادم. باستخدام هذه التفاصيل، تحقَّق مما إذا كانت مجموعة البيانات متوفرة على النظام.

تعتمد الخطوة التالية على ما إذا كانت البيانات متاحة.

مجموعة البيانات متاحة

إذا كانت مجموعة البيانات متاحة على الجهاز، يمكنك الوصول إليها من النظام، كما هو موضّح في مقتطف الرمز البرمجي التالي:

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