‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

افزودن Firebase به پروژه C++‎

بازی‌های ++C خود را با کیت‌های توسعه نرم‌افزار Firebase در ++C ما که یک میانای ++C در بالای کیت‌های توسعه نرم‌افزار Firebase ارائه می‌دهند، تقویت کنید.

به‌طور کامل از کد C++‎ خود به Firebase دسترسی داشته باشید، بدون اینکه نیاز به نوشتن هیچ کد بومی پلاتفرم داشته باشید. کیت توسعه نرم‌افزار Firebase همچنین بسیاری از اصطلاحات خاص زبان را که توسط Firebase استفاده می‌شود به رابطی ترجمه می‌کند که برای توسعه‌دهندگان C++‎ آشناتر است.

برای کسب اطلاعات بیشتر درباره تقویت بازی‌هایتان با Firebase، به صفحه بازی‌های Firebase ما مراجعه کنید.

قبلاً Firebase را به پروژه C++‎ خود اضافه کرده‌اید؟ مطمئن شوید که از جدیدترین نسخه Firebase C++ SDK استفاده می‌کنید.

پیش‌نیازها

ویرایشگر یا IDE دلخواهتان را نصب کنید، مثلاً Android Studio،‏ IntelliJ، یا VS Code.
کیت توسعه نرم‌افزار Android را دریافت کنید.
مطمئن شوید پروژه‌تان این الزامات را برآورده می‌کند:
- سطح میانای برنامه‌سازی کاربردی هدف ۲۴ (Nougat) یا بالاتر
- از Gradle استفاده می‌کند و با CMake پیکربندی شده است
دستگاهی فیزیکی راه‌اندازی کنید یا از شبیه‌ساز برای اجرای برنامه‌تان استفاده کنید.
- شبیه‌سازها باید از تصویر شبیه‌ساز با Google Play استفاده کنند.
- برای برخی‌از کتابخانه‌های ++C، «خدمات Google Play» در دستگاه کارخواه لازم است؛ فهرست موجود در این صفحه را مرور کنید.
بااستفاده از حساب Google خود، به سیستم Firebase وارد شوید.

مرحله ۲: ایجاد پروژه Firebase

قبل‌از اینکه بتوانید Firebase را به پروژه C++‎ خود اضافه کنید، باید یک پروژه Firebase ایجاد کنید تا به پروژه C++‎ خود متصل شوید. برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به آشنایی با پروژه‌های Firebase مراجعه کنید.

مشاهده دستورالعمل‌های ایجاد پروژه Firebase

تازه با Firebase یا Cloud آشنا شده‌اید

اگر با Firebase یا Google Cloud آشنایی ندارید، این مراحل را دنبال کنید.
اگر می‌خواهید پروژه Firebase کاملاً جدیدی (و پروژه Google Cloud زیربنایی آن) ایجاد کنید، می‌توانید این مراحل را نیز دنبال کنید.

به سیستم کنسول Firebase وارد شوید.
برای ایجاد پروژه Firebase جدید، روی دکمه کلیک کنید.
در فیلد نوشتاری، نام پروژه را وارد کنید.

اگر عضو سازمان Google Cloud هستید، می‌توانید به‌صورت اختیاری انتخاب کنید که پروژه شما در کدام پوشه ایجاد شود.

نام پروژه شما به‌عنوان نام نمایشی در میاناهای Firebase استفاده می‌شود و Firebase به‌طور خودکار شناسه پروژه منحصربه‌فردی براساس این نام پروژه ایجاد می‌کند. توجه داشته باشید که اکنون می‌توانید به‌صورت اختیاری روی نماد ویرایش کلیک کنید تا شناسه پروژه دلخواهتان را تنظیم کنید، اما نمی‌توانید این شناسه را پس‌از ایجاد پروژه تغییر دهید. درباره نحوه استفاده Firebase از شناسه پروژه بیشتر بدانید.
اگر درخواست شد، شرایط Firebase را مرور و قبول کنید، سپس روی ادامه کلیک کنید.
(اختیاری) کمک هوش مصنوعی را در کنسول 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 را بعداً در برگه «ادغام‌ها» در تنظیمات پروژه راه‌اندازی کنید.
روی ایجاد پروژه کلیک کنید.

Firebase پروژه شما را ایجاد می‌کند، برخی منابع اولیه را فراهم می‌کند، و میاناهای برنامه‌سازی کاربردی مهم را فعال می‌کند. وقتی فرایند تکمیل شد، به صفحه نمای کلی پروژه Firebase خود در کنسول Firebase هدایت می‌شوید.

