Các lựa chọn để cài đặt Firebase trong ứng dụng Apple

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

Firebase đề xuất Trình quản lý gói Swift cho các dự án mới.

Thông qua Xcode

Tính năng hỗ trợ Trình quản lý gói Swift yêu cầu phiên bản 14.1 trở lên.

  1. Nếu di chuyển từ dự án dựa trên CocoaPods, hãy chạy pod deintegrate để xoá CocoaPods từ dự án Xcode của bạn. .xcworkspace do CocoaPods tạo có thể được xoá an toàn sau đó. Nếu bạn đang thêm Firebase vào một dự án lần đầu tiên, nên bước này có thể bị bỏ qua.

  2. Trong Xcode, hãy cài đặt thư viện Firebase bằng cách chuyển đến Tệp > Thêm gói.

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

    https://github.com/firebase/firebase-ios-sdk.git

  4. Chọn phiên bản Firebase mà bạn muốn sử dụng. Đối với các dự án mới, chúng tôi bạn nên sử dụng phiên bản Firebase mới nhất.

  5. Chọn các 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 phân giải các phần phụ thuộc của gói và tải chúng xuống trong nền.

Qua Package.swift

Để tích hợp Firebase vào gói Swift thông qua tệp kê khai Package.swift, bạn có thể thêm Firebase vào mảng dependencies trong gói của bạn. Để biết thêm thông tin, hãy xem thời gian Tài liệu về Trình quản lý gói Swift.

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 nào phụ thuộc vào sản phẩm Firebase, hãy thêm mục tiêu đó vào Mảng dependencies của mục tiêu đó.

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

Những điểm cần cân nhắc theo từng sản phẩm

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

Google Analytics

Google Analytics yêu cầu bạn phải thêm cờ trình liên kết -ObjC vào nếu được đưa vào theo cách bắc cầu.

Crashlytics

Crashlytics yêu cầu bạn tải các biểu tượng gỡ lỗi lên.

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

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

Một tuỳ chọn khác để tải các biểu tượng lên là sử dụng upload-symbols tập lệnh. Đặt tập lệnh vào một thư mục con của tệp dự án (ví dụ: scripts/upload-symbols), sau đó đảm bảo tập lệnh có thể thực thi:

chmod +x scripts/upload-symbols

Bạn có thể sử dụng tập lệnh này để tải các tệp dSYM lên theo cách thủ công. Để biết ghi chú về việc sử dụng và hướng dẫn bổ sung cho tập lệnh, hãy chạy upload-symbols mà không có bất kỳ tham số.

CocoaPods

Firebase hỗ trợ cài đặt bằng CocoaPods ngoài Trình quản lý gói Swift.

Tính năng phân phối CocoaPods của Firebase yêu cầu Xcode 14.1 và CacaoPods 1.12.0 trở lên. Sau đây là cách cài đặt Firebase sử dụng CocoaPods:

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

    pod init

  2. Đối với Podfile, 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ỳ phương thức nào được hỗ trợ các sản phẩm của Firebase vào ứng dụng của bạn.

    Đã bật Analytics 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# 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 'FirebaseAuth'
pod 'FirebaseFirestore'

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

    Chưa bật Analytics 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

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

    pod install --repo-update
    open your-project.xcworkspace

Những điểm cần cân nhắc theo từng sản phẩm

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

Crashlytics

Crashlytics yêu cầu bạn tải các biểu tượng gỡ lỗi lên.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage (Lễ hội Carthage)

Tính năng hỗ trợ Carthage đang trong giai đoạn thử nghiệm. Xem hướng dẫn trên GitHub để đưa Firebase vào ứng dụng của bạn thông qua Carthage.

Tích hợp theo cách thủ công

Firebase cung cấp bản phân phối XCFramework nhị phân được tạo sẵn cho những 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ần phụ thuộc. Cách cài đặt Firebase:

  1. Tải xuống mã zip SDK khung. Tệp này chứa các lát cắt cấu trúc cho mọi cấu trúc mục tiêu có sẵn cho tất cả Firebase SDK nên có thể mất chút thời gian để tải xuống.

  2. Giải nén tệp, sau đó xem lại README của các khung mà bạn muốn có trong ứng dụng của bạn.

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