إضافة Firebase إلى مشروع C++ الخاص بك

يمكنك تعزيز أداء ألعابك المصمّمة بلغة C++‎ باستخدام حِزم تطوير البرامج (SDK) المصمّمة بلغة C++‎ من Firebase والتي توفّر واجهة C++‎ بالإضافة إلى حِزم تطوير البرامج (SDK) من Firebase.

يمكنك الوصول إلى Firebase بالكامل من خلال رمز C++‎، بدون الحاجة إلى كتابة أي رمز برمجي أصلي للنظام الأساسي. تترجم حزمة Firebase SDK أيضًا العديد من المصطلحات الخاصة باللغة التي تستخدمها Firebase إلى واجهة مألوفة أكثر لمطوّري C++‎.

يمكنك الاطّلاع على مزيد من المعلومات حول تحسين ألعابك باستخدام Firebase في صفحة ألعاب Firebase.

هل سبق لك إضافة Firebase إلى مشروع C++‎؟ تأكَّد من استخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لـ Firebase C++.


المتطلبات الأساسية

  • ثبِّت ما يلي:

    • الإصدار 26.2 من Xcode أو الإصدارات الأحدث

  • تأكَّد من أنّ مشروعك يستهدف إصدارات المنصات التالية أو الإصدارات الأحدث:

    • iOS 15
    • tvOS 15

  • اضبط جهازًا فعليًا أو استخدِم المحاكي لتشغيل تطبيقك.

  • سجِّل الدخول إلى 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.

  2. افتح مشروع C++‎ في بيئة تطوير متكاملة (IDE)، ثم اسحب ملف الإعداد إلى جذر مشروع C++‎.

  3. إذا طُلب منك ذلك، اختَر إضافة ملف الإعداد إلى جميع الأهداف.

لقد انتهيت من مهام الإعداد في وحدة تحكّم Firebase. انتقِل إلى قسم إضافة حِزم تطوير البرامج (SDK) لـ Firebase C++‎ أدناه.

الخطوة 5: إضافة حِزم تطوير البرامج (SDK) لـ Firebase C++‎

الخطوات الواردة في هذا القسم هي مثال على كيفية إضافة منتجات Firebase المتوافقة إلى مشروع Firebase C++‎.

  1. نزِّل حزمة تطوير البرامج (SDK) لـ Firebase C++، ثم فُكّ ضغطها في مكان مناسب.

    لا تقتصر حزمة تطوير البرامج (SDK) لـ Firebase C++ على نظام أساسي معيّن، ولكنّها تحتوي على مكتبات خاصة بأنظمة أساسية معيّنة.

  2. استخدِم Swift Package Manager لتثبيت وإدارة التبعيات الخاصة بحزمة تطوير البرامج (SDK) لمنصات Apple من Firebase.

    1. في Xcode، افتح مشروع تطبيقك، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).

    2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple من Firebase:

      https://github.com/firebase/firebase-ios-sdk.git

    3. بالنسبة إلى قاعدة الاعتمادية، اختَر الإصدار الدقيق وأدخِل 13.1.1.

    4. اختَر مكتبات Firebase التي تريد استخدامها في تطبيقك (على سبيل المثال، FirebaseAuth وFirebaseDatabase). إذا كانت خدمة Google Analytics مفعَّلة في مشروع Firebase، تأكَّد من إضافة FirebaseAnalytics.

    بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

  3. أضِف XCFrameworks من Firebase من دليل xcframeworks لحزمة تطوير البرامج (SDK) التي تم فك ضغطها.

    أسهل طريقة لإضافة حِزم XCFrameworks هذه هي عادةً سحبها من نافذة Finder مباشرةً إلى لوحة Project Navigator في Xcode (اللوحة في أقصى اليمين تلقائيًا، أو انقر على رمز الملف في أعلى يمين Xcode) وإضافتها إلى هدف الإصدار في تطبيقك.

    1. أضِف حزمة Firebase C++ XCFramework firebase.xcframework، وهي مطلوبة لاستخدام أيّ من منتجات Firebase.

    2. أضِف XCFramework لكل منتج من منتجات Firebase تريد استخدامه. على سبيل المثال، لاستخدام Firebase Authentication، أضِف firebase_auth.xcframework.

  4. بالعودة إلى وحدة تحكّم Firebase، في سير عمل الإعداد، انقر على التالي.

  5. إذا أضفت Analytics، شغِّل تطبيقك لإرسال إثبات إلى Firebase بأنّك دمجت Firebase بنجاح. بخلاف ذلك، يمكنك تخطي خطوة التحقق هذه.

    ستعرض سجلات جهازك عملية التحقق من Firebase التي اكتملت عملية التهيئة. إذا شغّلت تطبيقك على محاكي لديه إمكانية الوصول إلى الشبكة، ستعلمك وحدة تحكّم Firebase بأنّ عملية ربط تطبيقك قد اكتملت.

