Android 3分鐘帶你集成極光推送

話不多說(shuō) 首先申請(qǐng)極光的賬號(hào),(官方地址:https://www.jiguang.cn

1561710140829.png

登錄完成之后,先看到這個(gè)地方 ,我個(gè)人比較喜歡用舊版本,這里點(diǎn)擊舊版
1561710235064.png

點(diǎn)擊這個(gè)創(chuàng)建應(yīng)用
1561710626969.png

注意這個(gè)地方應(yīng)用名稱是必填項(xiàng),圖標(biāo)是選填,這里我就只填一個(gè)應(yīng)用名稱(這里的名稱就是Mainface里面的app_name)
1561710724862.png

1561710743741.png

填入名字之后 點(diǎn)擊創(chuàng)建我的應(yīng)用(這里我沒(méi)試過(guò)名字不一樣是否可以成功推送,個(gè)人覺(jué)得沒(méi)必要做這種嘗試)
1561710852958.png

看到創(chuàng)建成功字樣后點(diǎn)擊完成推送配置:
里面有Android IOS 和win 這里我只演示Android
1561711022205.png

取項(xiàng)目中app目錄下的build.gradle文件中的applicationId 對(duì)應(yīng)的值(一般在集成三方庫(kù)的時(shí)候用到包名的,我們都認(rèn)為這個(gè)applicationId 是應(yīng)用程序的包名),將這個(gè)包名復(fù)制粘貼到以下頁(yè)面的選項(xiàng)中并點(diǎn)擊保存:
1561711265137.png

點(diǎn)擊 下載Demo,把Demo解壓到一個(gè)文件中如下:
1561711547102.png

很多博客寫(xiě)到這里都是說(shuō)把解壓之的文件以module的方式引入到項(xiàng)目中,經(jīng)過(guò)我自己的測(cè)試我發(fā)現(xiàn)這樣是行不通的,因?yàn)闃O光提供的這個(gè)Demo其實(shí)是一個(gè)eclipse項(xiàng)目,所以在AS上跑是有問(wèn)題的,經(jīng)過(guò)閱讀官方文檔和自己的摸索,發(fā)現(xiàn)其實(shí)這里面有用的就上面標(biāo)記的兩個(gè)地方,src里面存放了一些極光為我們生成的一套收消息的類,Mainface里面為我們配置了一些權(quán)限信息和其他的東西,這里首先需要按照官方文檔配置APP目錄下的build.gradle文件:

1561714344089.png

回到首頁(yè)查看極光推送的文檔(這里我只截取build.gradle里面的配置信息):


1561714447363.png

這一這個(gè)里面有個(gè)JPUSH_APPKEY:需要填入剛剛申請(qǐng)后的APPkey:


1561715348319.png

AS執(zhí)行以下 Sync Now 以便于下載極光的包

以下都是權(quán)限 沒(méi)什么好說(shuō)的

<!-- Required  一些系統(tǒng)要求的權(quán)限,如訪問(wèn)網(wǎng)絡(luò)等-->
    <uses-permission android:name="com.yhb.pushdemo.permission.JPUSH_MESSAGE" />
    <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    
    <!-- Optional for location -->
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于開(kāi)啟 debug 版本的應(yīng)用在6.0 系統(tǒng)上 層疊窗口權(quán)限 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.GET_TASKS" />

