بدء استخدام Cloud Storage على Flutter

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

قبل البدء

  1. إذا لم يسبق لك ذلك، تأكَّد من إكمال دليل البدء لتطبيقات Flutter. ويشمل ذلك ما يلي:

    • إنشاء مشروع على Firebase

    • تثبيت حِزم Firebase SDK لـ Flutter وتهيئتها

  2. تأكَّد من أنّ مشروعك على Firebase يستخدم خطة أسعار Blaze للدفع حسب الاستخدام pay-as-you-go Blaze pricing plan، وهي شرط لاستخدام Cloud Storage for Firebase. إذا كنت تستخدم Firebase وGoogle Cloud للمرة الأولى، تحقَّق مما إذا كنت مؤهلاً للحصول على رصيد تجريبي مجاني بقيمة 300 دولار.

إنشاء حزمة تلقائية على Cloud Storage

  1. في وحدة تحكُّم Firebase، انتقِل إلى قواعد البيانات ومساحة التخزين > مساحة التخزين.

    إذا لم يكن مشروعك بعد على خطة أسعار Blaze للدفع حسب الاستخدام، سيُطلب منك ترقية مشروعك.

  2. انقر على البدء.

  3. اختَر موقعًا لحزمتك التلقائية.

  4. اضبط Firebase Security Rules لحزمتك التلقائية. أثناء التطوير، ننصحك بـ إعداد قواعدك للوصول العلني.

  5. انقر على تم.

يمكنك الآن عرض الحزمة في وحدة تحكُّم Firebase (انتقِل إلى قواعد البيانات ومساحة التخزين > مساحة التخزين > علامة التبويب الملفات). يكون تنسيق اسم الحزمة التلقائية هو PROJECT_ID.firebasestorage.app.

إعداد الوصول العلني

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

يؤدي ذلك إلى إتاحة Cloud Storage لأي مستخدم، حتى لو لم يكن يستخدم تطبيقك، لذا احرص على تقييد الوصول إلى Cloud Storage مرة أخرى عند إعداد المصادقة.

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

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

    flutter pub add firebase_storage

  2. بعد اكتمال التثبيت، أعِد إنشاء تطبيق Flutter:

    flutter run

  3. استورِد المكوّن الإضافي في رمز Dart:

    import 'package:firebase_storage/firebase_storage.dart';

إعداد Cloud Storage

  1. نفِّذ الأمر flutterfire configure من دليل مشروع Flutter. يؤدي ذلك إلى تعديل ملف إعداد Firebase (firebase_options.dart) في قاعدة رموز تطبيقك بحيث يتضمّن اسم حزمة Cloud Storage التلقائية.

  2. يمكنك الوصول إلى حزمة Cloud Storage من خلال إنشاء مثيل من FirebaseStorage:

    final storage = FirebaseStorage.instance;

// Alternatively, explicitly specify the bucket name URL.
// final storage = FirebaseStorage.instanceFor(bucket: "gs://<var>BUCKET_NAME</var>");

أصبحت جاهزًا لبدء استخدام Cloud Storage.

ما هي الخطوة التالية؟ تعرَّف على كيفية إنشاء مرجع في Cloud Storage.

عملية الإعداد المتقدّمة

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

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

تكون حالة الاستخدام الثانية مفيدة إذا كانت لديك بيانات تتضمّن أنماط وصول مختلفة. على سبيل المثال، يمكنك إعداد حزمة متعددة المناطق أو إقليمية تخزّن الصور أو المحتوى الآخر الذي يتم الوصول إليه بشكل متكرر، وحزمة nearline أو coldline تخزّن نُسخًا احتياطية للمستخدمين أو محتوى آخر لا يتم الوصول إليه بشكل متكرر.

في أيٍّ من حالتَي الاستخدام هاتَين، ننصحك باستخدام حِزم متعددة على Cloud Storage.

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

استخدام حِزم متعددة على Cloud Storage

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

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

العمل مع الحِزم المستورَدة

عند استيراد حزمة حالية على Cloud Storage إلى 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 App مخصّص

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

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

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