دليل البدء السريع لوحدة Mendix

ابدأ مع وحدة Pushwoosh لـ Mendix عن طريق تشغيل التطبيق التجريبي الذي يأتي مع الوحدة وإرسال إشعار فوري إليه.

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

لتشغيل التطبيق التجريبي، ستحتاج إلى ما يلي:

المتطلبات

• حساب Pushwoosh.
• مشروع Pushwoosh مُعد في حسابك.
• لتكامل iOS:
  • منصة iOS مُعدة لإرسال إشعارات الدفع (push notifications). نوصي باستخدام إعداد المصادقة المستندة إلى الرمز المميز (Token-Based Authentication) كأبسط طريقة.
  • أثناء الإعداد، قم بتعيين Gateway إلى Sandbox لإرسال الإشعارات إلى جهاز محاكاة.
• لتكامل Android:
  • منصة Android مُعدة
  • ملف google-services.json و package name من مشروع Firebase الخاص بك.
  • مشروع Firebase متصل بتطبيق Android الخاص بك. اتبع دليل إعداد Firebase إذا لزم الأمر.
• Pushwoosh Application Code الخاص بك و رمز Device API الخاص بـ Pushwoosh من لوحة تحكم Pushwoosh لتطبيقك.

ستحتاج أيضًا إلى Mendix Studio Pro 11.12.3 أو أحدث مع ملف تعريف تنقل أصلي للجوال، و Xcode أو Android Studio لإنتاج البناء الأصلي.

رمز Device API Token في القائمة أعلاه غير مطلوب لهذه الوحدة. تأخذ الأداة رمز التطبيق (Application Code) ولا شيء آخر.

تنزيل التطبيق التجريبي

استنسخ مستودع الوحدة:

git clone https://github.com/Pushwoosh/pushwoosh-mendix.git

التطبيق التجريبي هو مجلد demo. وهو نفس التطبيق الذي تم تطوير الوحدة عليه: شاشة واحدة بها أزرار لتسجيل وإلغاء تسجيل الجهاز، وقراءة رمز الدفع (push token)، وتعيين وقراءة العلامات (tags)، ونشر حدث (event)، بالإضافة إلى مدخلات لمفتاح وقيمة العلامة واسم الحدث.

افتح التطبيق في Studio Pro

افتح demo/PushwooshDemo.mpr في Studio Pro. يحتوي التطبيق بالفعل على وحدة Pushwoosh، وأداة Pushwoosh events على الصفحة الرئيسية، و nanoflow خلف كل زر.

قم بتعيين رمز التطبيق الخاص بك

افتح الصفحة الرئيسية لملف تعريف التنقل الأصلي للجوال، وحدد أداة Pushwoosh events، واستبدل العنصر النائب XXXXX-XXXXX في خاصية Application Code برمز التطبيق (Application Code) الخاص بتطبيقك من لوحة تحكم Pushwoosh.

بناء التطبيق الأصلي

لا يمكن تشغيل العرض التجريبي في تطبيق Make It Native، لأن هذا التطبيق لا يحتوي على كود أصلي من جهة خارجية. قم بإنتاج تطبيق مطور مخصص أو بناء أصلي حقيقي بدلاً من ذلك.

على نظام Windows، استخدم App > Build Native App لفتح Native Mobile Builder، وقم بتعيين الإمكانيات على النحو التالي:

• إشعارات الدفع (Push notifications): إيقاف.
• Firebase Android: تشغيل.

يستبدل Pushwoosh الإشعارات الفورية المدمجة في تطبيق Mendix بدلاً من العمل بجانبها. خدمتا إشعارات مسجلتان لنفس حدث Firebase تحجبان بعضهما البعض وتتوقف الإشعارات عن الوصول.

على نظام macOS، لا يحتوي Studio Pro على Native Mobile Builder. قم بتكوين القالب الأصلي باستخدام أداة سطر الأوامر @mendix/native-mobile-toolkit بدلاً من ذلك، ثم قم ببناء مشاريع iOS و Android التي تم إنشاؤها محليًا.

بالنسبة لنظام iOS، افتح مشروع Xcode الذي تم إنشاؤه وأضف إمكانية Push Notifications في Signing & Capabilities. بالنسبة لنظام Android، ضع ملف google-services.json من مشروع Firebase الخاص بك في مشروع Android الذي تم إنشاؤه.

قم بتشغيل التطبيق وتسجيل الجهاز

ابدأ وقت تشغيل Mendix للتطبيق، ثم قم بتشغيل البناء الأصلي على جهاز أو محاكي وانقر على Register For Push Notifications. يطلب الجهاز إذن الإشعارات، ويسجل مع Pushwoosh، ويعرض رمز الدفع (push token) في رسالة.

إرسال إشعار فوري تجريبي

سجل الجهاز كجهاز اختبار وأرسل رسالة إليه من لوحة تحكم Pushwoosh. راجع اختبر تكاملك لمعرفة الخطوات.

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

• دليل التكامل الأساسي - أضف الوحدة إلى تطبيقك الخاص
• مرجع إجراءات الوحدة - خصائص الأداة وإجراءات JavaScript