بدء استخدام Cloud Storage على منصات Apple

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

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

1. ثبِّت حزمة تطوير البرامج (SDK) لمنصّة Firebase.
2. أضِف تطبيقك إلى مشروع Firebase في وحدة تحكُّم Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

1. في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:

  https://github.com/firebase/firebase-ios-sdk.git

3. اختَر مكتبة Cloud Storage.
4. أضِف العلامة -ObjC إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك.
5. عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل ملف والتبعيات في الخلفية.

إعداد Cloud Storage

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

1. استيراد وحدة FirebaseCore في UIApplicationDelegate بالإضافة إلى أي تطبيق آخر وحدات Firebase التي يستخدمها تطبيقك المفوَّض على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

   واجهة المستخدم

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. ضبط FirebaseApp المثيل المشترك في حساب مفوَّض تطبيقك طريقة application(_:didFinishLaunchingWithOptions:):

   واجهة المستخدم

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

   Swift

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

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه. إلى بنية App عبر UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor ويجب أيضًا إيقاف إيماءة تفويض التطبيق. بالنسبة لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات SwiftUI.

   واجهة المستخدم

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. الحصول على مرجع إلى خدمة Cloud Storage باستخدام تطبيق Firebase التلقائي:

   Swift

   let storage = Storage.storage()
   

   Objective-C

   FIRStorage *storage = [FIRStorage storage];
   

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

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

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

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

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

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

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

في أي من حالات الاستخدام هذه، ستحتاج إلى استخدام حِزم متعدّدة في Cloud Storage

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

استخدام حِزم متعدّدة في Cloud Storage

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

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

// Get a non-default Cloud Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"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://<your-cloud-storage-bucket>

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

لا يؤثر ذلك في الحِزم التي تم إنشاؤها حديثًا، لأنّ هذه الحِزم لديها إذن الوصول التلقائي. مجموعة التحكم للسماح بـ 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"];
    

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

• الاستعداد لإطلاق تطبيقك:

  • يمكنك تفعيل فحص التطبيقات للمساعدة في ضمان وصول تطبيقاتك إلى حِزم مساحة التخزين

  • إعداد الميزانية تنبيهات لمشروعك في Google Cloud Console.

  • يمكنك مراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكم Firebase للحصول على صورة شاملة عبر خدمات Firebase المتعددة. يمكنك أيضًا الانتقال إلى مقالة استخدام الاستخدام في Cloud Storage. لوحة البيانات لمزيد من معلومات الاستخدام التفصيلية.

  • راجِع قائمة التحقّق الخاصة بإطلاق Firebase.