jean-michel Douin, douin au cnam point fr

Présentation au sujet: "jean-michel Douin, douin au cnam point fr"— Transcription de la présentation:

1 jean-michel Douin, douin au cnam point fr
Android Publish/Subscribe, GCM, Google Cloud Messaging : une introduction jean-michel Douin, douin au cnam point fr version : 6 Mai 2014 Notes de cours

2 Sommaire Le socle, les fondements L’entité Android de base : Receiver
Le patron publish-subscribe L’entité Android de base : Receiver Publication sendBroadcast(Intent i) , sendOrderedBroadcast Souscription onReceive, (BroadcastReceiver) Exemples: Abonnement à un évènement Batterie, réception de SMS Abonnement à une alarme Service déjà installé sur le mobile GCM, Google Cloud Messaging Google/Cloud s’occupe de tout Compte gmail dédié Abonnement de plusieurs mobiles Librairies, BroadcastReceiver et service, prêts à l’emploi Ce qui reste à faire: Une classe dérivée, 4 redéfinitions de méthodes et c’est tout Une architecture logicielle possible, pour discussions

3 Principale bibliographie
Le tutorial indispensable Avant il y avait c2dm Vogella

4 Les fondements Le patron publish/subscribe
Publication à l’occurrence d’un évènement Un sms entrant, la batterie déchargée, … Un évènement engendré par l’utilisateur Souscription à un évènement Agir en conséquence Un médiateur se charge De la réception des évènements, de leur filtrage De la diffusion auprès des souscripteurs sélectionnés Diffusion aléatoire ou ordonnée

5 Publish-Subscribe,cf NSY102
source:

6 Publish-subscribe/ pull-push
Les news d’internet, ou le forum de jfod … Enregistrement d’un « client » à un sujet de discussion, Un des « clients » décide de poster un message, Les utilisateurs à leur initiative vont chercher l’information, Publish-subscribe, mode pull Les listes de diffusion, logiciels de causerie, (« chat ») Abonnement d’un « client » à une liste de diffusion, Tous les abonnés reçoivent ce message, Publish-subscribe, mode push

7 Un exemple, mode push Source:

8 En Java/ notation UML/BlueJ
Source:

9 Android et le patron Publish/Subscribe
Une application Android peut : Souscrire à un thème de publication, réception de SMS, niveau de batterie, … Publier un évènement une alarme à son échéance, un évènement interne à l’application, … Google Cloud Messaging une API prête à l’emploi plusieurs mobiles peuvent souscrire et être notifiés « Over the Air »

10 Android/Publish-Subscribe : les bases
souscription publication Source :

11 Publish-Subscribe/Intent & Context
BroadcastReceiver X,Y Intent

