Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

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

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

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

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

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

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

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

צור דלי ברירת מחדל של ענן אחסון

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

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

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

    • הגדרת מיקום זו היא מיקום המשאב המשמש כברירת מחדל של Google Cloud Platform (GCP) של הפרויקט שלך. שים לב שמיקום זה ישמש עבור שירותי GCP בפרויקט שלך הדורשים הגדרת מיקום, במיוחד מסד הנתונים של Cloud Firestore ואפליקציית App Engine שלך (דבר הנדרש אם אתה משתמש ב- Cloud Scheduler).

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

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

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

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

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

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

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

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

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

#include "firebase/app.h"

דְמוּי אָדָם

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

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

iOS

צור את firebase::App :

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

גש ל- firebase::storage::Storage מחלקת firebase::storage::Storage

firebase::storage::Storage מחלקת firebase::storage::Storage היא נקודת הכניסה ל- Cloud Storage C ++ SDK.

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

אתה מוכן להתחיל להשתמש בענן אחסון!

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

התקנה מתקדמת

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

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

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

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

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

השתמש במספר דליים של אחסון בענן

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

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

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

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

אם אתה בונה אפליקציה מסובכת יותר באמצעות firebase::App מותאם אישית 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");

הצעדים הבאים