Thêm Firebase vào dự án Apple của bạn

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

  • Cài đặt như sau:

    • Xcode 14.1 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 mục tiêu các phiên bản nền tảng này trở lên:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6

  • Thiết lập thiết bị vật lý của Apple hoặc sử dụng trình giả lập để chạy ứng dụng của bạn.

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

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

Trước khi có thể thêm Firebase vào ứng dụng Apple của mình, bạn cần tạo dự án Firebase để kết nối với ứng dụng của mình. Truy cập Tìm hiểu 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 của bạn, bạn cần đăng ký ứng dụng của mình với dự án Firebase. Đăng ký ứng dụng của bạn thường được gọi là "thêm" ứng dụng vào dự án của bạn.

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

  2. Ở giữa trang tổng quan dự án, hãy nhấp vào biểu tượng iOS+ để khởi 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 của mình, hãy nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.

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

  4. (Tùy chọn) Nhập thông tin ứng dụng khác: Biệt hiệu ứng dụng và ID 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 Tải xuống GoogleService-Info.plist để lấy tệp cấu hình nền tảng Apple Firebase của bạn ( GoogleService-Info.plist ).

  2. Di chuyển tệp cấu hình của bạn vào thư mục gốc của dự án Xcode của bạn. 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 bạn có nhiều ID gói trong dự án của mình, thì bạn phải liên kết từng ID 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 của bạn

Sử dụng Trình quản lý gói Swift để 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 điều hướng đến File > Add Packages .
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
    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 thư viện Firebase mà bạn muốn sử dụng.

    Nếu Google Analytics được bật trong dự án Firebase của bạn, hãy nhớ thêm FirebaseAnalytics . Đối với Analytics không có khả năng thu thập IDFA, thay vào đó hãy thêm FirebaseAnalyticsWithoutAdId .

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

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

Bước cuối cùng là thêm mã khởi tạo vào ứng dụng của bạn. Bạn có thể đã làm điều này như một phần của việc thêm Firebase vào ứng dụng của mình. Nếu bạn đang sử dụng một dự án mẫu khởi động nhanh , điều này đã được thực hiện cho bạn.

  1. Nhập mô-đun FirebaseCore trong UIApplicationDelegate của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ứng dụng ủy quyền của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Nhanh

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Mục tiêu-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Định cấu hình một phiên bản chia sẻ FirebaseApp trong phương thức application application(_:didFinishLaunchingWithOptions:) của ứng dụng của bạn:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Nhanh

    // Use Firebase library to configure APIs
FirebaseApp.configure()

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

Đó là nó! Bạn có thể bỏ qua trước các bước tiếp theo .

Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập Câu hỏi thường gặp & khắc phục sự 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 Firebase được hỗ trợ cho các nền tảng của Apple. Tìm hiểu thêm về các thư viện nền tảng Firebase Apple này:

Dịch vụ hoặc Sản phẩm quả Thư viện SwiftPM Thêm phân tích?
AdMob pod 'Google-Mobile-Ads-SDK' không áp dụng
phân tích pod 'FirebaseAnalytics' FirebaseAnalytics
Kiểm tra ứng dụng pod 'FirebaseAppCheck' FirebaseAppCheck
Phân phối ứng dụng pod 'FirebaseAppDistribution' FirebaseAppDistribution
xác thực pod 'FirebaseAuth' FirebaseAuth
Cửa hàng lửa trên đám mây pod 'FirebaseFirestore' FirebaseFirestore
Chức năng đám mây cho SDK máy khách Firebase pod 'FirebaseFunctions' FirebaseFunctions
Nhắn tin qua đám mây pod 'FirebaseMessaging' FirebaseMessaging
Lưu trữ đám mây pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Liên kết động pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Nhắn tin trong ứng dụng pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(yêu cầu)
cài đặt căn cứ hỏa lực pod 'FirebaseInstallations' FirebaseInstallations
API mô hình tùy chỉnh Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Giám sát hiệu suất pod 'FirebasePerformance' FirebasePerformance
Cơ sở dữ liệu thời gian thực pod 'FirebaseDatabase' FirebaseDatabase
Cấu hình từ xa pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Tích hợp mà không cần sử dụng Swift Package Manager

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

Vỏ ca cao

Tìm hiểu thêm về 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, zip hiện bao gồm các tệp .xcframework . Để biết chi tiết, hãy xem SDK README của nền tảng Firebase Apple trên GitHub .

  1. Tải xuống zip SDK khuôn khổ . Đây là tệp ~200 MB và có thể 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 khung hoặc phần phụ thuộc, 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 trong Other Linker Settings trong cài đặt bản dựng của mục tiêu.

Bước tiếp theo

Tìm hiểu về Firebase:

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