หน้านี้ได้รับการแปลโดย Cloud Translation API

เพิ่ม 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
ขอรับ SDK Android
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- เป้าหมาย API ระดับ 19 (KitKat) หรือสูงกว่า
- ใช้ Gradle และมีการ กำหนดค่าด้วย CMake
ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ
- อีมูเลเตอร์ จะต้องใช้ภาพจำลองกับ Google Play
- สำหรับไลบรารี C++ บางตัว จำเป็นต้องมีบริการ Google Play บนอุปกรณ์ไคลเอนต์ ตรวจสอบ รายชื่อ ในหน้านี้
ลงชื่อเข้าใช้ Firebase ใช้บัญชี Google ของคุณ

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

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

สร้างโปรเจ็กต์ Firebase

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

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

ทั้งเลือกที่มีอยู่ บัญชี Google Analytics หรือสร้างบัญชีใหม่

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

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

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

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

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

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

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

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

(Gradle สร้างเท่านั้น) ต้องการเปิดใช้บริการ Firebase ของคุณใน C ++ โครงการเพิ่ม google-บริการปลั๊กอิน ระดับบนสุดของคุณ 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.10'  // Google Services plugin
      implementation 'com.google.android.gms:17.6.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 ++ SDKs

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

ดาวน์โหลด Firebase c ++ SDK แล้วเปิดเครื่องรูด SDK สะดวกที่ไหนสักแห่ง
Firebase C++ SDK ไม่ใช่เฉพาะแพลตฟอร์ม แต่มีไลบรารีเฉพาะแพลตฟอร์ม
ในโครงการของคุณเป็น gradle.properties ไฟล์ระบุตำแหน่งที่ตั้งของ SDK ซิปไปนี้:
```
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"

โมดูลของคุณ (app ระดับ) ไฟล์ Gradle (ปกติ app/build.gradle ) เพิ่มเนื้อหาดังต่อไปนี้
รวมถึง การพึ่งพาห้องสมุด สำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ

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

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

# Add the dependencies for the Firebase products you want to use in your app
# For example, to use Analytics, Firebase Authentication, and Firebase Realtime Database
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  analytics
  auth
  database
}

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

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

# Add the dependencies for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  auth
  database
}

ให้กับโครงการของคุณ 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 สร้างเพื่อเพิ่ม SDKs

ตรวจสอบให้แน่ใจว่าคุณมี 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:20.0.0'
}
```
2. เพิ่มบรรทัดต่อไปเพื่อให้โครงการของคุณใช้ในตัว ndk สร้างการสนับสนุนที่จะรวมถึงห้องสมุด Firebase ระบุไว้ในของคุณ Gradle ของ 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:20.0.0

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

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

เรียนรู้เพิ่มเติมเกี่ยวกับห้องสมุด C ++ Firebase ใน เอกสารอ้างอิง และในรุ่น SDK เปิดแหล่งที่มาของเราใน GitHub

ห้องสมุดใช้ได้สำหรับ Android (ใช้ CMake)

โปรดทราบว่า c ++ ห้องสมุดสำหรับ iOS มีการระบุไว้ใน iOS เวอร์ชันของหน้าการตั้งค่านี้

ผลิตภัณฑ์ Firebase	การอ้างอิงห้องสมุด ( `firebaseCpp.dependencies` สำหรับ `build.gradle` ไฟล์)	การอ้างอิงห้องสมุด ( `firebase_libs` สำหรับ `CMakeLists.txt` ไฟล์)
AdMob	`admob`	`firebase_admob` (จำเป็น) `firebase_analytics` (จำเป็น) `firebase_app`
การวิเคราะห์	`analytics`	`firebase_analytics` (จำเป็น) `firebase_app`
การตรวจสอบสิทธิ์	`auth`	`firebase_auth` (จำเป็น) `firebase_app`
Cloud Firestore	`firestore`	`firebase_firestore` (จำเป็น) `firebase_auth` (จำเป็น) `firebase_app`
ฟังก์ชั่นคลาวด์	`functions`	`firebase_functions` (จำเป็น) `firebase_app`
การส่งข้อความบนคลาวด์	`messaging`	`firebase_messaging` (แนะนำ) `firebase_analytics` (จำเป็น) `firebase_app`
การจัดเก็บเมฆ	`storage`	`firebase_storage` (จำเป็น) `firebase_app`
ลิงก์แบบไดนามิก	`dynamicLinks`	`firebase_dynamic_links` (แนะนำ) `firebase_analytics` (จำเป็น) `firebase_app`
ฐานข้อมูลเรียลไทม์	`database`	`firebase_database` (จำเป็น) `firebase_app`
การกำหนดค่าระยะไกล	`remoteConfig`	`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 สร้าง, makefiles, Visual Studio, ฯลฯ ) คุณสามารถใช้สคริปต์นี้โดยอัตโนมัติรุ่นของ Android ทรัพยากรสตริง

โปรการ์ด

หลายคนสร้างระบบ 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 พึ่งพาแทนมาตรฐาน com.google.firebase:firebase-ads พึ่งพาระบุไว้ข้างต้นบริการ Google Play เป็นสิ่งจำเป็น

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

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

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

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

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

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

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

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

ไลบรารีของ Windows

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

สร้างแพลตฟอร์ม: โหมด 32 บิต (x86) กับ 64 บิต (x64)
สภาพแวดล้อมรันไทม์ของ Windows: Multithreaded / MT เทียบกับ Multithreaded DLL /MD
เป้าหมาย: ปล่อย 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 (ดาร์วิน) เวอร์ชันไลบรารีมีให้สำหรับแพลตฟอร์ม 64 บิต (x86_64) กรอบการทำงานยังมีให้เพื่อความสะดวกของคุณ

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

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

pthread ระบบห้องสมุด
CoreFoundation กรอบระบบ MacOS
Foundation กรอบระบบ MacOS
Security ระบบกรอบ MacOS
GSS กรอบระบบ MacOS
Kerberos กรอบระบบ MacOS
SystemConfiguration กรอบระบบ MacOS

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

ไลบรารีลินุกซ์

สำหรับ 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 0

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

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