這里主要是要查看Mainface里面的配置信息,備注信息很清楚,這里我就做過(guò)多贅述了:

   //參照集成文檔中來(lái)的文檔中
        <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.yhb.pushdemo">

    <!-- Required  一些系統(tǒng)要求的權(quán)限,如訪問(wèn)網(wǎng)絡(luò)等-->
    <uses-permission android:name="com.yhb.pushdemo.permission.JPUSH_MESSAGE" />
    <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />


    <!-- Optional for location -->
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于開(kāi)啟 debug 版本的應(yīng)用在6.0 系統(tǒng)上 層疊窗口權(quán)限 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.GET_TASKS" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- For test only 測(cè)試狀態(tài)通知欄,需要打開(kāi)的Activity -->
        <activity android:name="com.example.jpushdemo.TestActivity" android:exported="false">
            <intent-filter>
                <action android:name="jpush.testAction" />
                <category android:name="jpush.testCategory" />
            </intent-filter>
        </activity>

        <!-- Rich push 核心功能 since 2.0.6-->
        <activity
            android:name="cn.jpush.android.ui.PopWinActivity"
            android:theme="@style/MyDialogStyle"
            android:exported="false">
        </activity>

        <!-- Required SDK核心功能-->
        <activity
            android:name="cn.jpush.android.ui.PushActivity"
            android:configChanges="orientation|keyboardHidden"
            android:theme="@android:style/Theme.NoTitleBar"
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.ui.PushActivity" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="com.yhb.pushdemo" />
            </intent-filter>
        </activity>

        <!-- Required SDK 核心功能-->
        <!-- 可配置android:process參數(shù)將PushService放在其他進(jìn)程中 -->
        <service
            android:name="cn.jpush.android.service.PushService"
            android:process=":pushcore"
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTER" />
                <action android:name="cn.jpush.android.intent.REPORT" />
                <action android:name="cn.jpush.android.intent.PushService" />
                <action android:name="cn.jpush.android.intent.PUSH_TIME" />
            </intent-filter>
        </service>
        <!-- since 3.0.9 Required SDK 核心功能-->
        <provider
            android:authorities="com.yhb.pushdemo.DataProvider"
            android:name="cn.jpush.android.service.DataProvider"
            android:process=":pushcore"
            android:exported="false"
            />

        <!-- since 1.8.0 option 可選項(xiàng)。用于同一設(shè)備中不同應(yīng)用的JPush服務(wù)相互拉起的功能。 -->
        <!-- 若不啟用該功能可刪除該組件,將不拉起其他應(yīng)用也不能被其他應(yīng)用拉起 -->
        <service
            android:name="cn.jpush.android.service.DaemonService"
            android:enabled="true"
            android:exported="true">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.DaemonService" />
                <category android:name="com.yhb.pushdemo" />
            </intent-filter>

        </service>
        <!-- since 3.1.0 Required SDK 核心功能-->
        <provider
            android:authorities="com.yhb.pushdemo.DownloadProvider"
            android:name="cn.jpush.android.service.DownloadProvider"
            android:exported="true"
            />
        <!-- Required SDK核心功能-->
        <receiver
            android:name="cn.jpush.android.service.PushReceiver"
            android:enabled="true"
            android:exported="false">
            <intent-filter android:priority="1000">
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />   <!--Required  顯示通知欄 -->
                <category android:name="com.yhb.pushdemo" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.USER_PRESENT" />
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            </intent-filter>
            <!-- Optional -->
            <intent-filter>
                <action android:name="android.intent.action.PACKAGE_ADDED" />
                <action android:name="android.intent.action.PACKAGE_REMOVED" />

                <data android:scheme="package" />
            </intent-filter>
        </receiver>

        <!-- Required SDK核心功能-->
        <receiver android:name="cn.jpush.android.service.AlarmReceiver" android:exported="false"/>

        <!--since 3.3.0 Required SDK核心功能-->
        <activity
            android:name="cn.jpush.android.service.JNotifyActivity"
            android:exported="true"
            android:taskAffinity="jpush.custom"
            android:theme="@android:style/Theme.Translucent.NoTitleBar">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.JNotifyActivity" />
                <category android:name="com.yhb.pushdemo" />
            </intent-filter>
        </activity>

        <!-- Since JCore2.0.0 Required SDK核心功能-->
        <!-- 這個(gè)Service要繼承JCommonService -->
        <service android:name="com.example.jpushdemo.PushService"
            android:process=":pushcore">
            <intent-filter>
                <action android:name="cn.jiguang.user.service.action" />
            </intent-filter>
        </service>


        <!-- User defined.  For test only  用戶自定義的廣播接收器-->
        <receiver
            android:name="com.example.jpushdemo.MyReceiver"
            android:exported="false"
            android:enabled="true">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTRATION" /> <!--Required  用戶注冊(cè)SDK的intent-->
                <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" /> <!--Required  用戶接收SDK消息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" /> <!--Required  用戶接收SDK通知欄信息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" /> <!--Required  用戶打開(kāi)自定義通知欄的intent-->
                <action android:name="cn.jpush.android.intent.CONNECTION" /><!-- 接收網(wǎng)絡(luò)變化 連接/斷開(kāi) since 1.6.3 -->
                <category android:name="com.yhb.pushdemo" />
            </intent-filter>
        </receiver>

        <!-- User defined.  For test only  用戶自定義接收消息器,3.0.7開(kāi)始支持,目前新tag/alias接口設(shè)置結(jié)果會(huì)在該廣播接收器對(duì)應(yīng)的方法中回調(diào)-->
        <receiver android:name="com.example.jpushdemo.MyJPushMessageReceiver">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />
                <category android:name="com.yhb.pushdemo"></category>
            </intent-filter>
        </receiver>
        <!-- Required  . Enable it you can get statistics data with channel -->
        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
        <meta-data android:name="JPUSH_APPKEY" android:value="af286405fb9a70a376ad2669" /> <!--  </>值來(lái)自開(kāi)發(fā)者平臺(tái)取得的AppKey-->

    </application>

</manifest>

復(fù)制上去之后,會(huì)有以下幾處報(bào)錯(cuò),這幾處報(bào)錯(cuò)只需要把src下面對(duì)應(yīng)的類拷貝過(guò)來(lái),然后修改Mainface里面的路徑名即可


image.png

image.png

image.png

image.png

新增完后的項(xiàng)目目錄:


image.png

可看到還有兩個(gè)類報(bào)錯(cuò),這個(gè)時(shí)候,看看一看里面需要的東西,差什么拷貝什么
最后剩下一個(gè)MainActivity里面需要添加?xùn)|西,這里我直接拷貝過(guò)來(lái)