اكتملت عملية الإعداد. تم تسجيل تطبيق C++‎ وإعداده لاستخدام منتجات Firebase.

المكتبات المتاحة

يمكنك الاطّلاع على مزيد من المعلومات حول مكتبات Firebase بلغة C++‎ في المستندات المرجعية وفي إصدار حزمة تطوير البرامج (SDK) المفتوحة المصدر على GitHub.

المكتبات المتاحة لمنصات Apple

يُرجى العِلم أنّ مكتبات C++‎ لنظام التشغيل Android مُدرَجة في إصدار Android من صفحة الإعداد هذه.

لكل منتج من منتجات Firebase تبعيات مختلفة. احرص على إضافة جميع التبعيات المدرَجة لمنتج Firebase المحدّد باستخدام Swift Package Manager وفي مشروع C++‎.

قد يتيح كل منتج من منتجات Firebase مجموعة محدّدة من أنظمة تشغيل Apple (مثل iOS وtvOS وما إلى ذلك). يمكنك الاطّلاع على المنصات المتوافقة مع كل مكتبة في مزيد من المعلومات حول C++‎ وFirebase.

منتج Firebase مكتبات XCFrameworks وSwift Package Manager
Analytics (مطلوب) firebase.xcframework
firebase_analytics.xcframework

FirebaseAnalytics (13.1.1)
App Check (مطلوب) firebase.xcframework
firebase_app_check.xcframework

FirebaseAppCheck (13.1.1)
Authentication (مطلوب) firebase.xcframework
firebase_auth.xcframework

FirebaseAuth (13.1.1)
Cloud Firestore (مطلوب) firebase.xcframework
firebase_firestore.xcframework
firebase_auth.xcframework

FirebaseFirestore (13.1.1)
FirebaseAuth (13.1.1)
Cloud Functions (مطلوب) firebase.xcframework
firebase_functions.xcframework

FirebaseFunctions (13.1.1)
Cloud Messaging (مطلوب) firebase.xcframework
firebase_messaging.xcframework
(يُنصح به) firebase_analytics.xcframework

FirebaseMessaging (13.1.1)
(يُنصح به) FirebaseAnalytics (13.1.1)
Cloud Storage (مطلوب) firebase.xcframework
firebase_storage.xcframework

FirebaseStorage (13.1.1)
Realtime Database (مطلوب) firebase.xcframework
firebase_database.xcframework

FirebaseDatabase (13.1.1)
Remote Config (مطلوب) firebase.xcframework
firebase_remote_config.xcframework
(يُنصح به) firebase_analytics.xcframework

FirebaseRemoteConfig (13.1.1)
(يُنصح به) FirebaseAnalytics (13.1.1)
المكتبات المتوقفة نهائيًا أو غير المتوافقة
Dynamic Links (مطلوب) firebase.xcframework
firebase_dynamic_links.xcframework
(يُنصح به) firebase_analytics.xcframework

FirebaseDynamicLinks (13.1.1)
(يُنصح به) FirebaseAnalytics (13.1.1)

معلومات إضافية حول الإعداد على الأجهزة الجوّالة

الدمج بدون استخدام Swift Package Manager

إذا كنت لا تريد استخدام Swift Package Manager لإدارة تبعيات حزمة تطوير البرامج (SDK) الأساسية لمنصات Firebase Apple، يُرجى الاطّلاع على الدمج بدون استخدام Swift Package Manager في دليل إعداد منصات Apple للحصول على خيارات دمج بديلة.

تغيير وظيفة الإجراء

على نظام التشغيل iOS، تتطلّب بعض أحداث التطبيق (مثل فتح عناوين URL وتلقّي الإشعارات) أن ينفّذ مفوَّض التطبيق طرقًا معيّنة. على سبيل المثال، قد يتطلّب تلقّي إشعار أن ينفّذ مفوَّض تطبيقك application:didReceiveRemoteNotification:. بما أنّ كل تطبيق iOS له مفوَّض خاص به، تستخدم Firebase ميزة تغيير وظيفة الإجراء التي تتيح استبدال إجراء بآخر، وذلك لإرفاق معالِجاتها الخاصة بالإضافة إلى أي معالِجات قد تكون نفّذتها.

