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:812216982441注意#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所在目录extrasgooglegcm中,在这里你会看到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


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

原文地址:https://www.cnblogs.com/jiangu66/p/3161485.html