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

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

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

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

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


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

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

    • ‫Xcode 26.2 أو إصدار أحدث
    • الإصدار 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) الخاصة بلغة C++ في Firebase أدناه.

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

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

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

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

  2. أضِف حِزم Firebase من حزمة SDK التي تم فك ضغطها.

    1. أنشِئ Podfile في حال عدم توفّره: 

      cd your-app-directory
       
      pod init

    2. أضِف إلى ملف Podfile حِزم Firebase التي تريد استخدامها في تطبيقك.

      تم تفعيل 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. ثبِّت وحدات Pod، ثم افتح الملف .xcworkspace في Xcode. 

      pod install
       
      open your-app.xcworkspace

  3. أضِف أُطر Firebase من حزمة SDK التي تم فك ضغطها.

    أسهل طريقة لإضافة هذه الأُطر هي عادةً سحبها من نافذة Finder مباشرةً إلى جزء مستكشف المشروع في 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pod 'FirebaseDynamicLinks', '12.19.0'
(يُنصح به) pod 'FirebaseAnalytics', '12.19.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