راهنمای جامع توسعه Android با Pushfa SDK
مسیر کامل استفاده از SDK رسمی Android پوشفا؛ از نصب نسخه 2.0.4 و initialize تا Topic، Alias، RetenX، دریافت اعلان، Deep Link و گزارشها.
SDK چه کارهایی را خودکار انجام میدهد؟
SDK رسمی پوشفا FCM token را دریافت و ثبت میکند، Subscriber ID میسازد، تغییر token را مدیریت میکند، پیامهای پوشفا را دریافت و نمایش میدهد، گزارش تحویل و کلیک را با WorkManager ثبت میکند و API آماده برای Topic، External ID، Alias و RetenX در اختیار اپ قرار میدهد. در مسیر عادی لازم نیست endpoint ثبت token را دستی فراخوانی یا FirebaseMessagingService جداگانه بسازید.
| قابلیت | متد یا رفتار SDK |
|---|---|
| راهاندازی و ثبت خودکار | Pushfa.initialize() |
| درخواست permission و ثبت Push | requestNotificationPermission() / registerForPush() |
| Subscriber ID و token | getSubscriberId() / getPushToken() |
| Topic | subscribeTopic() / unsubscribeTopic() / getTopics() |
| هویت کاربر | setExternalId() / getExternalId() |
| Aliasهای سفارشی | addAlias(es) / removeAlias(es) / getAliases() |
| RetenX | trackEvent() |
| دریافت سفارشی | setNotificationListener() / displayNotification() |
| ادغام با Service موجود | handleMessage() / handleNewToken() |
مسیر پیشنهادی پیادهسازی
SDK را نصب کنید
Maven Central روش پیشنهادی است؛ JitPack و ماژول سورس نیز پشتیبانی میشوند.
Firebase همان سرویس را متصل کنید
google-services.json و Service Account پنل باید متعلق به یک Firebase project باشند.
در Application مقداردهی کنید
Pushfa.initialize() پروفایل را میسازد و در صورت داشتن permission، token را خودکار ثبت میکند.
permission را در زمان مناسب بگیرید
در Android 13+ پس از قبول کاربر، registerForPush() را اجرا کنید.
هویت و دستهبندی را متصل کنید
پس از Login، External ID و Aliasها را تنظیم و Topicهای لازم را ثبت کنید.
دریافت و کلیک را بررسی کنید
حالت پیشفرض SDK کافی است؛ فقط برای رفتار سفارشی Listener یا Service اختصاصی بسازید.
ادامه این راهنما
راهنمای رسمی نسخه 2.0.4
Maven Central، فایل ZIP، SHA-256، ارتقا و راهنمای Firebase پنل.
نصب و راهاندازی سریع
Gradle، Firebase، initialize و permission.
مرجع تمام متدها
امضا، خروجی و کاربرد API عمومی SDK.
Topic و هویت کاربر
Subscriber ID، External ID و Custom Alias.
RetenX Event
ثبت رفتار و پارامترهای Journey از داخل اپ.
دریافت و نمایش اعلان
حالت خودکار، Listener و Firebase Service موجود.
رفع اشکال
Gradle، Firebase، permission، نمایش، لینک و Collapse.
پیشنیاز نسخه فعلی
| مورد | مقدار |
|---|---|
| نسخه SDK | 2.0.4 |
| minSdk | 23 (Android 6.0) |
| compileSdk | 35 یا بالاتر |
| Firebase Messaging | توسط خود SDK اضافه میشود |
| JDK 17 | فقط برای Build کردن SDK از سورس |