پروژه Cloud موجود

اگر می‌خواهید استفاده از Firebase را با پروژه Google Cloud موجود شروع کنید، این مراحل را دنبال کنید. درباره «افزودن Firebase» به پروژه Google Cloud موجود بیشتر بدانید و آن را عیب‌یابی کنید.

با حسابی که به شما امکان دسترسی به پروژه Google Cloud موجود را می‌دهد، به سیستم کنسول Firebase وارد شوید.
برای ایجاد پروژه Firebase جدید، روی دکمه کلیک کنید.
در پایین صفحه، روی افزودن Firebase به پروژه Google Cloud کلیک کنید.
در فیلد نوشتاری، نام پروژه موجود را وارد کنید، سپس پروژه را از فهرست نمایش‌داده‌شده انتخاب کنید.
روی باز کردن پروژه کلیک کنید.
اگر درخواست شد، شرایط Firebase را مرور و قبول کنید، سپس روی ادامه کلیک کنید.
(اختیاری) کمک هوش مصنوعی را در کنسول 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 را بعداً در برگه «ادغام‌ها» در تنظیمات پروژه راه‌اندازی کنید.
روی افزودن Firebase کلیک کنید.

Firebase Firebase را به پروژه موجودتان اضافه می‌کند. وقتی فرایند تکمیل شد، به صفحه نمای کلی پروژه Firebase خود در کنسول Firebase هدایت می‌شوید.

مرحله ۳: ثبت برنامه در Firebase

برای استفاده از Firebase در برنامه Android، باید برنامه‌تان را در پروژه Firebase ثبت کنید. ثبت کردن برنامه اغلب «افزودن» برنامه به پروژه نامیده می‌شود.

به کنسول Firebase بروید.
در مرکز صفحه نمای کلی پروژه، روی نماد Android () یا افزودن برنامه کلیک کنید تا گردش کار راه‌اندازی شروع شود.
نام بسته برنامه‌تان را در فیلد نام بسته Android وارد کنید.
نام بسته چیست و کجا آن را پیدا می‌کنید؟
- نام بسته برنامه شما را به‌طور منحصربه‌فرد در دستگاه و در «فروشگاه Google Play» شناسایی می‌کند.
- نام بسته اغلب به‌عنوان شناسه برنامه شناخته می‌شود.
- نام بسته برنامه‌تان را در فایل Gradle (سطح برنامه) واحدتان پیدا کنید، معمولاً app/build.gradle (نام بسته نمونه: com.yourcompany.yourproject).
- توجه داشته باشید که مقدار نام بسته به حروف بزرگ و کوچک حساس است و پس‌از ثبت شدن در پروژه Firebase، نمی‌توان آن را برای این برنامه Android در Firebase تغییر داد.
حتماً نام بسته‌ای را وارد کنید که برنامه‌تان درحال‌حاضر از آن استفاده می‌کند. مقدار نام بسته به حروف بزرگ و کوچک حساس است و پس‌از ثبت شدن در پروژه Firebase، نمی‌توان آن را برای این برنامه Android در Firebase تغییر داد.
(اختیاری) نام مستعار برنامه را وارد کنید که شناسه‌ای داخلی و راحت است و فقط برای شما در کنسول Firebase قابل‌مشاهده است.
روی ثبت برنامه کلیک کنید.

مرحله ۴: افزودن فایل پیکربندی Firebase

روی بارگیری google-services.json کلیک کنید تا فایل پیکربندی Firebase Android را دریافت کنید.
چه چیزی باید درباره این فایل پیکربندی بدانید؟
- فایل پیکربندی Firebase حاوی شناسه‌های یکتا اما غیرمحرمانه برای پروژه و برنامه شما است. برای کسب اطلاعات بیشتر درباره این فایل پیکربندی، به آشنایی با پروژه‌های Firebase مراجعه کنید.
- هرزمان خواستید می‌توانید فایل پیکربندی Firebase را دوباره بارگیری کنید.
- مطمئن شوید که نویسه‌های اضافی، مثل (2)، به نام فایل پیکربندی اضافه نشده باشد.
پروژه C++‎ خود را در IDE باز کنید، سپس فایل پیکربندی خود را به پروژه اضافه کنید:
- ساخت‌های Gradle — فایل پیکربندی‌تان را به همان دایرکتوری فایل build.gradle سطح بالای خود اضافه کنید.
- سایر سیستم‌های ساخت — برای تولید منابع رشته Android، سیستم‌های ساخت سفارشی را در زیر ببینید.

