‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הוספת Firebase לפרויקט C++

שפרו את משחקי ה-C++‎ שלכם באמצעות ערכות ה-Firebase C++ SDK, שמספקות ממשק C++‎ על גבי ערכות ה-Firebase SDK.

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

מידע נוסף על שיפור המשחקים באמצעות Firebase זמין בדף המשחקים של Firebase.

כבר הוספתם את Firebase לפרויקט C++‎? חשוב לוודא שאתם משתמשים בגרסה העדכנית של Google Mobile Ads SDK ל-Firebase C++.

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

מתקינים את הכלי המועדף לעריכה או את סביבת הפיתוח המשולבת (IDE), כמו Android Studio, ‏IntelliJ או VS Code.
מורידים את Android SDK.
חשוב לוודא שהפרויקט עומד בדרישות הבאות:
- מטרגטת ל-API ברמה 24 (Nougat) ומעלה
- משתמש ב-Gradle ומוגדר באמצעות CMake
מגדירים מכשיר פיזי או משתמשים באמולטור כדי להפעיל את האפליקציה.
- אמולטורים חייבים להשתמש בתמונת אמולטור עם Google Play.
- בחלק מספריות C++‎, נדרש Google Play Services במכשיר הלקוח. עיינו ברשימה שבדף הזה.
נכנסים ל-Firebase באמצעות חשבון Google.

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

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

הוראות ליצירת פרויקט ב-Firebase

משתמשים חדשים ב-Firebase או ב-Cloud

אם אתם משתמשים חדשים ב-Firebase או ב-Google Cloud, אתם צריכים לפעול לפי השלבים הבאים.
אפשר גם לפעול לפי השלבים האלה כדי ליצור פרויקט Firebase חדש לגמרי (והפרויקט הבסיסי שלו ב-Google Cloud).

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

אם אתם חלק מארגון ב-Google Cloud, אתם יכולים לבחור באיזו תיקייה ליצור את הפרויקט.

שם הפרויקט משמש כשם המוצג בממשקי Firebase, והמערכת יוצרת באופן אוטומטי מזהה פרויקט ייחודי על סמך שם הפרויקט. שימו לב: אפשר ללחוץ על סמל העריכה כדי להגדיר את מזהה הפרויקט הרצוי, אבל אי אפשר לשנות את המזהה הזה אחרי שיוצרים את הפרויקט. מידע ולמידה על איך Firebase משתמש במזהה הפרויקט
אם מוצגת בקשה, קוראים ומאשרים את התנאים של Firebase ולוחצים על Continue.
(אופציונלי) מפעילים את העזרה מבוססת-AI במסוף Firebase (נקראת Gemini ב-Firebase), שיכולה לעזור לכם להתחיל ולייעל את תהליך הפיתוח.
(אופציונלי) מגדירים את Google Analytics לפרויקט, כדי לאפשר חוויית שימוש אופטימלית במוצרי Firebase הבאים: Firebase A/B Testing,‏ Cloud Messaging,‏ Crashlytics,‏ In-App Messaging ו-Remote Config (כולל התאמה אישית).

בוחרים חשבון Google Analytics קיים או יוצרים חשבון חדש. אם יוצרים חשבון חדש, בוחרים את מיקום הדיווח של Analytics, מאשרים את הגדרות שיתוף הנתונים ומסכימים לתנאים של Google Analytics בפרויקט.

תמיד אפשר להגדיר את Google Analytics מאוחר יותר בכרטיסייה Integrations ב Project settings.
לוחצים על Create project.

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

פרויקט קיים ב-Cloud

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

נכנסים למסוף Firebase באמצעות החשבון שנותן גישה לפרויקט הקיים ב-Google Cloud.
לוחצים על הכפתור כדי ליצור פרויקט חדש ב-Firebase.
בתחתית הדף, לוחצים על Add Firebase to Google Cloud project.
בשדה הטקסט, מתחילים להזין את שם הפרויקט הקיים ובוחרים את הפרויקט מהרשימה שמוצגת.
לוחצים על פתיחת הפרויקט.
אם מוצגת בקשה, קוראים ומאשרים את התנאים של Firebase ולוחצים על Continue.
(אופציונלי) מפעילים את העזרה מבוססת-AI במסוף Firebase (נקראת Gemini ב-Firebase), שיכולה לעזור לכם להתחיל ולייעל את תהליך הפיתוח.
(אופציונלי) מגדירים את Google Analytics לפרויקט, כדי לאפשר חוויית שימוש אופטימלית במוצרי Firebase הבאים: Firebase A/B Testing,‏ Cloud Messaging,‏ Crashlytics,‏ In-App Messaging ו-Remote Config (כולל התאמה אישית).

