開始在 Apple 平台上使用 Cloud Storage

Cloud Storage for Firebase 可讓您上傳及分享使用者原創內容，例如圖片和影片，讓您在應用程式中建立多媒體內容。您的資料儲存在 Google Cloud Storage 值區 - EB 規模物件儲存解決方案，具備高可用性和全域性 以及備援功能「Cloud Storage for Firebase」可讓你安全地上傳這些檔案 直接透過行動裝置和網路瀏覽器處理 。

事前準備

  1. 安裝 Firebase SDK。
  2. 在 Firebase控制台中，將應用程式新增至 Firebase 專案。

建立預設 Cloud Storage 值區

  1. 在 Firebase 控制台的導覽窗格中，選取「Storage」(儲存空間)。 然後按一下「開始使用」。

  2. 查看相關訊息，瞭解如何確保 Cloud Storage 資料安全無虞 不過，編寫這類演算法並不容易 因為我們無法寫出所有可能的規則開發期間，建議您設定公開存取規則。

  3. 選取預設位置 Cloud Storage 值區。

    • 這項位置設定是專案的預設 Google Cloud Platform (GCP) 資源位置。請注意，這個位置會用於專案中的 GCP 服務 需要設定位置資訊才能正常運作 Cloud Firestore 資料庫和 App Engine 應用程式 (使用 Cloud Scheduler 則為必要項目)。

    • 如果無法選取位置，代表您的專案已經 已有預設的 GCP 資源位置這是在專案期間所設定 您在設定需要位置的其他服務時 以及環境敘述

    如果您使用 Blaze 方案，可以建立多個資料夾，每個資料夾都有各自的位置。

  4. 按一下「完成」。

設定公開存取權

Cloud Storage for Firebase 提供宣告式規則語言，可讓您定義資料的結構、索引方式，以及資料可讀取及寫入的時機。根據預設，Cloud Storage 的讀取和寫入權限受到限制，因此只有經過驗證的使用者才能讀取或寫入資料。如要開始使用，但不想設定 Authentication，您可以設定公開存取權規則。

這會讓 Cloud Storage 對所有人開放，甚至是未使用您應用程式的使用者，因此請務必在設定驗證時再次限制 Cloud Storage。

在應用程式中新增 Cloud Storage

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

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

設定「Cloud Storage」

您必須先初始化 Firebase，才能建立或使用任何 Firebase 參照。如果您已經為另一項 Firebase 功能執行這項作業，可以略過 這個步驟。

  1. 在 UIApplicationDelegate 中匯入 FirebaseCore 模組，以及應用程式委派程式使用的任何其他 Firebase 模組。例如，如要使用 Cloud Firestore 和 Authentication：

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. 設定 FirebaseApp 共用執行個體 application(_:didFinishLaunchingWithOptions:) 方法：

    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 或App NSApplicationDelegateAdaptor。您也必須停用應用程式委派程式 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()
      }
    }
  }
}
  4. 使用預設的 Firebase 應用程式，取得 Cloud Storage 服務的參照：

    Swift

    let storage = Storage.storage()

    Objective-C

    FIRStorage *storage = [FIRStorage storage];

你可以開始使用「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 值區匯入 Firebase 時，您必須授予 Firebase 使用 Google Cloud SDK 中的 gsutil 工具存取這些檔案的權限：

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 例項，並透過該應用程式進行初始化：

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

後續步驟