(فقط Gradle builds) برای فعال کردن سرویس‌های Firebase در پروژه C++‎، افزونه Google services 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
      // ...
    }
  }

افزایه Gradle خدمات Google را اعمال کنید:

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

  android {
    // ...
  }

تکالیف راه‌اندازی را در کنسول Firebase انجام داده‌اید. به افزودن کیت‌های توسعه نرم‌افزار Firebase در ++C در زیر بروید.

مرحله ۵: افزودن کیت‌های توسعه نرم‌افزار Firebase در ++C

مراحل این بخش نمونه‌ای از نحوه افزودن محصولات Firebase پشتیبانی‌شده به پروژه Firebase C++‎ شما است.

کیت توسعه نرم‌افزار Firebase C++ را بارگیری کنید، سپس کیت توسعه نرم‌افزار را در جایی مناسب از حالت فشرده خارج کنید.

کیت توسعه نرم‌افزار Firebase C++ مختص پلاتفرم نیست، اما حاوی کتابخانه‌های مختص پلاتفرم است.
در فایل gradle.properties پروژه‌تان، مکان کیت توسعه نرم‌افزار از حالت فشرده خارج‌شده را مشخص کنید:
```
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 برای افزودن کیت‌های توسعه نرم‌افزار

مطمئن شوید که Android NDK نسخه v10d یا جدیدتر را دارید.
Firebase C++ SDK را بارگیری کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.

Firebase C++ SDK مختص پلاتفرم نیست، اما حاوی کتابخانه‌های مختص پلاتفرم است.
فایل local.properties را باز کنید، سپس:
- متغیر firebase_cpp_sdk.dir را روی مکان کیت توسعه نرم‌افزار Firebase C++ از حالت فشرده خارج‌شده تنظیم کنید.
- متغیر ndk.dir را روی مکان Android NDK تنظیم کنید.

برای استفاده از پشتیبانی ndkBuild داخلی Gradle، یک دایرکتوری 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'
}
```

خطوط زیر را اضافه کنید تا پروژه‌تان از پشتیبانی ndk-build داخلی Gradle برای گنجاندن کتابخانه‌های 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 سطح بالا اضافه کنید.

مهم: هر نسخه از کیت توسعه نرم‌افزار Firebase C++ به نسخه‌های خاصی از کیت توسعه نرم‌افزار Firebase Android برای هر واحد سنجاق شده است. اگر نسخه کیت توسعه نرم‌افزار Firebase C++ را به‌روز می‌کنید، حتماً نسخه‌های کیت توسعه نرم‌افزار Firebase Android را که در فایل build.gradle شما به آن‌ها ارجاع داده شده است نیز به‌روز کنید تا با شماره نسخه‌های زیر مطابقت داشته باشند.

دیگر نیازی به افزودن کتابخانه Android com.google.firebase:firebase-core ندارید. این کیت توسعه نرم‌افزار (SDK) شامل کیت توسعه نرم‌افزار Firebase برای 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'`

کتابخانه‌های دردسترس

درباره کتابخانه‌های C++ Firebase در اسناد مرجع و در نسخه کیت توسعه نرم‌افزار متن‌باز ما در GitHub بیشتر بدانید.

کتابخانه‌های دردسترس برای Android (بااستفاده از CMake)