تحتاج مكتبتا Dynamic Links وCloud Messaging إلى إرفاق معالِجات بمفوَّض التطبيق باستخدام ميزة تغيير وظيفة الإجراء. إذا كنت تستخدم أيًا من منتجات Firebase هذه، ستتعرّف Firebase عند التحميل على فئة AppDelegate وتستبدل الطرق المطلوبة بها، مع ربط طلب معاودة الاتصال بتنفيذ الطريقة الحالية.

إعداد سير عمل على الكمبيوتر المكتبي (إصدار تجريبي)

عند إنشاء لعبة، غالبًا ما يكون من الأسهل اختبارها على أنظمة تشغيل أجهزة الكمبيوتر المكتبي أولاً، ثم نشرها واختبارها على الأجهزة الجوّالة في مرحلة لاحقة من عملية التطوير. ولدعم سير العمل هذا، نقدّم مجموعة فرعية من حِزم تطوير البرامج (SDK) لـ Firebase C++ التي يمكن تشغيلها على أنظمة التشغيل Windows وmacOS وLinux ومن داخل محرِّر C++‎.

  1. بالنسبة إلى مسارات العمل على أجهزة الكمبيوتر المكتبي، عليك إكمال ما يلي:

    1. اضبط مشروع C++‎ لاستخدام CMake.
    2. إنشاء مشروع على Firebase
    3. تسجيل تطبيقك (iOS أو Android) في Firebase
    4. إضافة ملف إعداد Firebase لمنصة الأجهزة الجوّالة

  2. أنشئ نسخة لأجهزة الكمبيوتر من ملف إعداد Firebase:

    • في حال إضافة ملف google-services.json لنظام التشغيل Android: عند تشغيل تطبيقك، يحدّد 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. انتقِل إلى مقالة فهم مشاريع Firebase لمعرفة المزيد عن ملفات الإعداد.

  3. أضِف حزم تطوير البرامج (SDK) لمنصة 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++‎.

المكتبات المتاحة (على الكمبيوتر المكتبي)

تتضمّن حزمة تطوير البرامج (SDK) لـ Firebase C++ دعمًا لسير العمل على أجهزة الكمبيوتر المكتبي لمجموعة فرعية من الميزات، ما يتيح استخدام أجزاء معيّنة من 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

تستخدم حزمة تطوير البرامج (SDK) لـ Realtime Database على أجهزة الكمبيوتر المكتبي REST للوصول إلى قاعدة بياناتك، لذا عليك تعريف الفهارس التي تستخدمها مع Query::OrderByChild() على أجهزة الكمبيوتر المكتبي وإلا ستتعطّل أدوات الاستماع.

معلومات إضافية حول الإعداد على الكمبيوتر المكتبي

مكتبات Windows

بالنسبة إلى نظام التشغيل Windows، يتم توفير إصدارات المكتبة استنادًا إلى ما يلي:

  • النظام الأساسي للإصدار: وضع 32 بت (x86) مقابل وضع 64 بت (x64)
  • بيئة تشغيل Windows: سلاسل تعليمات متعددة / MT مقابل مكتبة الربط الديناميكي لسلاسل التعليمات المتعددة / MD
  • الهدف: الإصدار مقابل تصحيح الأخطاء

يُرجى العِلم أنّه تم اختبار المكتبات التالية باستخدام Visual Studio 2015 و2017.

عند إنشاء تطبيقات C++‎ متوافقة مع أجهزة الكمبيوتر المكتبي على نظام التشغيل Windows، اربط مكتبات حزمة تطوير البرامج (SDK) التالية لنظام التشغيل Windows بمشروعك. يُرجى الرجوع إلى مستندات برنامج التجميع للحصول على مزيد من المعلومات.

مكتبة Firebase C++‎ الاعتماديات الخاصة بمكتبات حِزم تطوير البرامج (SDK) لنظام التشغيل 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)، يتم توفير إصدارات المكتبة للنظام الأساسي 64 بت (x86_64). يتم أيضًا توفير أُطر عمل لتسهيل الأمر عليك.

يُرجى العِلم أنّه تم اختبار مكتبات macOS باستخدام Xcode 26.2.

عند إنشاء تطبيقات C++‎ متوافقة مع أجهزة الكمبيوتر المكتبي على نظام التشغيل macOS، اربط ما يلي بمشروعك:

  • مكتبة نظام واحدة (pthread)
  • إطار عمل نظام macOS واحد (CoreFoundation)
  • إطار عمل نظام macOS واحد (Foundation)
  • إطار عمل نظام macOS واحد (Security)
  • إطار عمل نظام macOS واحد (GSS)
  • إطار عمل نظام macOS واحد (Kerberos)
  • إطار عمل نظام macOS واحد (SystemConfiguration)

يُرجى الرجوع إلى مستندات برنامج التجميع لمزيد من المعلومات.

مكتبات 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.

الخطوات التالية