Thêm Firebase vào dự án Apple

Điều kiện tiên quyết

  • Cài đặt các mục sau:

    • Xcode 16.2 trở lên

  • Đảm bảo rằng dự án của bạn đáp ứng các yêu cầu sau:

    • Dự án của bạn phải nhắm đến các phiên bản nền tảng này trở lên:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • Thiết lập một thiết bị thực của Apple hoặc sử dụng trình mô phỏng để chạy ứng dụng.

Nếu chưa có dự án Xcode và chỉ muốn dùng thử một sản phẩm của Firebase, bạn có thể tải một trong các mẫu khởi động nhanh của chúng tôi xuống.

Bước 1: Tạo dự án Firebase

Trước khi có thể thêm Firebase vào ứng dụng Apple, bạn cần tạo một dự án Firebase để kết nối với ứng dụng của mình. Hãy truy cập vào trang Tìm hiểu về các dự án Firebase để tìm hiểu thêm về các dự án Firebase.

Bước 2: Đăng ký ứng dụng của bạn với Firebase

Để sử dụng Firebase trong ứng dụng Apple, bạn cần đăng ký ứng dụng với dự án Firebase. Việc đăng ký ứng dụng thường được gọi là "thêm" ứng dụng vào dự án.

  1. Chuyển đến bảng điều khiển Firebase.

  2. Ở giữa trang tổng quan của dự án, hãy nhấp vào biểu tượng iOS+ để chạy quy trình thiết lập.

    Nếu bạn đã thêm một ứng dụng vào dự án Firebase, hãy nhấp vào Thêm ứng dụng để hiển thị các lựa chọn về nền tảng.

  3. Nhập mã nhận dạng gói của ứng dụng vào trường mã nhận dạng gói.

  4. (Không bắt buộc) Nhập thông tin khác về ứng dụng: Biệt hiệu của ứng dụng và Mã App Store.

  5. Nhấp vào Đăng ký ứng dụng.

Bước 3: Thêm tệp cấu hình Firebase

  1. Nhấp vào Download GoogleService-Info.plist (Tải GoogleService-Info.plist xuống) để lấy tệp cấu hình Firebase của ứng dụng (GoogleService-Info.plist).

  2. Di chuyển tệp cấu hình vào thư mục gốc của dự án Xcode. Nếu được nhắc, hãy chọn thêm tệp cấu hình vào tất cả các mục tiêu.

Nếu có nhiều mã nhận dạng gói trong dự án, bạn phải liên kết từng mã nhận dạng gói với một ứng dụng đã đăng ký trong bảng điều khiển Firebase để mỗi ứng dụng có thể có tệp GoogleService-Info.plist riêng.

Bước 4: Thêm SDK Firebase vào ứng dụng

Sử dụng Swift Package Manager để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK Firebase cho các nền tảng của Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Chọn phiên bản SDK mà bạn muốn sử dụng.

  4. Chọn các thư viện Firebase mà bạn muốn sử dụng.

    Nếu bạn đã bật Google Analytics trong dự án Firebase, hãy nhớ thêm FirebaseAnalytics. Thao tác này sẽ cung cấp tất cả các tính năng phân tích. Bạn cũng có thể chọn các tính năng riêng lẻ; hãy tham khảo Câu hỏi thường gặp của chúng tôi về cách sắp xếp mới nhất của các mô-đun trong Google Analytics cho Firebase SDK.

Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc của bạn xuống ở chế độ nền.

Bước 5: Khởi động Firebase trong ứng dụng của bạn

