इस पेज का अनुवाद Cloud Translation API से किया गया है.

अपने C++ प्रोजेक्ट में Firebase जोड़ें

हमारे फायरबेस सी++ एसडीके के साथ अपने सी++ गेम्स को सशक्त बनाएं जो आईओएस और एंड्रॉइड के लिए फायरबेस के शीर्ष पर एक सी ++ इंटरफेस प्रदान करते हैं।

किसी भी प्लेटफ़ॉर्म-देशी कोड को लिखे बिना, अपने C++ कोड से पूरी तरह से Firebase तक पहुंचें। फायरबेस एसडीके फायरबेस द्वारा उपयोग किए जाने वाले कई भाषा-विशिष्ट मुहावरों का एक इंटरफ़ेस में अनुवाद करता है जो सी ++ डेवलपर्स के लिए अधिक परिचित है।

हमारे फायरबेस गेम पेज पर फायरबेस के साथ अपने गेम को सशक्त बनाने के बारे में अधिक जानकारी प्राप्त करें।

आपके C++ प्रोजेक्ट में पहले से ही Firebase जोड़ा गया है? सुनिश्चित करें कि आप Firebase C++ SDK के नवीनतम संस्करण का उपयोग कर रहे हैं।

इस गाइड में प्लेटफ़ॉर्म-विशिष्ट निर्देश प्रदर्शित करने के लिए नीचे एक प्लेटफ़ॉर्म टैब चुनें।

यदि आप अपने गेम को आईओएस और एंड्रॉइड दोनों प्लेटफॉर्म पर रिलीज कर रहे हैं: आप अभी अपने सी ++ प्रोजेक्ट का एक बिल्ड लक्ष्य पंजीकृत कर सकते हैं, फिर बाद में अन्य बिल्ड लक्ष्य को भी पंजीकृत करने के लिए सेटअप वर्कफ़्लो पर वापस आ सकते हैं।

आवश्यक शर्तें

अपना पसंदीदा संपादक या IDE इंस्टॉल करें, जैसे Android Studio, IntelliJ, या VS कोड।
एंड्रॉइड एसडीके प्राप्त करें।
सुनिश्चित करें कि आपकी परियोजना इन आवश्यकताओं को पूरा करती है:
- लक्ष्य API स्तर 19 (किटकैट) या उच्चतर
- ग्रैडल का उपयोग करता है और सीएमके के साथ कॉन्फ़िगर किया गया है
एक भौतिक उपकरण सेट करें या अपना ऐप चलाने के लिए एक एमुलेटर का उपयोग करें।
- एमुलेटर को Google Play के साथ एक एमुलेटर इमेज का उपयोग करना चाहिए।
- कुछ C++ लाइब्रेरी के लिए, क्लाइंट डिवाइस पर Google Play सेवाओं की आवश्यकता होती है; इस पृष्ठ पर सूची की समीक्षा करें ।
अपने Google खाते का उपयोग करके Firebase में साइन इन करें ।

चरण 2 : एक फायरबेस प्रोजेक्ट बनाएं

अपने C++ प्रोजेक्ट में Firebase जोड़ने से पहले, आपको अपने C++ प्रोजेक्ट से कनेक्ट करने के लिए एक Firebase प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएं।

एक फायरबेस प्रोजेक्ट बनाएं

फायरबेस कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें।
- किसी मौजूदा Google क्लाउड प्रोजेक्ट में Firebase संसाधन जोड़ने के लिए, उसका प्रोजेक्ट नाम दर्ज करें या ड्रॉपडाउन मेनू से उसका चयन करें।
- एक नया प्रोजेक्ट बनाने के लिए, वांछित प्रोजेक्ट नाम दर्ज करें। आप वैकल्पिक रूप से प्रोजेक्ट नाम के नीचे प्रदर्शित प्रोजेक्ट आईडी को संपादित भी कर सकते हैं।
  आपके द्वारा दिए गए नाम के आधार पर Firebase आपके Firebase प्रोजेक्ट के लिए एक अद्वितीय आईडी बनाता है। अगर आप इस प्रोजेक्ट आईडी को संपादित करना चाहते हैं, तो आपको इसे अभी करना होगा क्योंकि आपके प्रोजेक्ट के लिए फायरबेस प्रावधान संसाधनों के बाद इसे बदला नहीं जा सकता है। Firebase प्रोजेक्ट आईडी का उपयोग कैसे करता है, इस बारे में जानने के लिए Firebase प्रोजेक्ट्स को समझें पर जाएं.
संकेत मिलने पर, Firebase शर्तों की समीक्षा करें और उन्हें स्वीकार करें.
जारी रखें पर क्लिक करें।

(वैकल्पिक) अपने प्रोजेक्ट के लिए Google Analytics सेट करें, जो आपको निम्न में से किसी भी Firebase उत्पादों का उपयोग करके एक इष्टतम अनुभव प्राप्त करने में सक्षम बनाता है:

या तो कोई मौजूदा Google Analytics खाता चुनें या एक नया खाता बनाएं.

यदि आप एक नया खाता बनाते हैं, तो अपना Analytics रिपोर्टिंग स्थान चुनें, फिर अपने प्रोजेक्ट के लिए डेटा साझाकरण सेटिंग और Google Analytics शर्तें स्वीकार करें।

प्रोजेक्ट बनाएं पर क्लिक करें (या अगर आप किसी मौजूदा Google क्लाउड प्रोजेक्ट का उपयोग कर रहे हैं तो Firebase जोड़ें )।

Firebase स्वचालित रूप से आपके Firebase प्रोजेक्ट के लिए संसाधनों का प्रावधान करता है। जब प्रक्रिया पूरी हो जाती है, तो आपको Firebase कंसोल में अपने Firebase प्रोजेक्ट के अवलोकन पृष्ठ पर ले जाया जाएगा।

चरण 3 : अपने ऐप को Firebase के साथ पंजीकृत करें

अपने Android ऐप्लिकेशन में Firebase का उपयोग करने के लिए, आपको अपने ऐप्लिकेशन को अपने Firebase प्रोजेक्ट के साथ पंजीकृत करना होगा. अपने ऐप को पंजीकृत करने को अक्सर अपने प्रोजेक्ट में अपने ऐप को "जोड़ना" कहा जाता है।

फायरबेस कंसोल पर जाएं।
प्रोजेक्ट ओवरव्यू पेज के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए Android आइकन ( ) या ऐप जोड़ें पर क्लिक करें।
Android पैकेज नाम फ़ील्ड में अपने ऐप का पैकेज नाम दर्ज करें।
पैकेज का नाम क्या है, और आप इसे कहां ढूंढते हैं?
- पैकेज का नाम डिवाइस पर और Google Play Store में आपके ऐप की विशिष्ट रूप से पहचान करता है।
- पैकेज नाम को अक्सर एप्लिकेशन आईडी के रूप में संदर्भित किया जाता है।
- अपने मॉड्यूल (ऐप-लेवल) ग्रैडल फ़ाइल में अपने ऐप के पैकेज का नाम खोजें, आमतौर पर app/build.gradle (उदाहरण पैकेज का नाम: com.yourcompany.yourproject )।
- ध्यान रखें कि पैकेज नाम का मान केस-संवेदी होता है, और आपके Firebase प्रोजेक्ट के साथ पंजीकृत होने के बाद इसे इस Firebase Android ऐप के लिए बदला नहीं जा सकता है।
उस पैकेज का नाम दर्ज करना सुनिश्चित करें जिसका उपयोग आपका ऐप वास्तव में कर रहा है। पैकेज का नाम मान केस-संवेदी है, और आपके Firebase प्रोजेक्ट के साथ पंजीकृत होने के बाद इसे इस Firebase Android ऐप के लिए बदला नहीं जा सकता है।
(वैकल्पिक) अन्य ऐप जानकारी दर्ज करें: ऐप उपनाम और डीबग हस्ताक्षर प्रमाणपत्र SHA-1 ।
Firebase में ऐप्लिकेशन का प्रचलित नाम और डीबग साइनिंग प्रमाणपत्र SHA-1 का इस्तेमाल कैसे किया जाता है?
- ऐप का प्रचलित नाम : एक आंतरिक, सुविधा पहचानकर्ता जो केवल आपको Firebase कंसोल में दिखाई देता है
- डिबग साइनिंग सर्टिफिकेट SHA-1 : फायरबेस ऑथेंटिकेशन ( Google साइन इन या फोन नंबर साइन इन का उपयोग करते समय) और फायरबेस डायनेमिक लिंक्स द्वारा SHA-1 हैश की आवश्यकता होती है।
रजिस्टर ऐप पर क्लिक करें।

चरण 4 : फायरबेस कॉन्फ़िगरेशन फ़ाइल जोड़ें

अपनी Firebase Android कॉन्फ़िग फ़ाइल प्राप्त करने के लिए google-services.json डाउनलोड करें पर क्लिक करें।
इस कॉन्फ़िग फ़ाइल के बारे में आपको क्या जानने की ज़रूरत है?
- फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता हैं। इस कॉन्फ़िग फ़ाइल के बारे में अधिक जानने के लिए, फायरबेस प्रोजेक्ट्स को समझें पर जाएं।
- आप अपनी Firebase कॉन्फ़िग फ़ाइल को किसी भी समय फिर से डाउनलोड कर सकते हैं।
- सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों के साथ नहीं जोड़ा गया है, जैसे (2) ।
एक IDE में अपना C++ प्रोजेक्ट खोलें, फिर अपनी कॉन्फ़िग फ़ाइल को अपने प्रोजेक्ट में जोड़ें:
- ग्रैडल बिल्ड — अपनी कॉन्फिग फाइल को उसी डायरेक्टरी में जोड़ें, जिसमें आपकी टॉप-लेवल build.gradle फाइल है।
- अन्य बिल्ड सिस्टम — Android स्ट्रिंग संसाधन उत्पन्न करने के लिए नीचे कस्टम बिल्ड सिस्टम देखें।

(केवल ग्रैडल बिल्ड करता है) अपने C++ प्रोजेक्ट में Firebase सेवाओं को सक्षम करने के लिए, अपनी शीर्ष-स्तरीय build.gradle फ़ाइल में google-services प्लगइन जोड़ें।

Google Services Gradle प्लग इन को शामिल करने के लिए नियम जोड़ें। जांचें कि आपके पास 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.3.10'  // Google Services plugin
      implementation 'com.google.android.gms:18.0.1'
    }
  }

  allprojects {
    // ...

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

Google सेवाएं ग्रैडल प्लगइन लागू करें:

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

  android {
    // ...
  }

आपने Firebase कंसोल में सेट अप कार्य पूर्ण कर लिए हैं। नीचे Firebase C++ SDK जोड़ना जारी रखें।

चरण 5 : Firebase C++ SDK जोड़ें

इस अनुभाग में दिए गए चरण इस बात का उदाहरण हैं कि आपके Firebase C++ प्रोजेक्ट में समर्थित Firebase उत्पादों को कैसे जोड़ा जाए।

फायरबेस सी++ एसडीके डाउनलोड करें, फिर एसडीके को किसी सुविधाजनक स्थान पर अनज़िप करें।
फायरबेस सी ++ एसडीके प्लेटफॉर्म-विशिष्ट नहीं है, लेकिन इसमें प्लेटफॉर्म-विशिष्ट पुस्तकालय शामिल हैं।
अपने प्रोजेक्ट की 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"

अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल (आमतौर पर app/build.gradle ) में, निम्न सामग्री जोड़ें।
उन Firebase उत्पादों के लिए लाइब्रेरी निर्भरताएं शामिल करें जिनका आप अपने ऐप्लिकेशन में उपयोग करना चाहते हैं।

एनालिटिक्स सक्षम

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
}

एनालिटिक्स सक्षम नहीं है

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 उत्पादों के लिए लाइब्रेरी शामिल करें जिनका आप अपने ऐप्लिकेशन में उपयोग करना चाहते हैं.

एनालिटिक्स सक्षम

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

एनालिटिक्स सक्षम नहीं है

# 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 सत्यापन प्रदर्शित करेंगे कि आरंभीकरण पूरा हो गया है। अगर आपने अपना ऐप किसी ऐसे एमुलेटर पर चलाया है जिसके पास नेटवर्क एक्सेस है, तो फायरबेस कंसोल आपको सूचित करता है कि आपका ऐप कनेक्शन पूरा हो गया है।

तुम सब सेट हो! आपका C++ ऐप फ़ायरबेस सेवाओं का उपयोग करने के लिए पंजीकृत और कॉन्फ़िगर किया गया है।

(वैकल्पिक विकल्प) एसडीके जोड़ने के लिए एनडीके-बिल्ड का उपयोग करें

सुनिश्चित करें कि आपके पास Android NDK v10d या बाद का संस्करण है।
फायरबेस सी++ एसडीके डाउनलोड करें, फिर एसडीके को किसी सुविधाजनक स्थान पर अनज़िप करें।
फायरबेस सी ++ एसडीके प्लेटफॉर्म-विशिष्ट नहीं है, लेकिन इसमें प्लेटफॉर्म-विशिष्ट पुस्तकालय शामिल हैं।
अपनी local.properties फ़ाइल खोलें, फिर:
- firebase_cpp_sdk.dir वैरिएबल को अनज़िप किए गए Firebase C++ SDK के स्थान पर सेट करें।
- Android NDK के स्थान पर ndk.dir चर सेट करें।

ग्रैडल के बिल्ट-इन 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 उत्पाद की लाइब्रेरी शामिल करें जिनका आप उपयोग करना चाहते हैं. उदाहरण के लिए, एनालिटिक्स का उपयोग करने के लिए:

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 फ़ाइल खोलें, फिर निम्न चरणों को पूरा करें:
1. उन Firebase उत्पादों के लिए निर्भरताएँ जोड़ें जिनका आप उपयोग करना चाहते हैं। उदाहरण के लिए, एनालिटिक्स का उपयोग करने के लिए:
```
dependencies {
  implementation 'com.google.firebase:firebase-analytics:21.0.0'
}
```
2. निम्नलिखित पंक्तियाँ जोड़ें ताकि आपका प्रोजेक्ट आपकी jni/Android.mk फ़ाइल में निर्दिष्ट Firebase पुस्तकालयों को शामिल करने के लिए Gradle के अंतर्निर्मित ndk-build समर्थन का उपयोग करे।
```
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)
        }
    }
}
```

एंड्रॉइड के लिए उपलब्ध पुस्तकालय (एनडीके-बिल्ड का उपयोग करके)

प्रत्येक Firebase उत्पाद की अलग-अलग निर्भरताएँ होती हैं। उन Firebase उत्पादों के लिए सभी सूचीबद्ध निर्भरताएं जोड़ना सुनिश्चित करें जिनका आप उपयोग करना चाहते हैं।

Firebase C++ लाइब्रेरी (जैसे libfirebase_app.a ) को शीर्ष-स्तरीय jni/Android.mk फ़ाइल में शामिल करके जोड़ें। अन्य निर्भरता के लिए (जैसे com.google.firebase:firebase-auth ), उन्हें अपनी शीर्ष-स्तरीय build.gradle फ़ाइल में जोड़ें।

महत्वपूर्ण: फायरबेस सी ++ एसडीके की प्रत्येक रिलीज को प्रत्येक मॉड्यूल के लिए विशिष्ट फायरबेस एंड्रॉइड एसडीके संस्करणों में पिन किया गया है। अगर आप Firebase C++ SDK के अपने संस्करण को अपडेट करते हैं, तो नीचे दिए गए संस्करण संख्याओं से मेल खाने के लिए अपनी build.gradle फ़ाइल में संदर्भित Firebase Android SDK संस्करणों को भी अपडेट करना सुनिश्चित करें।

अब आपको Android लाइब्रेरी com.google.firebase:firebase-core जोड़ने की आवश्यकता नहीं है। इस SDK में Google Analytics के लिए Firebase SDK शामिल है। अब, Analytics का उपयोग करने के लिए (या ऐसे किसी भी Firebase उत्पाद जिन्हें Analytics के उपयोग की आवश्यकता है या अनुशंसा करते हैं), आपको स्पष्ट रूप से Analytics निर्भरता जोड़नी होगी: com.google.firebase:firebase-analytics:21.0.0 ।

फायरबेस उत्पाद	पुस्तकालय और निर्भरता
AdMob	`libfirebase_admob.a` (आवश्यक) `libfirebase_analytics.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-ads:19.8.0'` (आवश्यक) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
एनालिटिक्स	`libfirebase_analytics.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
प्रमाणीकरण	`libfirebase_auth.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-auth:21.0.3'`
क्लाउड फायरस्टोर	`libfirebase_firestore.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-firestore:24.1.2'`
बादल कार्य	`libfirebase_functions.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-functions:20.1.0'`
क्लाउड मैसेजिंग	`libfirebase_messaging.a` (अनुशंसित) `libfirebase_analytics.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-messaging:23.0.4'` (अनुशंसित) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
घन संग्रहण	`libfirebase_storage.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-storage:20.0.1'`
गतिशील लिंक	`ibfirebase_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'`
रीयलटाइम डेटाबेस	`libfirebase_database.a` (आवश्यक) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-database:20.0.5'`
रिमोट कॉन्फिग	`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'`

उपलब्ध पुस्तकालय

संदर्भ दस्तावेज़ में C++ Firebase लाइब्रेरी के बारे में और GitHub पर हमारे ओपन-सोर्स SDK रिलीज़ में और जानें।

एंड्रॉइड के लिए उपलब्ध पुस्तकालय (सीएमके का उपयोग करके)

ध्यान दें कि iOS के लिए C++ लाइब्रेरी इस सेटअप पेज के iOS संस्करण में सूचीबद्ध हैं।

फायरबेस उत्पाद	पुस्तकालय संदर्भ ( `firebaseCpp.dependencies` `build.gradle` फ़ाइल के लिए)	पुस्तकालय संदर्भ ( `firebase_libs` `CMakeLists.txt` फ़ाइल के लिए)
AdMob	`admob`	`firebase_admob` (आवश्यक) `firebase_analytics` (आवश्यक) `firebase_app`
एनालिटिक्स	`analytics`	`firebase_analytics` (आवश्यक) `firebase_app`
प्रमाणीकरण	`auth`	`firebase_auth` (आवश्यक) `firebase_app`
क्लाउड फायरस्टोर	`firestore`	`firebase_firestore` (आवश्यक) `firebase_auth` (आवश्यक) `firebase_app`
बादल कार्य	`functions`	`firebase_functions` (आवश्यक) `firebase_app`
क्लाउड मैसेजिंग	`messaging`	`firebase_messaging` (अनुशंसित) `firebase_analytics` (आवश्यक) `firebase_app`
घन संग्रहण	`storage`	`firebase_storage` (आवश्यक) `firebase_app`
गतिशील लिंक	`dynamicLinks`	`firebase_dynamic_links` (अनुशंसित) `firebase_analytics` (आवश्यक) `firebase_app`
रीयलटाइम डेटाबेस	`database`	`firebase_database` (आवश्यक) `firebase_app`
रिमोट कॉन्फिग	`remoteConfig`	`firebase_remote_config` (अनुशंसित) `firebase_analytics` (आवश्यक) `firebase_app`

मोबाइल सेटअप के लिए अतिरिक्त जानकारी

एनडीके क्रैश रिपोर्ट प्राप्त करें

Firebase Crashlytics Android मूल पुस्तकालयों का उपयोग करने वाले ऐप्स के लिए क्रैश रिपोर्टिंग का समर्थन करता है। अधिक जानने के लिए, Android NDK क्रैश रिपोर्ट प्राप्त करें देखें।

कस्टम बिल्ड सिस्टम

Firebase google-services.json को .xml संसाधनों में बदलने के लिए generate_xml_from_google_services_json.py स्क्रिप्ट प्रदान करता है जिसे आप अपने प्रोजेक्ट में शामिल कर सकते हैं। यह स्क्रिप्ट उसी परिवर्तन को लागू करती है जो Google Play सेवाएं ग्रैडल प्लगइन एंड्रॉइड एप्लिकेशन बनाते समय करता है।

यदि आप ग्रैडल का उपयोग करके निर्माण नहीं करते हैं (उदाहरण के लिए, आप ndk-build, Makefiles, Visual Studio, आदि का उपयोग करते हैं), तो आप Android String Resources की पीढ़ी को स्वचालित करने के लिए इस स्क्रिप्ट का उपयोग कर सकते हैं।

प्रोगार्ड

कई Android बिल्ड सिस्टम एप्लिकेशन आकार को छोटा करने और Java स्रोत कोड की सुरक्षा के लिए रिलीज़ मोड में बिल्ड के लिए ProGuard का उपयोग करते हैं।

यदि आप ProGuard का उपयोग करते हैं, तो आपको अपने ProGuard कॉन्फ़िगरेशन में उपयोग की जा रही Firebase C++ लाइब्रेरी के अनुरूप libs/android/*.pro में फ़ाइलें जोड़नी होंगी।

उदाहरण के लिए, ग्रैडल के साथ, यदि आप 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 सेवाओं की आवश्यकता

अधिकांश फायरबेस सी ++ पुस्तकालयों के लिए क्लाइंट के एंड्रॉइड डिवाइस पर Google Play सेवाओं की आवश्यकता होती है। यदि कोई Firebase C++ लाइब्रेरी प्रारंभ होने पर kInitResultFailedMissingDependency लौटाती है, तो इसका अर्थ है कि क्लाइंट डिवाइस पर Google Play सेवाएं उपलब्ध नहीं हैं (जिसका अर्थ है कि इसे अद्यतन करने, पुनः सक्रिय करने, अनुमतियां तय करने आदि की आवश्यकता है)। जब तक क्लाइंट डिवाइस पर स्थिति ठीक नहीं हो जाती, तब तक Firebase लाइब्रेरी का उपयोग नहीं किया जा सकता है।

आप google_play_services/availability.h में फ़ंक्शन का उपयोग करके पता लगा सकते हैं कि क्लाइंट डिवाइस पर Google Play सेवाएं अनुपलब्ध क्यों हैं (और इसे ठीक करने का प्रयास करें)।

निम्न तालिका सूचीबद्ध करती है कि प्रत्येक समर्थित फ़ायरबेस उत्पाद के लिए क्लाइंट डिवाइस पर Google Play सेवाओं की आवश्यकता है या नहीं।

फायरबेस सी++ लाइब्रेरी	क्लाइंट डिवाइस पर Google Play सेवाएं आवश्यक हैं?
AdMob	आवश्यक नहीं (आमतौर पर)
एनालिटिक्स	की जरूरत नहीं है
प्रमाणीकरण	आवश्यक
क्लाउड फायरस्टोर	आवश्यक
बादल कार्य	आवश्यक
क्लाउड मैसेजिंग	आवश्यक
घन संग्रहण	आवश्यक
गतिशील लिंक	आवश्यक
रीयलटाइम डेटाबेस	आवश्यक
रिमोट कॉन्फिग	आवश्यक

AdMob और Google Play सेवाएं

Android के लिए Google मोबाइल विज्ञापन SDK के अधिकांश संस्करण क्लाइंट डिवाइस पर Google Play सेवाओं के बिना ठीक से काम कर सकते हैं। हालांकि, यदि आप ऊपर सूचीबद्ध मानक com.google.firebase:firebase-ads निर्भरता के बजाय com.google.android.gms:play-services-ads-lite निर्भरता का उपयोग कर रहे हैं, तो Google Play सेवाएं आवश्यक हैं ।

AdMob इनिशियलाइज़ेशन केवल kInitResultFailedMissingDependency , जब निम्नलिखित दोनों सत्य होंगे:

क्लाइंट डिवाइस पर Google Play सेवाएं उपलब्ध नहीं हैं।
आप com.google.android.gms:play-services-ads-lite का उपयोग कर रहे हैं।

डेस्कटॉप वर्कफ़्लो सेट करें ( बीटा )

जब आप कोई गेम बना रहे होते हैं, तो पहले डेस्कटॉप प्लेटफॉर्म पर अपने गेम का परीक्षण करना, फिर बाद में विकास में मोबाइल डिवाइस पर परिनियोजित करना और परीक्षण करना बहुत आसान हो जाता है। इस वर्कफ़्लो का समर्थन करने के लिए, हम फायरबेस सी ++ एसडीके का एक सबसेट प्रदान करते हैं जो विंडोज़, मैकोज़, लिनक्स और सी ++ संपादक के भीतर से चल सकता है।

डेस्कटॉप वर्कफ़्लोज़ के लिए, आपको निम्नलिखित को पूरा करना होगा:
1. CMake के लिए अपना C++ प्रोजेक्ट कॉन्फ़िगर करें।
2. एक फायरबेस प्रोजेक्ट बनाएं
3. Firebase के साथ अपना ऐप्लिकेशन (iOS या Android) पंजीकृत करें
4. मोबाइल-प्लेटफ़ॉर्म Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ें
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 कंसोल सेटअप वर्कफ़्लो में दर्ज किया है। कॉन्फिग फाइलों के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएं।
अपने सी++ प्रोजेक्ट में फायरबेस एसडीके जोड़ें।
नीचे दिए गए चरण इस बात के उदाहरण के रूप में काम करते हैं कि आपके C++ प्रोजेक्ट में किसी समर्थित Firebase उत्पाद को कैसे जोड़ा जाए। इस उदाहरण में, हम Firebase प्रमाणीकरण और Firebase रीयलटाइम डेटाबेस को जोड़कर चलते हैं।
1. अपने FIREBASE_CPP_SDK_DIR पर्यावरण चर को अनज़िप किए गए Firebase C++ SDK के स्थान पर सेट करें।
2. अपने प्रोजेक्ट की CMakeLists.txt फ़ाइल में, निम्न सामग्री जोड़ें, जिसमें 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}")
```
अपना सी ++ ऐप चलाएं।

उपलब्ध पुस्तकालय (डेस्कटॉप)

Firebase C++ SDK में सुविधाओं के सबसेट के लिए डेस्कटॉप वर्कफ़्लो समर्थन शामिल है, जिससे Firebase के कुछ हिस्सों को Windows, macOS और Linux पर स्टैंडअलोन डेस्कटॉप बिल्ड में उपयोग करने में सक्षम बनाता है।

फायरबेस उत्पाद	पुस्तकालय संदर्भ (सीएमके का उपयोग करके)
प्रमाणीकरण	`firebase_auth` (आवश्यक) `firebase_app`
क्लाउड फायरस्टोर	`firebase_firestore` `firebase_auth` `firebase_app`
बादल कार्य	`firebase_functions` (आवश्यक) `firebase_app`
घन संग्रहण	`firebase_storage` (आवश्यक) `firebase_app`
रीयलटाइम डेटाबेस	`firebase_database` (आवश्यक) `firebase_app`
रिमोट कॉन्फिग	`firebase_remote_config` (आवश्यक) `firebase_app`

फायरबेस विंडोज, मैकओएस और लिनक्स के निर्माण के दौरान सुविधा के लिए शेष डेस्कटॉप लाइब्रेरी को स्टब (गैर-कार्यात्मक) कार्यान्वयन के रूप में प्रदान करता है। इसलिए, आपको डेस्कटॉप को लक्षित करने के लिए सशर्त रूप से कोड संकलित करने की आवश्यकता नहीं है।

रीयलटाइम डेटाबेस डेस्कटॉप

डेस्कटॉप के लिए रीयलटाइम डेटाबेस एसडीके आपके डेटाबेस तक पहुंचने के लिए आरईएसटी का उपयोग करता है, इसलिए आपको डेस्कटॉप पर Query::OrderByChild() के साथ उपयोग किए जाने वाले इंडेक्स घोषित करना होगा या आपके श्रोता विफल हो जाएंगे।

डेस्कटॉप सेटअप के लिए अतिरिक्त जानकारी

विंडोज़ पुस्तकालय

विंडोज के लिए, पुस्तकालय संस्करण निम्नलिखित के आधार पर प्रदान किए जाते हैं:

प्लेटफ़ॉर्म बनाएँ: 32-बिट (x86) बनाम 64-बिट (x64) मोड
विंडोज रनटाइम एनवायरनमेंट: मल्टीथ्रेडेड / एमटी बनाम मल्टीथ्रेडेड डीएलएल / एमडी
लक्ष्य: रिलीज बनाम डीबग

ध्यान दें कि विजुअल स्टूडियो 2015 और 2017 का उपयोग करके निम्नलिखित पुस्तकालयों का परीक्षण किया गया था।

विंडोज़ पर सी ++ डेस्कटॉप ऐप्स बनाते समय, निम्न विंडोज़ एसडीके पुस्तकालयों को अपने प्रोजेक्ट से लिंक करें। अधिक जानकारी के लिए अपने कंपाइलर दस्तावेज़ीकरण से परामर्श लें।

फायरबेस सी++ लाइब्रेरी	विंडोज एसडीके पुस्तकालय निर्भरता
प्रमाणीकरण	`advapi32, ws2_32, crypt32`
क्लाउड फायरस्टोर	`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 (डार्विन) के लिए, 64-बिट (x86_64) प्लेटफॉर्म के लिए लाइब्रेरी संस्करण उपलब्ध कराए गए हैं। आपकी सुविधा के लिए फ्रेमवर्क भी उपलब्ध कराए गए हैं।

ध्यान दें कि macOS लाइब्रेरी का परीक्षण Xcode 13.3.1 का उपयोग करके किया गया है।

macOS पर C++ डेस्कटॉप ऐप बनाते समय, निम्नलिखित को अपने प्रोजेक्ट से लिंक करें:

pthread सिस्टम लाइब्रेरी
CoreFoundation मैकओएस सिस्टम फ्रेमवर्क
Foundation macOS सिस्टम फ्रेमवर्क
Security macOS सिस्टम फ्रेमवर्क
GSS macOS सिस्टम फ्रेमवर्क
Kerberos macOS सिस्टम फ्रेमवर्क
SystemConfiguration macOS सिस्टम फ्रेमवर्क

अधिक जानकारी के लिए अपने कंपाइलर दस्तावेज़ीकरण से परामर्श लें।

लिनक्स पुस्तकालय

लिनक्स के लिए, 32-बिट (i386) और 64-बिट (x86_64) प्लेटफॉर्म के लिए लाइब्रेरी संस्करण प्रदान किए गए हैं।

ध्यान दें कि उबंटू पर जीसीसी 4.8.0, जीसीसी 7.2.0 और क्लैंग 5.0 का उपयोग करके लिनक्स पुस्तकालयों का परीक्षण किया गया था।

Linux पर C++ डेस्कटॉप ऐप्स बनाते समय, pthread सिस्टम लाइब्रेरी को अपने प्रोजेक्ट से लिंक करें। अधिक जानकारी के लिए अपने कंपाइलर दस्तावेज़ीकरण से परामर्श लें। यदि आप GCC 5 या बाद के संस्करण के साथ निर्माण कर रहे हैं, -D_GLIBCXX_USE_CXX11_ABI=0 परिभाषित करें।

अगले कदम

नमूना Firebase ऐप्लिकेशन एक्सप्लोर करें.
गिटहब में ओपन सोर्स एसडीके का अन्वेषण करें।
अपना ऐप लॉन्च करने की तैयारी करें:
- Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट करें।
- अनेक Firebase सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए Firebase कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
- फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।