استفاده از کتابخانه پوش نوتیفیکشن در اندروید استودیو

راه‌اندازی

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

AndroidManifest.xml

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

در ابتدای این فایل پرمیشن‌های مورد نیاز توسط نیواد تعریف شده اند. لازم است این تگ‌ها را در منیفست اپلیکیشن خود کپی کنید.

<permission android:name="<your_package_name>.permission.C2D_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="<your_package_name>.permission.C2D_MESSAGE" />

در دو پرمیشن اول باید عبارت <your_package_name> را با package name مربوط به اپلیکیشن خود جایگزین کنید .

در صورتی که تمایل داشته باشید نوتیفیکیشن‌های ارسال شده باعث لرزش دستگاه شوند لازم است پرمیشن مربوط را اضافه کنید:

<uses-permission android:name="android.permission.VIBRATE" />

همچنین در منیفست تولید شده یک تگ application نیز وجود دارد که لازم است قسمتی از محتویات آن را داخل فایل منیفست اپلیکیش خود کپی کنید:

این تگ شامل application_id اپلیکیشن شماست. application_id مقدار یکتایی برای هر اپلیکیشن است که توسط نیواد برای تشخیص پیام‌های ارسالی اپلیکیشن‌های مختلف از یکدیگر استفاده می‌شود.

<meta-data
    android:name="io.nivad.push.application_id"
    android:value="(12345678910"/>

build.gradle

کتابخانهٔ پوش در مخزن maven نیواد قرار دارد و بدون نیاز به فیلترشکن می‌توانید آن را به کمک gradle به پروژه‌تان اضافه کنید. در فایل build.gradle در دو بخش repositories و dependencies این کدها را اضافه کنید:

repositories {
    jcenter()
    maven { url 'http://repo.nivad.io:8081/artifactory/list/libs-release' }
}
dependencies {
    compile 'io.nivad.core:library:+'
    compile 'io.nivad.push:library:+'
    compile 'com.auth0:java-jwt:2.1.0'
    compile 'com.android.support:appcompat-v7:23.2.1'
    compile 'com.google.android.gms:play-services-gcm:8.4.0'
}

استفاده

در اولین اجرای اپلیکیشن شما لازم است که سرویس‌های مربوط به پوش نوتیفیکیشن نیواد آغاز به کار کنند. برای این کار کافی است متد NivadPush.initialize و NivadCore.initialize در لحظهٔ اجرای برنامه فراخوانی شوند. پیشنهاد می‌شود این متد را در متد onCreate کلاس اپلیکیشن فراخوانی کنید.

public class YourApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        NivadCore.initialize(
                this,
                <Nivad application id>,
                <Nivad application secret>
        );
        NivadPush.initialize(<Nivad push secret>);
    }
}

مقادیر application id, application secret و push secret را از پنل مدیریت اپلیکیشنتان می‌توانید دریافت کنید. در پنل مدیریت پوش نوتیفیکیشن، بخش «مستندات/دانلود کتابخانه» این قسمت از کد برای هر اپلیکیشن شما به صورت آماده وجود دارد و برای راحتی بیشتر می‌توانید این قطعه کد را از آن قسمت کپی کنید.

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

• بعدی