Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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ó một dự án Xcode và chỉ muốn thử ra một sản phẩm căn cứ hỏa lực, bạn có thể tải về một trong chúng tôi mẫu QuickStart .

Bước 1: Tạo một dự án căn cứ hỏa lực

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. Thăm Hiểu căn cứ hỏa lực dự án để tìm hiểu thêm về các dự án căn cứ hỏa lực.

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

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

Thăm Hiểu dự án căn cứ hỏa lực để tìm hiểu thêm về thực tiễn tốt nhất và cân nhắc để thêm các ứng dụng cho một dự án căn cứ hỏa lực, bao gồm cách xử lý nhiều build biến thể.

  1. Tới các căn cứ hỏa lực console .

  2. Ở trung tâm của trang tổng quan về dự án, nhấp vào biểu tượng iOS ( ) để khởi động công việc cài đặt.

    Nếu bạn đã thêm vào một ứng dụng cho dự án căn cứ hỏa lực của bạn, 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 của ứng dụng của bạn ID bó trong iOS bó trường ID.

  4. (Tùy chọn) Nhập thông tin ứng dụng khác: App nickname và App Store ID.

  5. Bấm vào Đăng ký ứng dụng.

Bước 3: Thêm một tập tin cấu hình căn cứ hỏa lực

  1. Nhấp vào Tải xuống GoogleService-Info.plist để có được tập tin cấu hình căn cứ hỏa lực 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 bó ID trong dự án của bạn, bạn phải kết hợp mỗi bó ID với một ứng dụng đã đăng ký trong các căn cứ hỏa lực console để mỗi ứng dụng có thể có của riêng mình GoogleService-Info.plist tập tin.

Bước 4: Thêm căn cứ hỏa lực SDK để ứng dụng của bạn

Chúng tôi khuyên bạn sử dụng CocoaPods để cài đặt các thư viện căn cứ hỏa lực. Tuy nhiên, nếu bạn không muốn sử dụng CocoaPods, bạn có thể tích hợp các khuôn khổ SDK trực tiếp hoặc sử dụng Swift Package Manager để thay thế.

Bạn đang sử dụng một trong những mẫu QuickStart ? Dự án Xcode và Podfile (với vỏ) đã xuất hiện, nhưng bạn vẫn sẽ cần phải thêm tập tin cấu hình căn cứ hỏa lực của bạn và cài đặt các cụ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 căn cứ hỏa lực hỗ trợ để ứng dụng iOS của bạn.

    Đã bật phân tích

    platform :ios, ‘10.0’
    
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# 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'

    Tìm hiểu thêm về IDFA, nhận dạng quảng cáo cấp thiết bị, trong của Apple tài khoản riêng tư và dữ liệu sử dụng và theo dõi ứng dụng minh bạch tài liệu.

    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 vỏ, sau đó mở của bạn .xcworkspace tập tin để xem dự án trong Xcode:

    pod install
    open your-project.xcworkspace

Bước 5: Khởi tạo căn cứ hỏa lực 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 QuickStart , điều này đã được thực hiện cho bạn.

  1. Nhập module căn cứ hỏa lực trong bạn UIApplicationDelegate :

    Nhanh

    import Firebase

    Objective-C

    @import Firebase;
  2. Cấu hình một FirebaseApp chia sẻ Ví dụ, điển hình là trong ứng dụng của bạn application:didFinishLaunchingWithOptions: phương pháp:

    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ể bỏ qua cho các bước tiếp theo .

Nếu bạn đang gặp rắc rối việc thiết lập, mặc dù, hãy truy cập xử lý sự cố iOS & FAQ .

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'
Kiểm tra ứng dụng pod 'Firebase/AppCheck'
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'
Crashlytics pod 'Firebase/Crashlytics'
Liên kết động pod 'Firebase/DynamicLinks'
Nhắn tin trong ứng dụng pod 'Firebase/InAppMessaging'
(yêu cầu)
Cài đặt Firebase pod 'Firebase/Installations'
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, xem các căn cứ hỏa lực iOS SDK README trên GitHub .

  1. Tải zip framework SDK . Đâ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 tin, sau đó xem lại README cho Khung mà bạn muốn bao gồm trong ứng dụng của bạn.

  3. Thêm ObjC mối liên kết cờ trong của bạn Other Linker Settings trong cài đặt xây dựng của đối tượng.

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

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

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: