شارك المقالة
تنزيل الملفات مع إشعارات التقدم في Flutter باستخدام tbib_downloader

تنزيل الملفات مع إشعارات التقدم في Flutter باستخدام tbib_downloader

تعرّف على تنزيل الملفات مع إشعارات التقدم باستخدام tbib_downloader في Flutter، ومعالجة الحجم غير المعروف والفشل وإعدادات Android وiOS.

تنزيل الملفات مع إشعارات التقدم في Flutter باستخدام tbib_downloader يختلف عن مجرد تحميل bytes. الحزمة تضيف فتح الملف والتعامل مع إشعارات عبر awesome_notifications، لذلك تحتاج إعدادات منصة ومراجعة صلاحياتها. الإصدار الذي راجعناه هو 2.6.1، ولا يكفي نسخ اعتماد 1.10.2 من مثال قديم مع استدعاءات إصدار أحدث.

تهيئة الحزمة قبل أول تنزيل

أضف tbib_downloader 2.6.1 ثم نفذ flutter pub get. يستدعي main بعد WidgetsFlutterBinding.ensureInitialized العملية await TBIBDownloader().init() قبل استخدام التنزيل. إذا أردت أزرار فتح الملف أو حذفه من الإشعار، اتبع إعداد مستمعي awesome_notifications في المثال الرسمي؛ المقطع التالي لا يغني عن هذه التهيئة.

import 'package:flutter/material.dart';
import 'package:tbib_downloader/tbib_downloader.dart';

Future<String?> downloadWithNotification(BuildContext context, String url,
    void Function(double?) onProgress) {
  return TBIBDownloader().downloadFile(
    context: context,
    url: url,
    fileName: 'document.pdf',
    saveFileInDataApp: true,
    onReceiveProgress: ({required int receivedBytes, required int totalBytes}) {
      final value = totalBytes <= 0 ? null
          : (receivedBytes / totalBytes).clamp(0.0, 1.0).toDouble();
      onProgress(value);
    },
  );
}

حساب التقدم عند غياب الحجم

totalBytes قد لا يكون موجبًا، لذلك نرسل null إلى واجهة العرض ليظهر مؤشر غير محدد. لا تستخدم receivedBytes / totalBytes دون فحص. إذا كان callback يستدعي setState، تحقق من mounted قبل تحديث الشاشة، وحدّث العرض بوتيرة مناسبة بدل تنفيذ عمليات باهظة مع كل دفعة bytes.

اختلاف Android وiOS

شريط تقدم الإشعار على iOS لا يتطابق مع Android وفق توثيق الحزمة؛ لا تعد المستخدم بنفس الشكل على النظامين. راجع إعدادات Info.plist وصلاحيات الإشعارات وإصدارات النظام الفعلية. اختيار saveFileInDataApp يجعل المقصد مساحة التطبيق، ولا يعني أن الملف سيظهر تلقائيًا في كل تطبيقات الملفات أو المعرض.

النجاح والخلفية وحدود المثال

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

جرّب رفض صلاحية الإشعار ومصدرًا لا يرسل حجمًا وفشل الاتصال والتنزيل المكرر. لا تمرر عنوان HTTP غير آمن من مثال توضيحي قديم إلى تطبيق منشور. المثال جرى فحص واجهته البرمجية، لكن عرض الإشعارات والتكامل الأصلي يحتاجان تجربة المنصتين قبل اعتماد الميزة.

توافق الاعتمادات قبل دمج الأمثلة

عند الاختبار ظهر تعارض بين tbib_downloader 2.6.1 وflutter_secure_storage 11.2.0 في اعتماد win32 الانتقالي. فُحص مثال التنزيل في مشروع مستقل. إذا جمعت الحزمتين في تطبيق واحد، راجع حَلّ الاعتمادات وإصداراتها المتوافقة دون dependency_overrides عشوائيًا أو خفض الحماية لمجرد تمرير البناء.

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

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

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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