Swift cho lớp học lập trình Firebase dành cho iOS

1. Tổng quan

Chào mừng bạn đến với lớp học lập trình về ứng dụng Friendly Chat. Trong lớp học lập trình này, bạn sẽ tìm hiểu cách sử dụng nền tảng Firebase để tạo ứng dụng iOS. Bạn sẽ triển khai ứng dụng trò chuyện và theo dõi hiệu suất của ứng dụng đó bằng Firebase.

Kiến thức bạn sẽ học được

• Cho phép người dùng đăng nhập.
• Đồng bộ hoá dữ liệu bằng Cơ sở dữ liệu theo thời gian thực của Firebase.
• Lưu trữ các tệp nhị phân trong Bộ nhớ Firebase.

Bạn cần có

• Xcode
• CocoaPods
• Thiết bị thử nghiệm chạy iOS 8.0 trở lên hoặc trình mô phỏng

2. Nhận mã mẫu

Sao chép kho lưu trữ GitHub từ dòng lệnh.

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

3. Tạo ứng dụng khởi đầu

Cách tạo ứng dụng khởi đầu:

1. Trong cửa sổ dòng lệnh, hãy chuyển đến thư mục ios-starter/swift-starter trong phần tải mã mẫu xuống
2. Vòng pod install --repo-update
3. Mở tệp FriendlyChatSwift.xcworkspace để mở dự án trong Xcode.
4. Nhấp vào nút Run (Chạy).

Sau vài giây, bạn sẽ thấy màn hình chính của ứng dụng Friendly Chat xuất hiện. Giao diện người dùng sẽ xuất hiện. Tuy nhiên, tại thời điểm này, bạn không thể đăng nhập, gửi hoặc nhận thư. Ứng dụng sẽ huỷ bỏ kèm theo một ngoại lệ cho đến khi bạn hoàn tất bước tiếp theo.

4. Tạo dự án trên bảng điều khiển Firebase

Tạo dự án

Trong bảng điều khiển của Firebase, hãy chọn Thêm dự án.

Gọi dự án là FriendlyChat, sau đó nhấp vào Create Project (Tạo dự án).

Nâng cấp gói giá Firebase

Để sử dụng Cloud Storage cho Firebase, dự án Firebase của bạn phải sử dụng gói giá trả theo mức sử dụng (Blaze), tức là dự án đó được liên kết với một tài khoản Cloud Billing.

• Tài khoản Cloud Billing cần có một phương thức thanh toán, chẳng hạn như thẻ tín dụng.
• Nếu bạn mới sử dụng Firebase và Google Cloud, hãy kiểm tra xem bạn có đủ điều kiện nhận khoản tín dụng 300 USD và tài khoản thanh toán Cloud dùng thử miễn phí hay không.
• Nếu bạn tham gia lớp học lập trình này trong một sự kiện, hãy hỏi người tổ chức xem có tín dụng Cloud nào không.

Để nâng cấp dự án lên gói Blaze, hãy làm theo các bước sau:

1. Trong bảng điều khiển của Firebase, hãy chọn nâng cấp gói của bạn.
2. Chọn gói Blaze. Làm theo hướng dẫn trên màn hình để liên kết tài khoản Cloud Billing với dự án của bạn.
   Nếu cần tạo tài khoản Cloud Billing trong quá trình nâng cấp này, bạn có thể cần quay lại quy trình nâng cấp trong bảng điều khiển Firebase để hoàn tất quá trình nâng cấp.

Kết nối ứng dụng iOS

1. Trên màn hình Tổng quan về dự án của dự án mới, hãy nhấp vào Thêm Firebase vào ứng dụng iOS.
2. Nhập mã nhận dạng gói là "com.google.firebase.codelab.FriendlyChatSwift".
3. Nhập mã App Store là "123456".
4. Nhấp vào Đăng ký ứng dụng.

Thêm tệp GoogleService-Info.plist vào ứng dụng của bạn

Trên màn hình thứ hai, hãy nhấp vào Tải GoogleService-Info.plist xuống để tải tệp cấu hình chứa tất cả siêu dữ liệu Firebase cần thiết cho ứng dụng của bạn. Sao chép tệp đó vào ứng dụng và thêm tệp đó vào mục tiêu FriendlyChatSwift.

Giờ đây, bạn có thể nhấp vào biểu tượng "x" ở góc trên bên phải của cửa sổ bật lên để đóng cửa sổ đó – bỏ qua bước 3 và 4 – vì bạn sẽ thực hiện các bước đó tại đây.

Nhập mô-đun Firebase

Hãy bắt đầu bằng cách đảm bảo mô-đun Firebase đã được nhập.

