راهنمای راه‌اندازی پوش اندروید به زبان Kotlin

با خواندن این راهنما، در انتها شما می‌توانید SDK پوش‌نوتیفیکیشن نجوا را از طریق Kotlin به اپلیکیشن اندرویدی خود اضافه کنید، همچنین می‌توانید راهنمای زیر را در GitHub نجوا مشاهده کنید. در صورتی که در هر مرحله از فرآیند نصب با مشکلی روبرو شدید، با تلگرام پشتیبانی نجوا در ارتباط باشید.

پیاده‌سازی

تغییرات Gradle

در فایل gradle مربوط به ماژول اپلیکیشن در بخش dependencies خط کد زیر را وارد کنید

implementation 'com.najva.sdk:najva-android-sdk:1.1.5'

در فایل gradle مربوط به پروژه در بخش allproject و بخش repositories کد زیر را به شکل زیر قرار دهید.

allprojects {
    repositories {
        google()
        jcenter()
    }
}

در کلاس MainActivity و در بخش import ها کد زیر را اضافه کنید.

import com.najva.najvasdk.Class.Najva

سپس در تابع onCreate کد زیر را اضافه کنید.

Najva.initialize(this, YOUR-CAMPAIGN-ID, YOUR-WEBSITE-ID, YOUR-API-KEY)

شما می توانید در پنل نجوا مقادیر campaignId, websiteId, apiKey  را در قسمت تنظیمات اپلیکیشن خود، مطابق تصویر زیر مشاهده کنید.

پیاده‌سازی SDK نجوا

*قطعه کد بالا به صورت خودکار در پنل نجوای شما پس از وارد کردن اطلاعات اپلیکیشن ساخته می‌شود و کافیست تنها آن را کپی نمایید.

*برای اطمینان از صحت عملکرد سرویس نجوا، پس از اعمال تغییرات گفته شده اپلیکیشن خود را روی یک دستگاه نصب کنید. پس از مدت زمان کوتاهی در پنل نجوای شما اطلاعات دستگاه شما ثبت می‌شود.

همچنین می‌توانید یک نوتیف تستی به دستگاه خودتان بفرستید.

اکنون اپلیکیشن شما برای ارسال پوش‌نوتیفیکیشن آماده است.

دریافت توکن کاربران

شما می‌توانید برای این که برای کاربران خاص خود با توجه به رفتارشان در اپلیکیشن نوتیف ارسال کنید، کاربران اپلیکیشن و کاربران نجوایی خود را همگام نمایید. برای این کار لازم است که در پروژه خود یک کلاس جاوا مانند زیر پیاده سازی نمایید و تابع ذکر شده را override‌ کنید. در این تابع توکن نجوایی کاربر به شما داده می‌شود و در همین جا شما می‌توانید کاربر نجوایی و اپلیکیشن خود را map‌ کنید:

class MyUserHandler(val newUser : (String)->Unit) : NajvaUserHandler() {
   override fun najvaUserSubscribed(token: String?) {
       if (token!=null) newUser(token)
   }
}

در نهایت لازم است در اکتیویتی اصلی خود پس از initialize‌ کردن نجوا تکه کد زیر را قرار دهید.

Najva.setUserHandler(MyUserHandler(handlerResult))

برای دریافت مستقیم توکن می‌توانید از کد زیر استفاده کنید.

 
val token = Najva.getSubscribedToken()

دقت داشته باشید تا زمانی که توکن نجوای کاربر از سمت سرور دریافت نشده باید خروجی این تابع null است.