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

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

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

تثبيت حِزم تطوير البرامج (SDK) لمنصة Firebase وإعدادها من أجل Flutter إذا لم يسبق لك إجراء ذلك

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

  1. من مساحة الروابط في وحدة تحكُّم Firebase، اختَر مساحة التخزين، ثم انقر على البدء.

  2. راجِع الرسالة المتعلقة بتأمين بيانات Cloud Storage باستخدام قواعد الأمان. أثناء التطوير، يمكنك إعداد قواعد الوصول العام.

  3. اختَر موقعًا جغرافيًا لحزمتك التلقائية في Cloud Storage.

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

    • إذا لم تتمكّن من اختيار موقع جغرافي، يعني ذلك أنّ مشروعك يحتوي على موقع جغرافي تلقائي لمورد Google Cloud Platform. تم إعداده إما أثناء إنشاء المشروع أو عند إعداد خدمة أخرى تتطلب إعداد الموقع.

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

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

إعداد إتاحة الوصول للجميع

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

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

إضافة حزمة تطوير البرامج (SDK) في Cloud Storage إلى تطبيقك

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

    flutter pub add firebase_storage

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

    flutter run

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

    import 'package:firebase_storage/firebase_storage.dart';

إعداد Cloud Storage

تتمثل الخطوة الأولى للوصول إلى حزمة Cloud Storage في إنشاء نسخة افتراضية من FirebaseStorage:

final storage = FirebaseStorage.instance;

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

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

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

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

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

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

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

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

استخدام حِزم متعدّدة في 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

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

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

الخطوات اللاحقة