Cloud Storage for Firebase 可讓您上傳及分享使用者原創內容,例如圖片和影片,在應用程式中建構多媒體內容。您的資料會儲存在 Google Cloud Storage 值區中,這是具備高可用性和全域備援機制的 Exabyte 級物件儲存空間解決方案。Cloud Storage for Firebase 可讓您直接從行動裝置和網路瀏覽器安全上傳這些檔案,輕鬆處理網路不穩定的情況。
事前準備
如果尚未完成,請務必先參閱 Apple 平台應用程式入門指南。包括:
建立 Firebase 專案。
向專案註冊 Apple 平台應用程式,並將 Firebase 程式庫和 Firebase 設定檔 (
GoogleService-Info.plist
) 新增至應用程式,將應用程式連結至 Firebase。
確認 Firebase 專案採用即付即用 Blaze 定價方案。如果您剛開始使用 Firebase 和 Google Cloud,請確認是否符合 $300 美元抵免額的資格。
建立預設 Cloud Storage bucket
在 Firebase 控制台的導覽窗格中,選取「儲存空間」。
如果專案尚未採用即付即用 Blaze 定價方案,系統會提示您升級專案。
按一下「開始使用」。
選取預設值區的位置。
、US-CENTRAL1
和US-EAST1
中的值區可享有 Google Cloud Storage 的「一律免費」方案。其他地區的 Bucket 則遵循Google Cloud Storage價格和用量。US-WEST1
日後可以視需要建立多個值區,每個值區都有自己的位置。
為預設 bucket 設定 Firebase Security Rules。開發期間,請考慮設定公開存取規則。
按一下「完成」。
您現在可以在 Firebase 控制台的Cloud Storage「Files」(檔案) 分頁中查看 bucket。預設值區名稱格式為 PROJECT_ID.firebasestorage.app
設定公開存取權
Cloud Storage for Firebase 提供宣告式規則語言,可讓您定義資料的結構、索引方式,以及資料的讀取和寫入時間。根據預設,系統會限制 Cloud Storage 的讀取和寫入權限,只有通過身分驗證的使用者才能讀取或寫入資料。如要開始使用,但不想設定 Authentication,可以設定公開存取規則。
這會讓任何人都能存取 Cloud Storage,即使對方未使用您的應用程式也一樣,因此請務必在設定驗證時再次限制 Cloud Storage。
在應用程式中新增 Cloud Storage
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)。
- 系統提示時,請新增 Firebase Apple 平台 SDK 存放區:
- 選擇 Cloud Storage 程式庫。
- 將
-ObjC
標記新增至目標建構設定的「Other Linker Flags」部分。 - 完成後,Xcode 會自動開始在背景中解析並下載依附元件。
https://github.com/firebase/firebase-ios-sdk.git
在應用程式中設定 Cloud Storage
請先初始化 Firebase,再建立或使用任何 Firebase 參照。
如果您已設定其他 Firebase 產品,可能已完成這項操作,但請務必將
FirebaseStorage
程式庫新增至匯入清單。在
UIApplicationDelegate
中匯入FirebaseCore
模組和FirebaseStorage
模組。我們也建議新增FirebaseAuth
。SwiftUI
import SwiftUI import FirebaseCore import FirebaseStorage import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseStorage import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseStorage; @import FirebaseAuth; // ...
在應用程式委派的
application(_:didFinishLaunchingWithOptions:)
方法中,設定FirebaseApp
共用例項:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
(僅限 SwiftUI) 建立應用程式委派,並使用
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
將其附加至App
結構體。您也必須停用應用程式委派項目的交換。詳情請參閱 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 服務的參照。
請確認應用程式程式碼集中的 Firebase 設定檔 (
GoogleService-Info.plist
) 已更新為預設 Cloud Storage 值。使用這個下載的設定檔取代 Xcode 專案根目錄中的現有
GoogleService-Info.plist
檔案。系統出現提示時,請選取將設定檔新增至所有目標。請確認應用程式中只有這個最新下載的設定檔,且檔案名稱未附加額外字元,例如
(2)
。
使用預設 Firebase 應用程式,取得 Cloud Storage 服務的參照:
Swift
let storage = Storage.storage()
// Alternatively, explicitly specify the bucket name URL. storage = Storage.storage(url:"gs://BUCKET_NAME")
Objective-C
FIRStorage *storage = [FIRStorage storage];
// Alternatively, explicitly specify the bucket name URL. // FIRStorage storage = [FIRStorage storageWithURL:@"gs://BUCKET_NAME"];
你可以開始使用「Cloud Storage」手勢了!
下一步?瞭解如何建立 Cloud Storage 參考資料。
進階設定
以下幾個應用情境需要額外設定:
- 在多個地理區域使用 Cloud Storage 儲存空間
- 在不同儲存空間類別中使用 Cloud Storage 值區
- 在同一個應用程式中,為多個已通過驗證的使用者使用 Cloud Storage bucket
如果您有遍布全球的使用者,並希望將資料儲存在靠近他們的位置,第一個用途就非常適合。舉例來說,您可以在美國、歐洲和亞洲建立值區,儲存這些地區使用者的資料,以減少延遲。
如果您有存取模式不同的資料,第二個用途就很有幫助。舉例來說,您可以設定多區域或區域型值區,儲存圖片或其他經常存取的內容;並設定 Nearline 或 Coldline 值區,儲存使用者備份或其他不常存取的內容。
在上述任一使用案例中,您都會使用多個 Cloud Storage 值區。
如果您要建構的應用程式 (例如 Google 雲端硬碟) 允許使用者登入多個帳戶 (例如個人帳戶和公司帳戶),第三個用途就非常實用。您可以使用自訂 Firebase 應用程式例項,驗證每個額外帳戶。
使用多個 Cloud Storage 值區
如要使用上述預設 Cloud Storage 值區以外的值區,或在單一應用程式中使用多個 Cloud Storage 值區,可以建立參照自訂值區的 FIRStorage
執行個體:
Swift
// Get a non-default Cloud Storage bucket storage = Storage.storage(url:"gs://my-custom-bucket")
Objective-C
// Get a non-default Cloud Storage bucket FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
使用匯入的值區
將現有 Cloud Storage bucket 匯入 Firebase 時,您必須使用 Google Cloud SDK 隨附的 gsutil
工具,授予 Firebase 存取這些檔案的權限:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
如要查看專案編號,請參閱 Firebase 專案簡介。
這不會影響新建立的 bucket,因為這些 bucket 的預設存取權控制項已設為允許 Firebase。這項措施只是暫時解決方案,日後將會自動執行。
使用自訂 Firebase 應用程式
如果您要使用自訂 FirebaseApp
建構更複雜的應用程式,可以建立以該應用程式初始化的 Storage
執行個體:
Swift
// 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")
Objective-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 發布檢查清單。