Cloud Storage for Firebase به شما امکان میدهد محتوای تولید شده توسط کاربر، مانند تصاویر و ویدیو را آپلود و به اشتراک بگذارید، که به شما امکان میدهد محتوای رسانهای غنی را در برنامههای خود بسازید. دادههای شما در یک سطل Google Cloud Storage - یک راهحل ذخیرهسازی شی در مقیاس اگزابایت با در دسترس بودن بالا و افزونگی جهانی ذخیره میشود. Cloud Storage for Firebase به شما امکان میدهد این فایلها را مستقیماً از دستگاههای تلفن همراه و مرورگرهای وب بهطور ایمن آپلود کنید و به راحتی شبکههای ناقص را مدیریت کنید.
پیش نیازها
- Firebase SDK را نصب کنید .
- برنامه خود را به پروژه Firebase خود در کنسول Firebase اضافه کنید.
یک سطل پیشفرض Cloud Storage ایجاد کنید
از صفحه پیمایش کنسول Firebase ، Storage را انتخاب کنید، سپس روی شروع به کار کلیک کنید.
پیامهای مربوط به ایمن کردن دادههای Cloud Storage خود را با استفاده از قوانین امنیتی مرور کنید. در طول توسعه، قوانین خود را برای دسترسی عمومی تنظیم کنید .
مکانی را برای سطل Cloud Storage پیش فرض خود انتخاب کنید.
این تنظیم مکان، مکان منبع پیشفرض Google Cloud Platform (GCP) پروژه شما است. توجه داشته باشید که این مکان برای سرویسهای GCP در پروژه شما استفاده میشود که به تنظیمات مکان نیاز دارند، بهویژه پایگاه داده Cloud Firestore و برنامه App Engine شما (که در صورت استفاده از Cloud Scheduler لازم است).
اگر نمیتوانید مکانی را انتخاب کنید، پروژه شما از قبل دارای یک مکان منبع GCP پیشفرض است. در حین ایجاد پروژه یا هنگام راهاندازی سرویس دیگری که نیاز به تنظیم مکان دارد تنظیم شده است.
اگر در طرح Blaze هستید، میتوانید چندین سطل ایجاد کنید که هر کدام مکان خاص خود را دارند.
روی Done کلیک کنید.
دسترسی عمومی را تنظیم کنید
Cloud Storage for Firebase یک زبان قواعد اعلامی را ارائه می دهد که به شما امکان می دهد نحوه ساختار داده های شما، نحوه نمایه سازی و زمان خواندن و نوشتن داده های شما را تعریف کنید. به طور پیشفرض، دسترسی خواندن و نوشتن به Cloud Storage محدود شده است، بنابراین فقط کاربران تأیید شده میتوانند دادهها را بخوانند یا بنویسند. برای شروع بدون تنظیم Authentication ، می توانید قوانین خود را برای دسترسی عمومی پیکربندی کنید .
این باعث میشود که Cloud Storage برای هر کسی باز شود، حتی افرادی که از برنامه شما استفاده نمیکنند، بنابراین هنگام تنظیم احراز هویت، مطمئن شوید که Cloud Storage خود را دوباره محدود کنید.
Cloud Storage به برنامه خود اضافه کنید
برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.
- در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
- هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید:
- کتابخانه Cloud Storage را انتخاب کنید.
- پرچم
-ObjC
را به بخش Other Linker Flags تنظیمات ساخت هدف خود اضافه کنید. - پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.
https://github.com/firebase/firebase-ios-sdk.git
Cloud Storage راه اندازی کنید
قبل از ایجاد یا استفاده از هر مرجع Firebase، باید Firebase را مقداردهی اولیه کنید. اگر قبلاً این کار را برای یکی دیگر از ویژگی های Firebase انجام داده اید، می توانید از این مرحله رد شوید.
- ماژول
FirebaseCore
را درUIApplicationDelegate
خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده میکند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
سویفت
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
هدف-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- یک نمونه اشتراکگذاری شده
FirebaseApp
در روشapplication(_:didFinishLaunchingWithOptions:)
پیکربندی کنید:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
سویفت
// Use Firebase library to configure APIs FirebaseApp.configure()
هدف-C
// Use Firebase library to configure APIs [FIRApp configure];
- اگر از SwiftUI استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق
UIApplicationDelegateAdaptor
یاNSApplicationDelegateAdaptor
به ساختارApp
خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- با استفاده از برنامه Firebase پیش فرض، به سرویس Cloud Storage مراجعه کنید:
سویفت
let storage = Storage.storage()
هدف-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")
هدف-C
// Get a non-default Cloud Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
کار با سطل های وارداتی
هنگام وارد کردن یک سطل Cloud Storage موجود به 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 سفارشی استفاده کنید
اگر با استفاده از 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")
هدف-C
// 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"];
مراحل بعدی
برای راه اندازی برنامه خود آماده شوید:
برای اطمینان از اینکه فقط برنامههای شما میتوانند به سطلهای ذخیرهسازی شما دسترسی داشته باشند، App Check فعال کنید.
هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید. همچنین میتوانید برای اطلاعات بیشتر در مورد استفاده، از داشبورد استفاده از Cloud Storage دیدن کنید.
چک لیست راه اندازی Firebase را مرور کنید.