概述
Android SDK是为Android平台开发者接入“云推送”服务而提供开发者工具包,开发者需要在应用中正确集成Android SDK才能使安装该应用的Android设备接收到云推送服务端发送的各类消息。
关于如何开通云推送服务,请参考 接入指南,在开通推送服务后,可以通过快速开始一节内容了解如何快速构建一个Android应用并接收消息。
快速开始
下载最新的Android SDK压缩包并解压,使用Eclipse或者Android Studio,导入Android工程示例(Demo)。此时会看到Demo工程中有错误,把工程编码改为UTF-8,再打开左侧目录树,错误存在于PushDemo工程下src文件夹中,com.baidu.push.example包路径下的PushDemoActivity.java文件中。
报错的这一行特别提醒开发者,在特定位置上一定要填上您获得的API Key,否则会绑定失效,无法接收到推送的消息。
首先需要把错误注释掉。
然后将AndroidManifest.xml 122行 “api_key”修改为您的API Key并保存,如下图所示。
右键点击PushDemo工程,选择Run As --> Android Application,运行程序。
选中您已连接的手机设备或Android虚拟机,开始运行Demo。
开发指南
1. 集成SDK
下载最新的Android SDK压缩包并解压,在新建工程或已有工程中增加百度云推送功能,如果您使用的是Demo示例,请直接跳到 推送,注意:如果您的Android工程使用的是Android API level 21及以上的版本,您的通知图标背景必须是透明的,否则在Android5.0及以上的机器上通知图标可能会变成白色的方块。
导入云推送jar包和so文件:
将解压后的libs文件夹中所有文件拷贝到您的工程的libs文件夹中。如果您的工程中没有其他的.so文件,建议只拷贝armeabi文件夹。如果您的工程中还使用了其他的.so文件,只需要拷贝对应目录下的.so文件即可。如果你使用的Android开发环境是Android Stutio,在工程中“src/main”目录中新建名为jniLibs的目录,将libs文件夹中文件拷贝到“jniLibs”目录内。 如下图所示
2. 配置AndroidManifest文件:
在当前工程的AndroidManifest.xml文件中,添加权限和声明信息(请勿修改):
<!-- Push service 运行需要的权限 -->
<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-permission