L Intent. L'intent est un message envoyé au système Android pour lui indiquer que nous avons l'intention de faire quelque chose...

Transcription

1 L Intent L'intent est un message envoyé au système Android pour lui indiquer que nous avons l'intention de faire quelque chose... Android aura alors en charge de trouver l'activité répondant au mieux à cette intention. Pour l'y aider, les classes de type "activité" doivent définir des filtres d'intentions. Cependant, si plusieurs applications répondent à nos critères, Android proposera dans une fenêtre la liste des applications, permettant ainsi à l'utilisateur de choisir celle qui lui conviendra le mieux. Nos intentions peuvent ensuite: - Vouloir lancer une activité interne à notre application - Une activité/service externe à notre application Les filtres d intention Pour qu'une activité puisse être connue et choisie par android lors d'une demande d intention, elle doit en informer le système. Ceci se fera via la balise intent-filter dans le fichier AndroidManifest.xml. Ex : <activity android:name="cnam.nfa25.filtreintention.activiteprincipale" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> Dans la balise "action android", nous indiquons à Android que l'activité " ActivitePrincipale " est l'activité principale : action.main. Lorsque votre application sera lancée, c'est cette activité qui sera exécutée en premier. La balise "category android" indique que cette activité aura une icone dans le menu du lanceur d application : category.launcher Il sera possible d'indiquer d'autres actions ou catégories pour cette activité... 1

