Thêm Firebase vào dự án C ++ của bạn

Tăng sức mạnh cho các trò chơi C ++ của bạn với SDK Firebase C ++ của chúng tôi. Các SDK này cung cấp giao diện C ++ trên Firebase cho iOS và cho Android.

Truy cập Firebase hoàn toàn từ mã C ++ của bạn mà không cần phải viết bất kỳ mã gốc nền tảng nào. SDK Firebase cũng dịch nhiều thành ngữ dành riêng cho ngôn ngữ được Firebase sử dụng thành một giao diện quen thuộc hơn với các nhà phát triển C ++.

Tìm hiểu thêm thông tin về cách tăng sức mạnh cho trò chơi của bạn với Firebase tại trang trò chơi Firebase của chúng tôi.

Đã thêm Firebase vào dự án C ++ của bạn? Đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của SDK Firebase C ++ .

Điều kiện tiên quyết

Cài đặt sau:
- Xcode 11.7 trở lên
- CocoaPods 1.10.0 trở lên
Đảm bảo rằng dự án của bạn 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.
Bạn có muốn sử dụng Nhắn tin qua đám mây không?
Đố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.

Bước 2 : Tạo dự án Firebase

Trước khi có thể thêm Firebase vào dự án C ++ của mình, bạn cần tạo một dự án Firebase để kết nối với dự án C ++ 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.

Tạo dự án Firebase

Trong bảng điều khiển Firebase , nhấp vào Thêm dự án , sau đó chọn hoặc nhập tên Dự án .
Nếu bạn có dự án Google Cloud hiện tại, bạn có thể chọn dự án từ menu thả xuống để thêm tài nguyên Firebase vào dự án đó.
(Tùy chọn) Nếu bạn đang tạo một dự án mới, bạn có thể chỉnh sửa ID dự án .
Firebase tự động chỉ định một ID duy nhất cho dự án Firebase của bạn. Truy cập Tìm hiểu dự án Firebase để tìm hiểu về cách Firebase sử dụng ID dự án.
Sau khi Firebase cung cấp tài nguyên cho dự án Firebase của bạn, bạn không thể thay đổi ID dự án của mình.
Để sử dụng một số nhận dạng cụ thể, bạn phải chỉnh sửa ID dự án của mình trong bước thiết lập này.
Nhấp vào Tiếp tục .
(Tùy chọn) Thiết lập Google Analytics cho dự án của bạn, cho phép bạn có trải nghiệm tối ưu khi sử dụng bất kỳ sản phẩm Firebase nào sau đây:
Firebase Crashlytics
Dự đoán của Firebase
Nhắn tin qua đám mây Firebase
Nhắn tin trong ứng dụng Firebase
Cấu hình từ xa Firebase
Thử nghiệm Firebase A / B
Khi được nhắc, hãy chọn sử dụng tài khoản Google Analytics hiện có hoặc tạo tài khoản mới.
Nếu bạn chọn tạo tài khoản mới, hãy chọn vị trí báo cáo Analytics , sau đó chấp nhận cài đặt chia sẻ dữ liệu và điều khoản Google Analytics cho dự án của bạn.
Bạn luôn có thể thiết lập Google Analytics sau này trong tab Tích hợp của dự án .
Nhấp vào Tạo dự án (hoặc Thêm Firebase , nếu bạn đang sử dụng một dự án Google Cloud hiện có).

Firebase tự động cung cấp tài nguyên cho dự án Firebase của bạn. Khi quá trình hoàn tất, bạn sẽ được đưa đến trang tổng quan cho dự án Firebase của mình trong bảng điều khiển Firebase.

Bước 3 : Đă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 là gì và bạn tìm thấy nó ở đâu?
- 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.
Đảm bảo nhập ID gói mà ứng dụng của bạn đang thực sự sử dụ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 và ID cửa hàng ứng dụng được sử dụng trong Firebase như thế nào?
- 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à 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 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 4 : 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.
Bạn cần biết gì về tệp cấu hình này?
- 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) .
Mở dự án C ++ của bạn trong một IDE, sau đó kéo tệp cấu hình của bạn vào thư mục gốc của dự án C ++ 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.

Bạn đã hoàn tất việc thiết lập các tác vụ trong bảng điều khiển Firebase. Tiếp tục thêm các SDK Firebase C ++ bên dưới.

Bước 5 : Thêm các SDK Firebase C ++

Các bước trong phần này là ví dụ về cách thêm các sản phẩm Firebase được hỗ trợ vào dự án Firebase C ++ của bạn.

Tải xuống Firebase C ++ SDK , sau đó giải nén SDK ở nơi nào đó thuận tiện.
Firebase C ++ SDK không dành riêng cho nền tảng, nhưng nó chứa các thư viện dành riêng cho nền tảng.

Thêm căn cứ hỏa lực pods từ SDK được giải nén.

