เพิ่ม Firebase ในโปรเจ็กต์ C ++ ของคุณ

เพิ่มพลังให้เกม C ++ ของคุณด้วย Firebase C ++ SDK ซึ่งมีอินเทอร์เฟซ C ++ ที่ด้านบนของ Firebase สำหรับ iOS และสำหรับ Android

เข้าถึง Firebase ทั้งหมดจากโค้ด C ++ ของคุณโดยไม่ต้องเขียนโค้ดเนทีฟของแพลตฟอร์ม Firebase SDK ยังแปลสำนวนเฉพาะภาษาจำนวนมากที่ Firebase ใช้เป็นอินเทอร์เฟซที่นักพัฒนา C ++ คุ้นเคยมากขึ้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มพลังให้เกมของคุณด้วย Firebase ได้ที่ หน้าเกม Firebase ของเรา

เพิ่ม Firebase ในโครงการ C ++ ของคุณแล้วหรือยัง ตรวจสอบว่าคุณกำลังใช้ Firebase C ++ SDK เวอร์ชัน ล่าสุด

ข้อกำหนดเบื้องต้น

ติดตั้งโปรแกรมแก้ไขหรือ IDE ที่คุณต้องการเช่น Android Studio, IntelliJ หรือ VS Code
รับ Android SDK
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- กำหนดเป้าหมาย API ระดับ 16 (Jelly Bean) หรือใหม่กว่า
- ใช้ Gradle และ กำหนดค่าด้วย CMake
ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ
- ผู้เลียนแบบ ต้องใช้ภาพจำลองกับ Google Play
- สำหรับไลบรารี C ++ บางรายการจำเป็นต้องใช้บริการ Google Play บนอุปกรณ์ไคลเอนต์ ตรวจสอบ รายการ ในหน้านี้
ลงชื่อเข้า ใช้ Firebase โดยใช้บัญชี Google ของคุณ

ขั้นตอนที่ 2 : สร้างโครงการ Firebase

ก่อนจะเพิ่ม Firebase ในโปรเจ็กต์ C ++ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับโปรเจ็กต์ C ++ ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase

สร้างโครงการ Firebase

ใน คอนโซล Firebase ให้คลิก เพิ่มโครงการ จากนั้นเลือกหรือป้อน ชื่อโครงการ
หากคุณมีโครงการ Google Cloud Platform (GCP) อยู่แล้วคุณสามารถเลือกโปรเจ็กต์จากเมนูแบบเลื่อนลงเพื่อเพิ่มทรัพยากร Firebase ให้กับโปรเจ็กต์นั้น
(ไม่บังคับ) หากคุณกำลังสร้างโครงการใหม่คุณสามารถแก้ไข รหัสโครงการ ได้
Firebase จะกำหนดรหัสเฉพาะให้กับโครงการ Firebase ของคุณโดยอัตโนมัติ ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้ว่า Firebase ใช้รหัสโครงการอย่างไร
หลังจาก Firebase จัดเตรียมทรัพยากรสำหรับโครงการ Firebase ของคุณคุณจะไม่สามารถเปลี่ยนรหัสโครงการของคุณได้
ในการใช้ตัวระบุเฉพาะคุณต้องแก้ไขรหัสโครงการของคุณในระหว่างขั้นตอนการตั้งค่านี้
คลิก ดำเนินการต่อ

(ไม่บังคับ) ตั้งค่า Google Analytics สำหรับโครงการของคุณซึ่งจะช่วยให้คุณได้รับประสบการณ์ที่ดีที่สุดโดยใช้ผลิตภัณฑ์ Firebase ต่อไปนี้

เมื่อได้รับแจ้งให้เลือกใช้ บัญชี Google Analytics ที่มีอยู่หรือสร้างบัญชีใหม่
หากคุณเลือกที่จะสร้างบัญชีใหม่เลือก ตำแหน่งการรายงาน Analytics ของคุณจากนั้นยอมรับการตั้งค่าการแบ่งปันข้อมูลและข้อกำหนดของ Google Analytics สำหรับโครงการของคุณ

คลิก สร้างโครงการ (หรือ เพิ่ม Firebase หากคุณใช้โครงการ GCP ที่มีอยู่)

Firebase จัดเตรียมทรัพยากรสำหรับโครงการ Firebase ของคุณโดยอัตโนมัติ เมื่อกระบวนการเสร็จสิ้นคุณจะเข้าสู่หน้าภาพรวมของโครงการ Firebase ในคอนโซล Firebase

ขั้นตอนที่ 3 : ลงทะเบียนแอปของคุณกับ Firebase