12 Souscription : schéma de programme
Basée sur les Intent (Topic), Context (Mediator), BroadcastReceiver (Subscriber). import android.content.Intent; import android.content.Context; import android.content.BroadcastReceiver; import android.util.Log; public class ReceiverTemplate extends BroadcastReceiver { public void onReceive(Context context, Intent intent) { Log.i(TAG, "onReceive action: "+intent.getAction() ); }

13 Souscription effective
Déclarative, AndroidManifest.xml Au sein d’une application <receiver android:name=".ReceiverTemplate"> <intent-filter> <action android:name=" android.intent.action.SMS_RECEIVED_ACTION " /> </intent-filter> </receiver> Par programme getApplicationContext().registerReceiver( new ReceiverTemplate(), new IntentFilter(Intent.SMS_RECEIVED_ACTION));

14 Par programme Cf. le cycle de vie d’une activité onResume onPause
registerReceiver( … onPause unregisterReceiver( …

15 Les acteurs classe Context, le Mediator
classe BroadcastReceiver, le Subscriber classe Intent + IntentFilter, X,Y les thèmes À suivre: 3 exemples avec le système Android Le niveau de la batterie vient d’être réactualisé, Un sms vient d’arriver, Un évènement de l’utilisateur.

16 Exemple 1 : la batterie a changé d’état
public class LowBatteryActivity extends Activity { private BroadcastReceiver receiver; public void onCreate(Bundle savedInstanceState) { …} public void onResume() { IntentFilter filter = new IntentFilter(Intent.ACTION_BATTERY_CHANGED); this.receiver = new BatteryChangedReceiver(); // Souscription registerReceiver(this.receiver, filter); } public void onPause() { // Dé-souscription unregisterReceiver(this.receiver);

17 // le Souscripteur Le souscripteur }
private static class BatteryChangedReceiver extends BroadcastReceiver { public void onReceive(Context context, Intent intent) { Toast.makeText(context, "battery changed", Toast.LENGTH_SHORT).show(); Log.d(TAG, "onReceive action: "+intent.getAction() ); }

18 La publication par Android ressemblerait à
android.os.BatteryManager Intent broadcastIntent = new Intent(); broadcastIntent.setAction("ACTION_BATTERY_CHANGED"); broadcastIntent.putExtra("level", 3567); // // context.sendBroadcast(broadcastIntent);

19 Exemple 2 : réception d’un SMS
// le souscripteur public class SMSReceiver extends BroadcastReceiver{ @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "sms received", Toast.LENGTH_SHORT).show(); }

20 Configuration du souscripteur, <receiver />
// AndroidManifest.xml // La souscription <receiver android:name=".SMSReceiver"> <intent-filter> <action android:name="android.intent.action.SMS_RECEIVED_ACTION"/> </intent-filter> </receiver> Souscription effectuée (appel implicite de registerReceiver) au chargement de l’application (unregisterReceiver lorsque l’application est détruite)

21 Exemple 3: « un évènement utilisateur »
Ajout, retrait d’un « contrôleur » cf. MVC @Override public void onResume(){ super.onResume(); IntentFilter intentFilter = new IntentFilter(); intentFilter.addAction(Controler.ACTION); registerReceiver(this.controler, intentFilter); public void onPause(){ super.onPause(); unregisterReceiver(this.controler); Avec Controler.ACTION public static final String ACTION = "fr.cnam.list.ITEMS";

22 La classe « Controler », ici gestion d’une liste
Le contrôleur agit sur le modèle, ici une liste (classe Items) public class ItemsControler extends BroadcastReceiver { public static final String ACTION = "fr.cnam.list.ITEMS"; public static final String ADD = "add"; // valeurs public static final String REMOVE = "remove"; private Items items; // le modèle private Context context; // Android framework public ItemsControler(Context context, final Items items){ this.context = context; this.items = items; // le modèle } @Override public void onReceive(final Context context, final Intent intent) { String operation = intent.getStringExtra(OPERATION_KEY); if(operation.equals(ADD)) items.ajouter(intent.getStringExtra(DATA_KEY)); else if(operation.equals(REMOVE)) items.retirer(Integer.parseInt(intent.getStringExtra(DATA_KEY)));

23 Démonstration Un des trois exemples Le contrôleur Optionnels:
Intent.ACTION_BATTERY_CHANGED android.intent.action.SMS_RECEIVED_ACTION

24 Autre façon de souscrire PendingIntent
Intent à effet immédiat PendingIntent à effet retardé Destiné à un tiers A destination d’un service existant AlarmManager, NotificationManager … Souscription auprès du service Exécution de l’intent passé en paramètre, à l’aide d’un PendingIntent

25 Souscription auprès d’un service existant
Intent intent = new Intent(this, ReceiverTemplate.class);                 PendingIntent appIntent = PendingIntent.getBroadcast(this, 0, intent, 0); Calendar calendar = Calendar.getInstance(); calendar.setTimeInMillis(System.currentTimeMillis()); calendar.add(Calendar.SECOND, 3);                 AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);               am.set(AlarmManager.RTC, calendar.getTimeInMillis(), appIntent); // sendBroadcast(intent) par le service d’alarme

26 Variante de l’écriture précédente
PendingIntent appIntent = PendingIntent.getBroadcast (this, 0, new Intent(), 0); Calendar calendar = Calendar.getInstance(); // idem diapositive précédente              am.set(AlarmManager.RTC, calendar.getTimeInMillis(), appIntent); // Ce sont les receveurs déclarés dans AndroidManifest.xml // qui seront déclenchés, (méthode onReceive) // puis sendBroadcast(intent) par le service d’alarme

27 Notification Souvent associée à la réception d’un évènement
Déclenchée par le souscripteur Un « Receiver », un service, … Exemple: Une notification à la réception d’un message sms telnet localhost 5554 send 1234 SMS test message

28 Notification : affichage
private static void generateNotification(Context context, String message) { long when = System.currentTimeMillis(); NotificationManager notificationManager = null; notificationManager(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE); Notification notification = new Notification(R.drawable.ic_launcher,message, when); String title = context.getString(R.string.app_name); Intent intent = // page suivante notification.setLatestEventInfo(context, title, message, intent); notification.flags |= Notification.FLAG_AUTO_CANCEL; notificationManager.notify(0, notification); }

29 Autre exemple : une notification
Au clic sur la notification une application est déclenchée private static void generateNotification(Context context, String message) { long when = System.currentTimeMillis(); NotificationManager notificationManager = null; notificationManager(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE); Notification notification = new Notification(R.drawable.ic_launcher,message, when); String title = context.getString(R.string.app_name); Intent notificationIntent = new Intent(context,GCMClientActivity.class); // afin que l’intent retardée démarre une nouvelle activité notificationIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP); PendingIntent intent = PendingIntent.getActivity(context, 0, notificationIntent, 0); notification.setLatestEventInfo(context, title, message, intent); notification.flags |= Notification.FLAG_AUTO_CANCEL; notificationManager.notify(0, notification); } Source:

30 Autre usage : une notification, sans effet au clic
Au clic sur la notification rien ne se passe private static void generateNotification(Context context, String message) { long when = System.currentTimeMillis(); NotificationManager notificationManager = null; notificationManager(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE); Notification notification = new Notification(R.drawable.ic_launcher,message, when); String title = context.getString(R.string.app_name); PendingIntent intent = PendingIntent.getActivity(context, 0, null, 0); notification.setLatestEventInfo(context, title, message, intent); notification.flags |= Notification.FLAG_AUTO_CANCEL; notificationManager.notify(0, notification); } Source:

31 Démonstration

32 GCM Google Cloud Messaging >= Android 2.2 Message <= 4ko
Anciennement c2dm, Cloud to Delivering Message >= Android 2.2 Message <= 4ko Trafic illimité Nécessite une inscription auprès de Google Avec de préférence un compte gmail que l’on dédiera à cet usage

33 Architecture : Objectifs
Un client, tout système connecté S’adresse au serveur Google qui se chargera de publier auprès des mobiles Mobiles ayant préalablement souscrits Mise en œuvre : une librairie toute prête, un appel de méthode suffit

34 Architecture : Mise en œuvre, inscription
GCM 2)identifiant 3) dépôt de l’identifiant Chaque participant Doit avoir un compte google gmail S’inscrit auprès de GCM, en retour un identifiant lui est attribué Un serveur mémorise, l’identifiant retourné par GCM Un serveur au protocole HTTP de préférence Ces serveur contient les abonnés

35 Architecture : Mise en œuvre, inscriptions
id1 id2 id3 … Le serveur contient une liste des identifiants Un identifiant par application Application : un service sous Android Exemple : Une liste d’identifiants accessible depuis le web

36 Architecture : Mise en œuvre, publications
1) Demande de la liste 2) [id1, id2, id3, ……] 3) Demande de publication [id1, id2, id3, ……] + message id1 message id2 message id3 message Publication par tout système connecté 1,2) Obtention de la liste des identifiants, des abonnés 3) Envoi de cette liste au serveur Google/GCM accompagnée du message à transmettre GCM se charge de publier le message, de le ré-émettre, de le conserver …

37 Architecture : publications
id1 message id2 message id3 message Chaque mobile de la liste [id1, id2, id3, ……] est notifié C’est un « Receiver » prêt à l’emploi qui est déclenché sur chaque mobile Un service prêt à l’emploi est créé afin de prendre en compte cette notification Une de ses méthodes est appelée (onMessage)

38 Le tutorial que l’on se doit de lire

39 Comment ? Création d’un projet auprès des serveurs Google
En retour : un numéro_de_projet (ProjectId) Une API key est nécessaire Exemple ProjectId: , API_KEY: AIzaSyC60sIgG-fB3JSW47X2zGrOqJHGzV1jh0g Un mobile s’inscrit auprès du serveur Google (API_KEY, ProjectId) En retour un jeton d’identification lui est attribué Chaque participant doit posséder un compte gmail Cet identifiant est déposé sur un serveur, connu de tous les participants Envoi d’un message aux participants Obtention de la liste des identifiants auprès du serveur Publication du message Librairies toutes prêtes

40 Création du projet ProjectId API_Key

41 Inscription, mise en oeuvre
2)identifiant 3) dépôt de l’identifiant GCM Depuis une activity 1) Inscription auprès du cloud String regId = GCMRegistrar.getRegistrationId(this); if ("".equals(regId)) { GCMRegistrar.register(this, " "); Démarrage du service… Attente asynchrone de la réponse de GCM

42 Le service hérite d’une classe toute prête
1)inscription 2)identifiant 3) dépôt de l’identifiant GCM public class GCMIntentService extends GCMBaseIntentService { Méthode déclenchée à la suite de la demande d’inscription au GCM 2) onRegistered(Context context, String identifiant) 3) Dépôt de l’identifiant sur un serveur onMessage(Context context, Intent intent) onError …. onUnregistered

