Cloud Storage for Firebase 可讓您上傳及分享使用者原創內容,例如 圖片與影片,讓您能將互動式多媒體內容加入自己的 應用程式。您的資料儲存在 Google Cloud Storage 值區 - EB 規模物件儲存解決方案,具備高可用性和全域性 以及備援功能「Cloud Storage for Firebase」可讓你安全地上傳這些檔案 直接透過行動裝置和網路瀏覽器處理 。
事前準備
如果還沒試過 將 Firebase 新增至您的 Android 專案。
建立預設的 Cloud Storage 值區
在 Firebase 控制台的導覽窗格中,選取「Storage」(儲存空間)。 然後按一下「開始使用」。
查看相關訊息,瞭解如何確保 Cloud Storage 資料安全無虞 不過,編寫這類演算法並不容易 因為我們無法寫出所有可能的規則在開發期間 設定公開存取規則。
選取預設位置 Cloud Storage 值區。
這項位置資訊設定是專案的 預設 Google Cloud Platform (GCP) 資源位置。 請注意,這個位置會用於專案中的 GCP 服務 需要設定位置資訊才能正常運作 Cloud Firestore 資料庫和 App Engine 應用程式 (使用 Cloud Scheduler 則為必要項目)。
如果無法選取位置,代表您的專案已經 已有預設的 GCP 資源位置這是在專案期間所設定 您在設定需要位置的其他服務時 以及環境敘述
按一下「完成」。
設定公開存取權
Cloud Storage for Firebase 提供宣告規則語言, 定義資料結構、建立索引的方式 資料可供讀取及寫入根據預設, 「Cloud Storage」受到限制,因此只有已驗證的使用者才能讀取或寫入 資料。如要在不設定 Authentication 的情況下開始使用,您可以: 設定公開存取的規則。
這會讓「Cloud Storage」開放給所有人使用,包括未使用 應用程式,因此請務必在設定過程中再次限制您的 Cloud Storage 驗證。
在應用程式中新增 Cloud Storage SDK
在模組 (應用程式層級) Gradle 檔案中 (通常為<project>/<app-module>/build.gradle.kts
或
<project>/<app-module>/build.gradle
)、
新增 Android Cloud Storage 程式庫的依附元件。建議您使用
Firebase Android BoM敬上
管理程式庫版本管理
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.0")) // 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 程式庫版本。
(替代做法) 新增 Firebase 程式庫依附元件,「不使用」 BoM
如果選擇不使用 Firebase BoM,請指定各個 Firebase 程式庫版本 都屬於依附元件行
請注意,如果您在應用程式中使用多個 Firebase 程式庫,強烈建議您 建議使用 BoM 管理程式庫版本,確保所有版本 相容。
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:21.0.0") }
設定「Cloud Storage」
存取 Cloud Storage 值區的第一步是建立
FirebaseStorage
的例項:
Kotlin+KTX
storage = Firebase.storage
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
你可以開始使用「Cloud Storage」了!
首先,請瞭解如何建立Cloud Storage 參考資料。
進階設定
以下列舉幾個需要額外設定的用途:
- 使用以下值區的 Cloud Storage 個值區: 多個地理區域
- 使用以下值區的 Cloud Storage 個值區: 不同的儲存空間級別
- 在同一應用程式中與多位已驗證使用者搭配使用 Cloud Storage 值區
如果有使用者遍布世界各地,而且想要 儲存資料例如,您可以在美國建立值區 歐洲和亞洲地區,為這些地區的使用者儲存資料以縮短延遲時間。
如果資料擁有不同的存取模式,第二個用途就十分有用。 舉例來說,您可以設定多區域或單一區域值區 相片或其他經常存取的內容,以及 Nearline 或 Coldline 值區 儲存使用者備份或其他不常存取的內容
在這些用途中 使用多個 Cloud Storage 值區。
如果您要開發應用程式 例如 Google 雲端硬碟 能讓使用者擁有多個登入帳號 (例如個人帳戶) 以及公司帳戶)。你可以 使用自訂 Firebase 應用程式 執行個體驗證每個額外帳戶
使用多個 Cloud Storage 值區
如果您想使用上述預設非預設值區的 Cloud Storage 值區,
或是在單一應用程式中使用多個 Cloud Storage 值區,可建立執行個體
FirebaseStorage
參照您的自訂值區:
Kotlin+KTX
// Get a non-default Storage bucket val storage = Firebase.storage("gs://my-custom-bucket")
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
使用匯入的值區
將現有 Cloud Storage 值區匯入 Firebase 時,您需要
您必須使用
gsutil
工具,包含在
Google Cloud SDK:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
如需查看專案編號,請參閱 Firebase 專案。
由於新建立的值區已具備預設存取權,因此不會受到影響 控制項設為允許 Firebase。這只是暫時性措施, 自動執行
使用自訂 Firebase 應用程式
如果您使用自訂 FirebaseApp
建構更複雜的應用程式,可以
建立使用該應用程式初始化的 FirebaseStorage
執行個體:
Kotlin+KTX
// 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")
Java
// 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");
後續步驟
準備推出應用程式:
啟用 App Check,藉此確保 應用程式可以存取儲存空間值區
設定預算 快訊 。Google Cloud.
監控用量與計費 資訊主頁 前往 Firebase 控制台查看專案的整體概況 以及跨多項 Firebase 服務的用量 您也可以參閱 Cloud Storage Usage 資訊主頁 詳細的使用資訊
查看 Firebase 發布檢查清單。