หากต้องการใช้ Firebase ในแอป Android คุณต้องลงทะเบียนแอปกับโครงการ Firebase การลงทะเบียนแอปของคุณมักเรียกว่า "การเพิ่ม" แอปของคุณในโครงการ

ไปที่ คอนโซล Firebase
ตรงกลางหน้าภาพรวมโครงการให้คลิกไอคอน Android ( ) หรือ เพิ่มแอป เพื่อเปิดขั้นตอนการตั้งค่า
ป้อนชื่อแพ็กเกจของแอปในช่อง ชื่อแพ็กเกจ Android
ชื่อแพ็กเกจคืออะไรและคุณจะพบได้ที่ไหน
- ชื่อแพ็กเกจ ระบุแอปของคุณโดยไม่ซ้ำกันบนอุปกรณ์และใน Google Play Store
- ชื่อแพ็กเกจ มักเรียกว่า ID แอปพลิเคชัน
- ค้นหาชื่อแพ็กเกจของแอปของคุณในไฟล์ Gradle ของโมดูล (ระดับแอป) โดยปกติจะเป็น app/build.gradle (ชื่อแพ็กเกจตัวอย่าง: com.yourcompany.yourproject )
- โปรดทราบว่าค่าชื่อแพ็กเกจเป็นแบบตรงตามตัวพิมพ์เล็กและตัวพิมพ์ใหญ่และไม่สามารถเปลี่ยนแปลงสำหรับแอป Firebase สำหรับ Android นี้หลังจากที่ลงทะเบียนกับโครงการ Firebase ของคุณแล้ว
อย่าลืมป้อนชื่อแพ็กเกจที่แอปของคุณใช้งานอยู่จริง ค่าชื่อแพ็กเกจเป็นแบบตรงตามตัวพิมพ์เล็กและใหญ่และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase สำหรับ Android นี้หลังจากที่ลงทะเบียนกับโครงการ Firebase ของคุณแล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่น ๆ : ชื่อเล่นแอป และ ใบรับรองการลงนามการแก้ไขข้อบกพร่อง SHA-1
ชื่อเล่นแอป และ ใบรับรองการลงนามการแก้ไขข้อบกพร่อง SHA-1 ใช้ภายใน Firebase อย่างไร
- ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase
- แก้ไขข้อบกพร่องใบรับรองการลงนาม SHA-1 : การตรวจสอบสิทธิ์ของ Firebase จำเป็นต้องมี แฮช SHA-1 (เมื่อใช้การ ลงชื่อเข้า ใช้ Google หรือการ ลงชื่อเข้าใช้หมายเลขโทรศัพท์ ) และ ลิงก์แบบไดนามิกของ Firebase
คลิก ลงทะเบียนแอป

ขั้นตอนที่ 4 : เพิ่มไฟล์การกำหนดค่า Firebase

คลิก ดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android ของคุณ
คุณต้องรู้อะไรบ้างเกี่ยวกับไฟล์กำหนดค่านี้
- ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำกัน แต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่านี้โปรดไปที่ ทำความเข้าใจกับโครงการ Firebase
- คุณสามารถดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
- ตรวจสอบว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติมเช่น (2)
เปิดโปรเจ็กต์ C ++ ของคุณใน IDE จากนั้นเพิ่มไฟล์กำหนดค่าในโปรเจ็กต์ของคุณ:
- Gradle builds - เพิ่มไฟล์ config ของคุณไปยังไดเร็กทอรีเดียวกับไฟล์ build.gradle ระดับบนสุดของคุณ
- ระบบการสร้างอื่น ๆ - ดู ระบบการสร้างแบบกำหนดเอง ด้านล่างเพื่อสร้าง ทรัพยากรสตริงของ Android

(Gradle builds เท่านั้น) หากต้องการเปิดใช้งานบริการ Firebase ในโปรเจ็กต์ C ++ ให้เพิ่ม ปลั๊กอิน google-services ในไฟล์ build.gradle ระดับบนสุด

เพิ่มกฎเพื่อรวมปลั๊กอิน Google Services Gradle ตรวจสอบว่าคุณมีที่เก็บ Maven ของ Google ด้วย

  buildscript {

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
    }

    dependencies {
      // ...

      // Add the following lines:
      classpath 'com.google.gms:google-services:4.3.4'  // Google Services plugin
      implementation 'com.google.android.gms:17.5.0'
    }
  }

  allprojects {
    // ...

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
      // ...
    }
  }

ใช้ปลั๊กอิน Google Services Gradle:

  apply plugin: 'com.android.application'
  // Add the following line:
  apply plugin: 'com.google.gms.google-services'  // Google Services plugin

  android {
    // ...
  }