2 Les actions de la classe Intent Voici une liste de différentes constantes (non exshautive) utilisables pour effectuer des intentions implicites. Intitulé Action Paramètres entrées ACTION_MAIN ACTION_DIAL ACTION_DEFAULT ACTION_DELETE ACTION_EDIT ACTION_INSERT ACTION_PICK ACTION_SEARCH Indique la classe principale de l'application (point d'entrée) Ouvrir l'activité permettant à l'utilisateur de composer un n de telephone Action synonyme à ACTION_VIEW Supprimer des données Editeur permettant de modifier des données passées en paramètres Insérer des données Sélectionner un élément dans un ensemble de données Effectuer une recherche N de téléphone sous forme URI URI vers les données à supprimer ACTION_SENDTO Envoyer un message contact ACTION_VIEW ACTION_WEB_SEARCH Visualiser une donnée, Afficher une ressource Rechercher sur le WEB URI vers les données à éditer URI où insérer les données URI à partir duquel choisir un élément texte à rechercher URI de la donnée à visualiser site web (commençant par ou mots à rechercher via Google Valeurs sortie L'URI de l'élément sélectionné Content Provider X X X X Il est possible de définir plusieurs actions dans une activité. 2

3 Les catégories de la classe Intent LAUNCHER (C'est le cas de votre activité principale, ce qui permettra d'avoir une icone dans le menu du lanceur d'application). DEFAULT ou ALTERNATIVE. Il sera aussi possible de préciser le type MIME des données manipulées avec l'élément <data android:mimetype="type mime" />. Un type mime étant défini par un type et un sous type (Par exemple text/plain avec text le type et plain le sous type). L'utilisation * comme jocker est possible. Par exemple */* prendra tous les types mimes.(iana) Le routage en interne ou intent explicit Le routage en interne ou encore appelé intention explicite: Il s'agit d'appeler des activités internes à l'application. Nous disposons d une activité principale et de son layout.il suffit de créer une deuxieme activités et un un deuxieme layout afin qu il puisse être appelé par notre activité principale. Ex :ManifestAndroid.xml <activity android:name="cnam.nfa25.authentification.authentification" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> <activity android:name="cnam.nfa25.authentification.validation" > <intent-filter> <action android:name="android.intent.action.view" /> <category android:name="android.intent.category.default" /> </intent-filter> </activity>. android:name doit avoir le nom de la nouvelle classe. Le premier filtre d intention indique : 3

4 Action de type MAIN qui indique à Android que c est votre activité principale. Catégorie de type LAUNCHER indique à Android que cette application aura un lanceur dans le lanceur d application d android. Le 2e filtre d'intention indique: Action de type VIEW, car nous voulons visualiser notre nouvelle ressource Catégorie: Défaut. Instanciation d une intent Intent(contexte d'utilisation (l'instance de la classe Activity en cours), AutreClasseActivity.class); et enfin, lancer l'activité de la nouvelle classe... startactivity(intent); Exemple de code explicite de l application authentification (vu en cours) Authentification.java // Instantiation de l'intent Intent nextscreen = new Intent(getApplicationContext(), Validation.class); // envoi des données a la 2e activité : login et mot de passe nextscreen.putextra("log", login.gettext().tostring()); nextscreen.putextra("pwd", password.gettext().tostring()); // lancement de la 2e activity startactivity(nextscreen); Réception de l intent par le Validation.java //Récuperation de l'intent envoyé de notre activity principale Intent i = getintent(); // Receiving the Data String login = i.getstringextra("log"); String password = i.getstringextra("pwd"); Routage externe ou Intention implicite Lors d'un routage externe, nous n'indiquons plus la classe à atteindre (intention explicite) mais au minimum l'action que nous désirons déclencher et des données (sous forme uri) 4

5 Rien n'empêchera d'utiliser cette solution pour lancer des activités codées dans votre application. Mais à la différence du routage interne, rien ne vous assurera que cette votre activité qui sera lancée plutôt qu'une autre. Les actions (constantes de la classe Intent par exemple Intent.ACTION_VIEW): ACTION_VIEW pour afficher une ressource. (lancer un navigateur web) ACTION_EDIT pour éditer une ressource. ACTION_PICK pour choisir un élément d une collection représenté par la donnée uri. ACTION_DIAL pour afficher une dialogue de sélection (téléphone) ACTION_CALL pour déclencher un appel(téléphone) Les données sous forme uri, comme par exemple "tel: " (Utilisez Uri.parse() pour convertir votre chaîne de caractères url en uri). Pour définir notre intention, nous pourrons utiliser le constructeur Intent (action); Puis définir la donnée via Intent.setData(uri); Ou plus rapide en utilisant le constructeur Intent (action, donnée_uri); Nous pourrons passer d'autres critères. - Un type MIME des données manipulées via Intent.intent.setType(MIME). Attention, les données seront supprimées après cette méthode (setdata()) Il sera possible d'utiliser une méthode plus globale: data + MIME via la méthode setdataandtype() par exemple intent.setdataandtype(uri.parse("file:///tmp/android.c"), "text/plain"). - Une fois l'instance d'intention récupérée, il reste à savoir comment lancer l'activité qui répondra à notre intention. startactivity(intent intent) qui permet de lancer une activité. -Exemple Lancement d un appel téléphonique: // lancement du service d'appel startactivity(new Intent(Intent.ACTION_CALL, Uri.parse("tel: "))); 5

6 Permission du fichier Androidmanifest : <uses-permission android:name="android.permission.call_phone"/> -Exemple Lancement du navigateur : // lancement de l'intent pour bascule sur un navigateur String url = " Intent i = new Intent(Intent.ACTION_VIEW); i.setdata(uri.parse(url)); startactivity(i); Permission du fichier Androidmanifest : <uses-permission android:name="android.permission.internet -Exemple d envoi de sms. Intent i = new Intent(android.content.Intent.ACTION_VIEW); // paramètres nécessaire pour l'envoi d'un SMS, soit le(s) // numéro(s) de téléphone qui doivent recevoir ces SMS // (séparateur est le ;) i.putextra("address", " ; ;"); // corps du message i.putextra("sms_body", "test envoi sms de mon appli android!"); // le MIME pour qu'android sâche quelle application utiliser. i.settype("vnd.android-dir/mms-sms"); Permission du fichier Androidmanifest : startactivity(i); <uses-permission android:name="android.permission.send_sms"/> Exemple d appel de la gallery d image: Intent i = new Intent(android.content.Intent.ACTION_PICK); // le MIME pour qu'android sâche quelle application utiliser. i.settype("image/*"); startactivityforresult(i, ACTIVITY_GALLERY); ); Exemple de déclenchement d une alarme : Intent i = new Intent(AlarmClock.ACTION_SET_ALARM); 6

7 i.putextra(alarmclock.extra_message, "Alarme NFA25"); i.putextra(alarmclock.extra_hour, 19); i.putextra(alarmclock.extra_minutes, 00); startactivity(i); Permission du fichier AndroidManifest : <uses-permission android:name="com.android.alarm.permission.set_alarm"/> -Exemple d envoi de MMS : Intent mms = new Intent(Intent.ACTION_SEND); intent.putextra("sms_body", "image de NFA25"); mms.putextra(intent.extra_stream, imageuri); mms.settype("image/*"); startactivity(mms); Lancer une activité avec récupération d'informations en retour Cependant, nous aurons aussi besoin de lancer des activités et récupérer le résultat de ces activités. Le cas se présentera par exemple avec des intentions implicites utilisant ACTION_PICK qui permet de récupérer des informations d'une activité. Nous utiliserons cette fois la méthode startactivityforresult(intent intent, int requestcode) L'activité qui recevra le résultat (donc celle qui a fait le startactivityforresult) devant recevoir un résultat, devra implémenter la méthode suivante: protected void onactivityresult(int requestcode, int resultcode, Intent intent) { Pour les deux méthodes,startactivity(intent i) ou startactivityforresult(intent intent, int requestcode), des paramètres sont nécessaires: intent n'est plus à présenter, c'est l'instance de l ' intention. requestcode est une valeur que l'on passe à une activité. Cette valeur sera retournée par cette activité permettant ainsi de savoir qui retourne le résultat et donc d'effectuer les traitements en conséquence. Similaire à un identifiant. resultcode est le code retour de l'activité appelé: RESULT_CANCELED, RESULT_OK ou RESULT_FIRST_USER. 7

8 Récupération de résultat de l'activité appelée Généralement, nous voulons récupérer un résultat: Ce résultat pourra être stocké dans l'intention au niveau de data, ou extra data. Pour récupérer cette information, nous utiliserons la méthode String monstring= intent.getstringextra(clefdonnée); De même, pour un entier intent.getintextra(clef), un long intent.getlongextra (clef) Où clef est de type String ereprésente la clef pour accéder à une valeur. Le résultat pourra aussi être stocké dans data. Cette fois, il faudra utiliser la méthode getdata(). Tout le problème est alors de savoir ce que retourne l'activité appelée! Exemple : Nous allons lancer la gallery d images afin de récupérer le nom du fichier de l image selectionné. public class ActivitePrincipale extends Activity { public final static int ACTIVITY_GALLERY = protected void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.activity_activite_principale); Button gal = (Button) findviewbyid(r.id.gallerie); gal.setonclicklistener(new View.OnClickListener() { public void onclick(view v) { // instanciation du generator de son final ToneGenerator tg5 = new ToneGenerator( AudioManager.STREAM_NOTIFICATION, 100); // affectation du type de son et de sa durée de 200ms tg5.starttone(tonegenerator.tone_cdma_alert_call_guard, 200); Intent i = new Intent(android.content.Intent.ACTION_PICK); utiliser. // le MIME pour qu'android sâche quelle application i.settype("image/*"); startactivityforresult(i, ACTIVITY_GALLERY); ); protected void onactivityresult(int requestcode, int resultcode, 8

9 l'appel Intent intent) { // S'il y a lieu, il faudra tester requestcode pour vérifier que // provient bien de notre intention ACTIVITY_GALLERY if (resultcode!= RESULT_CANCELED) { String path; Uri imageuri = intent.getdata(); if (imageuri!= null) { path = imageuri.getstring(); Toast.makeText(this, "Path de l'image:" + path, Toast.LENGTH_LONG).show(); else { Toast.makeText(this, "Pas d'image dans la galerie!", Toast.LENGTH_LONG).show(); else { Toast.makeText(this, "Abandon!", Toast.LENGTH_LONG).show(); Gestion des erreurs lors de la recherche d'une activité Si Android ne parvient pas à trouver une activité répondant à notre intention, une exception est générée: ActivityNotFoundException Mais avant d'en arriver à cela, il est possible de demander ce qu'android ferait comme réponse avant de lancer une activité: Nous utiliserons pour cela le Package Manager qui permet d'obtenir des informations sur les packages qui sont installés sur l'appareil. La création d'une instance de Package Manager se fait de la manière suivante: PackageManager manager = getpackagemanager(); Puis création d'une instance d intent avec les filtres, type mime... Ex : Intent i = new Intent(Intent.ACTION_CALL, Uri.parse("tel:" + phone.gettext())); // lancement du service d'appel startactivity(i); Puis on demande à l'intention de résoudre la recherche ComponentName component = intent.resolveactivity(manager); Si component est null, il n'existe pas d'activité pouvant résoudre la demande. 9

10 Ex : Intent i = new Intent(Intent.ACTION_CALL, Uri.parse("tel:" + phone.gettext())); PackageManager manager = getpackagemanager(); ComponentName component = i.resolveactivity(manager); if (component!= null) { // lancement du service d'appel startactivity(i); else { Toast.makeText(ActivitePrincipale.this, " Aucune activité répondant aux critères!", Toast.LENGTH_LONG).show(); Définir les mimes sous Android pour nos activités L'action étant déclarée dans le fichier AndroidManifest tout comme la catégorie et le mime pour notre activité. Le Mime est donc déclaré dans un intent-filter via l'élément <data android:mimetype="mime" /> Par exemple, si nous voulons que notre application traite les fichiers.txt, il faudra définir le MIME suivant: text/plain Il est important de noter qu'un MIME est composé d'un type et d'un sous type. Le type est ici "text", le sous type est "plain". Sous Android, le type ou le sous-type pourra être positionné à * si vous voulez traiter tous les MIMES de type indiqué (Exemple tous les types text: text/*, ou */* pour tout traiter). Filtres sur le mime Seulement, ce MIME comprend d'autres extentions: g,h,c,cc,hh,m,f90 Si notre activité doit se limiter au.txt, il faudra positionner d'autres critères qui seront des filtres sur l'uri passé: l'uri étant construite de la manière suivante: scheme://host:port/path ou pathprefix ou pathpattern <data android:host="string" android:mimetype="string" android:path="string" android:pathpattern="string" android:pathprefix="string" android:port="string" android:scheme="string" /> scheme: schema host: le serveur déclaré dans une uri par exemple cnam.nfa25.fr ou * pour tous les serveurs. port: le port du chemin uri. 10

11 path: chemin complet. patprefix: Debut du chemin. pathpattern: Chemin pouvant contenir des jockers. * pour remplacer tous les caractères qui suivent le dernier caractère du path: Exemple toto*.* pour commencer la chaîne par n'importe quoi, suivi éventuellement d'une chaîne:.*\\.txt pour traiter tous les fichiers txt quelque soit la localisation et le nom. scheme: pour indiquer le shéma de la source uri file:, (la nature de l'information) sauf que l'on n'indiquera pas les : Si vous ne précisez pas le schéma, le système considèrera content: ou file: Ex de fichier Manifest : <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" package="cnam.nfa25.filtre" android:versioncode="1" android:versionname="1.0" > <uses-sdk android:minsdkversion="8" android:targetsdkversion="19" /> <activity android:name=" cnam.nfa25.filtre" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.view"/> <category android:name="android.intent.category.default"/> <data android:scheme="file" /> <data android:mimetype="text/plain"/> <data android:pathpattern=".*\\.txt" /> <data android:host="*" /> </intent-filter> </activity>...la suite du fichier... Le fait de lancer une nouvelle activité passe l'activité courante en arrière plan. Or, il est possible que cette activité en arrière plan soit supprimée si par exemple la place en mémoire venait à manquer. Cependant, l'utilisateur peut revenir dans cette activité et doit donc retrouver l'activité dans l'état où elle se trouvait initialement. Pour éviter ces désagréments, la méthode onsaveinstancestate() est déclenchée permettant à l'activité de sauvegarder certaines informations. Cette méthode est expliquée dans le cas de la rotation de l écran où l'activité peut se faire détruire pour prendre en compte le nouveau mode portrait/paysage. 11