開始在 Android 上使用 Cloud Storage

Cloud Storage for Firebase 可讓您上傳及分享使用者原創內容 (例如圖片和影片)，以便在應用程式中建構互動式多媒體內容。您的資料會儲存在 Google Cloud Storage bucket 中，這是 EB 級物件儲存庫解決方案，具備高可用性和全球備援功能。Cloud Storage for Firebase 可讓您直接從行動裝置和網路瀏覽器安全上傳這些檔案，輕鬆處理不穩定的網路。

事前準備

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

   • 建立 Firebase 專案。

   • 向專案註冊 Android 應用程式，並將 Firebase 依附元件、Google 服務外掛程式和 Firebase 設定檔 (google-services.json) 新增至應用程式，將應用程式連結至 Firebase。

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

建立預設 Cloud Storage bucket

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

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

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

3. 選取預設 bucket 的位置。

   • US-CENTRAL1、US-EAST1 和 US-WEST1 中的 bucket 可享有 Google Cloud Storage 的「一律免費」級別。所有其他位置的 bucket 則遵循 Google Cloud Storage 定價和用量。

   • 如有需要，您稍後可以建立多個 bucket，並為每個 bucket 指定位置。

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

5. 按一下「完成」。

現在，您可以在 Firebase 控制台中查看 bucket (依序前往「Databases & Storage」(資料庫和儲存空間) >「Storage」(儲存空間) >「Files」(檔案) 分頁)。預設 bucket 名稱格式為 PROJECT_ID.firebasestorage.app。

設定公開存取權

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

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

在應用程式中加入 Cloud Storage SDK

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.1"))

    // Add the dependency for the Cloud Storage library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-storage")
}

只要使用 Firebase Android BoM，應用程式就會一律使用相容的 Firebase Android 程式庫版本。

dependencies {
    // Add the dependency for the Cloud Storage library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-storage:23.0.0")
}

在應用程式中設定 Cloud Storage

1. 請確認應用程式程式碼集中的 Firebase 設定檔 (google-services.json) 已更新，並包含預設 Cloud Storage bucket 的名稱。

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

   2. 使用下載的設定檔，取代應用程式模組 (應用程式層級) 目錄中的現有 google-services.json 檔案。

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

2. 建立 FirebaseStorage 例項，存取 Cloud Storage bucket：

   Kotlin

   storage = Firebase.storage
   StorageActivity.kt

   // Alternatively, explicitly specify the bucket name URL.
   // val storage = Firebase.storage("gs://BUCKET_NAME")

   Java

   FirebaseStorage storage = FirebaseStorage.getInstance();
   StorageActivity.java

   // Alternatively, explicitly specify the bucket name URL.
   // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");

你可以開始使用「Cloud Storage」了！

下一步？瞭解如何建立 Cloud Storage 參照。

進階設定

有幾種用途需要額外設定：

• 在多個地理區域使用 Cloud Storage 值區
• 使用不同儲存空間級別的 Cloud Storage bucket
• 在同一個應用程式中，使用 Cloud Storage bucket 搭配多位已驗證使用者

如果您的使用者遍布全球，且您想將他們的資料儲存在鄰近位置，第一個用途就非常適合。舉例來說，您可以在美國、歐洲和亞洲建立 bucket，儲存這些區域使用者的資料，以縮短延遲時間。

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

無論是哪種用途，都建議使用多個 Cloud Storage 值區。

如果您正在建構應用程式 (例如 Google 雲端硬碟)，可讓使用者登入多個帳戶 (例如個人帳戶和工作帳戶)，則第三個用途會很有幫助。您可以使用自訂 Firebase 應用程式執行個體，驗證每個額外帳戶。

使用多個 Cloud Storage bucket

如要使用本指南稍早所述預設值以外的 Cloud Storage bucket，或在單一應用程式中使用多個 Cloud Storage bucket，可以建立參照自訂 bucket 的 FirebaseStorage 例項：

// Get a non-default Storage bucket
val storage = Firebase.storage("gs://my-custom-bucket")
StorageActivity.kt

// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
StorageActivity.java

使用匯入的值區

將現有的 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 專案簡介。

這不會影響新建立的值區，因為這些值區的預設存取控管設定會允許 Firebase。這項臨時措施日後會自動執行。

使用自訂 Firebase 應用程式

如果您使用自訂 FirebaseApp 建構更複雜的應用程式，可以建立以該應用程式初始化的 FirebaseStorage 例項：

// Get the default bucket from a custom FirebaseApp
val storage = Firebase.storage(customApp!!)

// Get a non-default bucket from a custom FirebaseApp
val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")
StorageActivity.kt

// Get the default bucket from a custom FirebaseApp
FirebaseStorage storage = FirebaseStorage.getInstance(customApp);

// Get a non-default bucket from a custom FirebaseApp
FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
StorageActivity.java

後續步驟

• 準備推出應用程式：

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

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

  • 在 Firebase 控制台監控「Usage and billing」(用量與帳單) 資訊主頁，全面掌握專案在多項 Firebase 服務的用量。您也可以前往Cloud Storage 用量資訊主頁，查看更詳細的使用資訊。

  • 查看 Firebase 推出檢查清單。