Google มุ่งมั่นที่จะพัฒนาความเท่าเทียมทางเชื้อชาติสำหรับชุมชนคนผิวดำ มาดูกันว่า
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

เพิ่ม Firebase ให้กับโครงการ C ++ ของคุณ

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

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

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

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

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

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

    • Xcode 10.3.0 หรือใหม่กว่า
    • CocoaPods 1.4.0 หรือใหม่กว่า
  • ตรวจสอบให้แน่ใจว่าโครงการของคุณกำหนดเป้าหมายเป็น iOS 8 หรือใหม่กว่า

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

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

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

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

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

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

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

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

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

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

  3. ป้อน ID กลุ่มแอปของคุณในฟิลด์ ID กลุ่ม iOS

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

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

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

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

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

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

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

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

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

  1. ดาวน์โหลด Firebase C ++ SDK จากนั้นคลายซิป SDK ที่ใดก็ได้ที่สะดวก

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

  2. เพิ่ม Firebase pods จาก SDK ที่คลายซิป

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

      cd your-app-directory 
      pod init

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

      เปิดใช้งาน Analytics แล้ว

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

      ไม่ได้เปิดใช้งาน Analytics

      # 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 ++ framework firebase.framework ซึ่ง จำเป็นต้อง ใช้ผลิตภัณฑ์ Firebase ใด ๆ

    2. เพิ่มเฟรมเวิร์กสำหรับผลิตภัณฑ์ Firebase แต่ละตัวที่คุณต้องการใช้ ตัวอย่างเช่นหากต้องการใช้การพิสูจน์ตัวตนของ Firebase ให้เพิ่ม 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 ++ ของคุณ

ผลิตภัณฑ์ Firebase กรอบและฝัก
AdMob (จำเป็น) firebase.framework
firebase_admob.framework
(จำเป็น) firebase_analytics.framework

pod 'Firebase/AdMob', '6.24.0'
(จำเป็น) pod 'Firebase/Analytics', '6.24.0'
Analytics (จำเป็น) firebase.framework
firebase_analytics.framework

pod 'Firebase/Analytics', '6.24.0'
การรับรอง (จำเป็น) firebase.framework
firebase_auth.framework

pod 'Firebase/Auth', '6.24.0'
Cloud Firestore (อัลฟา) (จำเป็น) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'Firebase/Firestore', '6.24.0'
pod 'Firebase/Auth', '6.24.0'
ฟังก์ชั่นคลาวด์ (จำเป็น) firebase.framework
firebase_functions.framework

pod 'Firebase/Functions', '6.24.0'
การส่งข้อความบนคลาวด์ (จำเป็น) firebase.framework
firebase_messaging.framework
(แนะนำ) firebase_analytics.framework

pod 'Firebase/Messaging', '6.24.0'
(แนะนำ) pod 'Firebase/Analytics', '6.24.0'
การจัดเก็บเมฆ (จำเป็น) firebase.framework
firebase_storage.framework

pod 'Firebase/Storage', '6.24.0'
ลิงค์แบบไดนามิก (จำเป็น) firebase.framework
firebase_dynamic_links.framework
(แนะนำ) firebase_analytics.framework

pod 'Firebase/DynamicLinks', '6.24.0'
(แนะนำ) pod 'Firebase/Analytics', '6.24.0'
ฐานข้อมูลเรียลไทม์ (จำเป็น) firebase.framework
firebase_database.framework

pod 'Firebase/Database', '6.24.0'
กำหนดค่าระยะไกล (จำเป็น) firebase.framework
firebase_remote_config.framework
(แนะนำ) firebase_analytics.framework

pod 'Firebase/RemoteConfig', '6.24.0'
(แนะนำ) pod 'Firebase/Analytics', '6.24.0'

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

วิธีการที่ร้อนแรง

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

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

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

เมื่อคุณสร้างเกมมักจะทดสอบเกมของคุณบนแพลตฟอร์มเดสก์ท็อปได้ง่ายกว่าก่อนจากนั้นปรับใช้และทดสอบบนอุปกรณ์พกพาในการพัฒนาในภายหลัง เพื่อรองรับเวิร์กโฟลว์นี้เรามี ชุดย่อยของ 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 เดสก์ท็อป โดยอัตโนมัติ ( google-services-desktop.json )

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

      generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist

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

  3. เพิ่ม Firebase SDKs ให้กับโครงการ C ++ ของคุณ

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

    1. ตั้งค่าตัวแปรสภาพแวดล้อม FIREBASE_CPP_SDK_DIR ของคุณเป็นตำแหน่งของ Firebase C ++ SDK ที่คลายซิป

    2. ไปยังไฟล์ CMakeLists.txt ของโครงการของคุณเพิ่มเนื้อหาต่อไปนี้รวมถึง ไลบรารี สำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ ตัวอย่างเช่นหากต้องการใช้การพิสูจน์ตัวตน Firebase และฐานข้อมูลเรียลไทม์ 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}")
      
  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-non-functional) เพื่อสร้างความสะดวกสบายเมื่อสร้างสำหรับ Windows, macOS และ Linux ดังนั้นคุณไม่จำเป็นต้องคอมไพล์รหัสตามเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

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

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

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

ไลบรารี Windows

สำหรับ Windows จะมีการจัดเตรียมเวอร์ชันของไลบรารี่ดังนี้

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

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

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

Firebase C ++ Library การอ้างอิงไลบรารีของ 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 10.3.0

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

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