Android studio集成百度云推送教程
1 前言
最近研究百度云推送和Android Studio集成,按照官方文档 没有跑成功,官网主要按照Eclipse集成来写的,查了许多资料,都是零零散散的,而且有些关键点都漏掉了,经过总结归纳最终实测成功,记录如下,希望对初学者有所帮助,少走弯路,节省时间。
说明:这里只介绍Android Studio 和 百度云推送的集成,Eclipse和百度云的集成请参考官网即可。
2 Android Studio和百度云推送的集成
JDK 版本:1.8.0_60
Android Studio 3.1.4(推荐)
百度云推送 jar包版本 pushservice-5.6.0.30.jar 下载最新即可
创建工程 选 Android 8.1
https://developer.baidu.com/
1)创建应用
在首页登陆已经注册为开发者的百度账号,然后点击开始使用或右上角的"我的控制台"进入推送控制台
进入推送控制台会进入应用列表页,应用列表页展示目前您在百度开发者中心曾经创建过的所有应用;如果您曾经在旧版管理控制台配置过的应用,新版管理控制台将可以直接使用;对于新创建或从未配置过的应用,则需要进行应用配置之后才可以进行消息发送等操作。
当您需要创建新的应用,请点击应用列表页中的创建应用按钮
随后请为您的应用命名。应用名称可以是中文,数字或英文字母的组合,最长32字符。注意应用名称符合相当法律法规并遵守“云推送”开发者服务协议
创建成功后,可以立刻进行应用配置,也可以稍后通过应用列表中的链接进入。
2)应用配置
如果您是第一次进行某个应用的应用配置,则需要您选择应用的平台(选Android)。在本次配置保存完毕后,应用的平台将不可以更改,请谨慎操作
注意:应用配置的包名 要和APP 的包名一致。
3)Android应用配置包名命名规则
安卓应用需要配置应用的包名,包名的要求如下:
只可以包含大写字母(A到Z)、小写字母(a到z)、数字和下划线、中文,可以用英文句号分隔
每段标识必须以字母或下划线或中文开头
至少包含两段标识符即至少包含一个英文句号
不可包含Java保留字
两段标识符之间有且只能有一个英文句号
4)iOS应用配置(本章不涉及ios集成,可略过)
iOS的应用配置包含以下几个部分
选择应用目前的默认推送模式
iOS应用根据编译过程中采用的证书不同分为开发版应用和生产版应用,两种类型的应用之间消息推送不能互通,即使用开发版证书的应用无法收到以生产版证书的推送,反之亦然。这里的配置会影响iOS推送时的默认应用(使用的证书)类型证书上传
如上述,您需要为iOS应用上传对应的开发版证书和生产版证书,这里要求应用至少上传默认推送模式对应的类型的证书才可以进行应用配置保存操作。
损坏的、过期的证书都会造成证书上传的失败,如果出现此类问题,请获取正确的iOS证书后重新上传
ApiKey是应用标识,在SDK调用过程中唯一标识一个应用 SecretKey是调用API时的Token,用来验证请求的合法性,请注意保密
ApiKey/SecretKey 在应用创建完毕后可以在应用详情页中查到
如果您的SecretKey泄露导致风险,请联系我们以重置SecretKey
应用创建完毕后,在应用详情页可以找到该应用的Demo客户端的下载链接下载,解压后备用(解压后为PushDemo)。
新建的工程 包名要和 百度云推送创建的应用配置的包名一致。
将解压后的libs文件夹中所有文件拷贝到您的工程的libs文件夹中。
在工程中“src/main”目录中新建名为jniLibs的目录,将libs文件夹中除了jar包外的文件夹拷贝到“jniLibs”目录内。 如下图所示:
在当前工程的AndroidManifest.xml文件中,添加权限和声明信息,配置参考官方文档给出的配置(这里不做重复粘贴了) https://push.baidu.com/doc/android/api
配置Manifest文件之后,请将YourPackageName替换成用户自己的包名。
我配置完的文件如下,请参考:
xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.srie.oaapp">
运行需要的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-ermission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
-->
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_DOWNLOAD_MANAGER" />
<uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
富媒体需要声明的权限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.EXPAND_STATUS_BAR" />
适配Android N系统必需的ContentProvider写权限声明,写权限包含应用包名-->
<uses-permission android:name="baidu.push.permission.WRITE_PUSHINFOPROVIDER.com.srie.oaapp" />
<permission
android:name="baidu.push.permission.WRITE_PUSHINFOPROVIDER.com.srie.oaapp"
android:protectionLevel="signature">
</permission>
<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>
用于接收系统消息以保证PushService正常运行 --><receiver android:name="com.baidu.android.pushservice.PushServiceReceiver"
android:process=":bdservice_v1" >
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
<action android:name="com.baidu.android.pushservice.action.notification.SHOW" />
<
action android:name="com.baidu.android.pushservice.action.media.CLICK" />
以下四项为可选的action声明,可大大提高service存活率和消息到达速度 -->
<action android:name="android.intent.action.MEDIA_MOUNTED" />
<action android:name="android.intent.action.USER_PRESENT" />
<action android:name="android.intent.action.ACTION_POWER_CONNECTED" />
<action android:name="android.intent.action.ACTION_POWER_DISCONNECTED" />
</intent-filter>
</receiver>
<receiver android:name="com.baidu.android.pushservice.RegistrationReceiver"
android:process=":bdservice_v1" >
<intent-filter>
<action android:name="com.baidu.android.pushservice.action.METHOD" />
<action android:name="com.baidu.android.pushservice.action.BIND_SYNC" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<data android:scheme="package" />
</intent-filter>
</receiver>
<service android:name="com.baidu.android.pushservice.PushService" android:exported="true"
android:process=":bdservice_v1" >
<intent-filter >
<action android:name="com.baidu.android.pushservice.action.PUSH_SERVICE" />
</intent-filter>
</service>
版本新增的CommandService声明,提升小米和魅族手机上的实际推送到达率 -->
<service android:name="com.baidu.android.pushservice.CommandService"
android:exported="true" />
适配Android N系统必需的ContentProvider声明,写权限包含应用包名-->
<provider
android:name="com.baidu.android.pushservice.PushInfoProvider"
android:authorities="com.srie.oaapp.bdpush"
android:writePermission="baidu.push.permission.WRITE_PUSHINFOPROVIDER.com.srie.oaapp"
android:protectionLevel = "signature"
android:exported="true" />
结束 -->
此处Receiver名字修改为当前包名路径 -->
<receiver android:name="com.srie.oaapp.MyPushMessageReceiver">
<intent-filter>
<action android:name="com.baidu.android.pushservice.action.MESSAGE" />
<action android:name="com.baidu.android.pushservice.action.RECEIVE" />
<action android:name="com.baidu.android.pushservice.action.notification.CLICK" />
</intent-filter>
</receiver>
<meta-data
android:name="api_key"
android:value="11hcYNN12345dUxr4DsjyvSY" />
</application>
</manifest>
2.9 导入 PushMessageReceiver 和 Utils 类
从PushDemo中导入PushMessageReceiver 和 Utils 类
编译 报错,找到报错位置,是因为找不到 PushDemoActivity.class,将其改为自己工程的相应的activity即可。
在当前工程的主Activity的onCreate函数中,添加以下代码:
PushManager.startWork(getApplicationContext(),PushConstants.LOGIN_TYPE_API_KEY,"api_key")
其中的“API Key“需要手动修改为指定应用的API Key。
如果编译通过,到这里就可以真机测试了
否则看2.12是否可以帮助你。
1)编译时,AndroidManifest此句报红
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
解决:当前注释掉此句。
2)连续推送消息手机接收不到
解决:AndroidManifest增加如下权限
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
3)注意模拟器是不能测试消息接收的,必须真机测试。
4)项目编译版本选择请参考我的配置文件 build.gradle
apply plugin: 'com.android.application'
android {
compileSdkVersion 28
defaultConfig {
applicationId "com.srie.oaapp"
minSdkVersion 19
targetSdkVersion 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
implementation 'com.android.support:appcompat-v7:28.0.0-rc02'
implementation 'com.android.support.constraint:constraint-layout:1.1.3'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
implementation files('libs/pushservice-5.6.0.30.jar')
}
5)api key
api key:如果手机端想要接受某个应用(web端通过管理控制台创建的)的推送,那么使用的api key必需和应用一致。如果同一台手机上多个应用使用同一个apikey,只有最后一个初始化的应用能收到推送,所以要为每一个app使用一个唯一的apikey。
6)