AppDelegate.swift, FCViewController.swift

import Firebase

Định cấu hình Firebase trong AppDelegate

Sử dụng phương thức "Configure" trong FirebaseApp bên trong hàm application:didFinishLaunchingWithOptions để định cấu hình các dịch vụ Firebase cơ bản từ tệp .plist của bạn.

AppDelegate.swift

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

5. Xác định người dùng

Sử dụng quy tắc để hạn chế những người dùng đã xác thực

Bây giờ, chúng ta sẽ thêm quy tắc để yêu cầu xác thực trước khi đọc hoặc viết bất kỳ thư nào. Để thực hiện việc này, chúng ta thêm các quy tắc sau vào đối tượng dữ liệu tin nhắn. Trong mục Cơ sở dữ liệu của Bảng điều khiển Firebase, hãy chọn Cơ sở dữ liệu theo thời gian thực, sau đó nhấp vào thẻ Quy tắc. Sau đó, hãy cập nhật các quy tắc để chúng trông giống như sau:

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

Để biết thêm thông tin về cách hoạt động của tính năng này (bao gồm cả tài liệu về biến "auth"), hãy xem tài liệu bảo mật của Firebase.

Định cấu hình API xác thực

Trước khi ứng dụng của bạn có thể thay mặt người dùng truy cập API Xác thực Firebase, bạn sẽ phải bật API đó

1. Chuyển đến bảng điều khiển của Firebase rồi chọn dự án của bạn
2. Chọn Xác thực
3. Chọn thẻ Phương thức đăng nhập
4. Gạt nút chuyển Google sang trạng thái bật (màu xanh dương)
5. Nhấn Save (Lưu) trên hộp thoại thu được

Nếu sau này bạn gặp lỗi trong lớp học lập trình này khi thông báo "CONFIGURATION_NOT_FOUND", hãy quay lại bước này và kiểm tra kỹ bài tập của bạn.

Xác nhận phần phụ thuộc Firebase Auth

Xác nhận rằng có các phần phụ thuộc Xác thực Firebase tồn tại trong tệp Podfile.

Podfile

pod 'Firebase/Auth'

Thiết lập tệp Info.plist cho tính năng Đăng nhập bằng Google.

Bạn cần thêm một giao thức URL tuỳ chỉnh vào dự án XCode.

1. Mở cấu hình dự án: nhấp đúp vào tên dự án trong chế độ xem dạng cây ở bên trái. Chọn ứng dụng của bạn trong mục MỤC TIÊU, sau đó chọn thẻ Thông tin rồi mở rộng mục Loại URL.
2. Nhấp vào nút dấu + rồi thêm giao thức URL cho mã ứng dụng khách đảo ngược. Để tìm giá trị này, hãy mở tệp cấu hình GoogleService-Info.plist rồi tìm khoá REVERSED_CLIENT_ID. Sao chép giá trị của khoá đó rồi dán vào hộp URL Schemes (Sơ đồ URL) trên trang cấu hình. Để trống các trường khác.
3. Khi hoàn tất, cấu hình của bạn sẽ có dạng như sau (nhưng với các giá trị dành riêng cho ứng dụng):

Đặt clientID cho tính năng Đăng nhập bằng Google

Sau khi định cấu hình Firebase, chúng ta có thể sử dụng clientID để thiết lập tính năng Đăng nhập bằng Google bên trong phương thức "didFinishLaunchingWithOptions:".

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
}

Thêm trình xử lý đăng nhập

Sau khi kết quả Đăng nhập bằng Google thành công, hãy sử dụng tài khoản đó để xác thực với 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
      }
    }
  }

Tự động đăng nhập người dùng. Sau đó, hãy thêm trình nghe vào Firebase Auth để cho phép người dùng truy cập vào ứng dụng sau khi đăng nhập thành công. Và xoá trình nghe trên 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)
    }
  }

Đăng xuất

Thêm phương thức Đăng xuất

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)")
    }
  }

Kiểm thử tính năng Đọc thư dưới vai trò là người dùng đã đăng nhập

1. Nhấp vào nút Run (Chạy).
2. Bạn sẽ được chuyển ngay đến màn hình đăng nhập. Nhấn vào nút Đăng nhập bằng Google.
3. Sau đó, bạn sẽ được chuyển đến màn hình nhắn tin nếu mọi thứ hoạt động tốt.

6. Kích hoạt Cơ sở dữ liệu theo thời gian thực

Nhập tin nhắn