בוחרים חשבון Google Analytics קיים או יוצרים חשבון חדש. אם יוצרים חשבון חדש, בוחרים את מיקום הדיווח של Analytics, מאשרים את הגדרות שיתוף הנתונים ומסכימים לתנאים של Google Analytics בפרויקט.

תמיד אפשר להגדיר את Google Analytics מאוחר יותר בכרטיסייה Integrations ב Project settings.
לוחצים על הוספת Firebase.

‫Firebase מוסיף את Firebase לפרויקט הקיים. בסיום התהליך, תועברו לדף הסקירה הכללית של הפרויקט ב-Firebase במסוף Firebase.

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

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

נכנסים למסוף Firebase.
במרכז דף הסקירה הכללית של הפרויקט, לוחצים על סמל Android () או על Add app כדי להפעיל את תהליך ההגדרה.
מזינים את שם החבילה של האפליקציה בשדה שם החבילה ב-Android.
מה זה שם חבילה ואיפה מוצאים אותו?
- שם החבילה הוא המזהה הייחודי של האפליקציה במכשיר ובחנות Google Play.
- שם החבילה נקרא לעיתים קרובות מזהה האפליקציה.
- מוצאים את שם החבילה של האפליקציה בקובץ Gradle של המודול (ברמת האפליקציה), בדרך כלל app/build.gradle (שם חבילה לדוגמה: com.yourcompany.yourproject).
- חשוב לזכור שהערך של שם החבילה הוא תלוי אותיות רישיות (case-sensitive), ואי אפשר לשנות אותו באפליקציית Android ב-Firebase אחרי שרושמים אותה בפרויקט ב-Firebase.
חשוב להזין את שם החבילה שבו האפליקציה משתמשת בפועל. הערך של שם החבילה הוא תלוי אותיות רישיות (case-sensitive), ואי אפשר לשנות אותו באפליקציית Firebase ל-Android אחרי שרושמים אותה בפרויקט Firebase.
(אופציונלי) מזינים כינוי לאפליקציה, שהוא מזהה פנימי שמוצג רק לכם במסוף Firebase.
לוחצים על Register app.

שלב 4: מוסיפים את קובץ התצורה של Firebase

לוחצים על Download google-services.json כדי לקבל את קובץ התצורה של Firebase ל-Android.
מה צריך לדעת על קובץ התצורה הזה?
- קובץ התצורה של Firebase מכיל מזהים ייחודיים, אבל לא סודיים, של הפרויקט והאפליקציה. מידע נוסף על קובץ התצורה הזה זמין במאמר הסבר על פרויקטים ב-Firebase.
- תמיד אפשר להוריד שוב את קובץ התצורה של Firebase.
- חשוב לוודא ששם קובץ התצורה לא כולל תווים נוספים, כמו (2).
פותחים את פרויקט ה-C++‎ בסביבת פיתוח משולבת (IDE) ומוסיפים את קובץ התצורה לפרויקט:
- ‫Gradle builds – מוסיפים את קובץ התצורה לאותה ספרייה שבה נמצא קובץ build.gradle ברמה העליונה.
- מערכות build אחרות – עיינו בקטע מערכות build בהתאמה אישית בהמשך כדי ליצור משאבי מחרוזות ל-Android.

(רק גרסאות build של Gradle) כדי להפעיל את שירותי Firebase בפרויקט C++‎, מוסיפים את הפלאגין של שירותי Google ל-Gradle לקובץ build.gradle ברמה העליונה.

מוסיפים כללים כדי לכלול את הפלאגין של Gradle לשירותי Google. מוודאים שגם מאגר 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.5.0'  // Google services Gradle plugin
      implementation 'com.google.android.gms:18.11.1'
    }
  }

  allprojects {
    // ...

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
      // ...
    }
  }

מפעילים את הפלאגין של שירותי Google ל-Gradle:

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

  android {
    // ...
  }

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

שלב 5: מוסיפים את ערכות Firebase C++ SDK

השלבים בקטע הזה הם דוגמה להוספת מוצרי Firebase נתמכים לפרויקט Firebase C++‎.

מורידים את Firebase C++ SDK, ואז מחלצים את קובצי ה-SDK למיקום נוח.

ערכת ה-SDK של Firebase C++ לא ספציפית לפלטפורמה, אבל היא מכילה ספריות ספציפיות לפלטפורמה.
בקובץ gradle.properties של הפרויקט, מציינים את המיקום של ה-SDK שחולץ:
```
systemProp.firebase_cpp_sdk.dir=full-path-to-SDK
```

