حفظ صورة في معرض الهاتف في Flutter يختلف عن تنزيلها داخل مجلد التطبيق. لظهورها في المعرض تحتاج آلية المنصة ونتيجة حفظ موثوقة، وليس طلب Permission.storage على جميع إصدارات Android ثم افتراض النجاح. المثال المراجع يستخدم saver_gallery 5.1.0 لتنزيل bytes ثم طلب حفظ الصورة.
إعداد الحزم والصلاحيات
أضف Dio وsaver_gallery. المقطع التالي جزء خدمة يُستدعى بعد موافقة المستخدم وإعداد المنصة، وليس شاشة تطلب الصلاحيات تلقائيًا. على iOS راجع مفاتيح وصف استخدام مكتبة الصور، واطلب صلاحية الإضافة المناسبة قبل الحفظ. على Android تختلف المتطلبات بحسب إصدار النظام وخيار فحص الملفات السابقة؛ اتبع جدول الحزمة بدل طلب وصول شامل لكل الملفات.
import 'dart:typed_data';
import 'package:dio/dio.dart';
import 'package:saver_gallery/saver_gallery.dart';
Future<bool> saveImageToGallery(Dio dio, String url) async {
final response = await dio.get<List<int>>(url,
options: Options(responseType: ResponseType.bytes));
final bytes = response.data;
if (bytes == null || bytes.isEmpty) throw const FormatException('Empty image');
final result = await SaverGallery.saveImage(Uint8List.fromList(bytes),
fileName: 'geecoders_${DateTime.now().millisecondsSinceEpoch}.jpg',
skipIfExists: false);
return result.isSuccess;
}
التحقق من نتيجة الحفظ
النتيجة result.isSuccess هي ما يحدد نجاح الحفظ؛ اكتمال طلب تنزيل الصورة وحده لا يثبت أنها ظهرت في المعرض. عند الفشل اعرض رسالة مناسبة ولا تطبع bytes أو بيانات حساسة. عطّل زر الحفظ أثناء العملية لتجنب نسخ متعددة من ضغطات متتالية.
نوع الملف وحجمه
يفترض اسم المثال امتداد jpg؛ استخدم امتدادًا مناسبًا لنوع الصورة الحقيقي في مشروعك، وتحقق من نوع المحتوى قبل تمرير الملف. الصورة الكبيرة تُحمَّل هنا إلى الذاكرة؛ أضف حدًا مقبولًا للحجم أو استخدم تدفقًا ومسار ملف إذا كانت أحجامك كبيرة. لا تحفظ صفحة HTML أعادها الخادم عند الخطأ كأنها صورة صحيحة.
الفرق بين الحفظ وفحص التكرار
skipIfExists:false لا يفحص وجود صورة سابقة بالاسم نفسه، وقد تكون متطلبات الصلاحية أقل من البحث في مكتبة المستخدم. إذا فعلت فحص التكرار فراجع أذونات القراءة المناسبة للنوع والمنصة. لا تطلب صلاحية صور كاملة عندما لا تحتاج سوى إضافة صورة، ولا تعِد المستخدم بمنع التكرار اعتمادًا على اسم عشوائي يتغير كل مرة.
اختبر رفض الإذن وفشل الشبكة وصورة غير صالحة وحفظًا ناجحًا على أجهزة Android وiOS. منطق الاستدعاء جرى فحصه برمجيًا، لكن ظهور الصورة والصلاحيات الأصلية يحتاجان اختبار جهاز فعلي. إذا كان هدفك كاشًا داخليًا فدرس مدير الملفات المؤقتة أبسط ولا يحتاج نشر الصورة في المعرض.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى تحميل ملف في Flutter باستخدام Dio مع نسبة التقدم والإلغاء، ثم طبّق الربط الذي يناسب بنية مشروعك.







