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

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

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

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

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


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

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

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

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

    • 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 للحصول على ملف إعداد منصات Apple في Firebase.

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

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

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

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

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

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

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

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

    1. أنشئ ملف Podfile إذا لم يكن لديك ملف: 

      cd your-app-directory
       
      pod init

    2. أضِف مجموعات الإعلانات المتسلسلة في Firebase التي تريد استخدامها في تطبيقك إلى ملف Podfile.

      تم تفعيل Analytics 

      # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'
      
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

      لم يتم تفعيل Analytics 

      # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

    3. ثبِّت مجموعات Pods، ثم افتح ملف .xcworkspace في Xcode. 

      pod install
       
      open your-app.xcworkspace

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

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

    1. أضِف إطار عمل Firebase C++‎‏ firebase.framework، وهو مطلوب لاستخدام أي منتج من منتجات Firebase.

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

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

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

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

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

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

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

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

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

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

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

منتج Firebase أُطر العمل وPods
Analytics (مطلوب) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '13.0.0'
App Check (مطلوب) firebase.framework
firebase_app_check.framework

pod 'FirebaseAppCheck', '13.0.0'
Authentication (مطلوب) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '13.0.0'
Cloud Firestore (مطلوب) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '13.0.0'
pod 'FirebaseAuth', '13.0.0'
Cloud Functions (مطلوب) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '13.0.0'
Cloud Messaging (مطلوبة) firebase.framework
firebase_messaging.framework
(يُنصح بها) firebase_analytics.framework

pod 'FirebaseMessaging', '13.0.0'
(يُنصح بها) pod 'FirebaseAnalytics', '13.0.0'
Cloud Storage (مطلوب) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '13.0.0'
Realtime Database (مطلوب) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '13.0.0'
Remote Config (مطلوبة) firebase.framework
firebase_remote_config.framework
(يُنصح بها) firebase_analytics.framework

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

pod 'FirebaseDynamicLinks', '13.0.0'
(يُنصح بها) pod 'FirebaseAnalytics', '13.0.0'

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

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

على نظام التشغيل 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) لـ C++ Firebase التي تم فك ضغطها.

    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 بمشروعك. يُرجى الرجوع إلى مستندات برنامج التجميع لمزيد من المعلومات. إذا كنت تستخدم الإصدار 5 من GCC أو إصدارًا أحدث، حدِّد -D_GLIBCXX_USE_CXX11_ABI=0.

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