הוסף את Firebase לפרויקט C++ שלך

הפעל את משחקי C++ שלך עם ערכות Firebase C++ SDK שלנו המספקות ממשק C++ על גבי Firebase עבור iOS ועבור Android.

גש ל-Firebase לחלוטין מקוד C++ שלך, ללא צורך לכתוב שום קוד מקורי לפלטפורמה. ה-SDK של Firebase גם מתרגם ניבים ספציפיים לשפה המשמשים את Firebase לממשק המוכר יותר למפתחי C++.

קבל מידע נוסף על הפעלת המשחקים שלך עם Firebase בדף משחקי Firebase שלנו.

כבר הוספת את Firebase לפרויקט C++ שלך? ודא שאתה משתמש בגרסה העדכנית ביותר של Firebase C++ SDK .

דרישות מוקדמות

  • התקן את הדברים הבאים:

    • Xcode 13.3.1 ואילך
    • CocoaPods 1.10.0 ואילך

  • ודא שהפרויקט שלך מכוון לגרסאות הפלטפורמה הבאות או מאוחרות יותר:

    • iOS 10

  • הגדר מכשיר iOS פיזי או השתמש בסימולטור iOS כדי להפעיל את האפליקציה שלך.

  • היכנס ל-Firebase באמצעות חשבון Google שלך.

שלב 2 : צור פרויקט Firebase

לפני שתוכל להוסיף את Firebase לפרויקט C++ שלך, עליך ליצור פרויקט Firebase כדי להתחבר לפרויקט C++ שלך. בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase.

שלב 3 : רשום את האפליקציה שלך ב-Firebase

