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

plat_ios plat_android plat_cpp

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

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

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

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

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

• ติดตั้งสิ่งต่อไปนี้:

  • Xcode 12 หรือใหม่กว่า
  • CocoaPods 1.10.0 หรือใหม่กว่า

• ตรวจสอบให้แน่ใจว่าโครงการของคุณกำหนดเป้าหมายเป็น iOS 10 ขึ้นไป

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

  คุณต้องการใช้ Cloud Messaging หรือไม่?

  สำหรับ Cloud Messaging บน iOS สิ่งที่ต้องมีมีดังต่อไปนี้:

  • ตั้งค่า อุปกรณ์ iOS จริง
  • รับคีย์การตรวจสอบสิทธิ์การแจ้งเตือนแบบพุชของ Apple สำหรับบัญชีนักพัฒนา Apple ของ คุณ
  • เปิดใช้งานการแจ้งเตือนแบบพุชใน Xcode ภายใต้ แอพ> ความสามารถ

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

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

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

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

หลังจากที่คุณมีโปรเจ็กต์ Firebase คุณสามารถเพิ่มแอป iOS ของคุณลงไปได้

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

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

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

   หากคุณได้เพิ่มแอปลงในโครงการ Firebase แล้วให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

3. ป้อนรหัสบันเดิลของแอปของคุณในช่อง รหัสมัดของ iOS

   Bundle ID คืออะไรและคุณจะหาได้ที่ไหน?

   • รหัสบันเดิลจะ ระบุแอปพลิเคชันในระบบนิเวศของ Apple โดยไม่ซ้ำกัน

   • ค้นหารหัสบันเดิลของคุณ: เปิดโปรเจ็กต์ iOS ของคุณใน Xcode เลือกแอพระดับบนสุดในตัวนำทางโปรเจ็กต์จากนั้นเลือกแท็บ ทั่วไป

     ค่าของช่อง Bundle Identifier คือรหัสบันเดิลของ iOS (ตัวอย่างเช่น com.yourcompany.yourproject )

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

4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่น ๆ : ชื่อเล่น แอป และ รหัส App Store

   ชื่อเล่นแอป และ รหัส App Store ใช้ภายใน Firebase อย่างไร

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

   • App Store ID : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store ของคุณ และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปของคุณยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสได้ในภายหลังใน การตั้งค่าโครงการ ของคุณ

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

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

1. คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่า Firebase iOS ของคุณ

   คุณต้องรู้อะไรบ้างเกี่ยวกับไฟล์กำหนดค่านี้

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

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

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

2. เปิดโปรเจ็กต์ C ++ ของคุณใน IDE จากนั้นลากไฟล์กำหนดค่าของคุณไปที่รูทของโปรเจ็กต์ C ++

3. หากได้รับแจ้งให้เลือกเพิ่มไฟล์กำหนดค่าให้กับเป้าหมายทั้งหมด

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

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

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

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

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

2. เพิ่ม Firebase ฝัก จาก SDK ซิป

   1. สร้าง Podfile หากคุณยังไม่มี:

      cd your-app-directory

      pod init

   2. ใน Podfile ของคุณให้เพิ่ม Firebase pods ที่คุณต้องการใช้ในแอปของคุณ

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

      # 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'

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

      # 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'

   3. ติดตั้ง .xcworkspace จากนั้นเปิดไฟล์. .xcworkspace ใน Xcode

      pod install

      open your-app.xcworkspace

3. เพิ่ม เฟรมเวิร์ก Firebase จาก SDK ที่คลายซิป

   วิธีที่ง่ายที่สุดในการเพิ่มเฟรมเวิร์กเหล่านี้มักจะลากจากหน้าต่าง Finder ไปยังบานหน้าต่าง Project Navigator ของ Xcode โดยตรง (บานหน้าต่างด้านซ้ายสุดตามค่าเริ่มต้นหรือคลิกไอคอนไฟล์ที่ด้านบนซ้ายของ Xcode)

   1. เพิ่ม Firebase c ++ กรอบ firebase.framework ซึ่งเป็นสิ่งจำเป็นที่จะใช้ผลิตภัณฑ์ Firebase ใด ๆ

   2. เพิ่มเฟรมเวิร์กสำหรับผลิตภัณฑ์ Firebase แต่ละรายการที่คุณต้องการใช้ ตัวอย่างเช่นหากต้องการใช้ Firebase Authentication ให้เพิ่ม firebase_auth.framework

4. กลับไปที่คอนโซล Firebase ในขั้นตอนการตั้งค่าคลิก ถัดไป

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

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

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

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

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

ไลบรารีที่พร้อมใช้งานสำหรับ iOS

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

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

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

วิธีการ swizzling

ใน iOS เหตุการณ์บางอย่างของแอปพลิเคชัน (เช่นการเปิด URL และการรับการแจ้งเตือน) ต้องการให้ผู้แทนแอปพลิเคชันของคุณใช้วิธีการเฉพาะ ตัวอย่างเช่นการรับการแจ้งเตือนอาจต้องให้ผู้มอบสิทธิ์แอปพลิเคชันของคุณใช้งาน application:didReceiveRemoteNotification: เนื่องจากแอปพลิเคชัน iOS แต่ละตัวมีตัวแทนแอปของตัวเอง Firebase จึงใช้ วิธีการ swizzling ซึ่งช่วยให้สามารถเปลี่ยนวิธีการหนึ่งกับอีกวิธีหนึ่งเพื่อแนบตัวจัดการของตัวเองนอกเหนือจากที่คุณอาจใช้

ลิงก์ไดนามิกและไลบรารีการส่งข้อความบนคลาวด์จำเป็นต้องแนบตัวจัดการกับแอปพลิเคชันที่ได้รับมอบหมายโดยใช้วิธีการ swizzling หากคุณกำลังใช้ผลิตภัณฑ์ Firebase ใด ๆ เหล่านี้ในขณะโหลด Firebase จะระบุคลาส AppDelegate ของคุณและสลับวิธีการที่จำเป็นลงไปโดยผูกสายการโทรกลับไปยังการใช้งานวิธีการที่คุณมี

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

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

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

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

2. สร้างไฟล์การกำหนดค่า Firebase เวอร์ชัน เดสก์ท็อป :

   • หากคุณเพิ่ม Android google-services.json ไฟล์ - เมื่อคุณเรียกใช้แอปของคุณ Firebase ตั้งไฟล์มือถือนี้แล้วโดยอัตโนมัติสร้างเดสก์ทอป Firebase ไฟล์ config ( 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 และฐานข้อมูลเรียลไทม์ของ 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}")
      

4. เรียกใช้แอป C ++ ของคุณ

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

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

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

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

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

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

ไลบรารีของ Windows

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

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

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

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

ไลบรารี macOS

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

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

เมื่อสร้างแอพ 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

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

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