คุณตั้งค่างานในคอนโซล Firebase เสร็จแล้ว ดำเนินการต่อเพื่อ เพิ่ม Firebase C ++ SDK ด้านล่าง

ขั้นตอนที่ 5 : เพิ่ม Firebase C ++ SDK

ขั้นตอนในส่วนนี้เป็นตัวอย่างวิธีเพิ่ม ผลิตภัณฑ์ Firebase ที่รองรับใน โครงการ Firebase C ++

ดาวน์โหลด Firebase C ++ SDK จากนั้นเปิดเครื่องรูด SDK ที่ใดก็ได้ที่สะดวก
Firebase C ++ SDK ไม่ใช่เฉพาะแพลตฟอร์ม แต่มีไลบรารีเฉพาะแพลตฟอร์ม
ระบุตำแหน่งของ SDK ที่คลายซิปในไฟล์ gradle.properties ของโปรเจ็กต์ของคุณ:
```
systemProp.firebase_cpp_sdk.dir=full-path-to-SDK
```

เพิ่มสิ่งต่อไปนี้ในไฟล์ settings.gradle ของโปรเจ็กต์ของคุณ:

def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')

gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
includeBuild "$firebase_cpp_sdk_dir"

เพิ่มสิ่งต่อไปนี้ลงในไฟล์ Gradle ของโมดูลของคุณ (ระดับแอป) (โดยทั่วไปคือ app/build.gradle ):

android.defaultConfig.externalNativeBuild.cmake {
  arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  analytics
}

ในไฟล์ CMakeLists.txt ของโปรเจ็กต์ให้เพิ่มเนื้อหาต่อไปนี้รวมถึง ไลบรารี สำหรับผลิตภัณฑ์ 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 Analytics, Firebase Authentication, and Firebase Realtime Database
set(firebase_libs firebase_analytics firebase_auth firebase_database firebase_app)
target_link_libraries(${target_name} "${firebase_libs}")

ไม่ได้เปิดใช้งานการวิเคราะห์

# 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}")

ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการอ้างอิงทั้งหมดมีเวอร์ชันที่จำเป็น
หากคุณเพิ่ม Analytics ให้เรียกใช้แอปของคุณเพื่อส่งการยืนยันไปยัง Firebase ว่าคุณได้รวม Firebase เรียบร้อยแล้ว มิฉะนั้นคุณสามารถข้ามขั้นตอนการยืนยันได้
บันทึกอุปกรณ์ของคุณจะแสดงการยืนยัน Firebase ว่าการเริ่มต้นเสร็จสมบูรณ์ หากคุณเรียกใช้แอปบนโปรแกรมจำลองที่มีการเข้าถึงเครือข่าย คอนโซล Firebase จะแจ้งให้คุณทราบว่าการเชื่อมต่อแอปของคุณเสร็จสมบูรณ์

คุณทุกชุด! แอป C ++ ของคุณได้รับการลงทะเบียนและกำหนดค่าให้ใช้บริการ Firebase

(ทางเลือกเสริม) ใช้ ndk-build เพื่อเพิ่ม SDK

ตรวจสอบให้แน่ใจว่าคุณมี Android NDK v10d หรือใหม่กว่า
ดาวน์โหลด Firebase C ++ SDK จากนั้นเปิดเครื่องรูด SDK ที่ใดก็ได้ที่สะดวก
Firebase C ++ SDK ไม่ใช่เฉพาะแพลตฟอร์ม แต่มีไลบรารีเฉพาะแพลตฟอร์ม
เปิดไฟล์ local.properties ของคุณจากนั้น:
- ตั้งค่าตัวแปร firebase_cpp_sdk.dir เป็นตำแหน่งของ Firebase C ++ SDK ที่คลายซิป
- ตั้งค่าตัวแปร ndk.dir เป็นตำแหน่งของ Android NDK

หากต้องการใช้ Gradle ตัวในการสนับสนุน ndkBuild สร้าง jni ไดเรกทอรีภายในไดเรกทอรีระดับบนสุดของคุณแล้วสร้างต่อไปนี้ make ไฟล์

สร้างไฟล์ jni/Application.mk ดังต่อไปนี้:

APP_PLATFORM:=android-14
NDK_TOOLCHAIN_VERSION=clang
APP_ABI:=armeabi-v7a arm64-v8a x86 x86_64
APP_STL:=c++_static
APP_MODULES:=android_main
APP_CPPFLAGS+=-std=c++11

สร้างไฟล์ jni/Android.mk โดยมีเนื้อหาดังต่อไปนี้

รวม ไลบรารี ของผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ ตัวอย่างเช่นในการใช้ Analytics:

