เพิ่ม 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 ระดับ 19 (KitKat) หรือสูงกว่า

  • ใช้ Gradle และ กำหนดค่าด้วย CMake

• ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ

  • อีมู เลเตอร์ต้องใช้อิมเมจอีมูเลเตอร์กับ Google Play

  • สำหรับไลบรารี C++ บางตัว จำเป็นต้องมีบริการ Google Play บนอุปกรณ์ไคลเอ็นต์ ตรวจสอบ รายชื่อ ในหน้านี้

• ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ

ขั้นตอนที่ 2 : สร้างโปรเจ็กต์ Firebase

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

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

1. ใน คอนโซล Firebase คลิก เพิ่มโครงการ

   • หากต้องการเพิ่มทรัพยากร Firebase ให้กับโปรเจ็กต์ Google Cloud ที่มีอยู่ ให้ป้อนชื่อโปรเจ็กต์หรือเลือกจากเมนูแบบเลื่อนลง

   • หากต้องการสร้างโครงการใหม่ ให้ป้อนชื่อโครงการที่ต้องการ คุณยังเลือกแก้ไขรหัสโปรเจ็กต์ที่แสดงด้านล่างชื่อโปรเจ็กต์ได้อีกด้วย

2. หากได้รับแจ้ง ให้ตรวจสอบและยอมรับ ข้อกำหนดของ Firebase

3. คลิก ดำเนินการ ต่อ

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

   Firebase Crashlytics การส่งข้อความบนคลาวด์ของ Firebase

   การส่งข้อความในแอปของ Firebase การกำหนดค่าระยะไกลของ Firebase

   การกำหนดค่าระยะไกลส่วนบุคคล การทดสอบ Firebase A/B

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

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

5. คลิก สร้างโปรเจ็ กต์ (หรือ เพิ่ม Firebase หากคุณใช้โปรเจ็กต์ Google Cloud ที่มีอยู่)

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

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

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

1. ไปที่ คอนโซล Firebase

2. ตรงกลางหน้าภาพรวมโครงการ ให้คลิกไอคอน Android ( plat_android ) หรือ เพิ่มแอป เพื่อเริ่มเวิร์กโฟลว์การตั้งค่า

3. ป้อนชื่อแพ็กเกจของแอปในช่อง ชื่อแพ็กเกจ Android

   ชื่อแพ็คเกจคืออะไรและจะหาได้จากที่ไหน?

   • ชื่อแพ็กเกจ จะระบุแอปของคุณบนอุปกรณ์และใน Google Play Store โดยไม่ซ้ำกัน

   • ชื่อแพ็คเกจ มักถูกเรียกว่า ID แอปพลิเคชัน

   • ค้นหาชื่อแพ็คเกจของแอปในไฟล์ Gradle ของโมดูล (ระดับแอป) ซึ่งมักจะเป็น app/build.gradle (ชื่อแพ็คเกจตัวอย่าง: com.yourcompany.yourproject )

   • โปรดทราบว่าค่าชื่อแพ็กเกจจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase Android นี้หลังจากที่ลงทะเบียนกับโปรเจ็กต์ Firebase แล้ว

4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่นแอป และ ใบรับรองการลงนามดีบัก SHA-1

   ชื่อเล่นของแอป และ ใบรับรองการลงนามดีบัก SHA-1 ใช้อย่างไรใน Firebase

   • ชื่อเล่นของแอป : ตัวระบุความสะดวกภายในที่มีคุณเท่านั้นที่เห็นในคอนโซล Firebase

   • ดีบักใบรับรองการลงชื่อ SHA-1 : ต้องมี แฮช SHA-1 โดย Firebase Authentication (เมื่อใช้ Google Sign In หรือ หมายเลขโทรศัพท์ลงชื่อเข้าใช้ ) และ Firebase Dynamic Links

5. คลิก ลงทะเบียนแอป

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

1. คลิก ดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android ของคุณ

   สิ่งที่คุณต้องรู้เกี่ยวกับไฟล์ปรับแต่งนี้

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

   • คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ

   • ตรวจสอบให้แน่ใจว่าชื่อไฟล์ปรับแต่งไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

2. เปิดโปรเจ็กต์ C++ ใน IDE จากนั้นเพิ่มไฟล์ปรับแต่งลงในโปรเจ็กต์ของคุณ:

   • Gradle builds — เพิ่มไฟล์ปรับแต่งของคุณไปยังไดเร็กทอรีเดียวกันกับไฟล์ build.gradle ระดับบนสุดของคุณ

   • ระบบบิลด์อื่นๆ — ดูระบบบิลด์ แบบกำหนดเอง ด้านล่างเพื่อสร้าง Android String Resources

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

   1. เพิ่มกฎเพื่อรวมปลั๊กอิน 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.14'  // Google Services plugin
            implementation 'com.google.android.gms:18.1.0'
          }
        }
      
        allprojects {
          // ...
      
          repositories {
            // Check that you have the following line (if not, add it):
            google()  // Google's Maven repository
            // ...
          }
        }
      

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

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

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

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

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

