Android·Android·开始使用

使用 Cloud Storage for Firebase，您可以上传和共享用户生成的内容（如图片和视频），以便将富媒体内容融入您的应用。您的数据存储在 Google Cloud Storage 存储桶中，这是一个 EB 级对象存储解决方案，具备高可用性和全局冗余性。借助 Cloud Storage for Firebase，您可以直接从移动设备和网络浏览器安全地上传这些文件，轻松应对质量不稳定的网络。

须知事项

  1. 请确保您已完成 Android 应用入门指南（如果尚未完成）。其中包括：

  2. 创建 Firebase 项目。

  3. 在项目中注册 Android 应用，并向应用添加 Firebase 依赖项、Google 服务插件和 Firebase 配置文件 (google-services.json) 以将应用与 Firebase 相关联。
  4. 确保您的 Firebase 项目采用的是随用随付 Blaze 定价方案，这项要求自 2024 年 10 月起生效（请参阅我们的常见问题解答）。如果您是 Firebase 和 Google Cloud 新手，请确认您是否有资格获得 300 美元赠金。

创建默认的 Cloud Storage 存储桶

  1. 在 Firebase 控制台的导航窗格中，选择 Storage。

如果您的项目尚未采用随用随付 Blaze 定价方案，系统会提示您升级项目。 2. 点击开始使用。 3. 为您的默认存储桶选择一个位置。

  • US-CENTRAL1、US-EAST1 和 US-WEST1 中的存储桶可为 Google Cloud Storage 使用“始终免费”层级。所有其他位置的存储桶都遵循 Google Cloud Storage 价格和用量。
  • 如果您愿意，稍后可以创建多个存储桶，每个存储桶都有自己的位置。
  • 为默认存储桶配置 Firebase Security Rules。在开发过程中，请考虑设置公开访问规则。
  • 点击完成。

您现在可以在 Firebase 控制台的“Cloud Storage 文件”标签页中查看存储桶。默认存储桶名称的格式为 PROJECT_ID.firebasestorage.app。

设置公开访问权限

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）中，添加 Cloud Storage Android 库的依赖项。我们建议使用 Firebase Android BoM 来实现库版本控制。

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.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 库的兼容版本。

（替代方法） 在不使用 BoM 的情况下添加 Firebase 库依赖项

如果您选择不使用 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:22.0.1")
}

在应用中设置 Cloud Storage

  1. 确保应用代码库中的 Firebase 配置文件 (google-services.json) 已更新为默认 Cloud Storage 存储桶的名称。

  2. 获取更新后的配置文件。

  3. 使用此下载的配置文件替换应用模块（应用级）目录中现有的 google-services.json 文件。

    确保您的应用中只有此最新下载的配置文件，并且其文件名未附加额外字符，如 (2)。 2. 通过创建 FirebaseStorage 实例来访问 Cloud Storage 存储桶：

### Kotlin

``` storage = Firebase.storage

StorageActivity

.kt ```

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