LOCAL_PATH:=$(call my-dir)/..

ifeq ($(FIREBASE_CPP_SDK_DIR),)
$(error FIREBASE_CPP_SDK_DIR must specify the Firebase package location.)
endif

# With Firebase libraries for the selected build configuration (ABI + STL)
STL:=$(firstword $(subst _, ,$(APP_STL)))
FIREBASE_LIBRARY_PATH:=\
$(FIREBASE_CPP_SDK_DIR)/libs/android/$(TARGET_ARCH_ABI)/$(STL)

# The Firebase C++ library `libfirebase_app.a` is required for all Firebase products.
include $(CLEAR_VARS)
LOCAL_MODULE:=firebase_app
LOCAL_SRC_FILES:=$(FIREBASE_LIBRARY_PATH)/libfirebase_app.a
LOCAL_EXPORT_C_INCLUDES:=$(FIREBASE_CPP_SDK_DIR)/include
include $(PREBUILT_STATIC_LIBRARY)

# Include the Firebase library for Google Analytics.
# Note: Duplicate this block for each Firebase product that you want
# to use in your app, and replace variable values as appropriate.
include $(CLEAR_VARS)
LOCAL_MODULE:=firebase_analytics
LOCAL_SRC_FILES:=$(FIREBASE_LIBRARY_PATH)/libfirebase_analytics.a
LOCAL_EXPORT_C_INCLUDES:=$(FIREBASE_CPP_SDK_DIR)/include
include $(PREBUILT_STATIC_LIBRARY)

include $(CLEAR_VARS)
LOCAL_MODULE:=android_main
# Reference your project's C++ source files
LOCAL_SRC_FILES:=\
  $(LOCAL_PATH)/src/common_main.cc \
  $(LOCAL_PATH)/src/android/android_main.cc
LOCAL_STATIC_LIBRARIES:=\
  firebase_analytics \
  firebase_app  # this library reference must always be listed last
LOCAL_WHOLE_STATIC_LIBRARIES:=\
  android_native_app_glue
LOCAL_C_INCLUDES:=\
  $(NDK_ROOT)/sources/android/native_app_glue \
  $(LOCAL_PATH)/src
LOCAL_LDLIBS:=-llog -landroid -latomic
LOCAL_ARM_MODE:=arm
LOCAL_LDFLAGS:=-Wl,-z,defs -Wl,--no-undefined
include $(BUILD_SHARED_LIBRARY)

$(call import-add-path,$(NDK_ROOT)/sources/android)
$(call import-module,android/native_app_glue)

เปิดไฟล์ build.gradle ระดับบนสุดของคุณจากนั้นทำตามขั้นตอนต่อไปนี้:
1. เพิ่มการ อ้างอิง สำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ ตัวอย่างเช่นในการใช้ Analytics:
```
dependencies {
  implementation 'com.google.firebase:firebase-analytics:17.5.0'
}
```
2. เพิ่มบรรทัดต่อไปนี้เพื่อให้โครงการของคุณใช้การสนับสนุน ndk-build ในตัวของ Gradle เพื่อรวมไลบรารี Firebase ที่ระบุในไฟล์ jni/Android.mk คุณ
```
android {
// ...
    defaultConfig {
        // ...
        externalNativeBuild.ndkBuild {
            arguments "FIREBASE_CPP_SDK_DIR=${project.ext.firebase_cpp_sdk_dir}",
                      "NDK_APPLICTION_MK=jni/Application.mk",
                      sprintf("APP_PLATFORM=android-%d",
                      android.defaultConfig.minSdkVersion.mApiLevel)
        }
    }
}
```

ไลบรารีที่พร้อมใช้งานสำหรับ Android (โดยใช้ ndk-build)

ผลิตภัณฑ์ Firebase แต่ละรายการมีการอ้างอิงที่แตกต่างกัน อย่าลืมเพิ่มการอ้างอิงที่ระบุไว้ทั้งหมดสำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้

เพิ่มไลบรารี Firebase C ++ (เช่น libfirebase_app.a ) โดยรวมไว้ในไฟล์ jni/Android.mk ระดับบนสุด สำหรับการอ้างอิงอื่น ๆ (เช่น com.google.firebase:firebase-auth ) ให้เพิ่มลงในไฟล์ build.gradle ระดับบนสุด

สำคัญ: Firebase C ++ SDK แต่ละรุ่นจะตรึงไว้กับ Firebase Android SDK เวอร์ชันเฉพาะสำหรับแต่ละโมดูล หากคุณอัปเดต Firebase C ++ SDK เวอร์ชันของคุณโปรดอย่าลืมอัปเดตเวอร์ชัน Firebase Android SDK ที่อ้างอิงในไฟล์ build.gradle ของคุณให้ตรงกับหมายเลขเวอร์ชันด้านล่าง

