開始在 Android 上使用 Cloud Storage

Cloud Storage for Firebase 可讓您上傳和共享用戶生成的內容，例如圖片和視頻，從而讓您可以將富媒體內容構建到您的應用中。您的數據存儲在Google Cloud Storage 存儲桶中——一種具有高可用性和全局冗餘的 EB 級對象存儲解決方案。 Cloud Storage for Firebase 讓您可以直接從移動設備和網絡瀏覽器安全地上傳這些文件，輕鬆處理不穩定的網絡。

先決條件

如果您還沒有，請將 Firebase 添加到您的 Android 項目中。

創建默認 Cloud Storage 存儲分區

1. 從Firebase 控制台的導航窗格中，選擇Storage ，然後單擊Get started 。

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 的讀寫訪問受到限制，因此只有經過身份驗證的用戶才能讀取或寫入數據。要在不設置身份驗證的情況下開始使用，您可以配置公共訪問規則。

這確實使 Cloud Storage 對任何人開放，甚至是不使用您的應用程序的人，因此請確保在設置身份驗證時再次限制您的 Cloud Storage。

將 Cloud Storage SDK 添加到您的應用

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

    // Declare 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'
}

dependencies {
    // Declare 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:20.0.1'
}

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

    // Declare 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-ktx'
}

dependencies {
    // Declare 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-ktx:20.0.1'
}

設置雲存儲

訪問您的 Cloud Storage 存儲分區的第一步是創建一個FirebaseStorage實例：

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

storage = Firebase.storage
StorageActivity.kt

您已準備好開始使用 Cloud Storage！

首先，讓我們學習如何創建 Cloud Storage 引用。

高級設置

有一些用例需要額外設置：

• 在多個地理區域使用 Cloud Storage 存儲分區
• 在不同的存儲類中使用 Cloud Storage 存儲分區
• 將 Cloud Storage 存儲分區與同一應用中的多個經過身份驗證的用戶一起使用

如果您的用戶遍布世界各地，並希望將他們的數據存儲在他們附近，那麼第一個用例是完美的。例如，您可以在美國、歐洲和亞洲創建存儲桶來為這些地區的用戶存儲數據以減少延遲。

如果您擁有具有不同訪問模式的數據，則第二個用例會很有幫助。例如：您可以設置一個多區域或區域存儲桶，用於存儲圖片或其他經常訪問的內容，以及一個近線或冷線存儲桶，用於存儲用戶備份或其他不經常訪問的內容。

在上述任一用例中，您都需要使用多個 Cloud Storage 存儲分區。

如果您正在構建一個應用程序，例如 Google Drive，第三個用例非常有用，它允許用戶擁有多個登錄帳戶（例如，一個個人帳戶和一個工作帳戶）。您可以使用自定義 Firebase 應用實例來驗證每個附加帳戶。

使用多個 Cloud Storage 存儲分區

如果您想使用上面提供的默認存儲分區以外的 Cloud Storage 存儲分區，或者在單個應用中使用多個 Cloud Storage 存儲分區，您可以創建一個引用您的自定義存儲分區的FirebaseStorage實例：

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

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

使用導入的存儲桶

將現有 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構建更複雜的應用，則可以創建使用該應用初始化的FirebaseStorage實例：

// 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

// 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

下一步

• 準備啟動您的應用程序：

  • 啟用應用檢查以幫助確保只有您的應用可以訪問您的存儲桶。

  • 在 Google Cloud Console 中為您的項目設置預算提醒。

  • 監控 Firebase 控制台中的使用情況和計費信息中心，以全面了解您的項目在多個 Firebase 服務中的使用情況。您還可以訪問云存儲使用儀表板以獲取更詳細的使用信息。

  • 查看Firebase 啟動清單。