Firebase Cloud Messaging (FCM) هو حلّ مراسلة متوافق مع جميع المنصات يتيح لك إرسال
الرسائل بشكل موثوق.
باستخدام FCM، يمكنك إشعار تطبيق العميل بأنّه أصبح بإمكانه مزامنة رسائل إلكترونية جديدة أو بيانات أخرى. يمكنك إرسال رسائل إشعار لزيادة تفاعل المستخدمين و
الاحتفاظ بهم. في حالات الاستخدام، مثل المراسلة الفورية، يمكن أن تنقل الرسالة حمولة ملف شخصي بحجم يصل إلى 4096 بايت إلى تطبيق العميل.
اطّلِع على نظرة عامة على البنية للحصول على مزيد من التفاصيل والمعلومات العميقة
حول مكوّنات FCM.
مسار التنفيذ
إعداد حزمة تطوير البرامج (SDK) من FCM
إعداد Firebase وFCM في تطبيقك وفقًا لتعليمات الإعداد الخاصة بمنصتك
تطوير تطبيق العميل
أضِف معالجة الرسائل أو منطق الاشتراك في المواضيع أو ميزات تكميلية أخرى
إلى تطبيق العميل. وخلال مرحلة التطوير، يمكنك بسهولة
إرسال رسائل اختبارية من
أداة إنشاء الإشعارات.
تطوير خادم التطبيقات
حدِّد ما إذا كنت تريد استخدام بروتوكول
Firebase Admin SDK أو بروتوكول الخادم لإنشاء منطق الرسائل المُرسَلة، وهو المنطق المخصّص للمصادقة وإنشاء طلبات الإرسال ومعالجة الردود وما إلى ذلك. بعد ذلك، يمكنك إنشاء المنطق في بيئتك الموثوق بها.
الخطوات التالية
شغِّل نموذج البدء السريع
لنظام التشغيل Android أو iOS. تتيح لك هذه النماذج تنفيذ الرمز ومراجعته لإرسال رسالة اختبارية
إلى جهاز واحد باستخدام وحدة تحكّم Firebase.
إعداد بيئة موثوق بها لإنشاء طلبات الرسائل وإرسالها
يمكنك كتابة منطق الإرسال باستخدام
حزمة SDK للمشرف، و
نشر هذا الرمز بسهولة على Cloud Functions for Firebase أو غيرها من أنظمة المعالجة المُشغّلة على السحابة المتوفّرة في Google.
وبدلاً من ذلك، يمكنك إجراء تطوير الخادم باستخدام
بروتوكول خادم "مراسلة Firebase من Google".
تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Firebase Cloud Messaging \nplat_ios plat_android plat_web plat_flutter plat_cpp plat_unity \nFirebase Cloud Messaging (FCM) is a cross-platform messaging solution that lets you reliably send\nmessages. \nUsing FCM, you can notify a client app that new email or other data is available to sync. You can send notification messages to drive user re-engagement and retention. For use cases such as instant messaging, a message can transfer a payload of up to 4096 bytes to a client app.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nReady to get started? Choose your platform:\n\n[iOS+](/docs/cloud-messaging/ios/client)\n[Android](/docs/cloud-messaging/android/client)\n[Web](/docs/cloud-messaging/js/client)\n[Flutter](/docs/cloud-messaging/flutter/client)\n\n[Unity](/docs/cloud-messaging/unity/client)\n[C++](/docs/cloud-messaging/cpp/client)\n\nKey capabilities\n\n|---------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Send notification messages or data messages | Send notification messages that are displayed to your user. Or send data messages and determine completely what happens in your application code. See [Message types](/docs/cloud-messaging/concept-options#notifications_and_data_messages). |\n| Versatile message targeting | Distribute messages to your client app in any of 3 ways---to single devices, to groups of devices, or to devices subscribed to topics. |\n\nHow does it work?\n\n\u003cbr /\u003e\n\nAn FCM implementation includes two main components for\nsending and receiving:\n\n1. A trusted environment such as Cloud Functions for Firebase or an app server on which to build, target, and send messages.\n2. An Apple, Android, or web (JavaScript) client app that receives messages via the corresponding platform-specific transport service.\n\n\u003cbr /\u003e\n\nYou can send messages via\nthe [Firebase Admin SDK](/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm) or the\n[FCM server protocol](/docs/cloud-messaging/server#choose).\nYou can use [the Notifications composer](//console.firebase.google.com/project/_/notification) for testing and to send marketing or engagement\nmessages using powerful built-in targeting and analytics or custom\n[imported segments](/docs/projects/import-segments).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nSee the [architectural\noverview](/docs/cloud-messaging/fcm-architecture) for more detail and important\ninformation about the components of FCM.\n\n\u003cbr /\u003e\n\nImplementation path\n\n|---|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Set up the FCM SDK | Set up Firebase and FCM on your app according to the setup instructions for your platform. |\n| | Develop your client app | Add message handling, topic subscription logic, or other optional features to your client app. During the development, you can easily send test messages from [the Notifications composer](//console.firebase.google.com/project/_/notification). |\n| | Develop your app server | Decide whether you want to use the Firebase Admin SDK or the server protocol to create your sending logic---logic to authenticate, build send requests, handle responses, and so on. Then build out the logic in your trusted environment. |\n\nNext steps\n\n- Run the [Android](https://github.com/firebase/quickstart-android/tree/master/messaging)\n or [iOS](https://github.com/firebase/quickstart-ios/tree/master/messaging/)\n Quickstart sample. These samples let you run and review code to send a test\n message to a single device using the Firebase console.\n\n- Learn more about FCM from the\n [architecture overview](/docs/cloud-messaging/fcm-architecture),\n guides to key [FCM concepts](/docs/cloud-messaging/concept-options),\n and best practices guides for [sending messages at scale](/docs/cloud-messaging/scale-fcm)\n and [managing registration tokens](/docs/cloud-messaging/manage-tokens).\n\n- Try the tutorials for [Android](/docs/cloud-messaging/android/first-message)\n or [iOS](/docs/cloud-messaging/ios/first-message).\n\n- Add Firebase Cloud Messaging to your\n [Android](/docs/cloud-messaging/android/client),\n [Apple](/docs/cloud-messaging/ios/client),\n or [Web](/docs/cloud-messaging/js/client) app.\n\n- Set up your trusted environment where you'll build and send message requests.\n You can write sending logic using the\n [Admin SDK](/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm), and\n readily deploy that code on Cloud Functions for Firebase or other cloud\n environments managed by Google.\n Alternatively, you can perform server development using the\n [FCM server protocol](/docs/cloud-messaging/server#choose)."]]
