Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

ابدأ مع Cloud Storage على Flutter

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يتيح لك Cloud Storage for Firebase تحميل ومشاركة المحتوى الذي ينشئه المستخدمون ، مثل الصور والفيديو ، مما يسمح لك بإنشاء محتوى وسائط غني في تطبيقاتك. يتم تخزين بياناتك في حاوية Google Cloud Storage - وهو حل تخزين كائنات بحجم إكسابايت مع توفر عالٍ وتكرار عالمي. يتيح لك التخزين السحابي لـ Firebase تحميل هذه الملفات بأمان مباشرة من الأجهزة المحمولة ومتصفحات الويب ، والتعامل مع الشبكات المتقطعة بسهولة.

المتطلبات الأساسية

قم بتثبيت وتهيئة Firebase SDKs لـ Flutter إذا لم تكن قد قمت بذلك بالفعل.

قم بإنشاء حاوية التخزين السحابي الافتراضية

  1. من جزء التنقل بوحدة تحكم Firebase ، حدد التخزين ، ثم انقر على البدء .

  2. راجع الرسائل المتعلقة بتأمين بيانات التخزين السحابي الخاصة بك باستخدام قواعد الأمان. أثناء التطوير ، ضع في اعتبارك إعداد القواعد الخاصة بك للوصول العام .

  3. حدد موقعًا لحاوية التخزين السحابية الافتراضية الخاصة بك.

    • يعد إعداد الموقع هذا هو موقع موارد Google Cloud Platform (GCP) الافتراضي لمشروعك. لاحظ أنه سيتم استخدام هذا الموقع لخدمات GCP في مشروعك التي تتطلب إعداد موقع ، وعلى وجه التحديد ، قاعدة بيانات Cloud Firestore وتطبيق App Engine (وهو مطلوب إذا كنت تستخدم Cloud Scheduler).

    • إذا لم تكن قادرًا على تحديد موقع ، فإن مشروعك يحتوي بالفعل على موقع موارد GCP افتراضي. تم تعيينه إما أثناء إنشاء المشروع أو عند إعداد خدمة أخرى تتطلب إعداد الموقع.

    إذا كنت تستخدم خطة Blaze ، فيمكنك إنشاء مجموعات متعددة ، لكل منها موقعه الخاص.

  4. انقر فوق تم .

إعداد الوصول العام

يوفر Cloud Storage for Firebase لغة قواعد تعريفية تسمح لك بتحديد كيفية تنظيم بياناتك ، وكيف ينبغي فهرستها ، ومتى يمكن قراءة بياناتك والكتابة إليها. بشكل افتراضي ، يكون الوصول للقراءة والكتابة إلى Cloud Storage مقيدًا بحيث يمكن للمستخدمين المصادق عليهم فقط قراءة البيانات أو كتابتها. للبدء بدون إعداد مصادقة Firebase ، يمكنك تهيئة قواعدك للوصول العام .

هذا يجعل التخزين السحابي مفتوحًا لأي شخص ، حتى الأشخاص الذين لا يستخدمون تطبيقك ، لذا تأكد من تقييد التخزين السحابي مرة أخرى عند إعداد المصادقة.

أضف Cloud Storage SDK إلى تطبيقك

  1. من جذر مشروع Flutter ، قم بتشغيل الأمر التالي لتثبيت المكون الإضافي:

    flutter pub add firebase_storage
    
  2. بمجرد الانتهاء ، أعد بناء تطبيق Flutter الخاص بك:

    flutter run
    
  3. قم باستيراد المكون الإضافي في كود Dart الخاص بك:

    import 'package:firebase_storage/firebase_storage.dart';
    

قم بإعداد التخزين السحابي

تتمثل الخطوة الأولى في الوصول إلى حاوية التخزين السحابي في إنشاء مثيل لـ FirebaseStorage :

final storage = FirebaseStorage.instance;

أنت جاهز لبدء استخدام Cloud Storage!

أولاً ، دعنا نتعلم كيفية إنشاء مرجع Cloud Storage .

وضع متطور

هناك عدد قليل من حالات الاستخدام التي تتطلب إعدادًا إضافيًا:

  • استخدام حاويات التخزين السحابي في مناطق جغرافية متعددة
  • استخدام حاويات التخزين السحابي في فئات تخزين مختلفة
  • استخدام حاويات التخزين السحابي مع العديد من المستخدمين المصادق عليهم في نفس التطبيق

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

حالة الاستخدام الثانية مفيدة إذا كانت لديك بيانات ذات أنماط وصول مختلفة. على سبيل المثال: يمكنك إعداد حاوية متعددة المناطق أو إقليمية تخزن الصور أو غيرها من المحتويات التي يتم الوصول إليها بشكل متكرر ، ودلو قريب أو بارد يخزن النسخ الاحتياطية للمستخدم أو غير ذلك من المحتويات التي نادرًا ما يتم الوصول إليها.

في أي من حالات الاستخدام هذه ، سترغب في استخدام العديد من حاويات التخزين السحابي .

تكون حالة الاستخدام الثالثة مفيدة إذا كنت تنشئ تطبيقًا ، مثل Google Drive ، والذي يتيح للمستخدمين تسجيل الدخول عدة حسابات (على سبيل المثال ، حساب شخصي وحساب عمل). يمكنك استخدام مثيل تطبيق Firebase المخصص لمصادقة كل حساب إضافي.

استخدم دلاء التخزين السحابي المتعددة

إذا كنت ترغب في استخدام حاوية التخزين السحابي بخلاف الافتراضي المذكور أعلاه ، أو استخدام عدة مجموعات تخزين سحابي في تطبيق واحد ، يمكنك إنشاء مثيل FirebaseStorage يشير إلى الحاوية المخصصة الخاصة بك:

// Get a non-default Storage bucket
final storage = FirebaseStorage.instanceFor(bucket: "gs://my-custom-bucket");

العمل مع الجرافات المستوردة

عند استيراد حاوية التخزين السحابي الحالية إلى Firebase ، سيتعين عليك منح Firebase القدرة على الوصول إلى هذه الملفات باستخدام أداة gsutil المضمنة في Google Cloud SDK :

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://YOUR-CLOUD-STORAGE-BUCKET

يمكنك العثور على رقم مشروعك كما هو موضح في مقدمة مشاريع Firebase .

لا يؤثر هذا على الحاويات التي تم إنشاؤها حديثًا ، حيث تم تعيين التحكم في الوصول الافتراضي لتلك المجموعات للسماح لـ Firebase. هذا إجراء مؤقت ، وسيتم تنفيذه تلقائيًا في المستقبل.

استخدم تطبيق Firebase المخصص

إذا كنت تنشئ تطبيقًا أكثر تعقيدًا باستخدام FirebaseApp مخصصًا ، فيمكنك إنشاء مثيل من FirebaseStorage بهذا التطبيق:

// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);

الخطوات التالية