توجه داشته باشید که کتابخانه‌های ++C برای پلاتفرم‌های Apple در نسخه پلاتفرم‌های Apple (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 از گزارش خرابی برای برنامه‌هایی که از کتابخانه‌های بومی Android استفاده می‌کنند پشتیبانی می‌کند. برای اطلاعات بیشتر، دریافت گزارش‌های خرابی Android NDK را ببینید.

سیستم‌های ساخت سفارشی

Firebase اسکریپت generate_xml_from_google_services_json.py را برای تبدیل منابع google-services.json به .xml ارائه می‌دهد که می‌توانید در پروژه‌تان لحاظ کنید. این متن همان تبدیلی را اعمال می‌کند که افزونه Gradle خدمات Google Play هنگام ساختن برنامه‌های Android انجام می‌دهد.

اگر بااستفاده از Gradle نمی‌سازید (برای مثال، از ndk-build، فایل‌های make، Visual Studio، و غیره استفاده می‌کنید)، می‌توانید از این اسکریپت برای خودکارسازی تولید منابع رشته‌ای Android استفاده کنید.

ProGuard

بسیاری از سیستم‌های ساخت Android از ProGuard برای ساخت در حالت «انتشار» استفاده می‌کنند تا اندازه برنامه را کاهش دهند و از کد منبع 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

اکثر کتابخانه‌های Firebase C++‎ نیاز دارند که خدمات Google Play در دستگاه Android مشتری باشد. اگر کتابخانه Firebase C++‎ kInitResultFailedMissingDependency را در مقداردهی اولیه برگرداند، یعنی خدمات Google Play در دستگاه کارخواه دردسترس نیست (یعنی باید به‌روزرسانی شود، دوباره فعال شود، اجازه‌ها اصلاح شود، و غیره). تا زمانی که وضعیت در دستگاه کارخواه اصلاح نشود، نمی‌توان از کتابخانه Firebase استفاده کرد.

بااستفاده از توابع موجود در google_play_services/availability.h می‌توانید دلیل دردسترس نبودن «خدمات Google Play» در دستگاه کارخواه را پیدا کنید (و برای رفع آن تلاش کنید).

جدول زیر نشان می‌دهد که آیا «خدمات Google Play» در دستگاه مشتری برای هر محصول Firebase پشتیبانی‌شده لازم است یا نه.

کتابخانه Firebase C++‎	آیا خدمات Google Play در دستگاه کارخواه لازم است؟
Analytics	الزامی نیست
Authentication	ضروری
Cloud Firestore	ضروری
Cloud Functions	ضروری
Cloud Messaging	ضروری
Cloud Storage	ضروری
Dynamic Links	ضروری
Realtime Database	ضروری
Remote Config	ضروری

راه‌اندازی گردش کار رایانه (نسخه بتا)

وقتی بازی‌ای می‌سازید، اغلب بسیار آسان‌تر است که ابتدا بازی‌تان را در پلاتفرم‌های رایانه آزمایش کنید، سپس در مراحل بعدی توسعه آن را در دستگاه‌های همراه مستقر و آزمایش کنید. برای پشتیبانی از این گردش کار، زیرمجموعه‌ای از کیت‌های توسعه نرم‌افزار Firebase C++ را ارائه می‌دهیم که می‌توانند در Windows،‏ macOS،‏ Linux، و از داخل ویرایشگر ++C اجرا شوند.

برای گردش کار رایانه، باید موارد زیر را تکمیل کنید:
1. پروژه C++‎ خود را برای CMake پیکربندی کنید.
2. ایجاد پروژه Firebase
3. ثبت کردن برنامه (iOS یا Android) در Firebase
4. افزودن فایل پیکربندی Firebase پلاتفرم تلفن همراه
نسخه رایانه فایل پیکربندی Firebase را ایجاد کنید:
- اگر فایل Android google-services.json را اضافه کرده‌اید — وقتی برنامه‌تان را اجرا می‌کنید، 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 مراجعه کنید.
کیت‌های توسعه نرم‌افزار Firebase را به پروژه C++‎ خود اضافه کنید.

مراحل زیر به‌عنوان نمونه‌ای از نحوه افزودن هر محصول Firebase پشتیبانی‌شده به پروژه C++‎ شما ارائه شده است. در این مثال، مراحل افزودن Firebase Authentication و Firebase Realtime Database را توضیح می‌دهیم.
1. متغیر محیطی FIREBASE_CPP_SDK_DIR را روی مکان کیت توسعه نرم‌افزار 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}")
```
برنامه C++‎ خود را اجرا کنید.

کتابخانه‌های دردسترس (رایانه)

Firebase C++ SDK شامل پشتیبانی از گردش کار رایانه برای زیرمجموعه‌ای از ویژگی‌ها است که امکان استفاده از بخش‌های خاصی از Firebase را در ساخت‌های مستقل رایانه در 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`

Firebase بقیه کتابخانه‌های رایانه را به‌صورت پیاده‌سازی‌های تهی (غیرفعال) ارائه می‌دهد تا ساختن برای Windows،‏ macOS، و Linux راحت‌تر شود. بنابراین، لازم نیست کد را به‌صورت شرطی برای هدف قرار دادن رایانه رومیزی کامپایل کنید.

رایانه Realtime Database

