رفع اشکال Pushfa Android SDK
چکلیست خطاهای نصب، Firebase، token، permission، نمایش اعلان، لینک و Collapse ID در نسخه 2.0.4.
Gradle کتابخانه را پیدا نمیکند
برای com.pushfa باید mavenCentral() و برای com.github.pushfa باید JitPack فعال باشد. مختصات دو روش را ترکیب نکنید. نسخه واقعی dependency tree باید 2.0.4 باشد.
FCM token ساخته یا ثبت نمیشود
| بررسی | انتظار |
|---|---|
| Package Name | با client داخل google-services.json یکسان باشد. |
| Google Services plugin | روی ماژول app فعال باشد. |
| Firebase project | با Service Account سرویس پوشفا یکی باشد. |
| Android 13+ | permission قبول و registerForPush اجرا شده باشد. |
| دستگاه | Google Play Services و اینترنت فعال باشد. |
اعلان دریافت میشود ولی نمایش داده نمیشود
areNotificationsEnabled را بررسی کنید. Notification Channel ممکن است در Settings خاموش باشد. Listener نباید ناخواسته true برگرداند. اگر autoDisplayNotifications=false است، نمایش کاملاً بر عهده اپ است. همچنین فقط یک FirebaseMessagingService باید MESSAGING_EVENT را مدیریت کند.
لینک یا مسیر داخلی باز نمیشود
برای https و Custom Scheme فرمت معتبر و Intent Filter لازم است. مسیر نسبی را در onCreate و onNewIntent بخوانید. نسخه 2.0.4 از Activity PendingIntent سازگار با Android 12+ استفاده میکند.
Collapse اعلان را جایگزین نمیکند
دو پیام باید collapse_id کاملاً یکسان داشته باشند. اعلانهای باقیمانده از نسخه قدیمی را پاک کنید. فقط اعلان فعال قابل بروزرسانی است و dependency نصبشده باید واقعاً 2.0.4 باشد.
بررسی نسخه در زمان اجرا
Log.d("Pushfa", "SDK version=${Pushfa.VERSION}")
// خروجی مورد انتظار: 2.0.4