Bước cuối cùng là thêm mã khởi chạy vào ứng dụng của bạn. Có thể bạn đã thực hiện việc này trong quá trình thêm Firebase vào ứng dụng. Nếu đang sử dụng dự án mẫu khởi động nhanh, thì bạn không cần làm gì cả.

  1. Nhập mô-đun FirebaseCore trong UIApplicationDelegate, cũng như mọi mô-đun Firebase khác mà uỷ quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và 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. Định cấu hình một phiên bản dùng chung FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của uỷ quyền ứng dụng:

    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. Nếu đang sử dụng SwiftUI, bạn phải tạo một uỷ quyền ứng dụng và đính kèm uỷ quyền đó vào cấu trúc App thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng thay thế phương thức uỷ quyền của ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn về 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. Nếu đã thêm Firebase SDK cho Google Analytics, bạn có thể chạy ứng dụng để gửi thông tin xác minh đến bảng điều khiển Firebase rằng bạn đã cài đặt thành công Firebase.

Tất cả chỉ có thế! Bạn có thể chuyển sang các bước tiếp theo.

Tuy nhiên, nếu bạn gặp vấn đề khi thiết lập, hãy truy cập vào trang Khắc phục sự cố và Câu hỏi thường gặp về các nền tảng của Apple.

Thư viện có sẵn

Phần này liệt kê các sản phẩm của Firebase được hỗ trợ cho nền tảng Apple. Tìm hiểu thêm về các thư viện nền tảng Apple của Firebase:

Dịch vụ hoặc Sản phẩm Nhóm Thư viện SwiftPM Thêm Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' Không áp dụng
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Data Connect Không áp dụng FirebaseDataConnect
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(bắt buộc)
Firebase lượt cài đặt pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Custom Model APIs pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

1 Firebase AI Logic trước đây có tên là "Vertex AI in Firebase" với pod pod 'FirebaseVertexAI' và Thư viện SwiftPM FirebaseVertexAI.

Tích hợp mà không cần sử dụng Trình quản lý gói Swift

Nếu không muốn dùng Trình quản lý gói Swift, bạn vẫn có thể tận dụng các SDK Firebase bằng cách dùng CocoaPods hoặc nhập trực tiếp các khung.

CocoaPods

Tìm hiểu thêm về việc tích hợp CocoaPods trong hướng dẫn của chúng tôi.

Khung

Ngoài việc hỗ trợ nền tảng iOS, tệp zip hiện có chứa các tệp .xcframework. Để biết thông tin chi tiết, hãy xem README của SDK Firebase cho các nền tảng Apple trên GitHub.

  1. Tải tệp zip SDK khung xuống. Đây là tệp có dung lượng khoảng 200 MB và có thể mất một chút thời gian để tải xuống.

  2. Giải nén tệp, sau đó tích hợp các khung mà bạn muốn đưa vào ứng dụng của mình.

    Bạn có thể tìm thấy hướng dẫn tích hợp ở một trong những nơi sau:

    Để biết thông tin về các phiên bản hoặc phần phụ thuộc của khung, hãy tham khảo tệp METADATA.md trong bản phân phối zip đã tải xuống.

  3. Thêm cờ trình liên kết -ObjC vào Other Linker Settings trong chế độ cài đặt bản dựng của mục tiêu.

Các bước tiếp theo

Tìm hiểu về Firebase:

Thêm các dịch vụ của Firebase vào ứng dụng:

  • Tạo các tính năng AI tạo sinh bằng các mô hình Gemini và Imagen bằng cách sử dụng Firebase AI Logic.

  • Thu thập thông tin chi tiết về hành vi của người dùng bằng Analytics.

  • Thiết lập quy trình xác thực người dùng bằng Authentication.

  • Lưu trữ dữ liệu, chẳng hạn như thông tin người dùng, bằng Cloud Firestore hoặc Realtime Database.

  • Lưu trữ các tệp như ảnh và video bằng Cloud Storage.

  • Kích hoạt mã phụ trợ chạy trong một môi trường an toàn bằng Cloud Functions.

  • Gửi thông báo bằng biểu tượng Cloud Messaging.

  • Tìm hiểu thời điểm và lý do ứng dụng của bạn gặp sự cố bằng Crashlytics.