Realtime Database SDK برای رایانه از REST برای دسترسی به پایگاه داده شما استفاده می‌کند، بنابراین باید نمایه‌هایی را که با Query::OrderByChild() در رایانه استفاده می‌کنید اعلام کنید، درغیراین‌صورت شنوندگان شما با شکست مواجه خواهند شد.

اطلاعات بیشتر برای راه‌اندازی رایانه

کتابخانه‌های Windows

برای Windows، نسخه‌های کتابخانه براساس موارد زیر ارائه می‌شود:

پلاتفرم ساخت: حالت ۳۲ بیتی (x86) درمقابل ۶۴ بیتی (x64)
محیط زمان اجرای Windows: چندرشته‌ای / MT درمقابل DLL چندرشته‌ای /MD
هدف: Release درمقابل Debug

توجه داشته باشید که کتابخانه‌های زیر بااستفاده از Visual Studio 2015 و 2017 آزمایش شده‌اند.

هنگام ساختن برنامه‌های رایانه‌ای C++‎ در Windows، کتابخانه‌های Windows SDK زیر را به پروژه‌تان پیوند دهید. برای اطلاعات بیشتر، به اسناد کامپایلر خود مراجعه کنید.

کتابخانه Firebase C++‎	وابستگی‌های کتابخانه کیت توسعه نرم‌افزار Windows
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)، نسخه‌های کتابخانه برای پلاتفرم ۶۴ بیتی (x86_64) ارائه می‌شود. چارچوب‌ها نیز برای راحتی شما ارائه شده است.

توجه داشته باشید که کتابخانه‌های macOS بااستفاده از Xcode نسخه ۲۶.۲ آزمایش شده‌اند.

هنگام ساختن برنامه‌های رایانه‌ای C++‎ در macOS، موارد زیر را به پروژه‌تان پیوند دهید:

‫pthread کتابخانه سیستم
CoreFoundation چارچوب سیستم macOS
چارچوب سیستم macOS‏ Foundation
چارچوب سیستم macOS‏ Security
چارچوب سیستم macOS‏ GSS
Kerberos چارچوب سیستم macOS
چارچوب سیستم macOS SystemConfiguration

برای اطلاعات بیشتر، به مستندات کامپایلر خود مراجعه کنید.

کتابخانه‌های Linux

برای Linux، نسخه‌های کتابخانه برای پلاتفرم‌های ۳۲ بیتی (i386) و ۶۴ بیتی (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 را کاوش کنید.
کیت توسعه نرم‌افزار متن‌باز را در GitHub کاوش کنید.
آماده شدن برای راه‌اندازی برنامه:
- هشدارهای بودجه را برای پروژه‌تان در کنسول Google Cloud راه‌اندازی کنید.
- داشبورد استفاده و صورت‌حساب را در کنسول Firebase پایش کنید تا تصویری کلی از استفاده پروژه‌تان در چندین سرویس Firebase به‌دست آورید.
- بازبینه راه‌اندازی Firebase را مرور کنید.

افزودن Firebase به پروژه C++‎ با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیش‌نیازها

مرحله ۲: ایجاد پروژه Firebase

تازه با Firebase یا Cloud آشنا شده‌اید

پروژه Cloud موجود

مرحله ۳: ثبت برنامه در Firebase

مرحله ۴: افزودن فایل پیکربندی Firebase

مرحله ۵: افزودن کیت‌های توسعه نرم‌افزار Firebase در ++C

‫Analytics فعال شد

Analytics فعال نیست

‫Analytics فعال شد

Analytics فعال نیست

(جایگزین اختیاری) استفاده از ndk-build برای افزودن کیت‌های توسعه نرم‌افزار

کتابخانه‌های دردسترس برای Android (بااستفاده از ndk-build)

کتابخانه‌های دردسترس

کتابخانه‌های دردسترس برای Android (بااستفاده از CMake)

اطلاعات تکمیلی برای راه‌اندازی تلفن همراه

دریافت گزارش‌های خرابی NDK

سیستم‌های ساخت سفارشی

ProGuard

الزامات خدمات Google Play

راه‌اندازی گردش کار رایانه (نسخه بتا)

کتابخانه‌های دردسترس (رایانه)

رایانه Realtime Database

اطلاعات بیشتر برای راه‌اندازی رایانه

کتابخانه‌های Windows

کتابخانه‌های macOS

کتابخانه‌های Linux

مراحل بعدی

افزودن Firebase به پروژه C++‎