رفع صورة إلى Firebase Storage في Flutter باستخدام putData، وتحديد النوع والحجم ومعالجة الإلغاء والأخطاء وحفظ الرابط بعد نجاح الرفع.
اختيار الصورة ليس رفعها
image_picker أو واجهة اختيار ملف تعيد ملفًا اختاره المستخدم، وقد يلغي العملية. افحص النتيجة قبل محاولة القراءة ولا تستخدم imageFile! عند احتمال null. خفّض أبعاد الصورة إذا لم يحتج المنتج للصورة الأصلية كاملة، ثم تحقق من الحجم ونوع المحتوى. المثال يستخدم bytes وputData فيسهل ربطه بمصدر يدعم الويب والمنصات الأصلية، بخلاف الاعتماد دائمًا على dart:io غير المتاح في Flutter Web.
تهيئة التخزين والقواعد
راجع متطلبات خطة Blaze واسم bucket من إعداد المشروع بدل افتراض انتهاء كل bucket بـ appspot.com؛ تختلف الأسماء للمشاريع الأحدث. اجعل المسار مرتبطًا بمالك واضح، وطبّق في قواعد Storage حدود الحجم والنوع والهوية المناسبة. المصادقة وحدها لا تمنح المستخدم حق استبدال صورة أي مستخدم آخر. فحص الامتداد على الهاتف غير كاف، واسم contentType لا يثبت وحده أن الملف سليم أو مأمون.
انتظار الرفع ثم استخراج الرابط
تعيد putData مهمة رفع يمكن مراقبة تقدمها وإلغاؤها، وتكتمل عند انتهاء النقل. لا تستدع getDownloadURL قبل اكتمال الرفع ولا تعرض نجاحًا عند بدء المهمة. اختر fileId مضبوطًا لتجنب استبدال ملف سابق دون قصد، ولا تستخدم اسم الملف المحلي الخام كمسار دائم. عند فشل الاتصال أو رفض القواعد اعرض سببًا مناسبًا مع خيار إعادة المحاولة، واحتفظ بحالة التحميل مستقلة عن إعداد ملف المستخدم.
حفظ المرجع وسياسة الإزالة
بعد الحصول على الرابط يمكنك حفظه مع storagePath في Firestore. الخدمتان ليستا معاملة ذرية واحدة؛ عالج فشل حفظ الملف الشخصي بعد نجاح الرفع ولا تترك ملفات يتيمة بلا سياسة. عند استبدال صورة مستخدم لا تحذف القديمة قبل التأكد من اعتماد الجديدة. اختبر إلغاء الاختيار وملفًا كبيرًا ورفض القواعد وانقطاع الشبكة. المقطع يقبل JPEG فقط وفق عقد المدخل، ويحتاج أن يتحقق المستدعي من المصدر ومحتواه قبل استدعائه.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'dart:typed_data';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:firebase_storage/firebase_storage.dart';
Future<String> uploadProfileJpeg(Uint8List bytes, String fileId) async {
final uid = FirebaseAuth.instance.currentUser?.uid;
if (uid == null) throw StateError('Sign in first');
if (bytes.isEmpty || bytes.lengthInBytes > 5 * 1024 * 1024) {
throw ArgumentError('Image must be between 1 byte and 5 MiB');
}
if (!RegExp(r'^[A-Za-z0-9_-]+$').hasMatch(fileId)) throw ArgumentError('Invalid file ID');
final ref = FirebaseStorage.instance.ref('profiles/$uid/$fileId.jpg');
await ref.putData(bytes, SettableMetadata(contentType: 'image/jpeg'));
return ref.getDownloadURL();
}الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.