מוסיפים את התוכן הבא לקובץ 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"

מוסיפים את התוכן הבא לקובץ Gradle של המודול (ברמת האפליקציה, בדרך כלל app/build.gradle).
כוללים את יחסי התלות של הספרייה למוצרי Firebase שבהם רוצים להשתמש באפליקציה.

‫Analytics מופעל

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
}

‫Analytics לא מופעל

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
}

מוסיפים את התוכן הבא לקובץ CMakeLists.txt של הפרויקט.
כוללים את הספריות של מוצרי Firebase שבהם רוצים להשתמש באפליקציה.

‫Analytics מופעל

# 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}")

‫Analytics לא מופעל

# 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}")

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

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

הכול מוכן! אפליקציית ה-C++‎ שלכם רשומה ומוגדרת לשימוש בשירותי Firebase.

(חלופה אופציונלית) שימוש ב-ndk-build כדי להוסיף ערכות SDK

מוודאים שמותקנת גרסה v10d ואילך של Android NDK.
מורידים את Firebase C++ SDK ומחלצים את הקבצים למיקום נוח.

‫Firebase C++ SDK לא ספציפי לפלטפורמה, אבל הוא מכיל ספריות ספציפיות לפלטפורמה.
פותחים את הקובץ ב-local.properties ואז:
- מגדירים את המשתנה firebase_cpp_sdk.dir למיקום של קובץ ה-ZIP שחולץ של Firebase C++ SDK.
- מגדירים את המשתנה ndk.dir למיקום של Android NDK.

כדי להשתמש בתמיכה המובנית של Gradle ב-ndkBuild, יוצרים ספריית jni בתוך הספרייה ברמה העליונה, ואז יוצרים את קובצי ה-make הבאים.

יוצרים קובץ 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

יוצרים קובץ 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)

פותחים את קובץ ה-build.gradle ברמה העליונה ומבצעים את הפעולות הבאות:

מוסיפים את יחסי התלות של מוצרי Firebase שבהם רוצים להשתמש. לדוגמה, כדי להשתמש ב-Analytics:
```
dependencies {
  implementation 'com.google.firebase:firebase-analytics:21.0.0'
}
```

מוסיפים את השורות הבאות כדי שהפרויקט ישתמש בתמיכה המובנית של Gradle ב-ndk-build, כדי לכלול את ספריות 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 ברמה העליונה.

חשוב: כל גרסה של ה-SDK של Firebase C++ מוצמדת לגרסאות ספציפיות של Firebase Android SDK לכל מודול. אם מעדכנים את הגרסה של ה-SDK של Firebase C++, צריך לוודא שגם הגרסאות של Firebase Android SDK שמצוינות בקובץ build.gradle תואמות למספרי הגרסאות שבהמשך.

אין יותר צורך להוסיף את ספריית Android‏ com.google.firebase:firebase-core. ה-SDK הזה כלל את Firebase SDK עבור Google Analytics. עכשיו, כדי להשתמש ב-Analytics (או בכל אחד ממוצרי Firebase שדורשים או ממליצים להשתמש ב-Analytics), צריך להוסיף באופן מפורש את התלות ב-Analytics: com.google.firebase:firebase-analytics:21.0.0.

מוצר של Firebase	ספריות ופריטים בקשרי תלות
Analytics	`libfirebase_analytics.a` (חובה) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
App Check	`libfirebase_app_check.a` (חובה) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-appcheck:17.0.0'`
Authentication	`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'`
Cloud Functions	`libfirebase_functions.a` (חובה) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-functions:20.1.0'`
Cloud Messaging	`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'`
Cloud Storage	`libfirebase_storage.a` (חובה) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-storage:20.0.1'`
Realtime Database	`libfirebase_database.a` (חובה) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-database:20.0.5'`
Remote Config	`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'`
ספריות שהוצאו משימוש או שלא נתמכות
Dynamic Links	`libfirebase_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'`

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

מידע נוסף על ספריות Firebase ב-C++‎ זמין במאמרי העזרה ובגרסת ה-SDK בקוד פתוח ב-GitHub.

ספריות זמינות ל-Android (באמצעות CMake)

שימו לב שספריות C++‎ לפלטפורמות של אפל מפורטות בגרסת הפלטפורמות של אפל (iOS+) של דף ההגדרה הזה.

