Adroid Studio 消息推送

      手机APP消息提醒功能是APP开发得一个重要功能，它主要能做到及时提醒用户一些重要且需要及时处理的信息。目前比较常用的是极光推送，而且如果只是简单的消息推送的话，是免费的，无限制的推送。当然还有其他推送接口，例如：阿里云推送。。。。。但是个人推荐使用极光推送，它无论是到达率还是及时性都是比较高的。

    那么如何将极光推送集成到Android项目中呢？网上大神们都给了许多例子，个人认为不是他们说的不好，只是有些细节过程大多都省略了，按照他们的方式来一步步操作会发现，没有什么卵用。所以最好的例子就是官网给的例子了，只要根据官网给的例子就基本没啥问题了。

   首先我们要注册一个极光账号，自己注册就行了。注册完后让我们登录极光平台：极光：https://www.jiguang.cn

 

 

 点击进入，然后我们要创建一个应用：

 

填写项目名称，和上传图片，注意这个图片是推送消息的时候会带上的图标。

 

 

 提交后，找到推送设置，点击进入，填写包名，特别注意：包名一定要和你的项目名称一样

 

 

 

 

 

 包名下面有一个下载推送demo，这个其实是一个apk安装包，也就是下载后手机可以直接安装，打开后通过极光平台创建推送的方式可以直接测试消息推送。其实这个老版本是一个实现消息推送的一个demo工程，直接打开稍作修改就可以直接用的。不知道怎末回事，现在变成了一个测试安装包了。

不过没关系，我们对着官方文档自己干就行了。

    首先我们要新建一个工程：

 

 

 工程建好后，登录极光官网，查看官方文档，找到Android SDK集成指南：

 

 

 

 你要先下载一下，Android SDK：

 

 

 

 

 

 下载后，得到一个文件夹，找到libs文件夹下：

 

 

 在main下面新建一个文件夹名为 jniLibs，然后把1拷贝到该文件夹下， 选中2中的jar包右击找到addlibrary，点击就将jar包应用到工程中了：

 

 

 找到工程中的libs文件夹，然后将2拷贝到该文件夹下面：

 

 

然后就开始进行极光推送的配置了，让我们看一下配置文档：

 

 

 将下面的AndroidManifest里面的东西全部拷贝到你的工程中去：特别注意：绿圈的两个必须要加上，不然推送不成功。

 

 

 

拷贝到工程中后，把”你的应用包名“都改成自己工程里面额应用包名，同时这个应用包名也是你在极光平台上创建的应用的包名。这两个包名一定要一样。：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:versionCode="316"
    android:versionName="3.1.6"
    package="com.example.demojiguang">
    <uses-sdk android:minSdkVersion="16" android:targetSdkVersion="30"
        tools:ignore="GradleOverrides" />
    <!-- Required -->
    <permission
        android:name="com.example.demojiguang.permission.JPUSH_MESSAGE"
        android:protectionLevel="signature" />

    <!-- Required -->
    <uses-permission android:name="com.example.demojiguang.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.MOUNT_UNMOUNT_FILESYSTEMS"
        tools:ignore="ProtectedPermissions" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <!-- Optional. Required for location feature -->
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于开启 debug 版本的应用在 6.0 系统上的层叠窗口权限 -->
    <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" />
    <uses-permission android:name="android.permission.VIBRATE" />
    <application
        android:allowBackup="true"
        android:name=".App"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.Demojiguang">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!-- Required SDK 核心功能-->
        <!-- 可配置 android:process 参数将 PushService 放在其他进程中 -->
        <service
            android:name="cn.jpush.android.service.PushService"
            android:enabled="true"
            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.example.demojiguang.DataProvider"
            android:name="cn.jpush.android.service.DataProvider"
            android:exported="true"
            />

        <!-- since 1.8.0 option 可选项。用于同一设备中不同应用的 JPush 服务相互拉起的功能。 -->
        <!-- 若不启用该功能可删除该组件，或把 enabled 设置成 false ；App 不会被其他 App 拉起，但会拉起其他的 App。 -->
        <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.example.demojiguang"/>
            </intent-filter>
        </service>

        <!-- since 3.1.0 Required SDK 核心功能-->
        <provider
            android:authorities="com.example.demojiguang.DownloadProvider"
            android:name="cn.jpush.android.service.DownloadProvider"
            android:exported="true"
            />

        <!-- Required SDK 核心功能-->
        <receiver
            android:name="cn.jpush.android.service.PushReceiver"
            android:enabled="true" >
            <intent-filter android:priority="1000">
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />
                <category android:name="com.example.demojiguang"/>
            </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 核心功能-->
        <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.example.demojiguang" />
            </intent-filter>
        </activity>
        <!-- SDK 核心功能-->
        <activity
            android:name="cn.jpush.android.ui.PopWinActivity"
            android:configChanges="orientation|keyboardHidden"
            android:exported="false"
            android:theme="@style/MyDialogStyle">
            <intent-filter>
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="com.example.demojiguang" />
            </intent-filter>
        </activity>

        <!-- 注意此配置在 JPush 3.2.0 及以前版本是必须配置，3.2.0 以后版本已废弃此配置-->
        <service
            android:name="cn.jpush.android.service.DownloadActivity"
            android:enabled="true"
            android:exported="false"
            tools:ignore="Instantiatable,MissingClass">
        </service>

        <!-- Since JCore2.0.0 Required SDK核心功能-->
        <!-- 可配置android:process参数将Service放在其他进程中；android:enabled属性不能是false -->
        <!-- 这个是自定义Service，要继承极光JCommonService，可以在更多手机平台上使得推送通道保持的更稳定 -->
        <service android:name=".JService"
            android:enabled="true"
            android:exported="false"
            android:process=":pushcore">
            <intent-filter>
                <action android:name="cn.jiguang.user.service.action" />
            </intent-filter>
        </service>

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

        <!-- Required since 3.0.7 -->
        <!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 -->
        <!-- 3.3.0开始所有事件将通过该类回调 -->
        <!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类, 并如下新增一个 Intent-Filter -->
        <receiver
            android:name=".Receiver"
            android:enabled="true"
            android:exported="false" >
            <intent-filter>
                <action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />
                <category android:name="com.example.demojiguang" />
            </intent-filter>
        </receiver>

        <!-- User defined. 用户自定义的广播接收器-->
        <!-- 这是3.3.0之前版本的接收方式，3.3.0开始是通过继承 JPushMessageReceiver并配置来接收所有事件回调。-->
        <!--如-果仍然需要在这个Receiver里接收，需要在JPushMessageReceiver 的子类里不重写对应的回调方法，或者重写方法且调用super-->
        <receiver
            android:name=".MyReceiver"
            android:enabled="true"
            android:exported="false">
            <intent-filter>
                <!--Required 用户注册 SDK 的 intent-->
                <action android:name="cn.jpush.android.intent.REGISTRATION" />
                <!--Required 用户接收 SDK 消息的 intent-->
                <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />
                <!--Required 用户接收 SDK 通知栏信息的 intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />
                <!--Required 用户打开自定义通知栏的 intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
                <!-- 接收网络变化 连接/断开 since 1.6.3 -->
                <action android:name="cn.jpush.android.intent.CONNECTION" />
                <category android:name="com.example.demojiguang" />
            </intent-filter>
        </receiver>

        <!-- User defined. 用户自定义 Receiver 接收被拉起回调-->
        <!-- 自定义 Receiver 组件，继承cn.jpush.android.service.MyWakedResultReceiver类,复写onWake(int wakeType)或 onWake(Context context, int wakeType)方法以监听被拉起 -->
        <receiver android:name=".MyWakedResultReceiver">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.WakedReceiver" />
                <category android:name="${applicationId}" />
            </intent-filter>
        </receiver>

        <!--Required SDK核心功能 since 3.3.0-->
        <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.example.demojiguang" />
            </intent-filter>
        </activity>

        <!-- Required. For publish channel feature -->
        <!-- JPUSH_CHANNEL 是为了方便开发者统计 APK 分发渠道。-->
        <!-- 例如: -->
        <!-- 发到 Google Play 的 APK 可以设置为 google-play; -->
        <!-- 发到其他市场的 APK 可以设置为 xxx-market。 -->
        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
        <!-- Required. AppKey copied from Portal -->
        <meta-data android:name="JPUSH_APPKEY" android:value="4f35d1870bb127eaa59ae13d"/>
    </application>

