Điều kiện tiên quyết
Cài đặt như sau:
- Xcode 15.2 trở lên
Hãy đảm bảo 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 đến các phiên bản nền tảng sau trở lên:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Dự án của bạn phải nhắm đến các phiên bản nền tảng sau trở lên:
Thiết lập thiết bị Apple thực hoặc sử dụng trình mô phỏng để chạy ứng dụng của bạn.
- Đăng nhập vào Firebase bằng Tài khoản Google.
Nếu bạn chưa có dự án Xcode và chỉ muốn dùng thử Firebase sản phẩm, 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 Apple, bạn cần tạo Firebase dự án để kết nối với ứng dụng của bạn. Truy cập/ghé qua Tìm hiểu về các dự án Firebase để tìm hiểu thêm Dự án Firebase.
Bước 2: Đăng ký ứng dụng của bạn với Firebase
Để sử dụng Firebase trong ứng dụng của Apple, bạn cần đăng ký ứng dụng của mình với Dự án Firebase. Việc đăng ký ứng dụng của bạn thường được gọi là "thêm" ứng dụng của bạn đến dự án.
Chuyển đến bảng điều khiển của Firebase.
Ở giữa trang tổng quan về dự án, hãy nhấp vào biểu tượng iOS+ để bắt đầu quy trình thiết lập.
Nếu bạn đã thêm một ứng dụng vào dự án Firebase, hãy nhấp vào Thêm ứng dụng để hiển thị các tuỳ chọn nền tảng.
Nhập mã gói của ứng dụng vào trường mã gói.
(Không bắt buộc) Nhập thông tin khác về ứng dụng: Biệt hiệu của ứng dụng và Mã cửa hàng ứng dụng.
Nhấp vào Đăng ký ứng dụng.
Bước 3: Thêm tệp cấu hình Firebase
Nhấp vào Tải GoogleService-Info.plist xuống để nhận Apple Firebase tệp cấu hình nền tảng (
GoogleService-Info.plist
).Di chuyển tệp cấu hình vào gốc của dự án Xcode. Nếu được nhắc, chọn để thêm tệp cấu hình vào tất cả mục tiêu.
Nếu có nhiều mã gói trong dự án, bạn phải liên kết từng gói
Mã nhận dạng của một ứng dụng đã đăng ký trong bảng điều khiển Firebase để mỗi ứng dụng đều có thể có
tệp GoogleService-Info.plist
riêng.
Bước 4: Thêm Firebase SDK vào ứng dụng của bạn
Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.
- Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến Tệp > Thêm gói.
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
- Chọn phiên bản SDK mà bạn muốn sử dụng.
Chọn những thư viện Firebase mà bạn muốn sử dụng.
Nếu bạn bật Google Analytics trong dự án Firebase, hãy đảm bảo để thêm
FirebaseAnalytics
. Đối với Analytics không thu thập IDFA chức năng, hãy thêmFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc trong nền.
Bước 5: Khởi chạy Firebase trong ứng dụng
Bước cuối cùng là thêm mã khởi chạy vào ứng dụng của bạn. Bạn có thể có đã thực hiện việc này trong quá trình thêm Firebase vào ứng dụng của bạn. Nếu bạn đang sử dụng Nhanh chóng bắt đầu dự án mẫu. Chúng tôi đã làm việc này cho bạn.
- Nhập mô-đun
FirebaseCore
trongUIApplicationDelegate
cũng như bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyền sử dụng. Ví dụ: để sử dụng Cloud Firestore và Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Định cấu hình một
FirebaseApp
thực thể dùng chung trong Phương thứcapplication(_:didFinishLaunchingWithOptions:)
:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Nếu đang sử dụng SwiftUI, bạn phải tạo một ứng dụng uỷ quyền và đính kèm nó
đến cấu trúc
App
của bạn thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt tính năng uỷ quyền ứng dụng. Cho hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Nếu đã bao gồm Firebase SDK cho Google Analytics, bạn có thể chạy để gửi thông tin xác minh đến bảng điều khiển Firebase cài đặt thành công Firebase.
Tất cả chỉ có thế! Bạn có thể chuyển sang các bước tiếp theo.
Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập vào Khắc phục sự cố cho các nền tảng của Apple và Câu hỏi thường gặp.
Thư viện có sẵn
Phần này liệt kê các sản phẩm của Firebase được hỗ trợ cho các nền tảng của Apple. Học hỏi thông tin thêm về các thư viện nền tảng Apple Firebase này:
Kho lưu trữ GitHub của Firebase dành cho các nền tảng của Apple
Dịch vụ hoặc Sản phẩm | Vị trí | Thư viện SwiftPM | Google Analytics.">Thêm Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
Không áp dụng | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(bắt buộc) |
Firebase lượt cài đặt | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML API mô hình tuỳ chỉnh | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | Không áp dụng | FirebaseVertexAI-Preview |
Tích hợp mà không cần sử dụng Trình quản lý gói Swift
Nếu không muốn sử dụng Trình quản lý gói Swift, bạn vẫn có thể tận dụng Firebase SDK bằng cách sử dụng CocoaPods hoặc nhập trực tiếp khung.
CocoaPods
Tìm hiểu thêm về việc tích hợp CocoaPods trong hướng dẫn của chúng tôi.
Khung
Ngoài việc hỗ trợ nền tảng iOS, tệp zip hiện bao gồm .xcframework
tệp. Để biết thông tin chi tiết, hãy xem bài viết về Firebase
SDK README trên các nền tảng của Apple trên
GitHub
của Google.
Tải xuống mã zip SDK khung. Đây là tệp khoảng 200MB và có thể mất thời gian để tải xuống.
Giải nén tệp, sau đó tích hợp các khung mà bạn muốn đưa vào trong ứng dụng của bạn.
Bạn có thể tìm thấy hướng dẫn tích hợp ở một trong những nơi sau:
- Trong Kho lưu trữ GitHub của Firebase dành cho iOS.
- Trong tệp
README.md
thuộc bản phân phối zip đã tải xuống.
Để biết thông tin về các phiên bản khung hoặc phần phụ thuộc, hãy tham khảo
METADATA.md
tệp trong bản phân phối zip đã tải xuống.Thêm
-ObjC
cờ trình liên kết trongOther Linker Settings
trong chế độ cài đặt bản dựng của mục tiêu.
Các bước tiếp theo
Tìm hiểu về Firebase:
Hãy tham khảo bài viết Tìm hiểu về các dự án Firebase để tìm hiểu thêm về các dự án Firebase và các phương pháp hay nhất dành cho dự án.
Khám phá ứng dụng Firebase mẫu.
Nhận trải nghiệm thực tế với Firebase iOS Lớp học lập trình.
Khám phá mã nguồn mở trong GitHub.
Chuẩn bị phát hành ứng dụng:
- Thiết lập ngân sách cảnh báo cho dự án của bạn trong bảng điều khiển Google Cloud.
- Theo dõi Việc sử dụng và thanh toán trang tổng quan trong bảng điều khiển của Firebase để có được thông tin tổng thể về trên nhiều dịch vụ Firebase.
- Xem danh sách kiểm tra khi phát hành Firebase.
Bạn gặp sự cố với Firebase và dự án Apple của bạn? Truy cập vào trang khắc phục sự cố về các nền tảng của Apple và Câu hỏi thường gặp.
Thêm dịch vụ Firebase vào ứng dụng:
Nhận thông tin chi tiết về hành vi của người dùng bằng Analytics.
Thiết lập tính năng xác thực người dùng bằng Authentication.
Lưu trữ dữ liệu, chẳng hạn như thông tin người dùng, bằng Cloud Firestore hoặc Realtime Database.
Lưu trữ các tệp, như ảnh và video bằng Cloud Storage.
Kích hoạt mã phụ trợ chạy trong môi trường bảo mật bằng Cloud Functions.
Gửi thông báo bằng Cloud Messaging.
Tìm hiểu thời điểm và lý do ứng dụng của bạn gặp sự cố với Crashlytics.