بدء استخدام Cloud Storage لـ C++

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

قبل البدء

قبل أن تتمكّن من استخدام Cloud Storage، عليك تنفيذ ما يلي:

  • سجِّل مشروع C++‎ وأعدَّه لاستخدام Firebase.

    إذا كان مشروعك المكتوب بلغة C++‎ يستخدم Firebase حاليًا، يعني ذلك أنّه سبق تسجيله وإعداده لاستخدام Firebase.

  • أضِف حزمة تطوير البرامج (SDK) لـ Firebase C++ إلى مشروعك بلغة C++‎.

يُرجى العِلم أنّ إضافة Firebase إلى مشروع C++‎ تتضمّن مهامًا في كلّ من وحدة تحكّم Firebase ومشروع C++‎ المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثم نقلها إلى مشروع C++‎).

يُرجى أيضًا التأكّد من أنّ مشروع Firebase الخاص بك يستخدم خطة Blaze المَرِنة للدفع حسب الاستخدام، لأنّها شرط أساسي لاستخدام 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.

إعداد إمكانية الوصول العلني

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

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

إنشاء firebase::App وإعداده

قبل أن تتمكّن من الوصول إلى Cloud Storage، عليك إنشاء firebase::App وإعداده.

أدرِج ملف العنوان لـ firebase::App:

#include "firebase/app.h"

Android

أنشئ firebase::App، مع تمرير بيئة JNI ومرجع jobject إلى نشاط Java كوسيطات:

app = App::Create(AppOptions(), jni_env, activity);

iOS+‎

أنشئ firebase::App:

app = App::Create(AppOptions());

الوصول إلى صف "firebase::storage::Storage"

يمثّل الصنف firebase::storage::Storage نقطة الدخول لحزمة تطوير البرامج (SDK) الخاصة بـ Cloud Storage للتطبيقات بلغة C++‎.

Storage* storage = Storage::GetInstance(app);

يمكنك الآن بدء استخدام Cloud Storage.

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

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

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

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

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

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

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

استخدام عدة مجموعات بيانات في Cloud Storage

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

// Get a non-default Cloud Storage bucket
Storage* storage = Storage::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 مخصّص

إذا كنت بصدد إنشاء تطبيق أكثر تعقيدًا باستخدام firebase::App مخصّص، يمكنك إنشاء مثيل من firebase::storage::Storage تم إعداده باستخدام هذا التطبيق:

// Get the default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp);

// Get a non-default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp, "gs://my-custom-bucket");

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