Android消息推送之GCM方式(一)

<声明>

转载请保留本来源地址:

http://blog.csdn.net/wzg_1987/article/details/9140371


首先,你需要使用一个谷歌账号登录谷歌Api控制台页面:https://code.google.com/apis/console,如果你没有在这里创建过任何项目,进入到页面后会显示成以下图片样子:

Android消息推送之GCM方式(一)

点击“Create project”按键后,将引导你创建第一个项目。如果之前有创建项目,将不会看到这个提示,你看到的会是一个面板。点击左上角的下拉菜单,选择“Other projects”-"Create",将会引导你创建一个项目,你的浏览器地址将会形如:https://code.google.com/apis/console/#project:。注意#project:后面的数字812216982441,这将会在后面的GCM服务中作为标识号,用于客户端向谷歌服务器注册。以上是准备工作的第一步。

第二:激活你的GCM服务。

在谷歌Api控制台页面中,选中“Services”项,打开“Google Cloud Messaging for Android”项中的开关并接受协议,激活你账号下的GCM服务。

第三:获得API Key

还是在控制台页面,选中“API Access”。点击“Create New Server Key”,在接下来的界面中直接点“Create”,将会生成一个Api Key,这个Api Key将用来验证发送方。

第四,你的电脑需要具有GCM服务所必须的一些包。这些包可以在Android SDK Manager中下载安装,更新的包名叫Google Cloud Messaging for Android,在Extras展开项中。安装完后,在sdk所在目录\extras\google\gcm中,在这里你会看到gcm的发送、接收等操作使用到的工具类和包都有在这里面。Android消息推送之GCM方式(一)

你可以用eclipse直接import这些项目,并导入里面的几个包,基于这些类文件,我们创建对它们的调用。以上,准备工作已经完毕。下面我们开始讲讲怎么使用。(注:准备工作中,如果安卓设备没有Google Play Services包,还需要另外增加第5步,自己去下载谷歌play的服务包并安装到手机/平板中)

需要注意的是,GMC的方式并没有严格的客户端和服务端的,只要求接收消息的是安卓应用,而发送消息的一方可以是任意程序。可以在你自己搭建的服务器里,可以是同一个安卓应用里,也可以只是一个main函数。不过需要使用到的类和环境就要分别搭建好了。

使用GCMRegistrar和Sender这两个类可以分别实现客户端的注册和发送消息的功能。这两个类就在我们刚才下载的gcm服务包中。(在谷歌play服务包google-play-services.jar包中,有一个GoogleCloudMessaging的类,也可以提供注册客户端和发送消息的方法。不过看了官方文档,和前一种方式差不多。这里先不讲这种方法了。)

以上完成了开始的准备工作。接下来讲代码的实现:Android消息推送之GCM方式(一)

先讲客户端注册服务首先要在AndroidManifest.xml文件里面添加3个GCM/C2DM的权限和必要的网络访问等权限。完整的文件在后面给出。

然后创建一个名为GCMIntentService的android服务,并且继承GCMBaseIntentService这个抽象类并实现里面的几个方法,记得在配置文件里面要申明service。尤其要注意的是,这个service一定要命名为GCMIntentService,并且放到应用包名下。因为GCM的机制会默认使用到这个服务,并且没有提供可以设置为其它服务代替它的方法。

GCMIntentService类:

public class GCMIntentService extends GCMBaseIntentService {
public static final String SENDERID = "812216982441"; public GCMIntentService(){
super(SENDERID);
} @Override
protected void onError(Context arg0, String arg1) {
Log.v("GCMIntentService", "onError错误");
} @Override
protected void onMessage(Context arg0, Intent arg1) {
Log.v("GCMIntentService", "收到新消息:"+arg1.getStringExtra("mine"));
final String info = arg1.getStringExtra("mine");
Handler handler = new Handler(Looper.getMainLooper());
handler.post(new Runnable() { @Override
public void run() {
Toast.makeText(getBaseContext(), "收到新消息:"+info, Toast.LENGTH_LONG).show();
}
});
} @Override
protected void onRegistered(Context arg0, String arg1) {
Log.v("GCMIntentService", "onRegistered注册完成");
} @Override
protected void onUnregistered(Context arg0, String arg1) {
Log.v("GCMIntentService", "onUnregistered注销注册");
} }

