الانتقال من OneSignal

الانتقال من OneSignal في معظمه تغيير أسماء. خادمك يرسل الطلب نفسه إلى رابط جديد، واستدعاءات Flutter والويب تحتفظ بأسمائها تحت Takeed، ومشتركينك على أندرويد وiOS ينتقلون معك. لن يحتاج تطبيقك بعد الآن إلى google-services.json، وتحصل على رموز التحقق عبر الواتساب في الحساب نفسه.

التعديل في الكود صغير، والجزء البطيء هو نشر التطبيق في المتاجر، لذا خطّط للانتقال مع إصدارك القادم. خمس خطوات:

1. أنشئ التطبيق وأضف مفاتيحك.
2. وجّه خادمك إلى تأكيد.
3. بدّل الحزمة في التطبيق.
4. استورد مشتركيك.
5. أكمل الانتقال.

1أنشئ التطبيق وأضف مفاتيحك#

أنشئ حسابًا وشركة وتطبيقًا. افتح الإعدادات ← إعدادات الإشعارات ← مفاتيح Firebase وApple ثم اختر إضافة مفتاح:

• أندرويد: ملف JSON لحساب خدمة Firebase (من Firebase console: إعدادات المشروع، ثم Service accounts، ثم Generate new private key). يقرأ تأكيد تطبيقات أندرويد في المشروع من Firebase مباشرة، ولا تضع شيئًا داخل تطبيقك.
• iOS: مفتاح APNs بصيغة .p8 مع Key ID وTeam ID وBundle ID الخاص بالتطبيق.

التفاصيل في البدء السريع: Flutter.

2وجّه خادمك إلى تأكيد#

غيّر الرابط والمفتاح والـ App ID، ويبقى محتوى الطلب كما هو:

-curl https://api.onesignal.com/notifications \-  -H "Authorization: Key $ONESIGNAL_REST_KEY" \+curl https://takeed-iq.com/api/v1/notifications \+  -H "Authorization: Key $TAKEED_KEY" \   -H "Content-Type: application/json" \-  -d '{"app_id": "ONESIGNAL-APP-ID",+  -d '{"app_id": "TAKEED-APP-ID",        "included_segments": ["All"],        "headings": {"en": "Hello"}, "contents": {"en": "It works"}}'

راجع الحقول التي يرسلها خادمك مع قائمة الحقول المدعومة.

3بدّل الحزمة في التطبيق#

Flutter#

من onesignal_flutter v5 إلى takeed_flutter 2.1.2 أو أحدث:

 dependencies:-  onesignal_flutter: ^5.2.0+  takeed_flutter: ^2.1.2

-import 'package:onesignal_flutter/onesignal_flutter.dart';+import 'package:takeed_flutter/takeed_flutter.dart'; -OneSignal.initialize('ONESIGNAL-APP-ID');+await Takeed.initialize('TAKEED-APP-ID');-OneSignal.login(user.id);+await Takeed.login(user.id);-OneSignal.User.addTagWithKey('plan', 'gold');+await Takeed.User.addTag('plan', 'gold');

1. احذف google-services.json وإضافة Google services من Gradle إن كانا موجودين لأجل OneSignal فقط. تأكيد يعطي الحزمة إعدادات Firebase من حساب الخدمة الذي أضفته في الخطوة 1.
2. على iOS: استبدل ملف Notification Service Extension بالملف extension/NotificationService.swift من الحزمة، واحذف OneSignal pod من ذلك الـ target.
3. غيّر أسماء بقية الاستدعاءات حسب هذا الجدول:

الويب (v16)#

-<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>+<script src="https://takeed-iq.com/sdk/v1/takeed.js" defer></script> <script>-  window.OneSignalDeferred = window.OneSignalDeferred || [];-  OneSignalDeferred.push(async (OneSignal) => {-    await OneSignal.init({ appId: 'ONESIGNAL-APP-ID' });+  window.TakeedDeferred = window.TakeedDeferred || [];+  TakeedDeferred.push(async (Takeed) => {+    await Takeed.init({ appId: 'TAKEED-APP-ID', serviceWorkerPath: '/push/TakeedSDKWorker.js', serviceWorkerScope: '/push/' });   }); </script>

يوضّح البدء السريع: الويب أين تضع ملف الـ worker.

4استورد مشتركيك#

1. من OneSignal، صدّر مشتركيك في ملف CSV.
2. في تأكيد، افتح صفحة مستخدمو الإشعارات في التطبيق واستخدم الاستيراد من OneSignal. اختر المفتاح الذي تستخدمه رموز أندرويد وiOS.
3. تنتقل رموز أندرويد وiOS، وتصل إشعارات تأكيد حتى إلى الهواتف التي ما زالت على إصدار تطبيقك القديم. أما اشتراكات الويب فلا تنتقل (لأنها مرتبطة بمفاتيح OneSignal)، والمتصفحات التي سمحت بالإشعارات تشترك من جديد تلقائيًا عند زيارتها التالية لصفحة فيها حزمة تأكيد.

5أكمل الانتقال#

1. اختبر أولًا: من صفحة مستخدمو الإشعارات اجعل هاتفك جهاز اختبار، ثم أرسل إلى شريحة Test Users من صفحة اختبار الإشعارات.
2. حوّل خادمك إلى تأكيد في كل عمليات الإرسال. لا ترسل الإشعار نفسه عبر الخدمتين معًا، فالهواتف المسجّلة في الاثنتين ستستلمه مرتين.
3. انشر إصدار التطبيق الذي يحمل حزمة تأكيد. الهواتف المحدّثة والتثبيتات الجديدة تسجّل في تأكيد مباشرة.
4. عندما تبدو الأرقام في سجل الإشعارات صحيحة، أوقف تطبيق OneSignal.