43 Liste des indentifiants
1)inscription 2)identifiant 3) dépôt de l’identifiant GCM id1 id2 id3 … id1 id2 id3 … Service web, servlette, php

44 Publication API_KEY + Message id1 id2 id3 …
Envoi de la liste des identifiants au GCM + un message + API_KEY Et se charge de tout

45 Librairie toute prête \android-sdk\extras\google\gcm\gcm-client\dist\
gcm.jar Souscription, abonnement Un service qu’il suffit de dériver public class GCMIntentService extends GCMBaseIntentService { Réception d’un message : un Receiver + un service Un Receiver prêt à l’emploi <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" /> Une classe IntentBaseService qu’il suffit de dériver

46 Démonstration, Obtention du jeton
GCMRegistrar: Classe interface avec le service GCM ProjectId: GCMRegistrar.getRegistrationId(this, " "); Une demande est faite auprès de Google onRegistered(Context context, String regId) Au retour de Google, la méthode du service est déclenchée Le l’identifiant reçu par le mobile: APA91bGy-GWQqqrgyFc652jghpTPygBsKyDHNFPWqzJDCMvtcIx7rtVecmxAYkDItfgztJcEJhyARnx0fmmp6FtqrFKNXqftmGXhRIGM5eObyLY67YkT_Aez3RJeOZFVkOpjv-_FRNASI0ZJL6VQk95Y925MQ9Wihw Exemples ici :

47 Souscription suite Souscription du mobile Permissions
<uses-permission android:name="com.google.android.c2dm.permission.REGISTRATION" /> <uses-permission android:name="android.permission.INTERNET" /> Le receveur, un extrait de AndroiManifest.xml <receiver android:name=".C2DMRegistrationReceiver" android:permission="com.google.android.c2dm.permission.SEND" > <intent-filter > <action android:name="com.google.android.c2dm.intent.REGISTRATION" > </action> </intent-filter> </receiver>

48 Le service public class GCMIntentService extends GCMBaseIntentService
onRegistered(Context context, String regId) Déclenchée par le Receiver pré-installé à la suite de l’abonnement Mémorisation de regId onMessage(Context context, Intent intent) Déclenchée par le Receiver pré-installé à la suite de la réception d’un message String msg = intent.get("message");

49 Publication : le message
Par tout système connecté, \android-sdk-new\extras\google\gcm\gcm-server\dist\ gcm-server.jar Sender sender = new Sender(API_KEY); String msg = "un message"; Message message = new Message.Builder() //.collapseKey("1") .timeToLive(60*60*24) // 24 heures //.timeToLive(0) // maintenant ou jamais .delayWhileIdle(true) .addData("message",msg) .build();

50 Publication : Envoi de message
Publication d’un message Send devices : une liste de regId MulticastResult result = sender.send(message, devices, 5); // 5 essais en cas d’indisponibilité des serveurs google Ensuite le cloud s’occupe de tout …

51 Une architecture possible, publication
De type MVC … un essai pour discussions Rappels: Hypothèse Un receveur et un service prêts à l’emploi Ce service est appelé à chaque publication par le cloud onMessage, onRegistered, onUnregistered, onError A chaque réception d’un message, envoi de celui-ci vers le receveur concerné Un champ du message contient l’ACTION à déclencher … Les receveurs peuvent être locaux à une activité, un service … publish onMessage(…) receveurs

52 Réalisation, onMessage
Émis directement au receveur concerné intentToAnControler(intentFromCloud.getStringExtra(OPERATION_KEY));

53 Réalisation, une variante onMessage
Un contrôleur dédié au cloud est installé Il est chargé de générer un journal, d’effectuer des statistiques, de contrôler… Receveur dédié au cloud publish onMessage(…) Receveur associé à l’ACTION

54 Publication, le contrôleur dédié au cloud pourrait s’en charger…
Receveur dédié au cloud PUBLISH ACTION publish Publication vers le GCM via le contrôleur

55 Démonstration Démonstration Installez cet apk sur votre mobile …
le souscripteur/publieur Les sources

56 Démonstration id1 id2 id3 …
Service web Interrogations La liste des abonnés Un journal des notifications Publication Un formulaire

57

58 Mise en œuvre Répertoire du projet eclipse du client souscripteur
Depuis l’explorateur windows, (eclipse n’est pas démarré) créer un répertoire libs dans lequel vous copiez gcm.jar libs>copy D:\android-sdk\extras\google\gcm\gcm-client\dist\gcm.jar . Répertoire du projet eclipse du client « publieur » créer un répertoire libs dans lequel vous copiez gcm-server.jar libs>copy D:\android-sdk\extras\google\gcm\gcm-server\dist\gcm-server.jar . . Si bluej, installez gcm-server.jar dans le répertoire +libs A l’exécution json est requis D:\android-sdk\extras\google\gcm\gcm-server\lib\json_simple-1.1.jar

59 Conclusion Simple Push/polling (voir en annexe) … Indispensable
Note: Sous eclipse dans le projet créez un dossier libs Dans lequel sont copiés : gcm.jar pour souscrire gcm-server.jar et json-simple-1.1.jar pour publier

60 Annexe consommation en « polling »