Catch up on everthing we announced at this year's Firebase Summit. Learn more

התחל בעבודה עם אחסון ענן עבור C ++

Cloud Storage for Firebase מאפשר לך להעלות ולשתף תוכן שנוצר על ידי משתמשים, כגון תמונות ווידאו, מה שמאפשר לך לבנות תוכן מדיה עשירה באפליקציות שלך. נתון שלך מאוחסן Google Cloud Storage דלי - פתרון אחסון אקסה בייט מידת אובייקט עם זמינות גבוהה ויתירות העולמית. Cloud Storage for Firebase מאפשר לך להעלות בצורה מאובטחת קבצים אלה ישירות ממכשירים ניידים ומדפדפני אינטרנט, תוך טיפול בקלות ברשתות נקודתיות.

לפני שאתה מתחיל

לפני שתוכל להשתמש לאחסון בענן , אתה צריך:

  • רשום את פרויקט C++ שלך והגדר אותו לשימוש ב-Firebase.

    אם פרויקט C++ שלך כבר משתמש ב-Firebase, אז הוא כבר רשום ומוגדר עבור Firebase.

  • מוסיפים את Firebase C ++ SDK לפרויקט C ++ שלך.

שימו לב כי הוספת Firebase ל- C ++ שלך פרויקט כולל משימות הן Firebase הקונסולה וב C ++ לפרויקט פתוח (למשל, אתה מוריד קבצי config Firebase מהמסוף, ולאחר מכן להעביר אותם לתוך C ++ שלך פרויקט).

צור דלי ברירת מחדל של Cloud Storage

  1. מתוך חלונית הניווט של קונסולת Firebase , בחר אחסון, ולאחר מכן לחץ על התחל.

  2. עיין בהודעות על אבטחת נתוני Cloud Storage שלך ​​באמצעות כללי אבטחה. במהלך הפיתוח, לשקול הקמת הכללים שלך עבור גישה ציבורית .

  3. בחר מיקום עבור דלי ברירת המחדל לאחסון בענן שלך.

    • הגדרת המיקום זהו הפרויקט שלך בפלטפורמת הענן של Google מחדל מיקום משאב (GCP) . שים לב שמיקום זה ישמש עבור שירותים GCP בפרויקט שלך הדורשים הגדרת המיקום, במיוחד, שלך ענן Firestore מסד הנתונים שלך מנוע יישום האפליקציה (נדרש אם אתה משתמש ענן מתזמן).

    • אם אינך יכול לבחור מיקום, אז לפרויקט שלך כבר יש מיקום ברירת מחדל של משאב GCP. הוא הוגדר במהלך יצירת הפרויקט או בעת הגדרת שירות אחר הדורש הגדרת מיקום.

    אם אתה נמצא בתוכנית Blaze, אתה יכול ליצור במספר קטגוריות , כל אחד עם משלה מיקום .

  4. לחץ על סיום.

הגדר גישה ציבורית

Cloud Storage for Firebase מספק שפת חוקים הצהרתית המאפשרת לך להגדיר כיצד הנתונים שלך צריכים להיות מובנים, כיצד יש להוסיף אותם לאינדקס ומתי ניתן לקרוא את הנתונים שלך ולכתוב אליהם. כברירת מחדל, גישת קריאה וכתיבה ל-Cloud Storage מוגבלת כך שרק משתמשים מאומתים יכולים לקרוא או לכתוב נתונים. כדי להתחיל ללא הגדרת אימות , אתה יכול להגדיר כללים שלך עבור גישה ציבורית .

זה אכן הופך את אחסון הענן פתוח לכל אחד, אפילו לאנשים שאינם משתמשים באפליקציה שלך, אז הקפד להגביל שוב את אחסון הענן שלך כשאתה מגדיר אימות.

צור לאתחל firebase::App

לפני שתוכל לגשת לאחסון בענן, תצטרך ליצור לאתחל את firebase::App .

כלול את קובץ הכותרת firebase::App :

#include "firebase/app.h"

דְמוּי אָדָם

צור את firebase::App , עובר בסביבה JNI וכן jobject התייחסות פעילות ג'אווה כמו טיעונים:

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

iOS+

צור את firebase::App :

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

גש firebase::storage::Storage בכיתה

firebase::storage::Storage בכיתה היא נקודת הכניסה עבור SDK לאחסון בענן C ++.

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

אתה מוכן להתחיל להשתמש ב-Cloud Storage!

ראשית, בואו ללמוד כיצד ליצור הפניה לאחסון בענן .

התקנה מתקדמת

ישנם כמה מקרי שימוש הדורשים הגדרה נוספת:

מקרה השימוש הראשון מושלם אם יש לך משתמשים ברחבי העולם, ואתה רוצה לאחסן את הנתונים שלהם בקרבתם. לדוגמה, אתה יכול ליצור דליים בארה"ב, אירופה ואסיה כדי לאחסן נתונים עבור משתמשים באזורים אלה כדי להפחית את זמן האחזור.

מקרה השימוש השני מועיל אם יש לך נתונים עם דפוסי גישה שונים. לדוגמה: אתה יכול להגדיר דלי רב-אזורי או אזורי המאחסן תמונות או תוכן אחר הנגיש לעתים תכופות, ו-nearline או דלי קולד המאחסן גיבויים של משתמשים או תוכן אחר שנגיש לעתים רחוקות.

בכל אחד ממקרים אלה לשימוש, אתה תרצה להשתמש דליים אחסון ענן מרובים .

מקרה השימוש השלישי שימושי אם אתה בונה אפליקציה, כמו Google Drive, המאפשרת למשתמשים לנהל מספר חשבונות מחוברים (לדוגמה, חשבון אישי וחשבון עבודה). אתה יכול להשתמש מנהג Firebase App למשל לאמת כל חשבון נוסף.

השתמש במספר דליים של Cloud Storage

אם אתה רוצה להשתמש לאחסון בענן דלי אחר מאשר ברירת המחדל המסופקים מעל, או להשתמש דליי אחסון הענן מרובים באפליקציה אחת, אתה יכול ליצור מופע של firebase::storage::Storage כי אזכור דלי המנהג שלך:

// Get a non-default Cloud Storage bucket
Storage* storage = Storage::GetInstance("gs://my-custom-bucket");

עבודה עם דליים מיובאים

בעת יבוא קובץ דלי אחסון הענן קיים לתוך 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 מותאמת אישית

אם אתם בונים את האפליקציה מסובך יותר באמצעות מנהג 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");

הצעדים הבאים