这几个方法是结合了GCM的机制的,注意不要误解成了它们是安卓的service的。

onError:在注册客户端或者解除注册出错时调用。

onMessage:客户端收到消息时调用。

onRegistered:注册完成。

onUnregistered:解除注册完成。

“常量”SENDERID是前面在控制台页面创建项目时得到的那个值。

建好服务类后就可以开始注册了。以下是注册的代码片段,直接在Activit的onCreate方法里执行就可以。

protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main); GCMRegistrar.checkDevice(this);
GCMRegistrar.checkManifest(this);
final String regId = GCMRegistrar.getRegistrationId(this);
if (regId.equals("")) {
GCMRegistrar.register(this, GCMIntentService.SENDERID);
Log.v(TAG, "新设备:"+GCMRegistrar.isRegistered(this)+GCMRegistrar.getRegistrationId(this));
} else {
Log.v(TAG, "Already registered");
}
//点击后解除注册,不接收消息
Button btn = (Button) findViewById(R.id.unregist_btn);
btn.setOnClickListener(new OnClickListener() { @Override
public void onClick(View v) {
GCMRegistrar.unregister(getBaseContext());
}
}); }

checkDevice()检查系统版本和是否装有google service frame,否则抛出异常。(GCM服务需要安装有谷歌服务包,且系统版本2.2及以上的才支持)

checkManifest()检查AndroidManifest.xml文件是否有配置有必须的权限,和检测广播接收器是否有正确的权限和过滤器,是否可以正常接收广播。否则抛出异常。

register()真正开始注册一个GCM服务,它会启动一个action名为com.google.android.c2dm.intent.REGISTER的服务。注意这个才是真正的GCM服务,而前面我们自己创建的那个其实并不是GCM服务,只是GCM整个服务机制里面为我们提供的一个业务上的回调而已。

完整的AndroidManifest.xml文件:

<?xml version="1.0" encoding="utf-8"?>
<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="com.ives.androidgcmclient"
android:versionCode="1"
android:versionName="1.0">
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="15"/>
<permission
android:name="com.ives.androidgcmclient.permission.C2D_MESSAGE"
android:protectionLevel="signature"/>
<uses-permission
android:name="com.ives.androidgcmclient.permission.C2D_MESSAGE"/>
<uses-permission
android:name="com.google.android.c2dm.permission.RECEIVE"/>
<uses-permission
android:name="android.permission.INTERNET"/>
<uses-permission
android:name="android.permission.GET_ACCOUNTS"/>
<uses-permission
android:name="android.permission.WAKE_LOCK"/>
<uses-permission
android:name="android.permission.CHANGE_NETWORK_STATE">
</uses-permission>
<uses-permission
android:name="android.permission.CHANGE_WIFI_STATE">
</uses-permission>
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE">
</uses-permission>
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE"/>
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme">
<activity
android:name="com.ives.androidgcmclient.MainActivity"
android:label="@string/app_name">
<intent-filter>
<action
android:name="android.intent.action.MAIN"/> <category
android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity> <receiver
android:name="com.google.android.gcm.GCMBroadcastReceiver"
android:permission="com.google.android.c2dm.permission.SEND">
<intent-filter>
<action
android:name="com.google.android.c2dm.intent.RECEIVE"/>
<action
android:name="com.google.android.c2dm.intent.REGISTRATION"/>
<category
android:name="com.ives.androidgcmclient"/>
</intent-filter>
</receiver>
<service
android:name=".GCMIntentService"/>
</application> </manifest>

以上实现了接收消息的功能。

demo下载:http://download.csdn.net/detail/wzg_1987/5662225

图片及参考自:http://developer.android.com/google/gcm/gs.html

下一节我们接着讲发送消息的实现。

上一篇:安装wampserve之前需要安装vc++2012.


下一篇:Codeforces 436E Cardboard Box (看题解)