מוצר של Firebase	הפניות לספרייה (`firebaseCpp.dependencies` לקובץ `build.gradle`)	הפניות לספרייה (`firebase_libs` לקובץ `CMakeLists.txt`)
Analytics	`analytics`	`firebase_analytics` (חובה) `firebase_app`
App Check	`appCheck`	`firebase_app_check` (חובה) `firebase_app`
Authentication	`auth`	`firebase_auth` (חובה) `firebase_app`
Cloud Firestore	`firestore`	`firebase_firestore` (חובה) `firebase_auth` (חובה) `firebase_app`
Cloud Functions	`functions`	`firebase_functions` (חובה) `firebase_app`
Cloud Messaging	`messaging`	`firebase_messaging` (מומלץ) `firebase_analytics` (חובה) `firebase_app`
Cloud Storage	`storage`	`firebase_storage` (חובה) `firebase_app`
Realtime Database	`database`	`firebase_database` (חובה) `firebase_app`
Remote Config	`remoteConfig`	`firebase_remote_config` (מומלץ) `firebase_analytics` (חובה) `firebase_app`
ספריות שהוצאו משימוש או שלא נתמכות
Dynamic Links	`dynamicLinks`	`firebase_dynamic_links` (מומלץ) `firebase_analytics` (חובה) `firebase_app`

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

קבלת דוחות קריסה של NDK

ב-Firebase Crashlytics יש תמיכה בדיווח על קריסות של אפליקציות שמשתמשות בספריות Native של Android. מידע נוסף זמין במאמר קבלת דוחות קריסה של Android NDK.

מערכות build בהתאמה אישית

ב-Firebase יש את הסקריפט generate_xml_from_google_services_json.py להמרת משאבי google-services.json למשאבי .xml שאפשר לכלול בפרויקט. הסקריפט הזה מחיל את אותה טרנספורמציה שמבצע הפלאגין של Google Play Services ל-Gradle כשמפתחים אפליקציות ל-Android.

