Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع Firebase In-App Messaging

يوضح لك هذا Quickstart كيفية إعداد Firebase In-App Messaging وإرسال رسالتك الأولى.

قبل ان تبدأ

قبل أن تبدأ ، تحتاج إلى إعداد بعض الأشياء في بيئتك:

  • تطبيق تم تمكين Firebase به: إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروع iOS الخاص بك .
  • Xcode 11.0 أو أعلى: يحتاج تطبيق Firebase In-App Messaging إلى إصدار حديث نسبيًا من Xcode ليتم تشغيله. يمكنك العثور على أحدث إصدار من Xcode على موقع Xcode الخاص بشركة Apple .
  • CocoaPods 1.4.0 أو أعلى: تستخدم المراسلة داخل التطبيق في Firebase CocoaPods لإدارة التبعيات على iOS. يمكنك تثبيته من موقع CocoaPods .

أضف Firebase In-App Messaging SDK إلى مشروعك

للبدء ، أضف ملفات إطار عمل Firebase In-App Messaging SDK إلى مشروعك عن طريق إضافة CocoaPods من Firebase In-App Messaging:

  1. افتح نافذة طرفية جديدة ، وانتقل إلى دليل مشروع Xcode الخاص بك.
  2. افتح ملف Podfile الخاص بك ، وأضف الأسطر المميزة:
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. من جهازك الطرفي ، قم بتثبيت تبعيات البود:
    pod install
  4. افتح مشروع تطبيقك في Xcode:
    open YOUR-PROJECT.xcworkspace
  5. قم باستيراد وحدة Firebase في UIApplicationDelegate ، إذا لم تكن قد قمت بذلك بعد:
    سويفت
    import Firebase
    ج موضوعية
    @import Firebase;
  6. قم أيضًا بتكوين مثيل FirebaseApp المشترك ، عادةً في تطبيق التطبيق الخاص بك application:didFinishLaunchingWithOptions: method ، إذا لم تكن قد قمت بما يلي:
    سويفت
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    ج موضوعية
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. تجميع وتشغيل التطبيق الخاص بك.

أرسل رسالة تجريبية

احصل على معرف تثبيت التطبيق الخاص بك

للحفاظ على الطاقة ، لا يسترد Firebase In-App Messaging سوى الرسائل من الخادم مرة واحدة يوميًا. يمكن أن يجعل هذا الاختبار صعبًا ، لذا تتيح لك وحدة تحكم Firebase تحديد جهاز اختبار يعرض الرسائل عند الطلب.

يتم تحديد جهاز الاختبار هذا من خلال معرف تثبيت Firebase الذي توفره خدمة تثبيت Firebase. للعثور على معرف تثبيت تطبيق الاختبار الخاص بك ، قم بتشغيل التطبيق باستخدام وسيطة أمر وقت التشغيل -FIRDebugEnabled :

  1. مع فتح مشروع Xcode الخاص بك ، حدد المنتج> مخطط> تحرير المخطط ... من شريط القائمة العلوي.
  2. افتح علامة تبويب الوسائط في مربع الحوار المنبثق.
  3. انقر فوق + إضافة عناصر ضمن Arguments Passed On Launch .
  4. أدخل "-FIRDebugEnabled" في الحقل الذي تم إنشاؤه حديثًا.
  5. انقر فوق إغلاق ، ثم قم بتشغيل التطبيق الخاص بك.

بمجرد بدء تشغيل التطبيق ، ابحث عن السطر التالي في سجلات وحدة تحكم Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID

أرسل رسالة إلى جهاز الاختبار الخاص بك

بمجرد تشغيل تطبيقك على جهاز الاختبار ولديك معرف تثبيت Firebase (FID) ، يمكنك تجربة إعداد Firebase In-App Messaging عن طريق إرسال رسالة اختبار:

  1. في وحدة تحكم Firebase ، افتح المراسلة داخل التطبيق .
  2. بمجرد الوصول إلى هناك ، انقر فوق حملة جديدة .
  3. أدخل عنوانا لرسالتك الأولى.
  4. انقر فوق اختبار على جهازك
  5. أدخل معرف تثبيت Firebase لتطبيقك في حقل إضافة معرف التثبيت .
  6. انقر فوق اختبار لإرسال الرسالة.

يرسل Firebase In-App Messaging رسالة الاختبار بمجرد النقر فوق " اختبار" . لرؤيتها ، أغلق التطبيق ثم أعد فتحه على جهاز الاختبار الخاص بك.

لتأكيد ما إذا كان جهازك جهاز اختبار أم لا ، ابحث عن رسالة السجل التالية:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.