開始在 Apple 平台上使用 Cloud Storage

Cloud Storage for Firebase 可讓您上傳及分享使用者原創內容,例如圖片和影片,在應用程式中建構多媒體內容。您的資料會儲存在 Google Cloud Storage 值區中,這是具備高可用性和全域備援機制的 Exabyte 級物件儲存空間解決方案。Cloud Storage for Firebase 可讓您直接從行動裝置和網路瀏覽器安全上傳這些檔案,輕鬆處理網路不穩定的情況。

事前準備

  1. 如果尚未完成,請務必先參閱 Apple 平台應用程式入門指南。包括:

    • 建立 Firebase 專案。

    • 向專案註冊 Apple 平台應用程式,並將 Firebase 程式庫和 Firebase 設定檔 (GoogleService-Info.plist) 新增至應用程式,將應用程式連結至 Firebase。

  2. 確認 Firebase 專案採用即付即用 Blaze 定價方案。如果您剛開始使用 Firebase 和 Google Cloud,請確認是否符合 $300 美元抵免額的資格。

建立預設 Cloud Storage bucket

  1. Firebase 控制台的導覽窗格中,選取「儲存空間」

    如果專案尚未採用即付即用 Blaze 定價方案,系統會提示您升級專案。

  2. 按一下「開始使用」

  3. 選取預設值區的位置

  4. 為預設 bucket 設定 Firebase Security Rules。開發期間,請考慮設定公開存取規則

  5. 按一下「完成」

您現在可以在 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 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)
  2. 系統提示時,請新增 Firebase Apple 平台 SDK 存放區:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. 選擇 Cloud Storage 程式庫。
  5. -ObjC 標記新增至目標建構設定的「Other Linker Flags」部分。
  6. 完成後,Xcode 會自動開始在背景中解析並下載依附元件。

在應用程式中設定 Cloud Storage

  1. 請先初始化 Firebase,再建立或使用任何 Firebase 參照。

    如果您已設定其他 Firebase 產品,可能已完成這項操作,但請務必將 FirebaseStorage 程式庫新增至匯入清單。

    1. 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;
      // ...
      
    2. 在應用程式委派的 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];
      
    3. (僅限 SwiftUI) 建立應用程式委派,並使用 UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor 將其附加至 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()
            }
          }
        }
      }
      
  2. 使用預設 Firebase 應用程式,取得 Cloud Storage 服務的參照。

    1. 請確認應用程式程式碼集中的 Firebase 設定檔 (GoogleService-Info.plist) 已更新為預設 Cloud Storage 值。

      1. 取得更新後的設定檔。

      2. 使用這個下載的設定檔取代 Xcode 專案根目錄中的現有 GoogleService-Info.plist 檔案。系統出現提示時,請選取將設定檔新增至所有目標。

        請確認應用程式中只有這個最新下載的設定檔,且檔案名稱未附加額外字元,例如 (2)

    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 參考資料

進階設定

以下幾個應用情境需要額外設定:

如果您有遍布全球的使用者,並希望將資料儲存在靠近他們的位置,第一個用途就非常適合。舉例來說,您可以在美國、歐洲和亞洲建立值區,儲存這些地區使用者的資料,以減少延遲。

如果您有存取模式不同的資料,第二個用途就很有幫助。舉例來說,您可以設定多區域或區域型值區,儲存圖片或其他經常存取的內容;並設定 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"];
    

後續步驟