אם אתם לא משתמשים ב-Gradle (לדוגמה, אתם משתמשים ב-ndk-build, ב-makefiles, ב-Visual Studio וכו'), אתם יכולים להשתמש בסקריפט הזה כדי להפוך את היצירה של משאבי מחרוזות ב-Android לאוטומטית.

ProGuard

בהרבה מערכות פיתוח ל-Android משתמשים ב-ProGuard לפיתוחים במצב Release כדי להקטין את גודל האפליקציה ולהגן על קוד המקור ב-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 Services

ברוב ספריות Firebase C++‎ נדרשת התקנה של Google Play Services במכשיר Android של הלקוח. אם ספריית Firebase C++‎ מחזירה את הערך kInitResultFailedMissingDependency במהלך ההפעלה, המשמעות היא ש-Google Play Services לא זמינה במכשיר הלקוח (כלומר, צריך לעדכן אותה, להפעיל אותה מחדש, לתקן את ההרשאות וכו'). אי אפשר להשתמש בספריית Firebase עד שהמצב במכשיר הלקוח יתוקן.

כדי לברר למה חבילת Google Play Services לא זמינה במכשיר הלקוח (ולנסות לתקן את הבעיה), אפשר להשתמש בפונקציות שב-google_play_services/availability.h.

בטבלה הבאה מפורט אם נדרש Google Play Services במכשיר לקוח לכל מוצר נתמך של Firebase.

ספריית Firebase C++‎	האם נדרשת חבילת Google Play Services במכשיר הלקוח?
Analytics	לא חובה
Authentication	חובה
Cloud Firestore	חובה
Cloud Functions	חובה
Cloud Messaging	חובה
Cloud Storage	חובה
Dynamic Links	חובה
Realtime Database	חובה
Remote Config	חובה

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

כשיוצרים משחק, בדרך כלל הרבה יותר קל לבדוק אותו קודם בפלטפורמות למחשב, ואז לפרוס ולבדוק אותו במכשירים ניידים בשלב מאוחר יותר של הפיתוח. כדי לתמוך בתהליך העבודה הזה, אנחנו מספקים קבוצת משנה של ערכות ה-SDK של Firebase C++ שיכולות לפעול ב-Windows, ב-macOS, ב-Linux ומתוך עורך C++‎.

בתהליכי עבודה במחשב, צריך לבצע את הפעולות הבאות:
1. מגדירים את פרויקט ה-C++‎ ל-CMake.
2. יצירת פרויקט ב-Firebase
3. רושמים את האפליקציה (iOS או Android) ב-Firebase
4. הוספת קובץ תצורה של Firebase לפלטפורמה לנייד
יוצרים גרסה של קובץ התצורה של Firebase שמתאימה למחשב:
- אם הוספתם את הקובץ google-services.json ל-Android – כשמפעילים את האפליקציה, Firebase מאתר את הקובץ הזה של הנייד ויוצר באופן אוטומטי קובץ תצורה של Firebase למחשב (google-services-desktop.json).
- אם הוספתם את הקובץ GoogleService-Info.plist ל-iOS – לפני שמפעילים את האפליקציה, צריך להמיר את הקובץ הזה ל-נייד לקובץ תצורה של Firebase למחשב. כדי להמיר את הקובץ, מריצים את הפקודה הבאה מאותה ספרייה שבה נמצא הקובץ GoogleService-Info.plist:
```
generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist
```
קובץ התצורה הזה למחשב מכיל את מזהה הפרויקט ב-C++‎ שהזנתם בתהליך העבודה להגדרת מסוף Firebase. מידע נוסף על קובצי תצורה זמין במאמר הסבר על פרויקטים ב-Firebase.
מוסיפים את ערכות ה-SDK של Firebase לפרויקט ב-C++‎.

השלבים הבאים הם דוגמה להוספה של כל מוצר נתמך של Firebase לפרויקט ב-C++‎. בדוגמה הזו, אנחנו מסבירים איך להוסיף את Firebase Authentication ו-Firebase Realtime Database.
1. מגדירים את משתנה הסביבה FIREBASE_CPP_SDK_DIR למיקום של קובץ ה-ZIP שחולץ של 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}")
```
מפעילים את אפליקציית ה-C++‎.

ספריות זמינות (במחשב)

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

מוצר של Firebase	הפניות לספרייה (באמצעות CMake)
App Check	`firebase_app_check` (חובה) `firebase_app`
Authentication	`firebase_auth` (חובה) `firebase_app`
Cloud Firestore	`firebase_firestore` `firebase_auth` `firebase_app`
Cloud Functions	`firebase_functions` (חובה) `firebase_app`
Cloud Storage	`firebase_storage` (חובה) `firebase_app`
Realtime Database	`firebase_database` (חובה) `firebase_app`
Remote Config	`firebase_remote_config` (חובה) `firebase_app`

כדי שיהיה נוח יותר לפתח ל-Windows, ל-macOS ול-Linux, ‏ Firebase מספקת את שאר הספריות למחשב כהטמעות של stub (לא פונקציונליות). לכן, אין צורך להדר קוד באופן מותנה כדי לטרגט למחשב.

מחשב Realtime Database

ערכת ה-SDK של Realtime Database למחשב משתמשת ב-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
App Check	`advapi32, ws2_32, crypt32`
Authentication	`advapi32, ws2_32, crypt32`
Cloud Firestore	`advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32`
Cloud Functions	`advapi32, ws2_32, crypt32, rpcrt4, ole32`
Cloud Storage	`advapi32, ws2_32, crypt32`
Realtime Database	`advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv`
Remote Config	`advapi32, ws2_32, crypt32, rpcrt4, ole32`

ספריות macOS

ב-macOS (Darwin), גרסאות הספרייה מסופקות לפלטפורמת 64 ביט (x86_64). אנחנו מספקים גם מסגרות עבודה לנוחותכם.

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

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

ספריית מערכת אחת (pthread)
‫CoreFoundation macOS system framework
‫Foundation macOS system framework
‫Security macOS system framework
‫GSS macOS system framework
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, עקבו אחרי לוח הבקרה Usage and billing במסוף Firebase.
- עיינו ברשימת המשימות להשקה של Firebase.

הוספת Firebase לפרויקט C++ קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

משתמשים חדשים ב-Firebase או ב-Cloud

פרויקט קיים ב-Cloud

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

שלב 4: מוסיפים את קובץ התצורה של Firebase

שלב 5: מוסיפים את ערכות Firebase C++ SDK

‫Analytics מופעל

‫Analytics לא מופעל

‫Analytics מופעל

‫Analytics לא מופעל

(חלופה אופציונלית) שימוש ב-ndk-build כדי להוסיף ערכות SDK

ספריות זמינות ל-Android (באמצעות ndk-build)

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

ספריות זמינות ל-Android (באמצעות CMake)

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

קבלת דוחות קריסה של NDK

מערכות build בהתאמה אישית

ProGuard

דרישה לגבי Google Play Services

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

ספריות זמינות (במחשב)

מחשב Realtime Database

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

ספריות של Windows

ספריות macOS

ספריות Linux

השלבים הבאים

הוספת Firebase לפרויקט C++