Catch up on everything we announced at this year's Firebase Summit. Learn more

Cài đặt Firebase trong ứng dụng Apple của bạn

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

Bắt đầu với v8.0.0 của căn cứ hỏa lực của Apple SDK, căn cứ hỏa lực của Swift Package Manager hỗ trợ là ra bản beta và nói chung là có sẵn để sử dụng. CocoaPods không bắt buộc đối với người dùng Swift Package Manager.

Đối với phiên bản Xcode 12.5 trở lên, Swift Package Manager là phương pháp cài đặt được khuyến nghị.

Qua Xcode

Hỗ trợ Trình quản lý gói Swift yêu cầu Xcode 12.5 trở lên.

  1. Nếu việc di chuyển từ một dự án CocoaPods-based, chạy pod deintegrate để loại bỏ CocoaPods từ dự án Xcode của bạn. Các CocoaPods tạo .xcworkspace tập tin một cách an toàn có thể bị xóa sau đó. Nếu bạn đang thêm Firebase vào một dự án lần đầu tiên, bạn có thể bỏ qua bước này.

  2. Trong Xcode, cài đặt các thư viện căn cứ hỏa lực bằng cách điều hướng tới File> Swift gói> Thêm gói phụ thuộc ...

  3. Trong lời nhắc xuất hiện, hãy chọn kho lưu trữ Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Chọn phiên bản Firebase bạn muốn sử dụng. Đối với các dự án mới, chúng tôi khuyên bạn nên sử dụng phiên bản Firebase mới nhất.

  5. Chọn thư viện Firebase bạn muốn đưa vào ứng dụng của mình.

Sau khi bạn hoàn tất, Xcode sẽ bắt đầu giải quyết các gói phụ thuộc của bạn và tải chúng xuống nền.

Via Package.swift

Thực hiện lồng ghép căn cứ hỏa lực vào một gói Swift qua một Package.swift manifest, bạn có thể thêm căn cứ hỏa lực với dependencies mảng của gói của bạn. Để biết thêm chi tiết, xem tài liệu Swift Package Manager .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Sau đó, trong bất kỳ mục tiêu mà phụ thuộc vào một sản phẩm căn cứ hỏa lực, thêm nó vào dependencies mảng của mục tiêu đó.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Cân nhắc về sản phẩm cụ thể

Một số sản phẩm Firebase yêu cầu các bước tích hợp bổ sung để hoạt động chính xác.

Google Analytics

Google Analytics đòi hỏi thêm -ObjC cờ mối liên kết để thiết lập xây dựng của mục tiêu của bạn nếu bao gồm transitively.

Crashlytics

Crashlytics yêu cầu bạn tải lên các ký hiệu gỡ lỗi.

Bạn có thể sử dụng giai đoạn xây dựng tập lệnh chạy cho Xcode để tự động tải lên các ký hiệu gỡ lỗi sau khi xây dựng. Tìm tập lệnh chạy ở đây:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Một tùy chọn khác cho các ký hiệu tải lên là sử dụng upload-symbols kịch bản. Đặt script trong thư mục con của tập tin dự án của bạn (ví dụ scripts/upload-symbols ), sau đó hãy chắc chắn rằng kịch bản được thực thi:

chmod +x scripts/upload-symbols

Tập lệnh này có thể được sử dụng để tải lên các tệp dSYM theo cách thủ công. Cho các ghi chú sử dụng và hướng dẫn bổ sung cho kịch bản, chạy upload-symbols mà không cần bất kỳ thông số.

Ca cao

Căn cứ hỏa lực hỗ trợ cài đặt với CocoaPods ngoài Swift Package Manager.

Bản phân phối CocoaPods của Firebase yêu cầu Xcode 12.5 và CocoaPods 1.10.0 trở lên. Dưới đây là cách cài đặt Firebase bằng CocoaPods:

  1. Tạo Podfile nếu bạn chưa có. Từ thư mục gốc của thư mục dự án của bạn, hãy chạy lệnh sau:

    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 của bạn.

    Đã bật phân tích

    # 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ụngtheo dõi ứng dụng minh bạch tài liệu.

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

    # 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 --repo-update
    open your-project.xcworkspace

Cân nhắc về sản phẩm cụ thể

Một số sản phẩm Firebase yêu cầu các bước tích hợp bổ sung để hoạt động chính xác.

Crashlytics

Crashlytics yêu cầu bạn tải lên các ký hiệu gỡ lỗi.

Bạn có thể sử dụng giai đoạn xây dựng tập lệnh chạy cho Xcode để tự động tải lên các ký hiệu gỡ lỗi sau khi xây dựng. Tìm tập lệnh chạy ở đây:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Hỗ trợ Carthage là thử nghiệm. Xem hướng dẫn trên GitHub cho bao gồm căn cứ hỏa lực trong ứng dụng của bạn thông qua Carthage.

Tích hợp thủ công

Firebase cung cấp bản phân phối XCFramework nhị phân được tạo sẵn cho người dùng muốn tích hợp Firebase mà không cần sử dụng trình quản lý phụ thuộc. Để cài đặt Firebase:

  1. Tải zip framework SDK . Tệp này chứa các lát kiến ​​trúc cho tất cả các kiến ​​trúc mục tiêu có sẵn cho tất cả các SDK Firebase và do đó 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 các khuôn khổ mà bạn muốn bao gồm trong ứng dụng của bạn.

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