Điều kiện tiên quyết
Cài đặt như sau:
- Xcode 14.1 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 mục tiêu các phiên bản nền tảng này trở lên:
- iOS 11
- macOS 10.13
- tvOS 12
- watchOS 6
- Dự án của bạn phải nhắm mục tiêu các phiên bản nền tảng này trở lên:
Thiết lập thiết bị Apple thực tế hoặc sử dụng trình mô phỏng để chạy ứng dụng của bạn.
Đối với Nhắn tin qua đám mây trên nền tảng Apple, đây là những điều kiện tiên quyết:
- Thiết lập một thiết bị Apple vật lý .
- Nhận Khóa xác thực thông báo đẩy của Apple cho tài khoản Nhà phát triển Apple của bạn.
- Bật Thông báo đẩy trong Xcode trong Ứng dụng > Khả năng .
- Đăng nhập vào Firebase bằng tài khoản Google của bạn.
Nếu bạn chưa có dự án Xcode và chỉ muốn dùng thử sản phẩm Firebase, 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 dự án Firebase để kết nối với ứng dụng của mình. Truy cập Tìm hiểu dự án Firebase để tìm hiểu thêm về các 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 với dự án Firebase của mình. Đăng ký ứng dụng của bạn thường được gọi là "thêm" ứng dụng vào dự án của bạn.
Chuyển đến bảng điều khiển Firebase .
Ở giữa trang tổng quan dự án, hãy nhấp vào biểu tượng iOS+ để khởi chạy quy trình thiết lập.
Nếu bạn đã thêm ứng dụng vào dự án Firebase của mình, hãy nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.
Nhập ID gói ứng dụng của bạn vào trường ID gói .
ID gói xác định duy nhất một ứng dụng trong hệ sinh thái của Apple.
Tìm ID gói của bạn: mở dự án của bạn trong Xcode, chọn ứng dụng cấp cao nhất trong trình điều hướng dự án, sau đó chọn tab Chung .
Giá trị của trường Mã định danh gói là ID gói (ví dụ:
com.yourcompany.yourproject
).Xin lưu ý rằng giá trị ID gói phân biệt chữ hoa chữ thường và không thể thay đổi giá trị này cho ứng dụng Firebase này sau khi được đăng ký với dự án Firebase của bạn.
(Tùy chọn) Nhập thông tin ứng dụng khác: Biệt hiệu ứng dụng và ID App Store .
Biệt hiệu ứng dụng : Mã nhận dạng nội bộ, tiện lợi chỉ hiển thị với bạn trong bảng điều khiển Firebase
ID cửa hàng ứng dụng : Được sử dụng bởi Liên kết động Firebase để chuyển hướng người dùng đến trang App Store của bạn và bởi Google Analytics để nhập các sự kiện chuyển đổi vào Google Ads . Nếu ứng dụng của bạn chưa có ID App Store, bạn có thể thêm ID sau trong cài đặt Dự án của mình.
Nhấn 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 xuống GoogleService-Info.plist để lấy tệp cấu hình nền tảng Firebase Apple của bạn (
GoogleService-Info.plist
).Tệp cấu hình Firebase chứa số nhận dạng duy nhất nhưng không bí mật cho dự án của bạn. Để tìm hiểu thêm về tệp cấu hình này, hãy truy cập Tìm hiểu dự án Firebase .
Bạn có thể tải xuống lại tệp cấu hình Firebase của mình bất kỳ lúc nào.
Đảm bảo tên tệp cấu hình không được thêm các ký tự bổ sung, như
(2)
.
Di chuyển tệp cấu hình của bạn vào thư mục gốc của dự án Xcode của bạn. 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 ID gói trong dự án của mình, bạn phải liên kết từng ID 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 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 của Firebase.
- Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến File > Add Packages .
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Firebase của Apple:
- Chọn phiên bản SDK mà bạn muốn sử dụng.
Chọn thư viện Firebase bạn muốn sử dụng.
Nếu Google Analytics được bật trong dự án Firebase của bạn, hãy đảm bảo thêm
FirebaseAnalytics
. Đối với Analytics không có khả năng thu thập IDFA, thay vào đó 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 của bạn ở chế độ nền.
Bước 5 : Khởi tạo Firebase trong ứng dụng của bạn
Bước cuối cùng là thêm mã khởi tạo vào ứng dụng của bạn. Bạn có thể đã thực hiện việc này như một phần của việc thêm Firebase vào ứng dụng của mình. Nếu bạn đang sử dụng một dự án mẫu bắt đầu nhanh thì việc này đã được thực hiện cho bạn.
- Nhập mô-đun
FirebaseCore
trongUIApplicationDelegate
của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ủy quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Nhanh
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Mục tiêu-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Định cấu hình phiên bản chia sẻ
FirebaseApp
trong phương thứcapplication(_:didFinishLaunchingWithOptions:)
của đại biểu ứng dụng của bạn:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Nhanh
// Use Firebase library to configure APIs FirebaseApp.configure()
Mục tiêu-C
// Use Firebase library to configure APIs [FIRApp configure];
- Nếu bạn đang sử dụng SwiftUI, bạn phải tạo một đại biểu ứng dụng và đính kèm nó vào cấu trúc
App
của mình thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt chức năng chuyển giao ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn 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 đã bao gồm SDK Firebase cho Google Analytics, bạn có thể chạy ứng dụng của mình để gửi xác minh tới bảng điều khiển Firebase rằng bạn đã cài đặt thành công Firebase.
Đó là nó! Bạn có thể bỏ qua để 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 phần Câu hỏi thường gặp và khắc phục sự cố 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 nền tảng Apple. Tìm hiểu thêm về các thư viện nền tảng Firebase Apple này:
Firebase Nền tảng Apple SDK GitHub repo
Dịch vụ hoặc Sản phẩm | Vỏ | Thư viện SwiftPM | Thêm phân tích? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | không áp dụng | |
phân tích | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Kiểm tra ứng dụng | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Phân phối ứng dụng | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Xác thực | pod 'FirebaseAuth' | FirebaseAuth | |
Cửa hàng đám mây | pod 'FirebaseFirestore' | FirebaseFirestore | |
Chức năng đám mây cho SDK khách Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Nhắn tin qua đám mây | pod 'FirebaseMessaging' | FirebaseMessaging | |
Lưu trữ đám mây | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Liên kết động | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Nhắn tin trong ứng dụng | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (yêu cầu) |
Cài đặt Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
API mô hình tùy chỉnh Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Giám sát hiệu suất | pod 'FirebasePerformance' | FirebasePerformance | |
Cơ sở dữ liệu thời gian thực | pod 'FirebaseDatabase' | FirebaseDatabase | |
Cấu hình từ xa | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
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 SDK Firebase bằng cách sử dụng CocoaPods hoặc bằng cách nhập trực tiếp các khung.
Vỏ ca cao
Tìm hiểu thêm về 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, zip hiện còn bao gồm các tệp .xcframework
. Để biết chi tiết, hãy xem SDK README của nền tảng Firebase Apple trên GitHub .
Tải xuống zip khung SDK . Đây là tệp ~200MB và có thể 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 của mình.
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 iOS SDK của Firebase .
- 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ờ liên kết
-ObjC
trongOther Linker Settings
trong cài đặt bản dựng của mục tiêu.
Bước tiếp theo
Tìm hiểu về Firebase:
Truy cập Tìm hiểu 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 cho dự án.
Khám phá các ứng dụng Firebase mẫu .
Có được trải nghiệm thực tế với Lớp học lập trình iOS của Firebase .
Khám phá mã nguồn mở trong GitHub .
Chuẩn bị khởi chạy ứng dụng của bạn:
- Thiết lập cảnh báo ngân sách cho dự án của bạn trong Google Cloud Console.
- Theo dõi trang tổng quan Mức sử dụng và thanh toán trong bảng điều khiển Firebase để có được bức tranh tổng thể về việc sử dụng dự án của bạn trên nhiều dịch vụ Firebase.
- Xem lại danh sách kiểm tra khởi chạy Firebase .
Bạn đang gặp sự cố với Firebase và dự án Apple của mình? Truy cập phần Câu hỏi thường gặp và khắc phục sự cố về nền tảng Apple .
Thêm dịch vụ Firebase vào ứng dụng của bạn:
Nhận thông tin chi tiết về hành vi của người dùng với Analytics .
Thiết lập xác thực người dùng bằng Authentication .
Lưu trữ dữ liệu, như thông tin người dùng, với Cloud Firestore hoặc Cơ sở dữ liệu thời gian thực .
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 an toàn với 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 .