Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ على iOS

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

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

  1. ثبّت حزمة Firebase SDK .
  2. أضف تطبيقك إلى مشروع Firebase في وحدة تحكم Firebase .

أنشئ حاوية تخزين افتراضية

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

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

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

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

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

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

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

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

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

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

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

  1. أضف تبعية التخزين السحابي إلى Podfile الخاص Podfile :

    pod 'Firebase/Storage'
    
  2. قم بتشغيل pod install وافتح ملف .xcworkspace تم إنشاؤه.

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

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

  1. استيراد وحدة Firebase في UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  2. هيئ مثيل FirebaseApp مشتركًا ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:

    سويفت

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    ج موضوعية

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. احصل على مرجع لخدمة التخزين ، باستخدام تطبيق Firebase الافتراضي:

    سويفت

    let storage = Storage.storage()
    

    ج موضوعية

    FIRStorage *storage = [FIRStorage storage];
    

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

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

اعدادات متقدمة

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

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

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

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

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

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

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

سويفت

// Get a non-default Storage bucket
storage = Storage.storage(url:"gs://my-custom-bucket")
    

ج موضوعية

// Get a non-default Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
    

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

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

gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>

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

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

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

سويفت

// Get the default bucket from a custom FirebaseApp
storage = Storage.storage(app:customApp)

// Get a non-default bucket from a custom FirebaseApp
storage = Storage.storage(app:customApp, url:"gs://my-custom-bucket")
    

ج موضوعية

// Get the default bucket from a custom FIRApp
FIRStorage storage = [FIRStorage storageForApp:customApp];

// Get a non-default bucket from a custom FIRApp
FIRStorage storage = [FIRStorage storageForApp:customApp withURL:@"gs://my-custom-bucket"];
    

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