</manifest>

同时还有一些自定义的推送类会报错，应为你工程离并没有建这些类，你只需要新建一个类按照官方说的集成一下就行了：

 

 注意由于官方给的文档不知道多久没更新了，但是SDK版本可能一直在更新，所以有些类找不到，仔细发现只是类名字换了而已，自己改一下就行了。

 

 

 

 

 

 换掉后，就不会报红了。然后把自定义类建一下，根据官方文档集成类就行了，如果只是做简单的消息推送，不需要对类方法进行实现。

 

 

 

 

 

import android.app.Application;

import cn.jpush.android.api.JPushInterface;

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



package com.example.demojiguang;

import cn.jpush.android.service.JCommonService;

public class JService extends JCommonService {
}



package com.example.demojiguang;

import cn.jpush.android.service.JPushMessageReceiver;

public class MyReceiver extends JPushMessageReceiver {
}



package com.example.demojiguang;

import android.content.Context;

import cn.jpush.android.service.WakedResultReceiver;

public class MyWakedResultReceiver extends WakedResultReceiver {

    public void onWake(Context context, int wakeType){

    }
}
package com.example.demojiguang;


import cn.jpush.android.service.JPushMessageReceiver;

public class Receiver extends JPushMessageReceiver {
}

 

紧接着把极光平台的appkey拷贝到对应的地方，就行了。

 

 

 

 

 

 

 

然后在application里面添加Android：name

 

 

 APP类型上面已经给出，实现推送的主要代码就是：

 

JPushInterface.setDebugMode(true);
 JPushInterface.init(this);

然后整个推送配置就完成了，下面就是推送测试了，首先先运行一下我们建的工程，启动后，我们登入极光平台，找的自己建的应用，创建一个推送：

 

 点击下方的推送，注意目前是广推，也就是只要是登录app的客户端都能街道推送。：

 

 点击发送预览，就能实现推送了。：

 

 

 

 当然这个是广推，我们可以选择给特定用户去做推送：

例如利用RegistrationID，这个是什么意思呢？大致意思就是，当用户使用app登录后，系统自动会生成一个该手机的一个唯一ID，用来识别单个用户的。这就说明一个问题，极光推送同一个账号，只能推送给一个手机，比如张三登陆了a账号，消息推送给他推送了，但是如果李四接着登录a账号，李四能收到推送，而张三就不能了。

 

 如何得到RegistrationID，官方给了方法：

 String registrationID = JPushInterface.getRegistrationID(this.getApplicationContext());
        Log.i("registrationID",registrationID);//打印

机关推送到这里基本实现了，至于后续要怎末自己定义一些推动方式，就看个人了。