package com.yhb.pushdemo;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.support.v4.content.LocalBroadcastManager;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {


    public static boolean isForeground = false;

    private MessageReceiver mMessageReceiver;
    public static final String MESSAGE_RECEIVED_ACTION = "com.example.jpushdemo.MESSAGE_RECEIVED_ACTION";
    public static final String KEY_TITLE = "title";
    public static final String KEY_MESSAGE = "message";
    public static final String KEY_EXTRAS = "extras";
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    public void registerMessageReceiver() {
        mMessageReceiver = new MessageReceiver();
        IntentFilter filter = new IntentFilter();
        filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
        filter.addAction(MESSAGE_RECEIVED_ACTION);
        LocalBroadcastManager.getInstance(this).registerReceiver(mMessageReceiver, filter);
    }

    public class MessageReceiver extends BroadcastReceiver {

        @Override
        public void onReceive(Context context, Intent intent) {
            try {
                if (MESSAGE_RECEIVED_ACTION.equals(intent.getAction())) {
                    String messge = intent.getStringExtra(KEY_MESSAGE);
                    String extras = intent.getStringExtra(KEY_EXTRAS);
                    StringBuilder showMsg = new StringBuilder();
                    showMsg.append(KEY_MESSAGE + " : " + messge + "\n");
                    if (!ExampleUtil.isEmpty(extras)) {
                        showMsg.append(KEY_EXTRAS + " : " + extras + "\n");
                    }
                    Toast.makeText(context, showMsg.toString(), Toast.LENGTH_SHORT).show();
                }
            } catch (Exception e){
            }
        }
    }

    @Override
    protected void onResume() {
        isForeground = true;
        super.onResume();
    }


    @Override
    protected void onPause() {
        isForeground = false;
        super.onPause();
    }
}

最后一步,初始化極光推送:

package com.yhb.pushdemo;

import android.app.Application;

import cn.jpush.android.api.JPushInterface;

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        JPushInterface.setDebugMode(true);
        JPushInterface.init(this);
    }
}

在Mainface中新增如下代碼:


image.png

這個(gè)時(shí)候在AndroidStudio中Rebuild一下,然后安裝app到手機(jī)上,注意這里最好使用真機(jī)(樓主使用的真機(jī)測(cè)試,不知道模擬器是否可以)
這個(gè)時(shí)候我們就可以開(kāi)始在極光后臺(tái)給我們的手機(jī)推送數(shù)據(jù)了
推送數(shù)據(jù)第一步:


image.png

注意這個(gè)列表10分鐘刷新一次,所有有時(shí)候我們看到的用戶數(shù)不對(duì),是因?yàn)闆](méi)有及時(shí)刷新,所以不必?fù)?dān)心
在這個(gè)頁(yè)面點(diǎn)擊相應(yīng)的應(yīng)用,這里我點(diǎn)擊極光測(cè)試用例然后進(jìn)入:


image.png

點(diǎn)擊這里的 “推送” 然后進(jìn)入:


image.png

可以看到當(dāng)前這個(gè)頁(yè)面中的推送歷史是什么都沒(méi)有的,然后點(diǎn)擊這里 “發(fā)送通知” 進(jìn)入發(fā)送通知頁(yè)面
左邊是發(fā)送的測(cè)試信息,右邊是接收的平臺(tái),我這里是Android
(注意:如果右邊這個(gè)方框里面沒(méi)有如圖顯示)
image.png

或者以下這四個(gè)按鈕不可選的時(shí)候,,說(shuō)明在前面配置極光的時(shí)候少了一步


image.png

如果右邊的手機(jī)沒(méi)有出現(xiàn),或者是方框內(nèi)什么都沒(méi)有,亦或是以上四個(gè)目標(biāo)平臺(tái)不可選的時(shí)候,那么大概率是缺少以下配置:(方框內(nèi)有顯示的,可以忽略此步驟)


1561710852958.png

如果沒(méi)問(wèn)題,選擇對(duì)應(yīng)的平臺(tái),我這里選擇Android(選擇的平臺(tái)需要在推送配置里面配置好之后,才可以在這里選擇你想要推送的平臺(tái))

以下目標(biāo)人群和發(fā)送時(shí)間我這邊都是默認(rèn)的,這里需要注意的是 這個(gè)立即發(fā)送按鈕,如果顯示是藍(lán)色的,說(shuō)明上面的信息都沒(méi)有問(wèn)題,否則你需要再次檢查上面需要填寫(xiě)的內(nèi)容


image.png

點(diǎn)擊立即發(fā)送,在手機(jī)上看到如下效果,說(shuō)明推送已經(jīng)集成成功


image.png

還可以在極光的控制臺(tái)看到詳細(xì)的數(shù)據(jù)如下,也說(shuō)明推送集成成功,一般情況下兩種都可以看到:
image.png

至此,推送的demo就完全集成完了,小伙伴們可以根據(jù)自己的業(yè)務(wù)在之前copy的接收器和TestActivity里面做自己的業(yè)務(wù)邏輯了,當(dāng)然 我這里實(shí)現(xiàn)的只是最簡(jiǎn)單的推送邏輯,更多詳細(xì)內(nèi)容請(qǐng)查看官方集成文檔。
如有問(wèn)題,可以在下方給博主留言哦,博主也是一位菜雞,希望各位大佬不喜輕噴,在這里先行謝謝各位!

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容