คุณไม่จำเป็นต้องเพิ่มไลบรารี Android com.google.firebase:firebase-core อีกต่อไป SDK นี้รวม Firebase SDK สำหรับ Google Analytics ตอนนี้หากต้องการใช้ Analytics (หรือผลิตภัณฑ์ Firebase ใด ๆ ที่ต้องการหรือแนะนำให้ใช้ Analytics) คุณต้องเพิ่มการพึ่งพา Analytics อย่างชัดเจน: com.google.firebase:firebase-analytics:17.5.0

ผลิตภัณฑ์ Firebase	ไลบรารีและการพึ่งพา
AdMob	`libfirebase_admob.a` (จำเป็น) `libfirebase_analytics.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-ads:19.3.0'` (จำเป็น) `implementation 'com.google.firebase:firebase-analytics:17.5.0'`
การวิเคราะห์	`libfirebase_analytics.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-analytics:17.5.0'`
การรับรองความถูกต้อง	`libfirebase_auth.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-auth:19.3.2'`
Cloud Firestore (อัลฟา)	`libfirebase_firestore.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-firestore:21.6.0'`
ฟังก์ชันคลาวด์	`libfirebase_functions.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-functions:19.1.0'`
การส่งข้อความบนคลาวด์	`libfirebase_messaging.a` (แนะนำ) `libfirebase_analytics.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-messaging:20.2.4'` (แนะนำ) `implementation 'com.google.firebase:firebase-analytics:17.5.0'`
การจัดเก็บเมฆ	`libfirebase_storage.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-storage:19.2.0'`
ลิงก์แบบไดนามิก	`ibfirebase_dynamic_links.a` (แนะนำ) `libfirebase_analytics.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-dynamic-links:19.1.0'` (แนะนำ) `implementation 'com.google.firebase:firebase-analytics:17.5.0'`
ฐานข้อมูลเรียลไทม์	`libfirebase_database.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-database:19.4.0'`
การกำหนดค่าระยะไกล	`libfirebase_remote_config.a` (แนะนำ) `libfirebase_analytics.a` (จำเป็น) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-config:19.2.0'` (แนะนำ) `implementation 'com.google.firebase:firebase-analytics:17.5.0'`

ห้องสมุดที่มีอยู่

เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี C ++ Firebase ใน เอกสารอ้างอิง และใน SDK โอเพนซอร์สของเราบน GitHub

ไลบรารีที่พร้อมใช้งานสำหรับ Android (โดยใช้ CMake)

โปรดทราบว่าไลบรารี C ++ สำหรับ iOS แสดงอยู่ใน เวอร์ชัน iOS ของหน้าการตั้งค่านี้

ผลิตภัณฑ์ Firebase	การอ้างอิงห้องสมุด (โดยใช้ CMake)
AdMob	`firebase_admob` (จำเป็น) `firebase_analytics` (จำเป็น) `firebase_app`
การวิเคราะห์	`firebase_analytics` (จำเป็น) `firebase_app`
การรับรองความถูกต้อง	`firebase_auth` (จำเป็น) `firebase_app`
Cloud Firestore (อัลฟา)	`firebase_firestore` (จำเป็น) `firebase_app` (จำเป็น) `firebase_auth`
ฟังก์ชันคลาวด์	`firebase_functions` (จำเป็น) `firebase_app`
การส่งข้อความบนคลาวด์	`firebase_messaging` (แนะนำ) `firebase_analytics` (จำเป็น) `firebase_app`
การจัดเก็บเมฆ	`firebase_storage` (จำเป็น) `firebase_app`
ลิงก์แบบไดนามิก	`firebase_dynamic_links` (แนะนำ) `firebase_analytics` (จำเป็น) `firebase_app`
ฐานข้อมูลเรียลไทม์	`firebase_database` (จำเป็น) `firebase_app`
การกำหนดค่าระยะไกล	`firebase_remote_config` (แนะนำ) `firebase_analytics` (จำเป็น) `firebase_app`

ข้อมูลเพิ่มเติมสำหรับการตั้งค่ามือถือ

รับรายงานข้อขัดข้อง NDK

Firebase Crashlytics รองรับการรายงานข้อขัดข้องสำหรับแอปที่ใช้ไลบรารีเนทีฟของ Android หากต้องการเรียนรู้เพิ่มเติมโปรดดูรับ รายงานข้อขัดข้องของ Android NDK

ระบบสร้างแบบกำหนดเอง

