Création d'une activité répondant à une intention implicite

Maintenant que nous savons créer un mime pour nos activités, il serait bien que ces activités sachent pourquoi elles sont lancées !

Enfin, rien de très compliqué (cela change). Car l'activité lancée connait l'instance de l'intention qui à permis ce lancement.

Récupération des informations de l'intention

Il suffit de le demander via la méthode getIntent() qui retourne cette instance.

Comme toutes les informations sont passées dans cette instance intention (via les setters), alors l'activité pourra en déduire ce qui lui est demandée de faire (via les getters équivalent). Plus de détails dans le chapitre Envoyer/récupérer des données entre deux activités d'un intention.

C'est tellement simple que je me contenterais de mettre un exemple de code basé sur l'exemple de MIME vu précédemment !

Dans cette exemple, lecture de l'instance de l'intention ayant provoquée l'appel à l'activité et affichage des informations sous forme de toast.

package fr.free.supertos.filtresperso; import android.app.Activity; import android.content.Intent; import android.os.Bundle; import android.widget.Toast; public class AffText extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_aff_text); Toast.makeText(this,"affichage du txt perso", Toast.LENGTH_SHORT).show(); Intent intent = getIntent(); Toast.makeText(this,"Informations récupérées - Action:"+intent.getAction()+", catégorie:"+intent.getCategories()+", Data "+intent.getDataString()+", Sheme:"+intent.getScheme(), Toast.LENGTH_LONG).show(); /* Ici le code qui va exploiter ces informations */ } }

Retourner un résultat

Nous avons vu que lors d'un appel implicite, l'activité appelante pouvait récupérer des informations (en utilisant la méthode startActivityForResult) de l'activité appelée.

L'activité appelante devra dans ce cas retourner ces informations !

Ces informations sont:

- Code retour de l'activité appelée dont les deux principaux sont:

• RESULT_OK: L'activité c'est bien déroulée (signé = -1 ou tous les bits sont positionnés 0xffffffff).
• RESULT_CANCELED: Abandon de l'activité (0).

Rien ne vous empêchant de retourner d'autres valeurs (différentes de celles indiqués ci-dessus si possible !) que l'activité appelante devra être en mesure d'interpréter.

Pour retourner cette valeur, il faudra (obligation !) utiliser la méthode setResult(int code_retour, Intent intent); ou setResult(int resultCode);

Terminer l'activité appelé

Il reste maintenant à mettre fin à notre activité appelée pour retourner à notre activité appelante.

Il suffit d'utiliser la méthode finish(); d'une activité.

Cette phase est importante, car c'est elle qui permettra de déclencher la méthode protected void onActivityResult(int requestCode, int resultCode, Intent intent) de l'activité appelante qui pourra alors lire les informations retournées par l'activité appelée.

Exemple de code

Avoir une activité qui affiche des fichiers .txt et une activité qui demande l'affichage d'un .txt

On reprend le fichier manifest pour définir les mimes et les filtres que l'on complétera pour nos activités:

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="fr.free.supertos.filtresperso" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="17" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="fr.free.supertos.filtresperso.MainActivity" android:label="@string/app_name" android:taskAffinity="fr.free.supertos.filtresperso" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name="fr.free.supertos.filtresperso.AffText" 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> </application> </manifest>

Le but n'étant pas ici d'afficher un fichier texte (c'est secondaire), mais d'avoir un squelette d'une activité pouvant répondre à nos besoins. Rendant ainsi le code plus lisible !

package fr.free.supertos.filtresperso; import android.app.Activity; import android.content.Intent; import android.os.Bundle; import android.widget.Toast; public class AffText extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_aff_text); Toast.makeText(this,"affichage du txt perso", Toast.LENGTH_SHORT).show(); Intent intent = getIntent(); Toast.makeText(this,"Informations récupérées - Action:"+intent.getAction()+", catégorie:"+intent.getCategories()+", Data "+intent.getDataString()+", Sheme:"+intent.getScheme(), Toast.LENGTH_LONG).show(); } }

Enfin, L'activité principale (bon, là je ne peux pas faire simple) qui va demander une activité permettant d'afficher un .txt et une activité permettant d'afficher un .c.

Pour le fichier .txt, notre activité devrait être proposée avec d'autres pour permettre l'affichage de celui-ci.

Pour le .c, notre activité filtrant l'extension du fichier, elle ne doit pas être proposée !

package fr.free.supertos.filtresperso; import android.app.Activity; import android.content.ComponentName; import android.content.Intent; import android.content.pm.PackageManager; import android.net.Uri; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.Toast; public class MainActivity extends Activity implements OnClickListener { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); Button button1=(Button)findViewById(R.id.button1); // Récupération de l'instance bouton 1 button1.setOnClickListener(this); // Positionnons un listener sur ce bouton Button button2=(Button)findViewById(R.id.button2); // Récupération de l'instance bouton 2 button2.setOnClickListener(this); // Positionnons un listener sur ce bouton } public void onClick(View view){ Intent intent = new Intent(Intent.ACTION_VIEW); String monTexte=""; if (view.getId()==R.id.button1){ // C'est notre bouton ? oui, alors affichage d'un message intent.setDataAndType(Uri.parse("file:///tmp/android.txt"), "text/plain"); monTexte="Lancer un afficheur de txt perso"; } else { intent.setDataAndType(Uri.parse("file:///tmp/android.c"), "text/plain"); monTexte="Lancer un afficheur de fichier c"; } PackageManager manager = getPackageManager(); ComponentName component = intent.resolveActivity(manager); // On vérifie que component n'est pas null if(component != null) { Toast.makeText(this,monTexte + " - Action:"+intent.getAction()+", Data "+intent.getDataString()+", Sheme:"+intent.getScheme(), Toast.LENGTH_LONG).show(); startActivity(intent); } else { Toast.makeText(this,monTexte + " - Aucune activité répondant aux critères !", Toast.LENGTH_LONG).show(); } } }

Cf. Activité, Listener bouton, les intentions implicites, la gestion des erreurs sur les intentions.

Enfin, les layouts

Pour l'activité principale nommé activity_main.xml:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity" > <Button android:id="@+id/button1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_alignParentLeft="true" android:layout_alignParentTop="true" android:layout_marginLeft="41dp" android:layout_marginTop="59dp" android:text="Afficheur TXT" /> <Button android:id="@+id/button2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_alignBaseline="@+id/button1" android:layout_alignBottom="@+id/button1" android:layout_marginLeft="42dp" android:layout_toRightOf="@+id/button1" android:text="Afficheur C" /> </RelativeLayout>

et celui de l'afficheur de text, nommé activity_aff_text.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".AffTextActivity" > <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_centerVertical="true" android:text="Affichage du fichier txt" /> </RelativeLayout>