開始在 Apple 平台上使用 Cloud Storage

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

事前準備

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

   • 建立 Firebase 專案。

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

2. 請確認 Firebase 專案採用即付即用 Blaze 定價方案，這是使用 Cloud Storage for Firebase 的必要條件。如果您剛開始使用 Firebase 和 Google Cloud，請確認是否符合 $300 美元免費試用抵免額的資格。

建立預設 Cloud Storage bucket

1. 在 Firebase 控制台中，依序前往「資料庫和儲存空間」>「儲存空間」。

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

2. 按一下「開始使用」。

3. 選取預設值區的位置。

   • US-CENTRAL1、US-EAST1 和 US-WEST1 中的值區可享有 Google Cloud Storage 的「一律免費」方案。其他地區的儲存空間用量和價格，請參閱Google Cloud Storage這篇文章。

   • 如要建立多個儲存空間，每個儲存空間都有自己的位置，請稍後建立多個儲存空間。

4. 為預設 bucket 設定 Firebase Security Rules。開發期間，建議您設定公開存取規則。

5. 按一下「完成」。

您現在可以在 Firebase 控制台中查看 bucket (依序前往「資料庫和儲存空間」>「儲存空間」>「檔案」分頁標籤)。預設 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 存放區：

  https://github.com/firebase/firebase-ios-sdk.git

3. 選擇 Cloud Storage 程式庫。
4. 將 -ObjC 標記新增至目標建構設定的「Other Linker Flags」 部分。
5. 完成後，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) 建立應用程式委派，並使用 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()
            }
          }
        }
      }
      

2. 使用預設 Firebase 應用程式，取得 Cloud Storage 服務的參照。

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

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

進階設定

如要使用下列功能，需要額外設定：

• 在多個地理區域使用 Cloud Storage 值區
• 使用Cloud Storage bucket (不同儲存空間類別)
• 在同一個應用程式中，為多個已通過驗證的使用者使用 Cloud Storage bucket

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

如果您有存取模式不同的資料，第二個用途就很有幫助。舉例來說，您可以設定多區域或區域型值區，儲存圖片或其他經常存取的內容；也可以設定 Nearline 或 Coldline 值區，儲存使用者備份或其他不常存取的內容。

在上述任一使用情況下，您都會使用多個 Cloud Storage 值區。

如果您要建構的應用程式 (例如 Google 雲端硬碟) 允許使用者登入多個帳戶 (例如個人帳戶和公司帳戶)，第三個用途就非常實用。您可以使用自訂 Firebase 應用程式例項，驗證每個額外帳戶。

使用多個 Cloud Storage 值區

如要使用上述預設值以外的 Cloud Storage 值區，或在單一應用程式中使用多個 Cloud Storage 值區，可以建立參照自訂值區的 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"];
    

處理匯入的值區

將現有 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 執行個體：

// 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"];
    

後續步驟

• 準備發布應用程式：

  • 啟用 App Check，確保只有您的應用程式可以存取儲存空間值區。

  • 在 Google Cloud 控制台中，為專案設定預算快訊。

  • 在 Firebase 控制台中監控用量和帳單資訊主頁，全面掌握專案在多項 Firebase 服務中的用量。如需更詳細的用量資訊，請前往Cloud Storage「用量」資訊主頁。

  • 詳閱 Firebase 發布檢查清單。