Trong dự án của bạn trong bảng điều khiển của Firebase, hãy chọn mục Cơ sở dữ liệu trên thanh điều hướng bên trái. Trong trình đơn mục bổ sung của Cơ sở dữ liệu, hãy chọn Import JSON (Nhập JSON). Duyệt đến tệp initial_messages.json trong thư mục friendlychat, chọn tệp đó rồi nhấp vào nút Import (Nhập). Thao tác này sẽ thay thế mọi dữ liệu hiện có trong cơ sở dữ liệu của bạn. Bạn cũng có thể chỉnh sửa trực tiếp cơ sở dữ liệu bằng cách sử dụng dấu x màu xanh lục + và màu đỏ để thêm và xoá các mặt hàng.

Sau khi nhập, cơ sở dữ liệu của bạn sẽ có dạng như sau:

Xác nhận phần phụ thuộc Cơ sở dữ liệu Firebase

Trong khối phần phụ thuộc của tệp Podfile, hãy xác nhận rằng Firebase/Database được đưa vào.

Podfile

pod 'Firebase/Database'

Đồng bộ hoá thư hiện có

Thêm mã để đồng bộ hoá các thông báo mới được thêm vào giao diện người dùng của ứng dụng.

Mã bạn thêm trong phần này sẽ:

• Khởi chạy cơ sở dữ liệu Firebase và thêm một trình nghe để xử lý các thay đổi được thực hiện đối với cơ sở dữ liệu.
• Hãy cập nhật DataSnapshot để hiển thị các thông báo mới.

Sửa đổi các phương thức "deinit", "configureDatabase" và "tableView:cellForRow indexPath:" của FCViewController; thay thế bằng mã được xác định bên dưới:

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
  }

Thử nghiệm tính năng đồng bộ hoá tin nhắn

1. Nhấp vào nút Run (Chạy).
2. Nhấp vào nút Đăng nhập để bắt đầu để chuyển đến cửa sổ thư.
3. Thêm thông báo mới ngay trong bảng điều khiển của Firebase bằng cách nhấp vào biểu tượng dấu + màu xanh lục bên cạnh mục "tin nhắn" và thêm một đối tượng như sau:
4. Hãy xác nhận rằng các cuộc trò chuyện đó sẽ xuất hiện trong giao diện người dùng friendly-Chat.

7. Gửi tin nhắn

Triển khai tính năng Gửi tin nhắn

Đẩy các giá trị đến cơ sở dữ liệu. Khi bạn sử dụng phương thức đẩy để thêm dữ liệu vào Cơ sở dữ liệu theo thời gian thực của Firebase, một mã nhận dạng tự động sẽ được thêm vào. Các mã nhận dạng được tạo tự động này theo tuần tự, đảm bảo rằng thư mới sẽ được thêm theo đúng thứ tự.

Sửa đổi phương thức "sendMessage:" của FCViewController; thay thế bằng mã được xác định bên dưới:

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)
  }

Kiểm thử tính năng gửi tin nhắn

1. Nhấp vào nút Run (Chạy).
2. Nhấp vào Đăng nhập để chuyển đến cửa sổ tin nhắn.
3. Nhập tin nhắn rồi nhấn vào biểu tượng gửi. Thông báo mới sẽ xuất hiện trong giao diện người dùng của ứng dụng và trong bảng điều khiển của Firebase.

8. Lưu trữ và nhận hình ảnh

Xác nhận phần phụ thuộc vào bộ nhớ Firebase

Trong khối phần phụ thuộc của Podfile, hãy xác nhận rằng Firebase/Storage được đưa vào.

Podfile

pod 'Firebase/Storage'

Thiết lập Cloud Storage cho Firebase

Sau đây là cách thiết lập Cloud Storage cho Firebase trong dự án Firebase:

1. Trong bảng điều khiển bên trái của Firebase, hãy mở rộng mục Bản dựng rồi chọn Bộ nhớ.
2. Nhấp vào Bắt đầu.
3. Chọn vị trí cho bộ chứa Bộ nhớ mặc định.
   Các bộ chứa trong US-WEST1, US-CENTRAL1 và US-EAST1 có thể tận dụng cấp "Luôn miễn phí" cho Google Cloud Storage. Các bộ chứa ở tất cả những vị trí khác đều tuân theo giá và mức sử dụng Google Cloud Storage.
4. Nhấp vào Bắt đầu ở chế độ thử nghiệm. Đọc tuyên bố từ chối trách nhiệm về các quy tắc bảo mật.
   Trong phần sau của lớp học lập trình này, bạn sẽ thêm các quy tắc bảo mật để bảo mật dữ liệu của mình. Đừng phân phối hoặc hiển thị công khai ứng dụng mà không thêm Quy tắc bảo mật cho bộ nhớ.
5. Nhấp vào Tạo.

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

  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
  }