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.
Qua Xcode
Hỗ trợ Trình quản lý gói Swift yêu cầu 14.1 trở lên.
Nếu di chuyển từ một dự án dựa trên CocoaPods, hãy chạy
pod deintegrate
để xóa CocoaPods khỏi dự án Xcode của bạn. Sau đó, tệp.xcworkspace
do CocoaPods tạo có thể được xóa một cách an toàn. Nếu bạn thêm Firebase vào dự án lần đầu tiên thì bạn có thể bỏ qua bước này.Trong Xcode, cài đặt thư viện Firebase bằng cách điều hướng đến Tệp > Thêm gói
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
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.
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 phụ thuộc gói của bạn và tải chúng xuống ở chế độ nền.
Thông 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
của gói. Để biết thêm chi tiết, hãy xem tài liệu 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 nó vào mảng dependencies
của mục tiêu đó.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Những cân nhắc dành riêng cho sản phẩm
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 phân tích
Google Analytics yêu cầu thêm cờ liên kết -ObjC
vào cài đặt bản dựng của mục tiêu nếu được đưa vào một cách bắc cầu.
Crashlytics
Crashlytics yêu cầu bạn tải lên các biểu tượng 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 biểu tượng 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 để tải lên các biểu tượng là sử dụng tập lệnh upload-symbols
. Đặt tập lệnh vào thư mục con của tệp dự án của bạn (ví dụ: scripts/upload-symbols
), sau đó đảm bảo rằng tập lệnh có thể thực thi được:
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. Để biết ghi chú 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ố nào.
Vỏ ca cao
Firebase hỗ trợ cài đặt bằng CocoaPods ngoài Trình quản lý gói Swift.
Việc phân phối CocoaPods của Firebase yêu cầu Xcode 14.1 và CocoaPods 1.10.0 trở lên. Dưới đây là cách cài đặt Firebase bằng CocoaPods:
Tạo một Podfile nếu bạn chưa có. Từ thư mục gốc của dự án, hãy chạy lệnh sau:
pod init
Vào Podfile của bạn, hãy thêm 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 được hỗ trợ nào vào ứng dụng của mình.
Đã bật phân tích
# 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 quảng cáo cấp thiết bị, trong tài liệu về Quyền riêng tư và việc sử dụng dữ liệu và quyền riêng tư của người dùng cũng như Tính minh bạch trong việc theo dõi ứng dụng của Apple.
Phân tích chưa đượ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 'FirebaseAuth' pod 'FirebaseFirestore'
Cài đặt nhóm, sau đó mở tệp
.xcworkspace
của bạn để xem dự án trong Xcode:pod install --repo-update
open your-project.xcworkspace
Những cân nhắc dành riêng cho sản phẩm
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 biểu tượng 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 biểu tượng 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 để đưa Firebase vào ứ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 dựng 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ụ thuộc. Để cài đặt Firebase:
Tải xuống zip khung SDK . Tệp này chứa các lát kiến trúc cho tất cả kiến trúc mục tiêu có sẵn cho tất cả SDK Firebase và do đó có thể mất chút thời gian để tải xuống.
Giải nén tệp, sau đó xem lại
README
để biết các khung mà bạn muốn đưa vào ứng dụng của mình.Thêm cờ liên kết
-ObjC
trongOther Linker Settings
trong cài đặt bản dựng của mục tiêu.