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

התחל בעבודה עם אחסון ענן ב- iOS

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

תנאים מוקדמים

  1. התקן את ה- SDK של Firebase .
  2. הוסף את האפליקציה שלך לפרויקט Firebase שלך במסוף Firebase .

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

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

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

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

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

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

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

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

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

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

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

הוסף אחסון ענן לאפליקציה שלך

  1. הוסף את התלות עבור אחסון ענן ל- 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];
    

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

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

התקנה מתקדמת

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

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

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

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

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

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

אם ברצונך להשתמש בדלי אחסון בענן שאינה ברירת המחדל FIRStorage לעיל, או להשתמש בדליים FIRStorage בענן באפליקציה אחת, תוכל ליצור מופע של 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"];
    

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

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

הצעדים הבאים