此页面由 Cloud Translation API 翻译。

Firebase iOS Codelab Swift

1. 概览

欢迎来到 Friendly Chat Codelab。在此 Codelab 中，您将学习如何使用 Firebase 平台构建 iOS 应用。您将实现一个聊天客户端并使用 Firebase 监控其性能。

学习内容

允许用户登录。
使用 Firebase Realtime Database 同步数据。
在 Firebase Storage 中存储二进制文件。

所需条件

Xcode
CocoaPods
搭载 iOS 8.0 或更高版本的测试设备或模拟器

您打算如何使用本教程？

仅阅读教程内容

阅读并完成练习

如何评估您构建 iOS 应用的经验？

新手

中等

熟练

2. 获取示例代码

通过命令行克隆 GitHub 代码库。

$ git clone https://github.com/firebase/codelab-friendlychat-ios

3. 构建起始应用

如需构建起始应用，请执行以下操作：

在终端窗口中，导航到下载的示例代码中的 ios-starter/swift-starter 目录
运行 pod install --repo-update
打开 FriendlyChatSwift.xcworkspace 文件，以便在 Xcode 中打开项目。
点击 Run 按钮。

几秒钟后，您应该会看到 Friendly Chat 主屏幕。界面应随即显示。不过，您目前无法登录、发送或接收消息。在您完成后续步骤之前，应用将会抛出异常并终止。

4. 创建 Firebase 控制台项目

创建项目

在 Firebase 控制台中，选择添加项目。

将项目命名为 FriendlyChat，然后点击创建项目。

2015-11-06 14:13:39 的屏幕截图.png

升级您的 Firebase 定价方案

如需使用 Cloud Storage for Firebase，您的 Firebase 项目必须采用随用随付 (Blaze) 定价方案，这意味着该项目已与一个 Cloud Billing 账号相关联。

Cloud Billing 账号要求提供付款方式，例如信用卡。
如果您刚开始接触 Firebase 和 Google Cloud，请确认您是否有资格获得 $300 赠金和免费试用 Cloud Billing 账号。
如果您是在某个活动中学习本 Codelab，请询问组织者是否有 Cloud 抵用金。

如需将项目升级到 Blaze 方案，请按以下步骤操作：

在 Firebase 控制台中，选择升级您的方案。
选择 Blaze 方案。按照屏幕上的说明将 Cloud Billing 账号与您的项目相关联。
如果您需要在此升级过程中创建 Cloud Billing 账号，则可能需要返回 Firebase 控制台中的升级流程以完成升级。

关联 iOS 应用

在新项目的“项目概览”屏幕中，点击将 Firebase 添加到您的 iOS 应用。
输入软件包 ID（例如“com.google.firebase.codelab.FriendlyChatSwift”）。
将 App Store ID 输入为“123456”。
点击注册应用。

将 GoogleService-Info.plist 文件添加到您的应用

在第二个屏幕上，点击下载 GoogleService-Info.plist 以下载包含应用所需的所有 Firebase 元数据的配置文件。将该文件复制到您的应用，并将其添加到 FriendlyChatSwift 目标。

现在，您可以点击弹出式窗口右上角的“x”将其关闭，从而跳过第 3 步和第 4 步，因为您将在此处执行这些步骤。

导入 Firebase 模块

首先，确保导入了 Firebase 模块。

AppDelegate.swift、FCViewController.swift

import Firebase

在 AppDelegate 中配置 Firebase

在 application:didFinishLaunchingWithOptions 函数内的 FirebaseApp 中使用“configure”方法，从 .plist 文件配置底层 Firebase 服务。

AppDelegate.swift

  func application(_ application: UIApplication, didFinishLaunchingWithOptions
      launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  GIDSignIn.sharedInstance().delegate = self
  return true
}

5. 识别用户

使用规则限制访问权限，仅限经过身份验证的用户访问

现在，我们将添加一条规则，要求在读取或写入任何消息之前进行身份验证。为此，我们将以下规则添加到 messages 数据对象。在 Firebase 控制台的“数据库”部分中，选择“Realtime Database”，然后点击“Rules”标签页。然后更新规则，使其如下所示：

{
  "rules": {
    "messages": {
      ".read": "auth != null",
      ".write": "auth != null"
    }
  }
}

如需详细了解此机制的运作方式（包括有关“auth”变量的文档），请参阅 Firebase 安全性文档。

配置身份验证 API

在您的应用可以代表用户访问 Firebase Authentication API 之前，您必须先启用配置。

前往 Firebase 控制台，然后选择您的项目
选择身份验证
选择登录方法标签页
将 Google 开关切换至启用状态（蓝色）
在出现的对话框上按保存

如果您在此 Codelab 的后面遇到显示“CONFIGURATION_NOT_FOUND”消息的错误，请返回到这一步并仔细检查您的操作。

确认 Firebase Auth 依赖项

确认 Podfile 文件中存在 Firebase Auth 依赖项。

Podfile

pod 'Firebase/Auth'

您需要向 XCode 项目添加自定义网址方案。

打开项目配置：在左侧的树状视图中双击项目名称。从“目标”部分中选择您的应用，然后选择“信息”标签页，并展开“网址类型”部分。
点击“+”按钮，并为您的倒序客户端 ID 添加一个网址架构。如需找到此值，请打开 GoogleService-Info.plist 配置文件，然后查找 REVERSED_CLIENT_ID 键。复制该键的值，并将其粘贴到配置页面上的“网址方案”框中。将其他字段留空。
完成后，您的配置应显示如下（但其中的值应替换为您的应用的值）：

配置 Firebase 后，我们可以使用 clientID 在“didFinishLaunchingWithOptions:”方法中设置 Google 登录。

AppDelegate.swift

  func sign(_ signIn: GIDSignIn!, didSignInFor user: GIDGoogleUser!, withError error: Error?) {
    if let error = error {
      print("Error \(error)")
      return
    }

    guard let authentication = user.authentication else { return }
    let credential = GoogleAuthProvider.credential(withIDToken: authentication.idToken,
                                                      accessToken: authentication.accessToken)
    Auth.auth().signIn(with: credential) { (user, error) in
      if let error = error {
        print("Error \(error)")
        return
      }
    }
  }

自动登录用户。然后，向 Firebase Authentication 添加监听器，以便在用户成功登录后进入应用。并在 deinit 时移除监听器。

SignInViewController.swift

  override func viewDidLoad() {
    super.viewDidLoad()
    GIDSignIn.sharedInstance().uiDelegate = self
    GIDSignIn.sharedInstance().signInSilently()
    handle = Auth.auth().addStateDidChangeListener() { (auth, user) in
      if user != nil {
        MeasurementHelper.sendLoginEvent()
        self.performSegue(withIdentifier: Constants.Segues.SignInToFp, sender: nil)
      }
    }
  }

  deinit {
    if let handle = handle {
      Auth.auth().removeStateDidChangeListener(handle)
    }
  }

退出账号

添加“退出”方法

FCViewController.swift

  @IBAction func signOut(_ sender: UIButton) {
    let firebaseAuth = Auth.auth()
    do {
      try firebaseAuth.signOut()
      dismiss(animated: true, completion: nil)
    } catch let signOutError as NSError {
      print ("Error signing out: \(signOutError.localizedDescription)")
    }
  }

测试以已登录用户身份阅读消息

点击 Run 按钮。
系统应当立即将您转至登录屏幕。点按 Google 登录按钮。
如果一切正常，您应当来到消息屏幕。

6. 激活 Realtime Database

导入“信息”应用中的消息

在 Firebase 控制台的项目中，选择左侧导航栏中的 Database（数据库）项。在 Database 的溢出菜单中，选择 Import JSON。浏览至 friendlychat 目录中的 initial_messages.json 文件，选择此文件，然后点击导入按钮。这会替换您的数据库中当前存在的任何数据。您也可以直接编辑数据库，使用绿色 + 和红色 x 添加和移除项。

导入后，您的数据库应如下所示：

确认 Firebase Realtime Database 依赖项

在 Podfile 文件的依赖项块中，确认包含 Firebase/Database。

Podfile

pod 'Firebase/Database'

同步现有消息

添加相应代码，将新添加的消息同步到应用界面。

您在此部分中添加的代码将：

初始化 Firebase 数据库并添加一个监听器来处理对数据库进行的更改。
更新 DataSnapshot，以便显示新消息。

修改 FCViewController 的“deinit”“configureDatabase”和“tableView:cellForRow indexPath:”方法；将其替换为下面定义的代码：

FCViewController.swift

  deinit {
    if let refHandle = _refHandle {
      self.ref.child("messages").removeObserver(withHandle: _refHandle)
    }
  }


  func configureDatabase() {
    ref = Database.database().reference()
    // Listen for new messages in the Firebase database
    _refHandle = self.ref.child("messages").observe(.childAdded, with: { [weak self] (snapshot) -> Void in
      guard let strongSelf = self else { return }
      strongSelf.messages.append(snapshot)
      strongSelf.clientTable.insertRows(at: [IndexPath(row: strongSelf.messages.count-1, section: 0)], with: .automatic)
    })
  }


  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    // Dequeue cell
    let cell = self.clientTable.dequeueReusableCell(withIdentifier: "tableViewCell", for: indexPath)
    // Unpack message from Firebase DataSnapshot
    let messageSnapshot = self.messages[indexPath.row]
    guard let message = messageSnapshot.value as? [String: String] else { return cell }
    let name = message[Constants.MessageFields.name] ?? ""
    let text = message[Constants.MessageFields.text] ?? ""
    cell.textLabel?.text = name + ": " + text
    cell.imageView?.image = UIImage(named: "ic_account_circle")
    if let photoURL = message[Constants.MessageFields.photoURL], let URL = URL(string: photoURL),
        let data = try? Data(contentsOf: URL) {
      cell.imageView?.image = UIImage(data: data)
    }
    return cell
  }

测试消息同步

点击 Run 按钮。
点击登录开始使用按钮，前往“信息”窗口。
在 Firebase 控制台中直接添加新消息，方法是点击“messages”条目旁边的绿色 + 符号，然后添加如下所示的对象：
确认它们出现在 Friendly-Chat 界面中。

7. 发送消息

实现“发送消息”功能

将值推送到数据库。当您使用推送方法向 Firebase Realtime Database 添加数据时，系统会添加一个自动 ID。这些自动生成的 ID 具有一定顺序，这样可以确保新消息会按正确的顺序添加。

修改 FCViewController 的“sendMessage:”方法；将其替换为下面定义的代码：

FCViewController.swift

  func sendMessage(withData data: [String: String]) {
    var mdata = data
    mdata[Constants.MessageFields.name] = Auth.auth().currentUser?.displayName
    if let photoURL = Auth.auth().currentUser?.photoURL {
      mdata[Constants.MessageFields.photoURL] = photoURL.absoluteString
    }

    // Push data to Firebase Database
    self.ref.child("messages").childByAutoId().setValue(mdata)
  }

测试发送消息

点击 Run 按钮。
点击登录，前往“消息”窗口。
输入消息内容，然后点击“发送”。您会在应用界面和 Firebase 控制台中看到新消息。

8. 存储和接收图片

确认 Firebase Storage 依赖项

在 Podfile 的依赖项块中，确认已添加 Firebase/Storage。

Podfile

pod 'Firebase/Storage'

设置 Cloud Storage for Firebase

如需在 Firebase 项目中设置 Cloud Storage for Firebase，请按以下步骤操作：

在 Firebase 控制台的左侧面板中，展开构建，然后选择存储。
点击开始使用。
为默认的 Storage 存储分区选择位置。
US-WEST1、US-CENTRAL1 和 US-EAST1 中的存储分区可以使用 Google Cloud Storage 的“始终免费”层级。所有其他位置的存储分区均遵循 Google Cloud Storage 价格和使用量。
点击以测试模式启动。阅读有关安全规则的免责声明。
在本 Codelab 的后面部分，您将添加安全规则来保护您的数据。在未为您的存储桶添加安全规则的情况下，请不要公开分发或公开应用。
点击创建。

配置 FirebaseStorage

FCViewController.swift

  func configureStorage() {
    storageRef = Storage.storage().reference()
  }

接收现有消息中的图片

添加用于从 Firebase Storage 下载图片的代码。

修改 FCViewController 的“tableView: cellForRowAt indexPath:”方法；将其替换为下面定义的代码：

FCViewController.swift

  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    // Dequeue cell
    let cell = self.clientTable .dequeueReusableCell(withIdentifier: "tableViewCell", for: indexPath)
    // Unpack message from Firebase DataSnapshot
    let messageSnapshot: DataSnapshot! = self.messages[indexPath.row]
    guard let message = messageSnapshot.value as? [String:String] else { return cell }
    let name = message[Constants.MessageFields.name] ?? ""
    if let imageURL = message[Constants.MessageFields.imageURL] {
      if imageURL.hasPrefix("gs://") {
        Storage.storage().reference(forURL: imageURL).getData(maxSize: INT64_MAX) {(data, error) in
          if let error = error {
            print("Error downloading: \(error)")
            return
          }
          DispatchQueue.main.async {
            cell.imageView?.image = UIImage.init(data: data!)
            cell.setNeedsLayout()
          }
        }
      } else if let URL = URL(string: imageURL), let data = try? Data(contentsOf: URL) {
        cell.imageView?.image = UIImage.init(data: data)
      }
      cell.textLabel?.text = "sent by: \(name)"
    } else {
      let text = message[Constants.MessageFields.text] ?? ""
      cell.textLabel?.text = name + ": " + text
      cell.imageView?.image = UIImage(named: "ic_account_circle")
      if let photoURL = message[Constants.MessageFields.photoURL], let URL = URL(string: photoURL),
          let data = try? Data(contentsOf: URL) {
        cell.imageView?.image = UIImage(data: data)
      }
    }
    return cell
  }

9. 发送图片消息

实现“存储和发送图片”功能

从用户上传图片，然后将此图片的存储网址同步到数据库，以便在消息中发送此图片。

修改 FCViewController 的“imagePickerController: didFinishPickingMediaWithInfo:”方法；将其替换为下面定义的代码：

FCViewController.swift

  func imagePickerController(_ picker: UIImagePickerController,
    didFinishPickingMediaWithInfo info: [String : Any]) {
      picker.dismiss(animated: true, completion:nil)
    guard let uid = Auth.auth().currentUser?.uid else { return }

    // if it's a photo from the library, not an image from the camera
    if #available(iOS 8.0, *), let referenceURL = info[UIImagePickerControllerReferenceURL] as? URL {
      let assets = PHAsset.fetchAssets(withALAssetURLs: [referenceURL], options: nil)
      let asset = assets.firstObject
      asset?.requestContentEditingInput(with: nil, completionHandler: { [weak self] (contentEditingInput, info) in
        let imageFile = contentEditingInput?.fullSizeImageURL
        let filePath = "\(uid)/\(Int(Date.timeIntervalSinceReferenceDate * 1000))/\((referenceURL as AnyObject).lastPathComponent!)"
        guard let strongSelf = self else { return }
        strongSelf.storageRef.child(filePath)
          .putFile(from: imageFile!, metadata: nil) { (metadata, error) in
            if let error = error {
              let nsError = error as NSError
              print("Error uploading: \(nsError.localizedDescription)")
              return
            }
            strongSelf.sendMessage(withData: [Constants.MessageFields.imageURL: strongSelf.storageRef.child((metadata?.path)!).description])
          }
      })
    } else {
      guard let image = info[UIImagePickerControllerOriginalImage] as? UIImage else { return }
      let imageData = UIImageJPEGRepresentation(image, 0.8)
      let imagePath = "\(uid)/\(Int(Date.timeIntervalSinceReferenceDate * 1000)).jpg"
      let metadata = StorageMetadata()
      metadata.contentType = "image/jpeg"
      self.storageRef.child(imagePath)
        .putData(imageData!, metadata: metadata) { [weak self] (metadata, error) in
          if let error = error {
            print("Error uploading: \(error)")
            return
          }
          guard let strongSelf = self else { return }
          strongSelf.sendMessage(withData: [Constants.MessageFields.imageURL: strongSelf.storageRef.child((metadata?.path)!).description])
      }
    }
  }

测试发送和接收图片消息

点击 Run 按钮。
点击登录，前往“消息”窗口。
点击“添加照片”图标以选择照片。您会在应用界面和 Firebase 控制台中看到包含照片的新消息。

10. 恭喜！

您已使用 Firebase 轻松地构建了一个实时聊天应用。

所学内容

Realtime Database
联合登录
存储

了解详情

Firebase.google.com

Firebase iOS Codelab Swift

1. 概览

学习内容

所需条件

您打算如何使用本教程？

如何评估您构建 iOS 应用的经验？

2. 获取示例代码

3. 构建起始应用

4. 创建 Firebase 控制台项目

创建项目

升级您的 Firebase 定价方案

关联 iOS 应用

将 GoogleService-Info.plist 文件添加到您的应用

导入 Firebase 模块

AppDelegate.swift、FCViewController.swift

在 AppDelegate 中配置 Firebase

5. 识别用户

使用规则限制访问权限，仅限经过身份验证的用户访问

配置身份验证 API

确认 Firebase Auth 依赖项

为 Google 登录功能设置 Info.plist。

为 Google 登录设置 clientID

添加登录处理脚本

退出账号

测试以已登录用户身份阅读消息

6. 激活 Realtime Database

导入“信息”应用中的消息

确认 Firebase Realtime Database 依赖项

同步现有消息

测试消息同步

7. 发送消息

实现“发送消息”功能

测试发送消息

8. 存储和接收图片

确认 Firebase Storage 依赖项

设置 Cloud Storage for Firebase

配置 FirebaseStorage

接收现有消息中的图片

9. 发送图片消息

实现“存储和发送图片”功能

测试发送和接收图片消息

10. 恭喜！

所学内容

了解详情