Tạo Podfile nếu bạn chưa có:
```
cd your-app-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ật phân tích

# 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 Firebase Realtime Database
pod 'Firebase/Auth'
pod 'Firebase/Database'

Phân tích không được bật

# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'Firebase/Auth'
pod 'Firebase/Database'

Cài đặt các nhóm, sau đó mở tệp .xcworkspace trong Xcode.
```
pod install
```
```
open your-app.xcworkspace
```

Thêm các khung Firebase từ SDK đã giải nén.
Cách dễ nhất để thêm các khung này thường là kéo chúng từ cửa sổ Finder trực tiếp vào ngăn Project Navigator của Xcode (theo mặc định là ngăn ngoài cùng bên trái; hoặc nhấp vào biểu tượng tệp ở trên cùng bên trái của Xcode).
1. Thêm khung Firebase C ++ firebase.framework , được yêu cầu để sử dụng bất kỳ sản phẩm Firebase nào.
2. Thêm khung cho từng sản phẩm Firebase mà bạn muốn sử dụng. Ví dụ: để sử dụng Xác thực Firebase, hãy thêm firebase_auth.framework .
Quan trọng: Đảm bảo rằng bạn thêm các khuôn khổ vào dự án của mình chứ không phải vào dự án Pods !
Quay lại bảng điều khiển Firebase, trong quy trình thiết lập, hãy nhấp vào Tiếp theo .
Nếu bạn đã thêm Analytics, hãy chạy ứng dụng của bạn để gửi xác minh đến Firebase rằng bạn đã tích hợp thành công Firebase. Nếu không, bạn có thể bỏ qua bước xác minh này.
Nhật ký thiết bị của bạn sẽ hiển thị xác minh Firebase rằng quá trình khởi chạy đã hoàn tất. Nếu bạn đã chạy ứng dụng của mình trên trình giả lập có quyền truy cập mạng, bảng điều khiển Firebase sẽ thông báo cho bạn rằng kết nối ứng dụng của bạn đã hoàn tất.

Bạn đã sẵn sàng! Ứng dụng C ++ của bạn đã được đăng ký và định cấu hình để sử dụng các sản phẩm Firebase.

Thư viện có sẵn

Tìm hiểu thêm về các thư viện C ++ Firebase trong tài liệu tham khảo và trong bản phát hành SDK nguồn mở của chúng tôi trên GitHub .

Thư viện có sẵn cho iOS

Lưu ý rằng các thư viện C ++ dành cho Android được liệt kê trên phiên bản Android của trang thiết lập này .

Mỗi sản phẩm Firebase có các phụ thuộc khác nhau. Đảm bảo thêm tất cả các phụ thuộc được liệt kê cho sản phẩm Firebase mong muốn vào dự án Podfile và C ++ của bạn.

Bạn không cần thêm nhóm iOS Firebase/Core nữa. SDK này bao gồm SDK Firebase cho Google Analytics. Bây giờ, để sử dụng Analytics (hoặc bất kỳ sản phẩm Firebase nào yêu cầu hoặc khuyến nghị sử dụng Analytics), bạn cần thêm nhóm Analytics một cách rõ ràng: Firebase/Analytics .

Sản phẩm Firebase	Khung và Nhóm
AdMob	(bắt buộc) `firebase.framework` `firebase_admob.framework` (bắt buộc) `firebase_analytics.framework` `pod 'Firebase/AdMob', '7.5.0'` (bắt buộc) `pod 'Firebase/Analytics', '7.5.0'`
phân tích	(bắt buộc) `firebase.framework` `firebase_analytics.framework` `pod 'Firebase/Analytics', '7.5.0'`
Xác thực	(bắt buộc) `firebase.framework` `firebase_auth.framework` `pod 'Firebase/Auth', '7.5.0'`
Cloud Firestore (beta)	(bắt buộc) `firebase.framework` `firebase_firestore.framework` `firebase_auth.framework` `pod 'Firebase/Firestore', '7.5.0'` `pod 'Firebase/Auth', '7.5.0'`
Chức năng đám mây	(bắt buộc) `firebase.framework` `firebase_functions.framework` `pod 'Firebase/Functions', '7.5.0'`
Nhắn tin qua đám mây	(bắt buộc) `firebase.framework` `firebase_messaging.framework` (được khuyến nghị) `firebase_analytics.framework` `pod 'Firebase/Messaging', '7.5.0'` (được khuyến nghị) `pod 'Firebase/Analytics', '7.5.0'`
Lưu trữ đám mây	(bắt buộc) `firebase.framework` `firebase_storage.framework` `pod 'Firebase/Storage', '7.5.0'`
Liên kết động	(bắt buộc) `firebase.framework` `firebase_dynamic_links.framework` (được khuyến nghị) `firebase_analytics.framework` `pod 'Firebase/DynamicLinks', '7.5.0'` (được khuyến nghị) `pod 'Firebase/Analytics', '7.5.0'`
Cơ sở dữ liệu thời gian thực	(bắt buộc) `firebase.framework` `firebase_database.framework` `pod 'Firebase/Database', '7.5.0'`
Cấu hình từ xa	(bắt buộc) `firebase.framework` `firebase_remote_config.framework` (được khuyến nghị) `firebase_analytics.framework` `pod 'Firebase/RemoteConfig', '7.5.0'` (được khuyến nghị) `pod 'Firebase/Analytics', '7.5.0'`

Thông tin bổ sung để thiết lập điện thoại di động

Phương pháp swizzling

Trên iOS, một số sự kiện ứng dụng (chẳng hạn như mở URL và nhận thông báo) yêu cầu đại biểu ứng dụng của bạn triển khai các phương pháp cụ thể. Ví dụ: nhận được thông báo có thể yêu cầu người được ủy quyền ứng dụng của bạn triển khai application:didReceiveRemoteNotification: . Vì mỗi ứng dụng iOS có đại biểu ứng dụng riêng, nên Firebase sử dụng phương pháp swizzling , cho phép thay thế một phương thức này bằng một phương thức khác, để đính kèm các trình xử lý của chính nó ngoài bất kỳ trình xử lý nào mà bạn có thể đã triển khai.

Thư viện Liên kết động và Nhắn tin qua đám mây cần phải đính kèm trình xử lý với đại biểu ứng dụng bằng cách sử dụng phương pháp swizzling. Nếu bạn đang sử dụng bất kỳ sản phẩm Firebase nào trong số này, tại thời điểm tải, Firebase sẽ xác định lớp AppDelegate của bạn và chuyển các phương thức bắt buộc vào đó, xâu chuỗi một cuộc gọi trở lại triển khai phương thức hiện có của bạn.

Thiết lập quy trình làm việc trên máy tính để bàn ( beta )

Khi bạn đang tạo một trò chơi, việc thử nghiệm trò chơi của bạn trên nền tảng máy tính để bàn trước tiên sẽ dễ dàng hơn nhiều, sau đó triển khai và thử nghiệm trên thiết bị di động trong quá trình phát triển sau này. Để hỗ trợ quy trình làm việc này, chúng tôi cung cấp một tập hợp con của Firebase C ++ SDK có thể chạy trên Windows, macOS, Linux và từ bên trong trình chỉnh sửa C ++.

Đối với quy trình làm việc trên máy tính để bàn, bạn cần hoàn thành những điều sau:
1. Định cấu hình dự án C ++ của bạn cho CMake.
2. Tạo dự án Firebase
3. Đăng ký ứng dụng của bạn (iOS hoặc Android) với Firebase
4. Thêm tệp cấu hình Firebase nền tảng di động
Tạo phiên bản máy tính để bàn của tệp cấu hình Firebase:
- Nếu bạn đã thêm tệp google-services.json Android - Khi bạn chạy ứng dụng của mình, Firebase sẽ định vị tệp di động này, sau đó tự động tạo tệp cấu hình Firebase trên máy tính để bàn ( google-services-desktop.json ).
- Nếu bạn đã thêm tệp GoogleService-Info.plist iOS - Trước khi chạy ứng dụng của mình, bạn cần chuyển đổi tệp di động này thành tệp cấu hình Firebase trên máy tính để bàn . Để chuyển đổi tệp, hãy chạy lệnh sau từ cùng một thư mục với tệp GoogleService-Info.plist của bạn:
```
generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist
```
Tệp cấu hình máy tính để bàn này chứa ID dự án C ++ mà bạn đã nhập vào quy trình thiết lập bảng điều khiển Firebase. Truy cập Tìm hiểu dự án Firebase để tìm hiểu thêm về tệp cấu hình.
Thêm SDK Firebase vào dự án C ++ của bạn.
Các bước dưới đây là ví dụ về cách thêm bất kỳ sản phẩm Firebase nào được hỗ trợ vào dự án C ++ của bạn. Trong ví dụ này, chúng tôi hướng dẫn thêm Xác thực Firebase và Cơ sở dữ liệu thời gian thực của Firebase.
1. Đặt biến môi trường FIREBASE_CPP_SDK_DIR của bạn thành vị trí của SDK Firebase C ++ đã giải nén.
2. CMakeLists.txt tệp CMakeLists.txt của dự án, hãy thêm nội dung sau, bao gồm các thư viện cho các sản phẩm Firebase mà bạn muốn sử dụng. Ví dụ: để sử dụng Xác thực Firebase và Cơ sở dữ liệu thời gian thực của Firebase:
```
# Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