כדי להשתמש ב-Firebase באפליקציית Apple שלך, עליך לרשום את האפליקציה שלך בפרויקט Firebase שלך. רישום האפליקציה שלך נקרא לעתים קרובות "הוספת" האפליקציה שלך לפרויקט שלך.

  1. עבור אל מסוף Firebase .

  2. במרכז דף סקירת הפרויקט, לחץ על סמל iOS+ כדי להפעיל את זרימת העבודה של ההגדרה.

    אם כבר הוספת אפליקציה לפרויקט Firebase שלך, לחץ על הוסף אפליקציה כדי להציג את אפשרויות הפלטפורמה.

  3. הזן את מזהה החבילה של האפליקציה שלך בשדה מזהה החבילה .

  4. (אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ומזהה App Store .

  5. לחץ על הרשמה אפליקציה .

שלב 4 : הוסף את קובץ התצורה של Firebase

  1. לחץ על הורד את GoogleService-Info.plist כדי להשיג את קובץ התצורה של Firebase Apple platforms שלך.

  2. פתח את פרויקט C++ שלך ב-IDE, ולאחר מכן גרור את קובץ התצורה שלך לשורש פרויקט C++ שלך.

  3. אם תתבקש, בחר להוסיף את קובץ התצורה לכל היעדים.

סיימת להגדיר משימות במסוף Firebase. המשך להוסיף Firebase C++ SDK למטה.

שלב 5 : הוסף ערכות SDK של Firebase C++

השלבים בסעיף זה הם דוגמה כיצד להוסיף מוצרי 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 שבהם אתה רוצה להשתמש באפליקציה שלך.

      אנליטיקס מופעל

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

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

ספריות זמינות

למד עוד על ספריות C++ Firebase בתיעוד העזר ובמהדורת SDK בקוד פתוח שלנו ב- GitHub .

ספריות זמינות עבור iOS

שים לב שספריות C++ עבור Android מופיעות בגרסת Android של דף הגדרה זה .

לכל מוצר Firebase יש תלות שונה. הקפד להוסיף את כל התלות המפורטות עבור מוצר Firebase הרצוי לפרויקט Podfile ו-C++ שלך.

מוצר Firebase מסגרות ותרמילים
AdMob (חובה) firebase.framework
firebase_admob.framework
(חובה) firebase_analytics.framework

pod 'FirebaseAdMob', '9.3.0'
(חובה) pod 'FirebaseAnalytics', '9.3.0'
ניתוח (חובה) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '9.3.0'
אימות (חובה) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '9.3.0'
Cloud Firestore (חובה) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '9.3.0'
pod 'FirebaseAuth', '9.3.0'
פונקציות ענן (חובה) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '9.3.0'
העברת הודעות בענן (חובה) firebase.framework
firebase_messaging.framework
(מומלץ) firebase_analytics.framework

pod 'FirebaseMessaging', '9.3.0'
(מומלץ) pod 'FirebaseAnalytics', '9.3.0'
אחסון בענן (חובה) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '9.3.0'
קישורים דינמיים (חובה) firebase.framework
firebase_dynamic_links.framework
(מומלץ) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '9.3.0'
(מומלץ) pod 'FirebaseAnalytics', '9.3.0'
מסד נתונים בזמן אמת (חובה) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '9.3.0'
תצורה מרחוק (חובה) firebase.framework
firebase_remote_config.framework
(מומלץ) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '9.3.0'
(מומלץ) pod 'FirebaseAnalytics', '9.3.0'

מידע נוסף עבור ההגדרה לנייד

שיטה סוויסינג

ב-iOS, אירועי יישומים מסוימים (כגון פתיחת כתובות אתרים וקבלת התראות) מחייבים את נציג האפליקציה שלך ליישם שיטות ספציפיות. לדוגמה, קבלת הודעה עשויה לחייב את נציג האפליקציה שלך ליישם את application:didReceiveRemoteNotification: . מכיוון שלכל אפליקציית iOS יש נציג אפליקציה משלה, Firebase משתמשת בשיטת swizzling , המאפשרת החלפה של שיטה אחת באחרת, כדי לצרף מטפלים משלה בנוסף לכל מה שייתכן שיישמת.

ספריות הקישורים הדינמיים והעברת ההודעות בענן צריכות לצרף מטפלים לנציג האפליקציה תוך שימוש ב-swizzling של שיטות. אם אתה משתמש באחד ממוצרי Firebase אלה, בזמן הטעינה, Firebase תזהה את מחלקת AppDelegate שלך ​​ותעביר עליה את השיטות הנדרשות, תוך שרשור קריאה חזרה ליישום השיטה הקיימת שלך.

הגדר זרימת עבודה בשולחן העבודה ( בטא )

כשאתה יוצר משחק, לעתים קרובות הרבה יותר קל לבדוק את המשחק שלך בפלטפורמות שולחניות תחילה, ואז לפרוס ולבדוק במכשירים ניידים מאוחר יותר בפיתוח. כדי לתמוך בזרימת עבודה זו, אנו מספקים תת-קבוצה של Firebase C++ SDKs שיכולים לפעול על 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 — לפני שתפעיל את האפליקציה שלך, עליך להמיר את הקובץ לנייד זה לקובץ תצורה של Firebase שולחני . כדי להמיר את הקובץ, הפעל את הפקודה הבאה מאותה ספרייה כמו קובץ GoogleService-Info.plist שלך:

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

    קובץ תצורת שולחן העבודה הזה מכיל את מזהה פרויקט C++ שהזנת בתהליך העבודה של הגדרת מסוף Firebase. בקר ב- Understand Firebase Projects כדי ללמוד עוד על קובצי תצורה.

  3. הוסף ערכות פיתוח של Firebase לפרויקט C++ שלך.

    השלבים שלהלן משמשים דוגמה להוספת כל מוצר נתמך של Firebase לפרויקט C++ שלך. בדוגמה זו, אנו עוברים על הוספת Firebase Authentication ו-Firebase Realtime Database.

    1. הגדר את משתנה הסביבה FIREBASE_CPP_SDK_DIR שלך למיקום של ה-SDK של Firebase C++ הפתוח.

    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 מספקת את ספריות שולחן העבודה הנותרות כהטמעות סטאב (לא פונקציונליות) לצורך נוחות בעת בנייה עבור 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 הבאות לפרויקט שלך. עיין בתיעוד המהדר שלך למידע נוסף.

ספריית 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 (Darwin), גרסאות ספרייה מסופקות עבור פלטפורמת 64 סיביות (x86_64). מסגרות מסופקות גם לנוחיותך.

שים לב שספריות macOS נבדקו באמצעות Xcode 13.3.1.

בעת בניית אפליקציות C++ למחשב שולחני ב-macOS, קשר את הדברים הבאים לפרויקט שלך:

  • ספריית מערכת pthread
  • CoreFoundation מסגרת מערכת macOS
  • בסיס מערכת Foundation
  • מסגרת מערכת Security macOS
  • מסגרת מערכת GSS macOS
  • מסגרת מערכת Kerberos macOS
  • תצורת מערכת מסגרת מערכת SystemConfiguration

עיין בתיעוד המהדר שלך למידע נוסף.

ספריות לינוקס

עבור לינוקס, גרסאות ספרייה מסופקות עבור פלטפורמות 32 סיביות (i386) ו-64 סיביות (x86_64).

שים לב שספריות לינוקס נבדקו באמצעות GCC 4.8.0, GCC 7.2.0 ו-Clang 5.0 באובונטו.

בעת בניית אפליקציות C++ לשולחן העבודה ב-Linux, קשר את ספריית מערכת pthread לפרויקט שלך. עיין בתיעוד המהדר שלך למידע נוסף. אם אתה בונה עם GCC 5 ואילך, הגדר -D_GLIBCXX_USE_CXX11_ABI=0 .

הצעדים הבאים