Cloud Storage 使用入门(Apple 平台)

使用 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
  4. 选择 Cloud Storage 库。
  5. -ObjC 标志添加到目标 build 设置的“其他链接器标志”部分。
  6. 完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。

设置 Cloud Storage

您必须先初始化 Firebase,然后才能创建或使用 Firebase 引用。如果您已为其他 Firebase 功能执行此操作,可以忽略此步骤。

  1. UIApplicationDelegate 中导入 FirebaseCore 模块,以及您的应用委托 (app delegate) 使用的所有其他 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. 在应用委托的 application(_:didFinishLaunchingWithOptions:) 方法中配置一个 FirebaseApp 共享实例:

    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,则必须创建应用委托并通过 UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor 将其附加到 App 结构体。您还必须停用应用委托调配。如需了解详情,请参阅 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 引用

高级设置

以下几种使用情形需要进行额外的设置:

  • 使用多个地理区域中的 Cloud 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 时,您必须使用 Google Cloud SDK 中包含的 gsutil 工具向 Firebase 授予访问这些文件的权限:

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

后续步骤