Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

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

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

  • Cài đặt sau:

    • Xcode 12.2 trở lên
    • CocoaPods 1.10.0 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 iOS 10 trở lên.

  • Thiết lập thiết bị iOS thực hoặc sử dụng trình mô phỏng iOS để 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 iOS của mình, bạn cần tạo dự án Firebase để kết nối với ứng dụng iOS 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

Sau khi có dự án Firebase, bạn có thể thêm ứng dụng iOS của mình vào đó.

Truy cập Tìm hiểu các dự án Firebase để tìm hiểu thêm về các phương pháp hay nhất và cân nhắc khi thêm ứng dụng vào dự án Firebase, bao gồm cả cách xử lý nhiều biến thể bản dựng.

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

  2. Ở giữa trang tổng quan về dự án, 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 iOS .

  4. (Tùy chọn) Nhập thông tin ứng dụng khác: Biệt hiệu ứng dụng và ID cửa hàng ứng dụng .

  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 để tải tệp cấu hình Firebase iOS 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, 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 của riêng mình.

Bước 4 : Thêm SDK Firebase vào ứng dụng của bạn

Chúng tôi khuyên bạn nên sử dụng CocoaPods để cài đặt các thư viện Firebase. Tuy nhiên, nếu không muốn sử dụng CocoaPods, bạn có thể tích hợp trực tiếp các khung SDK hoặc sử dụng Trình quản lý gói Swift (beta) .

Bạn có đang sử dụng một trong các mẫu khởi động nhanh không? Dự án Xcode và Podfile (với các nhóm) đã có sẵn, nhưng bạn vẫn cần thêm tệp cấu hình Firebase của mình và cài đặt các nhóm.

  1. Tạo Podfile nếu bạn chưa có:

    cd your-project-directory
    pod init

  2. Vào Podfile của bạn, hãy thêm các nhóm Firebase mà bạn muốn sử dụng trong ứng dụng của mình.

    Bạn có thể thêm bất kỳ sản phẩm Firebase nào được hỗ trợ vào ứng dụng iOS của mình.

    Đã bật phân tích

    platform :ios, ‘10.0’
    
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'
    
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

    Phân tích không được bật

    platform :ios, ‘10.0’
    
# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

  3. Cài đặt các nhóm, sau đó mở tệp .xcworkspace của bạn để xem dự án trong Xcode:

    pod install
    open your-project.xcworkspace

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ể đã thực hiện việc 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 Firebase trong UIApplicationDelegate của bạn:

    Nhanh

    import Firebase

    Objective-C

    @import Firebase;
  2. Định cấu hình phiên bản được chia sẻ FirebaseApp , thường trong ứng dụng của ứng dụng của bạn application:didFinishLaunchingWithOptions: phương thức application:didFinishLaunchingWithOptions: ::

    Nhanh

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Nếu bạn đã bao gồm Firebase Analytics, bạn có thể chạy ứng dụng của mình để gửi xác minh đến 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ể chuyển sang các bước tiếp theo .

Vỏ có sẵn

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

Dịch vụ hoặc Sản phẩm Vỏ Thêm phân tích?
AdMob pod 'Google-Mobile-Ads-SDK'
phân tích pod 'Firebase/Analytics'
Phân phối ứng dụng pod 'Firebase/AppDistribution'
Xác thực pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Chức năng đám mây cho SDK ứng dụng khách Firebase pod 'Firebase/Functions'
Nhắn tin qua đám mây pod 'Firebase/Messaging'
Lưu trữ đám mây pod 'Firebase/Storage'
Firebase Crashlytics pod 'Firebase/Crashlytics'
Liên kết động pod 'Firebase/DynamicLinks'
Nhắn tin trong ứng dụng pod 'Firebase/InAppMessaging'
(cần thiết)
API mô hình tùy chỉnh Firebase ML pod 'Firebase/MLModelDownloader'
Giám sát hiệu suất pod 'Firebase/Performance'
Cơ sở dữ liệu thời gian thực pod 'Firebase/Database'
Cấu hình từ xa pod 'Firebase/RemoteConfig'

Tích hợp mà không cần CocoaPods

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

Các khuôn khổ

Ngoài việc hỗ trợ nền tảng iOS, tệp zip hiện bao gồm các tệp .xcframework bổ sung hỗ trợ Catalyst dựa trên cộng đồng. Để biết chi tiết, hãy xem SDK Firebase iOS README trên GitHub .

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

  2. Giải nén tệp, sau đó xem lại README cho các Khung mà bạn muốn đưa vào ứng dụng của mình.

  3. Thêm cờ trình liên kết ObjC trong Other Linker Settings của bạn trong cài đặt xây dựng của mục tiêu.

Trình quản lý gói Swift

Hỗ trợ Trình quản lý gói Swift hiện đang ở giai đoạn thử nghiệm. Làm theo tài liệu trên GitHub và gửi bất kỳ phản hồi nào tới trình theo dõi vấn đề GitHub .

Bước tiếp theo

Tìm hiểu về Firebase:

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