1. ดาวน์โหลด Firebase C++ SDK จากนั้นเปิดเครื่องรูด SDK ที่ไหนสักแห่งที่สะดวก

   Firebase C++ SDK ไม่ใช่เฉพาะแพลตฟอร์ม แต่มีไลบรารีเฉพาะแพลตฟอร์ม

2. ในไฟล์ gradle.properties ของโปรเจ็กต์ของคุณ ระบุตำแหน่งของ SDK ที่คลายซิป:

   systemProp.firebase_cpp_sdk.dir=full-path-to-SDK
   

3. ในไฟล์ 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"
   

4. ในไฟล์ 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
   }
   

5. ในไฟล์ 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}")
   

6. ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการขึ้นต่อกันทั้งหมดมีเวอร์ชันที่จำเป็น

7. หากคุณเพิ่ม Analytics ให้เรียกใช้แอปเพื่อส่งการยืนยันไปยัง Firebase ว่าคุณผสานรวม Firebase สำเร็จแล้ว มิฉะนั้น คุณสามารถข้ามขั้นตอนการยืนยันได้

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

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

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

1. ตรวจสอบให้แน่ใจว่าคุณมี Android NDK v10d หรือใหม่กว่า

2. ดาวน์โหลด Firebase C++ SDK จากนั้นเปิดเครื่องรูด SDK ที่ไหนสักแห่งที่สะดวก

   Firebase C++ SDK ไม่ใช่เฉพาะแพลตฟอร์ม แต่มีไลบรารีเฉพาะแพลตฟอร์ม

3. เปิดไฟล์ local.properties จากนั้น:

   • ตั้งค่าตัวแปร firebase_cpp_sdk.dir เป็นตำแหน่งของ Firebase C++ SDK ที่คลายซิป
   • ตั้งค่าตัวแปร ndk.dir เป็นตำแหน่งของ Android NDK

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

   1. สร้างไฟล์ 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
      

   2. สร้างไฟล์ 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)
      

5. เปิดไฟล์ build.gradle ระดับบนสุดของคุณ จากนั้นทำตามขั้นตอนต่อไปนี้:

   1. เพิ่มการ พึ่งพา สำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ ตัวอย่างเช่น ในการใช้ Analytics:

      dependencies {
        implementation 'com.google.firebase:firebase-analytics:21.0.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	ห้องสมุดและการพึ่งพา
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:21.0.0'
การวิเคราะห์	libfirebase_analytics.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-analytics:21.0.0'
การตรวจสอบสิทธิ์	libfirebase_auth.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-auth:21.0.5'
Cloud Firestore	libfirebase_firestore.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-firestore:24.1.2'
ฟังก์ชั่นคลาวด์	libfirebase_functions.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-functions:20.1.0'
การส่งข้อความบนคลาวด์	libfirebase_messaging.a (แนะนำ) libfirebase_analytics.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-messaging:23.0.5' (แนะนำ) implementation 'com.google.firebase:firebase-analytics:21.0.0'
การจัดเก็บเมฆ	libfirebase_storage.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-storage:20.0.1'
ลิงก์แบบไดนามิก	ibfirebase_dynamic_links.a (แนะนำ) libfirebase_analytics.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-dynamic-links:21.0.1' (แนะนำ) implementation 'com.google.firebase:firebase-analytics:21.0.0'
ฐานข้อมูลเรียลไทม์	libfirebase_database.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-database:20.0.5'
การกำหนดค่าระยะไกล	libfirebase_remote_config.a (แนะนำ) libfirebase_analytics.a (จำเป็น) libfirebase_app.a implementation 'com.google.firebase:firebase-config:21.1.0' (แนะนำ) implementation 'com.google.firebase:firebase-analytics:21.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-build, makefiles, Visual Studio เป็นต้น) คุณสามารถใช้สคริปต์นี้เพื่อสร้าง Android String Resources โดย อัตโนมัติ

โปรการ์ด

ระบบบิลด์ 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++ SDK ซึ่งสามารถทำงานบน Windows, macOS, Linux และจากภายในตัวแก้ไข C++

1. สำหรับเวิร์กโฟลว์เดสก์ท็อป คุณต้องดำเนินการดังต่อไปนี้:

   1. กำหนดค่าโครงการ C ++ ของคุณสำหรับ CMake
   2. สร้างโปรเจ็กต์ Firebase
   3. ลงทะเบียนแอปของคุณ (iOS หรือ Android) ด้วย Firebase
   4. เพิ่มไฟล์การกำหนดค่า Firebase ของแพลตฟอร์มมือถือ

2. สร้างไฟล์การกำหนดค่า 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 เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่า

3. เพิ่ม 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}")
      

4. เรียกใช้แอป 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 ดังนั้น คุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

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

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

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

ไลบรารีของ Windows

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

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

โปรดทราบว่าไลบรารีต่อไปนี้ได้รับการทดสอบโดยใช้ 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 13.3.1

เมื่อสร้างแอปเดสก์ท็อป 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

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

• สำรวจ ตัวอย่างแอป Firebase

• สำรวจ SDK โอเพ่นซอร์สใน GitHub

• เตรียมเปิดแอปของคุณ:

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