Firebase ให้สคริปต์ generate_xml_from_google_services_json.py การแปลง google-services.json เพื่อ .xml ทรัพยากรที่คุณสามารถรวมอยู่ในโครงการของคุณ สคริปต์นี้ใช้การเปลี่ยนแปลงแบบเดียวกับที่ปลั๊กอิน Gradle ของบริการ Google Play ดำเนินการเมื่อสร้างแอปพลิเคชัน Android

หากคุณไม่ได้สร้างโดยใช้ Gradle (เช่นคุณใช้ ndk-build, makefiles, Visual Studio เป็นต้น) คุณสามารถใช้สคริปต์นี้เพื่อสร้าง ทรัพยากรสตริง Android โดยอัตโนมัติ

ProGuard

ระบบ บิว ด์ Android จำนวนมากใช้ ProGuard สำหรับ บิวด์ ในโหมดรีลีสเพื่อย่อขนาดแอพพลิเคชั่นและป้องกันซอร์สโค้ด Java

หากคุณใช้ ProGuard คุณจะต้องเพิ่มไฟล์ใน libs/android/*.pro สอดคล้องกับไลบรารี Firebase C ++ ที่คุณใช้ในการกำหนดค่า ProGuard

ตัวอย่างเช่นด้วย Gradle หากคุณใช้ Google Analytics ไฟล์ build.gradle ของคุณจะมีลักษณะดังนี้:

android {
  // ...
  buildTypes {
    release {
      minifyEnabled true
      proguardFile getDefaultProguardFile('your-project-proguard-config.txt')
      proguardFile file(project.ext.your_local_firebase_sdk_dir + "/libs/android/app.pro")
      proguardFile file(project.ext.your_local_firebase_sdk_dir + "/libs/android/analytics.pro")
      // ...  and so on, for each Firebase C++ library that you're using
    }
  }
}

ข้อกำหนดบริการ Google Play

ไลบรารี Firebase C ++ ส่วนใหญ่ต้องการ บริการ Google Play บนอุปกรณ์ Android ของไคลเอ็นต์ หากไลบรารี Firebase C ++ ส่งคืน kInitResultFailedMissingDependency ในการเริ่มต้นหมายความว่าบริการ Google Play ไม่พร้อมใช้งานบนอุปกรณ์ไคลเอนต์ (หมายความว่าต้องอัปเดตเปิดใช้งานอีกครั้งสิทธิ์คงที่ ฯลฯ ) ไม่สามารถใช้ไลบรารี Firebase ได้จนกว่าสถานการณ์บนอุปกรณ์ไคลเอ็นต์จะได้รับการแก้ไข

คุณสามารถค้นหาสาเหตุที่บริการ Google Play ไม่พร้อมใช้งานบนอุปกรณ์ไคลเอนต์ (และพยายามแก้ไข) โดยใช้ฟังก์ชันใน google_play_services/availability.h

ตารางต่อไปนี้แสดงรายการว่าต้องใช้บริการ Google Play บนอุปกรณ์ไคลเอนต์สำหรับผลิตภัณฑ์ Firebase ที่รองรับแต่ละผลิตภัณฑ์หรือไม่

ไลบรารี Firebase C ++	จำเป็นต้องใช้บริการ Google Play บนอุปกรณ์ไคลเอนต์?
AdMob	ไม่จำเป็น (โดยปกติ)
การวิเคราะห์	ไม่ต้องการ
การรับรองความถูกต้อง	จำเป็น
Cloud Firestore	จำเป็น
ฟังก์ชันคลาวด์	จำเป็น
การส่งข้อความบนคลาวด์	จำเป็น
การจัดเก็บเมฆ	จำเป็น
ลิงก์แบบไดนามิก	จำเป็น
ฐานข้อมูลเรียลไทม์	จำเป็น
การกำหนดค่าระยะไกล	จำเป็น

บริการ AdMob และ Google Play

SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google สำหรับ Android เวอร์ชันส่วนใหญ่สามารถทำงานได้อย่างถูกต้องหากไม่มีบริการ Google Play บนอุปกรณ์ไคลเอ็นต์ อย่างไรก็ตามหากคุณใช้ com.google.android.gms:play-services-ads-lite dependency แทนที่จะใช้ com.google.firebase:firebase-ads dependency ที่ระบุไว้ข้างต้น จำเป็นต้องใช้บริการ Google Play

การเริ่มต้น AdMob จะส่งคืน kInitResultFailedMissingDependency เมื่อทั้งสองอย่างต่อไปนี้เป็นจริง:

บริการ Google Play ไม่พร้อมใช้งานบนอุปกรณ์ไคลเอนต์
คุณกำลังใช้ com.google.android.gms:play-services-ads-lite

ตั้งค่าเวิร์กโฟลว์เดสก์ท็อป ( เบต้า )

เมื่อคุณสร้างเกมมักจะง่ายกว่ามากในการทดสอบเกมของคุณบนแพลตฟอร์มเดสก์ท็อปก่อนจากนั้นจึงปรับใช้และทดสอบบนอุปกรณ์เคลื่อนที่ในการพัฒนาในภายหลัง เพื่อสนับสนุนเวิร์กโฟลว์นี้เรามี ชุดย่อยของ Firebase C ++ SDK ซึ่งสามารถทำงานบน Windows, macOS, Linux และจากภายในตัวแก้ไข C ++

สำหรับเวิร์กโฟลว์บนเดสก์ท็อปคุณต้องดำเนินการดังต่อไปนี้:
1. กำหนดค่าโครงการ C ++ ของคุณสำหรับ CMake
2. สร้างโครงการ Firebase
3. ลงทะเบียนแอปของคุณ (iOS หรือ Android) กับ Firebase
4. เพิ่มไฟล์การกำหนดค่า Firebase แพลตฟอร์มมือถือ
สร้างไฟล์การกำหนดค่า Firebase เวอร์ชัน เดสก์ท็อป :
- หากคุณเพิ่มไฟล์ google-services.json Android - เมื่อคุณเรียกใช้แอป Firebase จะค้นหาไฟล์ มือถือ นี้จากนั้นจะสร้างไฟล์กำหนดค่า Firebase สำหรับ เดสก์ท็อป ( google-services-desktop.json ) โดยอัตโนมัติ
- หากคุณเพิ่มไฟล์ iOS GoogleService-Info.plist - ก่อนที่คุณจะเรียกใช้แอปคุณต้องแปลงไฟล์ มือถือ นี้เป็นไฟล์กำหนดค่า Firebase บนเดสก์ท็อป ในการแปลงไฟล์ให้เรียกใช้คำสั่งต่อไปนี้จากไดเร็กทอรีเดียวกับไฟล์ GoogleService-Info.plist ของคุณ:
```
generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist
```
ไฟล์กำหนดค่าเดสก์ท็อปนี้มีรหัสโครงการ C ++ ที่คุณป้อนในเวิร์กโฟลว์การตั้งค่าคอนโซล Firebase ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่า
เพิ่ม Firebase SDK ในโปรเจ็กต์ C ++
ขั้นตอนด้านล่างนี้เป็นตัวอย่างวิธีเพิ่ม ผลิตภัณฑ์ Firebase ที่รองรับ ในโปรเจ็กต์ C ++ ของคุณ ในตัวอย่างนี้เราดำเนินการเพิ่มการตรวจสอบสิทธิ์ Firebase และฐานข้อมูลเรียลไทม์ของ Firebase
1. ตั้งค่าตัวแปรสภาพแวดล้อม FIREBASE_CPP_SDK_DIR ของคุณไปยังตำแหน่งของ Firebase C ++ SDK ที่คลายซิป
2. ในไฟล์ CMakeLists.txt ของโปรเจ็กต์ของคุณให้เพิ่มเนื้อหาต่อไปนี้รวมถึง ไลบรารี สำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ ตัวอย่างเช่นในการใช้ Firebase Authentication และ Firebase Realtime Database:
```
# 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}")
```
เรียกใช้แอป C ++ ของคุณ

ไลบรารีที่พร้อมใช้งาน (เดสก์ท็อป)

Firebase C ++ SDK มี การสนับสนุนเวิร์กโฟลว์เดสก์ท็อป สำหรับคุณลักษณะย่อยบางส่วนทำให้สามารถใช้ Firebase บางส่วนในเดสก์ท็อปแบบสแตนด์อโลนที่สร้างบน Windows, macOS และ Linux

ผลิตภัณฑ์ Firebase	การอ้างอิงห้องสมุด (โดยใช้ CMake)
การรับรองความถูกต้อง	`firebase_auth` (จำเป็น) `firebase_app`
Cloud Firestore (อัลฟา)	`firebase_firestore` `firebase_auth` `firebase_app`
ฟังก์ชันคลาวด์	`firebase_functions` (จำเป็น) `firebase_app`
การจัดเก็บเมฆ	`firebase_storage` (จำเป็น) `firebase_app`
ฐานข้อมูลเรียลไทม์	`firebase_database` (จำเป็น) `firebase_app`
การกำหนดค่าระยะไกล	`firebase_remote_config` (จำเป็น) `firebase_app`

Firebase จัดเตรียมไลบรารีเดสก์ท็อปที่เหลือเป็นการใช้งานที่สมบูรณ์ (ใช้งานไม่ได้) เพื่อความสะดวกเมื่อสร้างสำหรับ Windows, macOS และ Linux ดังนั้นคุณไม่จำเป็นต้องคอมไพล์โค้ดตามเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

เดสก์ท็อปฐานข้อมูลเรียลไทม์

Realtime Database SDK สำหรับเดสก์ท็อปใช้ REST เพื่อเข้าถึงฐานข้อมูลของคุณดังนั้นคุณต้อง ประกาศดัชนี ที่คุณใช้กับ Query::OrderByChild() บนเดสก์ท็อปมิฉะนั้นผู้ฟังของคุณจะล้มเหลว

ข้อมูลเพิ่มเติมสำหรับการตั้งค่าเดสก์ท็อป

ไลบรารีของ Windows

สำหรับ Windows เวอร์ชันไลบรารีมีให้ตามสิ่งต่อไปนี้:

สร้างแพลตฟอร์ม: โหมด 32 บิต (x86) เทียบกับ 64 บิต (x64)
สภาพแวดล้อมรันไทม์ของ Windows: Multithreaded / MT เทียบกับ Multithreaded DLL / MD
Target: Release vs Debug

โปรดทราบว่าไลบรารีต่อไปนี้ได้รับการทดสอบโดยใช้ Visual Studio 2015 และ 2017

เมื่อสร้างแอป C ++ บนเดสก์ท็อปบน Windows ให้เชื่อมโยงไลบรารี Windows SDK ต่อไปนี้กับโครงการของคุณ ศึกษาเอกสารประกอบของคุณสำหรับข้อมูลเพิ่มเติม

ไลบรารี Firebase C ++	การพึ่งพาไลบรารี Windows SDK
การรับรองความถูกต้อง	`advapi32, ws2_32, crypt32`
Cloud Firestore	`advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32`
ฟังก์ชันคลาวด์	`advapi32, ws2_32, crypt32, rpcrt4, ole32`
การจัดเก็บเมฆ	`advapi32, ws2_32, crypt32`
ฐานข้อมูลเรียลไทม์	`advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv`
การกำหนดค่าระยะไกล	`advapi32, ws2_32, crypt32, rpcrt4, ole32`

ไลบรารี macOS

สำหรับ macOS (Darwin) เวอร์ชันไลบรารีมีให้สำหรับแพลตฟอร์ม 64 บิต (x86_64) นอกจากนี้ยังมีกรอบเพื่อความสะดวกของคุณ

โปรดทราบว่าไลบรารี macOS ได้รับการทดสอบโดยใช้ Xcode 10.3.0

เมื่อสร้างแอพ C ++ บนเดสก์ท็อปบน macOS ให้เชื่อมโยงสิ่งต่อไปนี้กับโปรเจ็กต์ของคุณ:

ไลบรารีระบบ pthread
กรอบระบบ CoreFoundation macOS
Foundation กรอบระบบ macOS
กรอบระบบ Security macOS
กรอบระบบ GSS macOS
กรอบระบบ Kerberos macOS
กรอบระบบ SystemConfiguration macOS

ศึกษาเอกสารประกอบของคุณสำหรับข้อมูลเพิ่มเติม

ไลบรารี Linux

สำหรับ Linux เวอร์ชันไลบรารีมีให้สำหรับแพลตฟอร์ม 32 บิต (i386) และ 64 บิต (x86_64)

โปรดทราบว่าไลบรารี Linux ได้รับการทดสอบโดยใช้ GCC 4.8.0, GCC 7.2.0 และ Clang 5.0 บน Ubuntu

เมื่อสร้างแอปเดสก์ท็อป C ++ บน Linux ให้เชื่อมโยงไลบรารีระบบ pthread กับโปรเจ็กต์ของคุณ ดูเอกสารประกอบของคุณสำหรับข้อมูลเพิ่มเติม หากคุณกำลังสร้างด้วย GCC 5 ขึ้นไปให้กำหนด -D_GLIBCXX_USE_CXX11_ABI=0

ขั้นตอนถัดไป

สำรวจ แอป Firebase ตัวอย่าง
สำรวจ SDK โอเพนซอร์สใน GitHub
เตรียมเปิดตัวแอปของคุณ:
- ตั้งค่าการ แจ้งเตือนงบประมาณ สำหรับโครงการของคุณในคอนโซล GCP
- ตรวจสอบ การใช้งานและแดชบอร์ดการเรียกเก็บเงิน ของคุณในคอนโซล Firebase
- ตรวจ สอบรายการตรวจสอบการเปิดตัว Firebase