Điều kiện tiên quyết
Cài đặt sau:
- Xcode 12.2 trở lên
- CocoaPods 1.10.0 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 iOS 10 trở lên.
Thiết lập thiết bị iOS thực hoặc sử dụng trình mô phỏng iOS để chạy ứng dụng của bạn.
Đối với Nhắn tin qua đám mây trên iOS, đây là các điều kiện tiên quyết:
- Thiết lập thiết bị iOS thực .
- 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 iOS của mình, bạn cần tạo dự án Firebase để kết nối với ứng dụng iOS của mình. Truy cập Tìm hiểu các 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
Sau khi có dự án Firebase, bạn có thể thêm ứng dụng iOS của mình vào đó.
Truy cập Tìm hiểu các dự án Firebase để tìm hiểu thêm về các phương pháp hay nhất và cân nhắc khi thêm ứng dụng vào dự án Firebase, bao gồm cả cách xử lý nhiều biến thể bản dựng.
Chuyển đến bảng điều khiển Firebase .
Ở giữa trang tổng quan về dự án, 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 một ứ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 iOS .
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 iOS 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 Số nhận dạng gói là ID gói iOS (ví dụ:
com.yourcompany.yourproject
).Xin lưu ý rằng giá trị ID gói có phân biệt chữ hoa chữ thường và không thể thay đổi giá trị này cho ứng dụng Firebase iOS 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 cửa hàng ứng dụng .
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 Liên kết động Firebase sử dụng để chuyển hướng người dùng đến trang Cửa hàng ứng dụng của bạn và 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 cửa hàng ứng dụng, bạn có thể thêm ID sau trong cài đặt Dự án của mình.
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 xuống GoogleService-Info.plist để tải tệp cấu hình Firebase iOS của bạn (
GoogleService-Info.plist
).Tệp cấu hình Firebase chứa các 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 rằng tên tệp cấu hình không được nối với các ký tự bổ sung, chẳng hạn 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 bạn 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
của riêng mình.
Bước 4 : Thêm SDK Firebase vào ứng dụng của bạn
Chúng tôi khuyên bạn nên sử dụng CocoaPods để cài đặt các thư viện Firebase. Tuy nhiên, nếu không muốn sử dụng CocoaPods, bạn có thể tích hợp trực tiếp các khung SDK hoặc sử dụng Trình quản lý gói Swift (beta) .
Bạn có đang sử dụng một trong các mẫu khởi động nhanh không? Dự án Xcode và Podfile (với các nhóm) đã có sẵn, nhưng bạn vẫn cần thêm tệp cấu hình Firebase của mình và cài đặt các nhóm.
Tạo Podfile nếu bạn chưa có:
cd your-project-directory
pod init
Vào Podfile của bạn, 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ỳ sản phẩm Firebase nào được hỗ trợ vào ứng dụng iOS của mình.
Đã bật phân tích
platform :ios, ‘10.0’
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# 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 'Firebase/Auth' pod 'Firebase/Firestore'Phân tích không được bật
platform :ios, ‘10.0’
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'Cài đặt các nhóm, sau đó mở tệp
.xcworkspace
của bạn để xem dự án trong Xcode:pod install
open your-project.xcworkspace
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 khởi động nhanh , điều này đã được thực hiện cho bạn.
- Nhập mô-đun Firebase trong
UIApplicationDelegate
của bạn:Nhanh
import Firebase
Objective-C
@import Firebase;
- Định cấu hình phiên bản được chia sẻ
FirebaseApp
, thường trong ứng dụng của ứng dụng của bạnapplication:didFinishLaunchingWithOptions:
phương thứcapplication:didFinishLaunchingWithOptions:
::Nhanh
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Nếu bạn đã bao gồm Firebase Analytics, bạn có thể chạy ứng dụng của mình để gửi xác minh đến 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ể chuyển sang các bước tiếp theo .
Vỏ có sẵn
Phần này liệt kê các sản phẩm Firebase được hỗ trợ cho iOS và các nhóm của chúng. Tìm hiểu thêm về các thư viện Firebase iOS này:
Firebase iOS SDK GitHub repo
Dịch vụ hoặc Sản phẩm | Vỏ | Thêm phân tích? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
phân tích | pod 'Firebase/Analytics' | |
Phân phối ứng dụng | pod 'Firebase/AppDistribution' | |
Xác thực | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Chức năng đám mây cho SDK ứng dụng khách Firebase | pod 'Firebase/Functions' | |
Nhắn tin qua đám mây | pod 'Firebase/Messaging' | |
Lưu trữ đám mây | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
Liên kết động | pod 'Firebase/DynamicLinks' | |
Nhắn tin trong ứng dụng | pod 'Firebase/InAppMessaging' | (cần thiết) |
API mô hình tùy chỉnh Firebase ML | pod 'Firebase/MLModelDownloader' | |
Giám sát hiệu suất | pod 'Firebase/Performance' | |
Cơ sở dữ liệu thời gian thực | pod 'Firebase/Database' | |
Cấu hình từ xa | pod 'Firebase/RemoteConfig' |
Tích hợp mà không cần CocoaPods
Nếu không muốn sử dụng Cocoapods, bạn vẫn có thể tận dụng các SDK Firebase bằng cách nhập trực tiếp các khung hoặc sử dụng Trình quản lý gói Swift.
Các khuôn khổ
Ngoài việc hỗ trợ nền tảng iOS, tệp zip hiện bao gồm các tệp .xcframework bổ sung hỗ trợ Catalyst dựa trên cộng đồng. Để biết chi tiết, hãy xem SDK Firebase iOS README trên GitHub .
Tải xuống zip SDK khung . Đây là một tệp có dung lượng ~ 200MB và có thể mất một chút thời gian để tải xuống.
Giải nén tệp, sau đó xem lại
README
cho các Khung mà bạn muốn đưa vào ứng dụng của mình.Thêm cờ trình liên kết
ObjC
trongOther Linker Settings
của bạn trong cài đặt xây dựng của mục tiêu.
Trình quản lý gói Swift
Hỗ trợ Trình quản lý gói Swift hiện đang ở giai đoạn thử nghiệm. Làm theo tài liệu trên GitHub và gửi bất kỳ phản hồi nào tới trình theo dõi vấn đề GitHub .
Bước tiếp theo
Tìm hiểu về Firebase:
Truy cập Tìm hiểu 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 cho các dự án.
Khám phá các ứng dụng Firebase mẫu .
Có được trải nghiệm thực tế với Firebase iOS Codelab .
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 thông báo ngân sách cho dự án của bạn trong Google Cloud Console.
- Theo dõi Bảng điều khiển 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 .
Thêm các 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 Xác thực .
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, chẳng hạn như ảnh và video, bằng Bộ nhớ đám mây .
Kích hoạt mã phụ trợ chạy trong môi trường an toàn với Chức năng đám mây .
Gửi thông báo bằng Nhắn tin qua đám mây .
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 .