تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Firebase Cloud Messaging
plat_ios
plat_android
plat_web
plat_flutter
plat_cpp
plat_unity
Firebase Cloud Messaging (FCM) هو حلّ مراسلة متوافق مع جميع المنصات يتيح لك إرسال
الرسائل بشكل موثوق.
باستخدام
FCM، يمكنك إشعار تطبيق العميل بأنّه أصبح بإمكانه مزامنة رسائل إلكترونية جديدة أو بيانات أخرى. يمكنك إرسال رسائل إشعار لزيادة تفاعل المستخدمين و
الاحتفاظ بهم. في حالات الاستخدام، مثل المراسلة الفورية، يمكن أن تنقل الرسالة حمولة ملف شخصي بحجم يصل إلى 4096 بايت إلى تطبيق العميل.
هل أنت مستعد للبدء؟ اختَر النظام الأساسي:
iOS والإصدارات الأحدث
Android
الويب
Flutter
Unity
C++
الإمكانات الرئيسية
| إرسال رسائل إشعار أو رسائل بيانات |
أرسِل رسائل إشعارات يتم عرضها للمستخدم.
أو يمكنك إرسال رسائل بيانات وتحديد ما يحدث تمامًا في
الرمز البرمجي لتطبيقك. راجِع
أنواع الرسائل. |
| استهداف الرسائل بطرق متنوعة |
يمكنك توزيع الرسائل على تطبيق العميل بأيّ من الطرق الثلاث التالية:
على الأجهزة الفردية أو مجموعات الأجهزة أو الأجهزة المشترِكة في المواضيع.
|
كيف تعمل هذه الميزة؟
يتضمّن تنفيذ FCM مكونَين رئيسيَّين ل
الإرسال والاستلام:
- بيئة موثوق بها، مثل Cloud Functions for Firebase أو خادم تطبيق
لإنشاء الرسائل واستهدافها وإرسالها
- تطبيق عميل Apple أو Android أو الويب (JavaScript) الذي يتلقّى
الرسائل من خلال خدمة النقل المخصّصة للمنصة المعنيّة
يمكنك إرسال الرسائل من خلال
Firebase Admin SDK أو
بروتوكول خادم FCM.
يمكنك استخدام
أداة إنشاء الإشعارات للاختبار وإرسال رسائل تسويقية أو رسائل تتعلّق بالتفاعل
باستخدام ميزات الاستهداف والتحليلات المضمّنة القوية أو شرائح الجمهور المستورَدة المخصّصة.
اطّلِع على نظرة عامة على البنية للحصول على مزيد من التفاصيل والمعلومات العميقة
حول مكوّنات FCM.
مسار التنفيذ
|
إعداد حزمة تطوير البرامج (SDK) من FCM |
إعداد Firebase وFCM في تطبيقك وفقًا لتعليمات الإعداد الخاصة بمنصتك
|
|
تطوير تطبيق العميل |
أضِف معالجة الرسائل أو منطق الاشتراك في المواضيع أو ميزات تكميلية أخرى
إلى تطبيق العميل. وخلال مرحلة التطوير، يمكنك بسهولة
إرسال رسائل اختبارية من
أداة إنشاء الإشعارات. |
|
تطوير خادم التطبيقات |
حدِّد ما إذا كنت تريد استخدام بروتوكول
Firebase Admin SDK أو بروتوكول الخادم لإنشاء منطق الرسائل المُرسَلة، وهو المنطق المخصّص للمصادقة وإنشاء طلبات الإرسال ومعالجة الردود وما إلى ذلك. بعد ذلك، يمكنك إنشاء المنطق في بيئتك الموثوق بها. |
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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)."]]
