طبق اعلام کافه بازار استفاده از SDK
قدیمی ronash.pushe
باعث ویروسی شناسایی شدن اپ شما می شود. برای حذف SDK
قدیمی و جایگزینی با SDK
جدید دستورالعمل زیر را دنبال کنید:
برای انتقال SDK
پوشه قدیم به پوش پل، باید SDK
قدیمی پوشه را که با عنوان ronash.pushe
استفاده شده است را به طور کامل از اپلیکیشن حذف نمایید (که در فایل های manifest
، gradle
و … استفاده شده است)
SDK
پوش پل را با استفاده از مراحل زیر به پروژه خود اضافه نمایید:
build.gradle
مربوط به اپلیکیشن وارد شوید. مراقب باشید اشتباها به فایل gradle مربوط به پروژه وارد نشوید. کد زیر را در dependencies
اضافه کنید:implementation 'com.push-pole.android:pushpolesdk:1.7.8'
build.gradle
مربوط به پروژه مطمئن شوید که لینک های لازم برای دریافت
پوشپل و کتابخانه های ساپورت موجود هستند:buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath "com.android.tools.build:gradle:4.2.1"
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
application
فایل manifest
دستور زیر را قرار دهید:<meta-data android:name="com.pushpole.sdk.token" android:value="PUSHPOLE_TOKEN"/>
توکنی که در زمان ثبت نام اپلیکیشن در کنسول پوش پل دریافت کرده اید را در به جای PUSHPOLE_TOKEN
قرار دهید.
onCreate
کلاس Application
کد زیر را وارد کنید:PushPole.initialize(context,true);
برای اطلاعات بیشتر می توانید داکیومت پوش پل را از طریق لینک زیر مشاهده کنید: راه اندازی پوش-پل
برای خطاهای مربوط به پلتفرمها لطفا به بخش عیبیابی مختص هر پلتفرم مراجعه کنید.
دسترسی هایی که پوشپل از آنها استفاده میکند.
پوشپل برای دریافت اطلاعات و ردوبدل اعلان نیاز به اینترنت دارد لذا بایستی برنامه بتواند از اینترنت استفاده کند.
برای اینکه دستگاه حتی در حالت خواب نیز بتواند اعلان را دریافت کند بایستی ارتباط با شیکه قطع نشود، لذا این دسترسی نیاز است.
برای اینکه دستگاه در هنگامی که ریست شد نیز بدون نیاز به اجرای دوباره ی برنامه بتواند اعلان دریافت کند.
برای مدیریت و زمانبندی بهتر اعلان ها پوشپل دسترسی به نت را بررسی میکند لذا این دسترسی استفاده میشود.
برای اینکه بتوانید بر حسب مکان کاربر اعلان ارسال کنید کاربر بایستی این دسترسی را مجاز بداند. این دسترسی اجباری نیست ولی در صورتی که از مانیفست نهایی حذف شود ارسال اعلان بر حسب مکان برای شما به درستی کار نخواهد کرد.
لطفا موارد زیر را چک کنید:
در صورتیکه موفق به حل مشکل نشدید با ذکر نوع پلتفرم و ابزار استفادهشده برای ساخت برنامه فایل مانیفست و فایل نصبی برنامهتان را به پشتیبانی ارسال نموده و مشکل را شرح دهید.
یپام | وضعیت | مشکل احتمالی |
---|---|---|
Trying to register to FCM | در حال تلاش برای ثبت نام در FCM | بعضا پیش می آید که سرویس های گوگل برای لحظاتی با کندی مواجه می شوند، این مورد موقت خواهد بود، اگر این مورد زیاد طول کشید با پشتیبانی تماس بگیرید |
Successfully registered to FCM | با موفقیت در FCM ثبت شد | |
Trying to register to PushPole | در حال تلاش برای ثبت نام در "پوشپل" | اگر در این حالت مانده است و بارها این پیام در لاگ میآید مطابقت نام بسته اپلیکیشن خود را با آنچه در سایت ثبت کرده اید بررسی کنید و دقت کنید که از منیفست همان اپلیکیشن حتما استفاده کرده باشید |
Successfully registered to pushpole | با موفقیت در "پوشپل" ثبت شد | |
Trying to subscribe to channel: " + channel | در حال تلاش برای عضویت در کانال "نام کانال شما" | |
Successfully subscribed to channel: " + channel | با موفقیت در کانال "نام کانال شما"اضافه شد | |
Trying to unsubscribe from channel: " + channel | در حال تلاش برای خارج شدن از کانال "نام کانال شما" | |
Successfully unsubscribed from channel: " + channel | با موفقیت از کانال "نام کانال شما" خارج شد |
پیام | راه حل |
---|---|
"bad topic name, topic name must just contains [a-zA-Z0-9-_.~%]{1,900}" | نام کنال خود را به خوبی انتخاب نکرده اید. نام انتخابی باید تنها شامل [a-zA-Z0-9-_.~%] باشد. |
"Initializing PushPole failed, " | این خطا ممکن است به دلایل مختلف پیش بیاید. با بخش پشتیبانی تماس بگیرید. |
"PushPole must be initialized before unsubscribing from a topic" | تابع PushPole.initialize را باید در کد MainActivity.java فراخوانی کنید. به آموزش نصب مراجعه کنید. |
"Failed to load meta-data from manifest, Token not found" | کد مربوط به meta-data پوشپل را در مانیفست خود قرار نداده اید. این کد را از فایل مانیفست در اختیار گذاشته شده در پنل، به مانیفست اپلیکیشن خود اضافه کنید. |
"Failed to load meta-data from manifest, Token is null" | توکن موجود در مانیفست خالی است. این توکن را ازفایل مانیفست در اختیار گذاشته شده در پنل، به مانیفست اپلیکیشن خود اضافه کنید. |
"Failed to load meta-data from manifest, Bad Token" | فرمت توکن قرار داده شده اشتباه است. توکن صحیح را از فایل مانیفست در اختیار گذاشته شده در پنل، به مانیفست اپلیکیشن خود اضافه کنید. |
"Google play services problem: " + result | گوگل پلی سرویس استفاده شده نصب نشده است و یا به روز نیست. به صفحه آموزش مراجعه کنید. |
"PushPole must be initialized before subscribing to a topic" | تابع PushPole.initialize را باید در کد MainActivity.java فراخوانی کنید. به آموزش نصب مراجعه کنید. |
“FCM error:” + error | با بخش پشتیبانی تماس بگیرید. |
"SERVICE NOT AVAILABLE | دستگاهی که برنامه روی آن اجرا شده به اینترنت وصل نیست. |