เพิ่ม Firebase ไปยังโปรเจ็กต์ C++

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

เพิ่มประสิทธิภาพเกม C++ ด้วย Firebase C++ SDK ซึ่งมีอินเทอร์เฟซ C++ บน Firebase SDK

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพเกมด้วย Firebase ได้ที่หน้าเกม Firebase

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

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

• ติดตั้งรายการต่อไปนี้

  • Xcode 13.3.1 ขึ้นไป
  • CocoaPods 1.12.0 ขึ้นไป

• ตรวจสอบว่าโปรเจ็กต์กำหนดเป้าหมายเป็นแพลตฟอร์มเวอร์ชันต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า

  • iOS 13
  • tvOS 13

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

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

  ข้อกําหนดเบื้องต้นสําหรับ Cloud Messaging ในแพลตฟอร์ม Apple มีดังนี้

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

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

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

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

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

1. ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์

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

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

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

3. คลิกต่อไป

4. (ไม่บังคับ) ตั้งค่า Google Analytics สําหรับโปรเจ็กต์ ซึ่งจะช่วยให้ได้รับประสบการณ์การใช้งานผลิตภัณฑ์ Firebase ต่อไปนี้อย่างเต็มประสิทธิภาพ Firebase A/B Testing Cloud Messaging Crashlytics In-App Messaging และ Remote Config (รวมถึงการปรับให้เหมาะกับผู้ใช้แต่ละราย)

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

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

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

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

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

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

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

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

3. ป้อนรหัสกลุ่มของแอปในช่องรหัสกลุ่ม

   รหัสกลุ่มคืออะไรและดูได้จากที่ใด

   • รหัสชุดเป็นตัวระบุที่ไม่ซ้ำสำหรับแอปพลิเคชันในระบบนิเวศของ Apple

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

     ค่าของช่องตัวระบุกลุ่มคือรหัสกลุ่ม (เช่น com.yourcompany.yourproject)

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

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

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

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

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

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

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

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

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

   • ไฟล์การกําหนดค่า 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 ไว้ที่ใดก็ได้ที่คุณสะดวก

   SDK Firebase C++ ไม่ได้เจาะจงแพลตฟอร์ม แต่มีไลบรารีที่เจาะจงแพลตฟอร์ม

2. เพิ่ม pods ของ Firebase จาก SDK ที่แยกไฟล์แล้ว

   1. หากคุณยังไม่มี Podfile ให้สร้างโดยเรียกใช้คำสั่งต่อไปนี้

      cd your-app-directory

      pod init

   2. เพิ่มพ็อด Firebase ที่ต้องการใช้ในแอปลงใน Podfile

      เปิดใช้ Analytics ไม่ได้เปิดใช้ Analytics
      # Add the Firebase pod for Google Analytics
      pod 'FirebaseAnalytics'
      
      # 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 'FirebaseAuth'
      pod 'FirebaseDatabase'

      # 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 'FirebaseAuth'
      pod 'FirebaseDatabase'

   3. ติดตั้งพ็อด แล้วเปิดไฟล์ .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 แล้ว

ไลบรารีที่ใช้ได้

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

ไลบรารีที่ใช้ได้สำหรับแพลตฟอร์ม Apple

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

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

ผลิตภัณฑ์ Firebase แต่ละรายการอาจรองรับเฉพาะแพลตฟอร์มระบบปฏิบัติการของ Apple บางรายการ (iOS, tvOS ฯลฯ) ตรวจสอบแพลตฟอร์มที่ไลบรารีแต่ละรายการรองรับในหัวข้อดูข้อมูลเพิ่มเติมเกี่ยวกับ C++ และ Firebase

อย่างชัดเจน

ข้อมูลเพิ่มเติมสำหรับการตั้งค่าอุปกรณ์เคลื่อนที่

การแลกเปลี่ยนเมธอด

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

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

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

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

   • หากคุณเพิ่มไฟล์ GoogleService-Info.plist ของ iOS ก่อนเรียกใช้แอป คุณต้องแปลงไฟล์ Mobile นี้เป็นไฟล์การกําหนดค่า 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 มีไลบรารีเดสก์ท็อปที่เหลือเป็นการใช้งานสแต็บ (ใช้งานไม่ได้) เพื่ออำนวยความสะดวกในการสร้างสำหรับ Windows, macOS และ Linux คุณจึงไม่ต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายไปยังเดสก์ท็อป

Realtime Database เดสก์ท็อป

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

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

ไลบรารีของ Windows

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

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

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

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

ไลบรารี macOS

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

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

เมื่อสร้างแอปเดสก์ท็อป 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
  • ตรวจสอบแดชบอร์ดการใช้งานและการเรียกเก็บเงินในคอนโซล Firebase เพื่อดูภาพรวมการใช้งานโปรเจ็กต์ในบริการ Firebase หลายรายการ
  • ตรวจสอบรายการตรวจสอบการเปิดตัว Firebase