# Add the Firebase SDKs for the products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
set(firebase_libs firebase_auth firebase_database firebase_app)
target_link_libraries(${target_name} "${firebase_libs}")
```
Chạy ứng dụng C ++ của bạn.

Thư viện có sẵn (máy tính để bàn)

Firebase C ++ SDK bao gồm hỗ trợ quy trình làm việc trên máy tính để bàn cho một tập hợp con các tính năng, cho phép sử dụng một số phần nhất định của Firebase trong các bản dựng máy tính để bàn độc lập trên Windows, macOS và Linux.

Sản phẩm Firebase	Thư viện tài liệu tham khảo (sử dụng CMake)
Xác thực	`firebase_auth` (bắt buộc) `firebase_app`
Cloud Firestore (beta)	`firebase_firestore` `firebase_auth` `firebase_app`
Chức năng đám mây	`firebase_functions` (bắt buộc) `firebase_app`
Lưu trữ đám mây	`firebase_storage` (bắt buộc) `firebase_app`
Cơ sở dữ liệu thời gian thực	`firebase_database` (bắt buộc) `firebase_app`
Cấu hình từ xa	`firebase_remote_config` (bắt buộc) `firebase_app`

Firebase cung cấp các thư viện máy tính để bàn còn lại dưới dạng triển khai sơ khai (không có chức năng) để thuận tiện khi xây dựng cho Windows, macOS và Linux. Do đó, bạn không cần phải biên dịch mã có điều kiện để nhắm mục tiêu đến máy tính để bàn.

Máy tính để bàn Cơ sở dữ liệu thời gian thực

SDK cơ sở dữ liệu thời gian thực cho máy tính để bàn sử dụng REST để truy cập cơ sở dữ liệu của bạn, vì vậy bạn phải khai báo các chỉ mục mà bạn sử dụng với Query::OrderByChild() trên máy tính để bàn nếu không bộ nghe của bạn sẽ không thành công.

Thông tin bổ sung để thiết lập máy tính để bàn

Thư viện Windows

Đối với Windows, các phiên bản thư viện được cung cấp dựa trên những điều sau:

Xây dựng nền tảng: chế độ 32-bit (x86) so với chế độ 64-bit (x64)
Môi trường thời gian chạy Windows: Đa luồng / MT so với DLL / MD đa luồng
Mục tiêu: Phát hành so với Gỡ lỗi

Lưu ý rằng các thư viện sau đã được thử nghiệm bằng Visual Studio 2015 và 2017.

Khi xây dựng ứng dụng C ++ dành cho máy tính để bàn trên Windows, hãy liên kết các thư viện SDK Windows sau với dự án của bạn. Tham khảo tài liệu trình biên dịch của bạn để biết thêm thông tin.

Thư viện Firebase C ++	Các phụ thuộc thư viện SDK Windows
Xác thực	`advapi32, ws2_32, crypt32`
Cloud Firestore	`advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32`
Chức năng đám mây	`advapi32, ws2_32, crypt32, rpcrt4, ole32`
Lưu trữ đám mây	`advapi32, ws2_32, crypt32`
Cơ sở dữ liệu thời gian thực	`advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv`
Cấu hình từ xa	`advapi32, ws2_32, crypt32, rpcrt4, ole32`

thư viện macOS

Đối với macOS (Darwin), các phiên bản thư viện được cung cấp cho nền tảng 64-bit (x86_64). Các khuôn khổ cũng được cung cấp để thuận tiện cho bạn.

Lưu ý rằng các thư viện macOS đã được kiểm tra bằng Xcode 11.7.

Khi xây dựng ứng dụng C ++ dành cho máy tính để bàn trên macOS, hãy liên kết phần sau với dự án của bạn:

thư viện hệ thống pthread
Khung hệ thống CoreFoundation macOS
Khuôn khổ hệ thống macOS Foundation
Khung hệ thống macOS Security
Khung hệ thống GSS macOS
Khung hệ thống macOS Kerberos
Khung hệ thống MacOS SystemConfiguration

Tham khảo tài liệu trình biên dịch của bạn để biết thêm thông tin.

Thư viện Linux

Đối với Linux, các phiên bản thư viện được cung cấp cho các nền tảng 32-bit (i386) và 64-bit (x86_64).

Lưu ý rằng các thư viện Linux đã được kiểm tra bằng GCC 4.8.0, GCC 7.2.0 và Clang 5.0 trên Ubuntu.

Khi xây dựng ứng dụng C ++ trên máy tính để bàn trên Linux, hãy liên kết thư viện hệ thống pthread với dự án của bạn. Tham khảo tài liệu trình biên dịch của bạn để biết thêm thông tin. Nếu bạn đang xây dựng với GCC 5 trở lên, hãy xác định -D_GLIBCXX_USE_CXX11_ABI=0 .

Bước tiếp theo

Khám phá các ứng dụng Firebase mẫu .
Khám phá SDK 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 .