نشر نص وصورة في Flutter مع Firebase Storage وFirestore، وفصل رفع الملف عن حفظ المنشور ومعالجة فشل إحدى الخطوتين وتكرار الإرسال.
خدمتان لمهمتين مختلفتين
احفظ الملف في Cloud Storage واحفظ نص المنشور ومرجع الصورة وبياناته في Firestore. لا تضع بيانات الصورة الثنائية الكبيرة داخل مستند المنشور. تحتاج إعداد Storage المناسب لخطة المشروع وقواعده؛ وفق الوثائق الحالية تتطلب Cloud Storage خطة Blaze، فراجع الفوترة وحدودك قبل التجربة. استخدم مشروع اختبار وملفًا صغيرًا بدل اعتماد نجاح حفظ النص دليلًا على عمل رفع الصورة.
حجز معرف ثابت قبل الرفع
أنشئ مرجع doc للمنشور قبل رفع الملف واستخدم معرفه في مسار Storage، مع UID المستخدم المسجل. هذا أفضل من توليد المعرف من نص تاريخ جهاز أو اسم ملف قد يتكرر. تحقق من طول النص وحجم الملف ونوعه قبل النقل، وطبق القيود أيضًا في القواعد؛ فحص العميل يحسن التجربة لكنه ليس حاجز أمان. لا تحفظ موقعًا جغرافيًا افتراضيًا كأنه موقع المستخدم دون طلبه.
الكتابة ليست معاملة مشتركة بين الخدمتين
بعد نجاح الرفع احصل على download URL ثم اكتب مستند المنشور. إذا فشلت كتابة Firestore فقد يبقى ملف يتيم؛ يلزم مسار تنظيف مضبوط أو حالة pending يعالجها خادمك. لا تدع نجاح الرفع يفعّل رسالة نجاح المنشور قبل اكتمال الكتابة. أظهر حالة إرسال ومنع نقر متكرر، واحتفظ بهوية عملية عند إعادة المحاولة حتى لا تنشئ عدة منشورات بسبب انقطاع استجابة واحدة.
قراءة المنشور وحماية الملف
الرابط القابل للتنزيل ليس ضمانًا لخصوصية المحتوى؛ صمم سياسة مشاركة الملفات وقواعدها حسب المنتج. لا تعتمد على إخفاء الزر وحده لمنع تعديل منشور لا يملكه المستخدم. رتّب المنشورات بحقل createdAt من الخادم، واعرض صورة افتراضية أثناء الانتظار أو فشل التحميل. المثال التالي يوضح حفظ المستند بعد اكتمال رفع الصورة؛ رفعها والتحقق من نوعها موضحان في الدرس المرتبط، ولا ينفذ المقطع تنظيف الملفات اليتيمة.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_auth/firebase_auth.dart';
Future<void> saveUploadedPost({
required DocumentReference<Map<String, dynamic>> postRef,
required String text,
required String imageUrl,
required String storagePath,
}) async {
final uid = FirebaseAuth.instance.currentUser?.uid;
if (uid == null) throw StateError('Sign in first');
final content = text.trim();
if (content.isEmpty || content.length > 5000) throw ArgumentError('Invalid post text');
await postRef.set({
'ownerId': uid, 'text': content, 'imageUrl': imageUrl,
'storagePath': storagePath, 'createdAt': FieldValue.serverTimestamp(),
});
}الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.









