Android消息推送之GCM方式（一）

<声明>

转载请保留本来源地址：

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

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

点击“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的发送、接收等操作使用到的工具类和包都有在这里面。

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

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

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

以上完成了开始的准备工作。接下来讲代码的实现：

先讲客户端注册服务。首先要在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

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