Điều kiện tiên quyết
Cài đặt các phần sau:
- Xcode 15.2 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 đến các phiên bản nền tảng này 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 này trở lên:
Thiết lập một thiết bị Apple thực hoặc sử dụng trình mô phỏng để chạy ứng dụng.
- Đăng nhập vào Firebase bằng Tài khoản Google của bạn.
Nếu chưa có dự án Xcode và chỉ muốn dùng thử một sản phẩm Firebase, bạn có thể tải một trong các mẫu làm quen nhanh của chúng tôi xuống.
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 một dự án Firebase để kết nối với ứng dụng của mình. Hãy truy cập vào bài viết Tìm hiểu về dự án Firebase để tìm hiểu thêm về 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 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 thường được gọi là "thêm" ứng dụng vào dự án.
Chuyển đến bảng điều khiển Firebase.
Ở trung tâm trang tổng quan của dự án, hãy nhấp vào biểu tượng iOS+ để chạy 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ã nhận dạng gói của ứng dụng vào trường mã nhận dạng gói.
(Không bắt buộc) Nhập thông tin khác về ứng dụng: Biệt hiệu ứng dụng và Mã App Store.
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 để lấy tệp cấu hình nền tảng Apple Firebase (
GoogleService-Info.plist
).Di chuyển tệp cấu hình vào thư mục gốc của dự án Xcode. 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 có nhiều mã nhận dạng gói trong dự án, bạn phải liên kết từng mã nhận dạng gói với một ứng dụng đã đăng ký trong bảng điều khiển Firebase để mỗi ứng dụng có thể có tệp GoogleService-Info.plist
riêng.
Bước 4: Thêm SDK Firebase vào ứng dụng
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 đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
- Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple Firebase:
- Chọn phiên bản SDK mà bạn muốn sử dụng.
Chọn 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 nhớ thêm
FirebaseAnalytics
. Đối với Analytics không có khả năng thu thập IDFA, 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 các phần phụ thuộc xuống ở chế độ nền.
Bước 5: Khởi động Firebase trong ứng dụng
Bước cuối cùng là thêm mã khởi chạy vào ứng dụng. Bạn có thể đã thực hiện việc này trong quá trình thêm Firebase vào ứng dụng. Nếu bạn đang sử dụng dự án mẫu nhanh, thì việc này đã được thực hiện cho bạn.
- Nhập mô-đun
FirebaseCore
trongUIApplicationDelegate
, cũng như mọi mô-đun Firebase khác mà ứng dụng của bạ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 bản sao
FirebaseApp
dùng chung trong phương thứcapplication(_:didFinishLaunchingWithOptions:)
của uỷ quyền ứng dụng: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 trình uỷ quyền ứng dụng và đính kèm trình uỷ quyền đó vào cấu trúc
App
thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt tính năng hoán đổi ứng dụng uỷ quyền. Để biết thêm thông tin, hãy xem hướng dẫn về SwiftUI.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 đã thêm SDK Firebase cho Google Analytics, bạn có thể chạy ứng dụng để gửi thông tin xác minh đến bảng điều khiển Firebase rằng bạn đã 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 bài viết Khắc phục sự cố và câu hỏi thường gặp về nền tảng Apple.
Thư viện có sẵn
Phần này liệt kê các sản phẩm Firebase được hỗ trợ cho các nền tảng của Apple. Tìm hiểu thêm về các thư viện nền tảng Apple Firebase sau:
Kho lưu trữ GitHub của SDK Firebase cho nền tảng Apple
Dịch vụ hoặc sản phẩm | Nhóm | 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) |
Lượt cài đặt Firebase | 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 | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
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 các SDK Firebase bằng cách sử dụng CocoaPods hoặc nhập trực tiếp các khung.
CocoaPods
Tìm hiểu thêm về cách 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 còn bao gồm các tệp .xcframework
. Để biết thông tin chi tiết, hãy xem README về SDK Firebase cho nền tảng Apple trên GitHub.
Tải tệp zip SDK khung xuống. Đây là tệp có dung lượng khoảng 200 MB và có thể mất một chút thời gian để tải xuống.
Giải nén tệp rồi tích hợp các khung mà bạn muốn đưa vào ứng dụng.
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 SDK Firebase cho iOS.
- Trong tệp
README.md
trong 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 tệp
METADATA.md
trong bản phân phối zip đã tải xuống.Thêm cờ trình liên kết
-ObjC
vàoOther 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:
Truy cập bài viết Tìm hiểu về dự án Firebase để tìm hiểu thêm về dự án Firebase và các phương pháp hay nhất cho dự án.
Khám phá các ứng dụng Firebase mẫu.
Tích luỹ kinh nghiệm thực tế thông qua Lớp học lập trình Firebase cho iOS.
Khám phá mã nguồn mở trong GitHub.
Chuẩn bị ra mắt ứng dụng:
- Thiết lập cảnh báo về ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
- Theo dõi bảng điều khiển về Mức sử dụng và thanh toán trong bảng điều khiển Firebase để nắm được thông tin tổng quan về mức sử dụng của dự án trên nhiều dịch vụ Firebase.
- Xem lại danh sách kiểm tra khi ra mắt Firebase.
Bạn gặp sự cố với Firebase và dự án Apple? Truy cập vào phần Câu hỏi thường gặp và cách khắc phục sự cố trên các nền tảng của Apple.
Thêm các 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 thông qua Analytics.
Thiết lập quy trình 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ố bằng Crashlytics.