تتيح لك أداة Cloud Storage for Firebase تحميل محتوى ينشئه المستخدمون ومشاركته، مثل الصور والفيديوهات، ما يتيح لك إنشاء محتوى وسائط متعددة تفاعلية في تطبيقاتك. يتم تخزين بياناتك في حزمة Google Cloud Storage، وهي حلّ تخزين كائنات على مستوى إكسابايت يتميز بمدى توفّر مرتفع ومزود بميزة التجميع الفائض على مستوى العالم. يتيح لك تطبيق Cloud Storage for Firebase تحميل هذه الملفات بأمان مباشرةً من الأجهزة الجوّالة ومتصفّحات الويب، والتعامل بسهولة مع الشبكات التي تتوفّر فيها اتصالات متقطّعة.
قبل البدء
تأكَّد من إكمال قراءة دليل بدء استخدام تطبيقات Android، إذا لم يسبق لك ذلك. ويشمل ذلك ما يلي:
إنشاء مشروع على Firebase
تسجيل تطبيق Android في المشروع، وربط تطبيقك بـ Firebase من خلال إضافة ملفات Firebase الملحقة ومكوّن Google Services الإضافي وملف إعدادات Firebase (
google-services.json
) إلى تطبيقك
تأكَّد من أنّ مشروعك على Firebase يستخدم خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام. إذا كنت حديث العهد باستخدام Firebase وGoogle Cloud، تحقّق ممّا إذا كنت مؤهلاً للحصول على رصيد بقيمة 300 دولار أمريكي.
إنشاء حزمة Cloud Storage تلقائية
من لوحة التنقّل في وحدة تحكّم Firebase، اختَر مساحة التخزين.
إذا لم يكن مشروعك مشتركًا في خطة أسعار Blaze المستندة إلى الدفع عند الاستخدام بعد، سيتم إعلامك بضرورة ترقية مشروعك.
انقر على البدء.
اختَر موقعًا جغرافيًا للحزمة التلقائية.
يمكن للحزم في
وUS-CENTRAL1
وUS-EAST1
الاستفادة من المستوى"مجاني دائمًا" في Google Cloud Storage. وتلتزم الحِزم في جميع المواقع الجغرافية الأخرى بحدود Google Cloud Storage السعر والاستخدام.US-WEST1
يمكنك في وقت لاحق إنشاء حِزم متعددة، يكون لكلّ منها موقع جغرافي خاص بها، إذا أردت ذلك.
اضبط Firebase Security Rules للحزمة التلقائية. أثناء التطوير، ننصحك بإعداد قواعد الوصول العلني.
انقر على تم.
يمكنك الآن عرض الحزمة في علامة التبويب
Cloud Storage الملفات
في وحدة تحكّم Firebase. تنسيق اسم الحزمة التلقائي هو
PROJECT_ID.firebasestorage.app
إعداد إمكانية الوصول العلني
Cloud Storage for Firebase يوفّر لغة قواعد توضيحية تتيح لك تحديد كيفية تنظيم بياناتك وكيفية فهرستها والحالات التي يمكن فيها قراءة بياناتك وكتابتها. يتم تلقائيًا حظر الوصول للقراءة والكتابة إلى Cloud Storage حتى لا يتمكّن سوى المستخدمين الذين تم مصادقة هويتهم من قراءة data أو كتابتها. للبدء بدون إعداد Authentication، يمكنك ضبط قواعدك للوصول العلني.
يؤدي ذلك إلى فتح Cloud Storage لأي مستخدم، حتى المستخدمين الذين لا يستخدمون تطبيقك، لذا احرص على حظر Cloud Storage مرة أخرى عند إعداد مصادقة.
إضافة حزمة تطوير البرامج (SDK) لتطبيق Cloud Storage إلى تطبيقك
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً<project>/<app-module>/build.gradle.kts
أو
<project>/<app-module>/build.gradle
)،
أضِف الاعتمادية لمكتبة Cloud Storage لنظام التشغيل Android. ننصحك باستخدام الرمز
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.6.0")) // Add the dependency for the Cloud Storage library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
(بديل) إضافة تبعيات مكتبة Firebase بدون استخدام BoM
إذا اخترت عدم استخدام Firebase BoM، يجب تحديد كل إصدار من مكتبة Firebase في سطر التبعية الخاص به.
يُرجى العلم أنّه في حال استخدام مكتبات Firebase متعدّدة في تطبيقك، ننصحك بشدة باستخدام BoM لإدارة إصدارات المكتبة، ما يضمن توافق جميع الإصدارات.
dependencies { // Add the dependency for the Cloud Storage library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage:21.0.1") }
إعداد Cloud Storage في تطبيقك
تأكَّد من تعديل ملف إعدادات Firebase (
google-services.json
) في codebase لتطبيقك باستخدام اسم حزمة Cloud Storage التلقائية.استخدِم ملف الإعدادات الذي تم تنزيله لاستبدال الملف الحالي
google-services.json
في دليل وحدة تطبيقك (على مستوى التطبيق).تأكَّد من أنّ لديك أحدث ملف ضبط تم تنزيله فقط في تطبيقك وأنّه لم يتم إلحاق اسم ملفه بأحرف إضافية، مثل
(2)
.
يمكنك الوصول إلى حزمة Cloud Storage من خلال إنشاء مثيل من
FirebaseStorage
:Kotlin+KTX
storage = Firebase.storage
// Alternatively, explicitly specify the bucket name URL. // val storage = Firebase.storage("gs://BUCKET_NAME")
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
// Alternatively, explicitly specify the bucket name URL. // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");
يمكنك الآن بدء استخدام Cloud Storage.
الخطوة التالية؟ تعرَّف على كيفية إنشاء مرجع Cloud Storage.
الإعداد المتقدّم
هناك بعض حالات الاستخدام التي تتطلّب إجراء إعدادات إضافية:
- استخدام حِزم Cloud Storage في مناطق جغرافية متعدّدة
- استخدام Cloud Storage حزمة في فئات تخزين مختلفة
- استخدام حِزم Cloud Storage مع مستخدمين مُعتمَدين متعدّدين في التطبيق نفسه
تكون حالة الاستخدام الأولى مثالية إذا كان لديك مستخدمون في جميع أنحاء العالم وأردت تخزين بياناتهم بالقرب منهم. على سبيل المثال، يمكنك إنشاء حِزم في الولايات المتحدة وأوروبا وآسيا لتخزين بيانات المستخدمين في تلك المناطق من أجل تقليل وقت الاستجابة.
تكون حالة الاستخدام الثانية مفيدة إذا كانت لديك بيانات تتضمّن أنماط وصول مختلفة. على سبيل المثال: يمكنك إعداد حزمة متعددة المناطق أو إقليمية لتخزين الصور أو المحتوى الآخر الذي يتم الوصول إليه بشكل متكرر، وحزمة في مساحة التخزين المؤقت أو في مساحة التخزين غير المتوفّرة بشكل دائم لتخزين النُسخ الاحتياطية للمستخدمين أو المحتوى الآخر الذي يتم الوصول إليه بشكل غير متكرر.
في أيّ من حالات الاستخدام هذه، عليك استخدام حِزم Cloud Storage متعددة.
يكون سيناريو الاستخدام الثالث مفيدًا إذا كنت بصدد إنشاء تطبيق، مثل Google Drive، الذي يتيح للمستخدمين استخدام حسابات متعدّدة مسجّلة الدخول (على سبيل المثال، حساب شخصي وحساب عمل). يمكنك استخدام مثيل تطبيق Firebase مخصّص لمصادقة كل حساب إضافي.
استخدام حِزم Cloud Storage متعددة
إذا كنت تريد استخدام حزمة Cloud Storage غير الحزمة التلقائية الموضّحة
في وقت سابق من هذا الدليل، أو استخدام حِزم Cloud Storage متعددة في تطبيق واحد،
يمكنك إنشاء مثيل من FirebaseStorage
يشير إلى حِزمك المخصّصة:
Kotlin+KTX
// Get a non-default Storage bucket val storage = Firebase.storage("gs://my-custom-bucket")
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
العمل مع الحِزم المستورَدة
عند استيراد حزمة Cloud Storage حالية إلى Firebase، عليك
منح Firebase إمكانية الوصول إلى هذه الملفات باستخدام أداة
gsutil
المضمّنة في
حزمة تطوير البرامج (SDK) لنظامGoogle Cloud:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
يمكنك العثور على رقم مشروعك كما هو موضّح في مقدّمة عن مشاريع Firebase.
ولا يؤثر ذلك في الحِزم التي تم إنشاؤها حديثًا، لأنّها تم ضبط عنصر التحكّم في الوصول التلقائي فيها للسماح بتطبيق Firebase. هذا إجراء مؤقت، وسيتم تنفيذه تلقائيًا في المستقبل.
استخدام تطبيق Firebase مخصّص
إذا كنت بصدد إنشاء تطبيق أكثر تعقيدًا باستخدام FirebaseApp
مخصّص، يمكنك
إنشاء مثيل من FirebaseStorage
تم إعداده باستخدام هذا التطبيق:
Kotlin+KTX
// Get the default bucket from a custom FirebaseApp val storage = Firebase.storage(customApp!!) // Get a non-default bucket from a custom FirebaseApp val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")
Java
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
الخطوات التالية
الاستعداد لإطلاق تطبيقك:
فعِّل App Check للمساعدة في التأكّد من أنّه يمكن لتطبيقاتك فقط الوصول إلى حِزم التخزين.
إعداد تنبيهات الميزانية لمشروعك في وحدة تحكّم Google Cloud
يمكنك مراقبة لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase للحصول على نظرة عامة على استخدام مشروعك على مستوى خدمات Firebase المتعددة. يمكنك أيضًا الانتقال إلى Cloud Storage لوحة بيانات "الاستخدام" للحصول على مزيد من المعلومات التفصيلية عن الاستخدام.