حفظ ملف في Flutter له أكثر من وجهة: دليل داخلي للتطبيق، أو موقع يختاره المستخدم، أو معرض صور تديره المنصة. لا يصح طلب MANAGE_EXTERNAL_STORAGE لمجرد حفظ مستند عادي أو الادعاء أن كل طريقة تعمل على جميع المنصات. يوضح هذا الدرس اختيار المسار المناسب قبل إضافة الحزمة.
اختيار آلية الحفظ
لإظهار نافذة اختيار ملف أو موضع حفظ، راجع file_selector ودعم ميزة الحفظ على كل منصة. قد يدعم الإصدار فتح الملفات في منصة ولا يدعم اختيار موضع حفظ بالطريقة نفسها، لذلك اقرأ جدول الميزات قبل كتابة واجهة موحدة. لدليل التطبيق الداخلي توجد آليات مثل path_provider، وللمعرض توجد واجهات خاصة بالوسائط.
فصل التنزيل عن الحفظ
نزّل البيانات عبر HTTP مع مهلة وفحص لحالة الاستجابة وحد للحجم، ثم مرر بايتات الملف واسمًا آمنًا إلى آلية الحفظ. افصل اسم العرض عن مسار تخزين يفرضه المستخدم، وامنع استخدام مسار وارد من خادم دون تحقق. لا تسمّ صفحة خطأ HTML ملف PDF ناجحًا لمجرد أن الطلب انتهى.
الإلغاء والأذونات
إلغاء نافذة الحفظ حالة طبيعية يجب أن تنهي الإجراء دون رسالة نجاح. وصول المستخدم إلى موضع عبر منتقي النظام قد يغني عن صلاحية تخزين شاملة؛ لا تضف requestLegacyExternalStorage أو صلاحيات واسعة كحل عام. على Android اتبع Storage Access Framework أو MediaStore بحسب نوع البيانات ومتطلبات المنصة.
الويب وسطح المكتب
تختلف نافذة الحفظ ومسار الملف على الويب عن dart:io في الهاتف. لا تستورد مكتبة ملفات محلية في مسار ويب دون فصل للمنصة. إذا لم تدعم الحزمة ميزة بعينها فوفّر تنزيلًا أو مشاركة مناسبة بدل إظهار زر لا يفعل شيئًا.
فتح الملف والتحقق
بعد نجاح الكتابة أغلق الموارد واحتفظ بمعرف الملف اللازم، ثم افتحه فقط إذا طلب المستخدم ذلك وكانت المنصة تدعمه. اختبر مساحة ممتلئة واسمًا عربيًا وملفًا موجودًا وفشل التنزيل وانتهاء صلاحية رابط المصدر. فتح التطبيق الخارجي لا يثبت أن المستخدم قرأ المستند.
تطبيق حفظ الملفات في Flutter في مشروعك
استخدم اسم ملف آمنًا ودليلًا مناسبًا، وتحقق من حالة HTTP وحجم التنزيل؛ فتح الملف يعتمد على نوعه ووجود تطبيق يدعمه.
مراجع الموضوع: pub.dev — file_selector






