شارك المقالة
تخزين ملفات الوسائط مؤقتًا في Flutter باستخدام Cache Manager

تخزين ملفات الوسائط مؤقتًا في Flutter باستخدام Cache Manager

استخدم Cache Manager لتخزين ملفات الوسائط مؤقتًا في Flutter، مع التعامل مع انتهاء الصلاحية والحجم والملفات المفقودة دون الخلط مع…

تخزين ملفات الوسائط مؤقتًا في Flutter يساعد على إعادة عرض ملف سبق تنزيله، لكنه لا يوفر نسخة دائمة يضمن بقاءها دائمًا. سنستخدم flutter_cache_manager 3.5.0 لمخزن ملفات محدود، بدل ربط الدرس بمثال قديم يعيد null من builder ويجمع مشغل فيديو مع مدير كاش دون تحديد حدود كل منهما.

مدير واحد للملفات

أضف flutter_cache_manager ثم أنشئ MediaCache مرة واحدة في طبقة الخدمة. لا تُنشئ مديرين بالمفتاح نفسه Config.key في كل build، لأنهما قد يتعاملان مع بيانات تخزين واحدة بطريقة متعارضة. يتيح المثال إزالة ملف أو مسح الكاش عندما تتغير بيانات الحساب أو سياسة المنتج.

import 'dart:io';
import 'package:flutter_cache_manager/flutter_cache_manager.dart';

class MediaCache {
  final CacheManager manager = CacheManager(Config(
    'geecoders_media_v1',
    stalePeriod: const Duration(days: 5),
    maxNrOfCacheObjects: 80,
  ));
  Future<File> load(String url) => manager.getSingleFile(url);
  Future<void> remove(String url) => manager.removeFile(url);
  Future<void> clear() => manager.emptyCache();
  Future<void> dispose() => manager.dispose();
}

مدة الركود ليست حذفًا دقيقًا في لحظة محددة

stalePeriod تساعد سياسة تنظيف الملفات غير المستخدمة، ولا تعني أن الملف يُحذف بالضبط بعد خمسة أيام من تنزيله. حد maxNrOfCacheObjects يحد عدد العناصر لا الحجم الإجمالي بالبايت. إذا كانت الملفات فيديوهات كبيرة فأضف سياسة حجم ومساحة بدل الاعتماد على العدد وحده.

تتأثر صلاحية المحتوى بتوجيهات Cache-Control وETag من الخادم. قد يعيد المدير ملفًا مخزنًا ثم يجدد نسخة قديمة؛ إذا احتجت استقبال التحديث استخدم stream المناسب وميّز النسخة المعروضة. لا تقدم محتوى الكاش على أنه أحدث نسخة مؤكدة في كل الحالات.

العرض والملفات المفقودة

على تطبيق يدعم dart:io يمكنك عرض صورة من File، أو تمرير المسار إلى مشغل فيديو مناسب. لكن بعض المنصات مثل الويب تحتاج مسارًا مختلفًا؛ لا تفترض أن Image.file تعمل في كل بناء. النظام قد ينظف مجلد الكاش، لذلك عالج غياب الملف بإعادة تحميل أو رسالة واضحة بدل انهيار.

ما الذي يجب اختباره؟

اختبر أول تحميل وإعادة القراءة وانقطاع الإنترنت بعد التحميل ومسح الكاش وإعادة التشغيل. إذا كانت الملفات خاصة بحساب فلا تشارك مخزنها دون عزل، ولا تضع رموز الوصول داخل أسماء الملفات أو سجلات الروابط. للحصول على ملف يريد المستخدم الاحتفاظ به، استخدم تنزيلًا دائمًا أو تصديرًا؛ الكاش وسيلة تحسين أداء قابلة للإخلاء.

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى تحميل ملف في Flutter باستخدام Dio مع نسبة التقدم والإلغاء، ثم طبّق الربط الذي يناسب بنية مشروعك.

صور الشرح السابق

How to cache any medi in Flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع