Firebase iOS 代码实验室 Swift

1. 概述

2efe6805ef369641.png

欢迎来到友好聊天代码实验室。在此 Codelab 中,您将学习如何使用 Firebase 平台创建 iOS 应用程序。您将使用 Firebase 实现聊天客户端并监控其性能。

此代码实验室也可在 Objective-C 中使用。

你会学到什么

  • 允许用户登录。
  • 使用 Firebase 实时数据库同步数据。
  • 将二进制文件存储在 Firebase 存储中。

你需要什么

  • Xcode
  • 可可豆
  • 带有 iOS 8.0+ 或模拟器的测试设备

您将如何使用本教程?

只通读一遍阅读并完成练习

您如何评价您构建 iOS 应用程序的体验?

新手中间的精通

2.获取示例代码

从命令行克隆 GitHub 存储库。

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

3. 构建入门应用

2f4c98d858c453fe.png

要构建入门应用程序:

  1. 在终端窗口中,导航到android_studio_folder.png ios-starter/swift-starter从示例代码下载目录
  2. 运行pod install --repo-update
  3. 打开 FriendlyChatSwift.xcworkspace 文件以在 Xcode 中打开项目。
  4. 点击98205811bbed9d74.png运行按钮。

几秒钟后,您应该会看到友好聊天主屏幕出现。应该会出现 UI。但是,此时您无法登录、发送或接收消息。应用程序将异常中止,直到您完成下一步。

4. 创建 Firebase 控制台项目

创建项目

火力地堡控制台中选择添加项目

把这个项目FriendlyChat ,然后点击创建项目

截图来自 2015-11-06 14:13:39.png

连接您的 iOS 应用

  1. 从您的新项目的项目总览屏幕上,点击添加火力地堡到您的iOS应用
  2. 进入包ID,如“ com.google.firebase.codelab.FriendlyChatSwift ”。
  3. 进入App Store的id作为“ 123456 ”。
  4. 点击注册应用

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

在第二个屏幕点击下载GoogleService-Info.plist中下载包含所有你的应用程序所需的火力地堡元数据的配置文件。这个文件复制到你的应用程序,并把它添加到FriendlyChatSwift目标。

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

19d59efb213ddbdc.png

导入 Firebase 模块

通过确保启动Firebase模块导入。

AppDelegate.swiftFCViewController.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. 识别用户

使用规则限制经过身份验证的用户

我们现在将添加一个规则,要求在读取或写入任何消息之前进行身份验证。为此,我们将以下规则添加到我们的消息数据对象中。从数据库部分中火力地堡控制台选择实时数据库,然后单击规则选项卡上。然后更新规则,使它们看起来像这样:

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

有关该作品(包括在“身份验证”可变文档)如何看待火力地堡更多信息的安全文档

配置身份验证 API

在您的应用程序可以代表您的用户访问 Firebase 身份验证 API 之前,您必须启用它

  1. 导航到火力地堡控制台和选择项目
  2. 选择身份验证
  3. 选择登录方法选项卡
  4. 拨动了谷歌开关启用(蓝色)
  5. 保存在出现的对话框上

如果您稍后在此 Codelab 中收到错误消息“CONFIGURATION_NOT_FOUND”,请返回此步骤并仔细检查您的工作。

确认 Firebase 身份验证依赖项

确认火力地堡验证依赖于存在Podfile文件。

播客文件

pod 'Firebase/Auth'

为 Google Sign In 设置您的 Info.plist。

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

  1. 打开您的项目配置:双击左侧树视图中的项目名称。从 TARGETS 部分选择您的应用,然后选择 Info 选项卡,并展开 URL Types 部分。
  2. 单击 + 按钮,然后为反向客户端 ID 添加 URL 方案。要查找此值,请打开 GoogleService-Info.plist 配置文件,并查找 REVERSED_CLIENT_ID 键。复制该键的值,并将其粘贴到配置页面上的 URL Schemes 框中。将其他字段留空。
  3. 完成后,您的配置应类似于以下内容(但具有特定于应用程序的值):

1b54d5bd2f4f1448.png

为 Google 登录设置客户端 ID

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

AppDelegate.swift

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

添加登录处理程序

Google 登录的结果成功后,使用该帐户向 Firebase 进行身份验证。

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 Auth 中添加一个监听器,让用户在成功登录后进入应用程序。并在 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)")
    }
  }

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

  1. 点击98205811bbed9d74.png运行按钮。
  2. 您应该立即被发送到登录屏幕。点按 Google 登录按钮。
  3. 如果一切正常,您应该会被发送到消息屏幕。

6. 激活实时数据库

2efe6805ef369641.png

导入消息

在你的项目中火力地堡控制台中选择左侧导航栏上的数据库项目。在数据库的溢出菜单中选择导入JSON。浏览到initial_messages.json在friendlychat目录中的文件,选择它,然后单击导入按钮。这将替换您数据库中当前的所有数据。您还可以直接编辑数据库,使用绿色 + 和红色 x 来添加和删除项目。

20ccf4856b715b4c.png

导入数据库后应如下所示:

f3e0367f1c9cd187.png

确认 Firebase 数据库依赖性

在的依赖块Podfile文件中,确认Firebase/Database被包括。

播客文件

pod 'Firebase/Database'

同步现有消息

添加将新添加的消息同步到应用程序 UI 的代码。

您在本节中添加的代码将:

  • 初始化 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
  }

测试消息同步

  1. 点击98205811bbed9d74.png运行按钮。
  2. 点击即可开始按钮转到消息窗口中登录
  3. 通过单击“消息”条目旁边的绿色 + 符号并添加如下所示的对象,直接在 Firebase 控制台中添加新消息: f9876ffc8b316b14.png
  4. 确认它们显示在友好聊天 UI 中。

7. 发送消息

实现发送消息

将值推送到数据库。当您使用 push 方法向 Firebase 实时数据库添加数据时,会添加一个自动 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)
  }

测试发送消息

  1. 点击98205811bbed9d74.png运行按钮。
  2. 点击登录去消息窗口。
  3. 输入一条消息并点击发送。新消息应该在应用 UI 和 Firebase 控制台中可见。

8. 存储和接收图像

确认 Firebase 存储依赖

在的依赖块Podfile ,确认Firebase/Storage被包括。

播客文件

pod 'Firebase/Storage'

在仪表板中激活 Firebase 存储

转到 Firebase 控制台并确认已使用“gs://PROJECTID.appspot.com”域激活存储

b0438b37a588bcee.png

如果您看到的是激活窗口,请单击“开始使用”以使用默认规则激活它。

c290bbebff2cafa7.png

配置 FirebaseStorage

FCViewController.swift

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

接收现有消息中的图像

添加从 Firebase 存储下载图像的代码。

修改你的 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. 发送图片信息

实现存储和发送图像

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

修改你的 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])
      }
    }
  }

测试发送和接收图像消息

  1. 点击98205811bbed9d74.png运行按钮。
  2. 点击登录去消息窗口。
  3. 单击“添加照片”图标以选择照片。带有照片的新消息应该在应用 UI 和 Firebase 控制台中可见。

10. 恭喜!

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

我们涵盖的内容

  • 实时数据库
  • 联合登录
  • 贮存

了解更多