N°3

1. Principe

La navigation entre activités est possible sur android grâce aux intents. Chaque application est découpée en plusieurs activités, ainsi chaque activité est accessible à l’aide d’un intent. Grâce aux intents, on met mettre en place la logique de navigation de l’application et faciliter son utilisation. Cette approche permet de distinguer deux scénarios possibles :

On connait l’activité à lancer On ne connait pas l’activité mais plutôt le type d’action qu’on souhaite

exécuter

2. Navigation entre écrans

La navigation est une brique essentielle de l’expérience utilisateur apportée par une application. Afin de pouvoir exécuter une activité, il faut utiliser la méthode startActivity.

public void startActivity (Intent intent)

Cette méthode utilise un intent qui correspond à l’activité qu’on souhaite exécuter. Pour créer un intent, on utilise le constructeur fourni par la classe Intent.Ce dernier prend en paramètres un contexte ainsi q’une référence vers la classe cible.

Intent (Context pckContext, Class< ?> activityToLaunch)

Si dans une application, on veut passer d’une activité A à une activité B, on utilise le code suivant :

Intent intent=new Intent(A.this,B.class); startActivity(intent);

Page 1 sur 9

Remarque

On n’oublie pas de déclarer de nouvelles activités dans le manifeste de l’application comme suit

3. Passage des données entre écrans

Le passage de données entre différentes vues d’une application s’effectue à l’aide des extras (ils sont portés par les intents). Un extra est un couple de clé/valeur utilisant le système de Bundle1.

Grâce aux intents, on peut passer différents types de donnéesà l’aide de la méthode putExtra. Cette méthode est disponible pour tous les types basiques de Java (int, string, float, double, byte, boolean,etc.). Elle possède deux paramètres :

Une clé identifiant l’élément à insérer La valeur de l’élément

3.1 Exemple

Prenons l’exemple d’un écran de connexion permettant à l’utilisateur de s’identifier à l’application.

Le premier écran représente l’interface de connexion qui se compose de deux zones de saisies et d’un bouton permettant de se connecter.

1 Bundle : Cette classe est une sorte de conteneur pour les données transmissibles d'une activité à l'autre. Elle permet de récupérer tout type de données : long, char, ArrayList ...

Page 2 sur 9

<LinearLayout

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" android:orientation="vertical">

</LinearLayout>

Un second écran permettant d’afficher les informations récupérées sous forme de zones de textes.

Première activité Dans cette activité, il faut :

1. Récupérer les différents éléments composants l’interface 2. Gérer le clic sur le bouton de connexion 3. Au moment de clic, il faut créer un intent qui servira à basculer vers la

deuxième activité. Il aura deux valeurs en extra (login, mot de passe)

private final String EXTRA_LOGIN="login"; private final String EXTRA_PASSWORD="password"; private EditText login; private EditText password; private Button connect;

Page 3 sur 9

@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_identification); login = (EditText) findViewById(R.id.login); password = (EditText) findViewById(R.id.pass); connect = (Button) findViewById(R.id.connect); } public void onClick(View v) { Intent intent = new Intent(Identification.this, Affichage.class); intent.putExtra(EXTRA_LOGIN, login.getText().toString()); intent.putExtra(EXTRA_PASSWORD, password.getText().toString()); startActivity(intent); }

Deuxième activité Dans cette deuxième activité, la récupération se fait comme suit : 1. Récupérer l’intent à l’aide de la méthode getIntent(). 2. Appeler la méthode permettant de récupérer la donnée correspondant au type de donnée cible. Pour les chaines de caractères, on utilise la méthode getStringExtra() en utilisant la même clé que pour l’insertion des données.

3. Pour finir, on associe ces valeurs aux textes de différents éléments

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_affichage); Intent intent =getIntent(); String loginTxt=intent.getStringExtra(EXTRA_LOGIN); String passwordTxt=intent.getStringExtra(EXTRA_PASSWORD); login=(TextView)findViewById(R.id.userLogin); login.setText(loginTxt); password=(TextView)findViewById(R.id.userPassword); password.setText(passwordTxt); }

Manifeste

Page 4 sur 9

3.2 Obtenir un résultat

On peut exécuter une activité afin d’effectuer un traitement et recevoir le résultat dans l’activité source. Par exemple, depuis une Activité A, on peut lancer une activitéB pour permettre à l’utilisateur de spécifier une information puis renvoyer le résultat vers l’activité A. Pour ce faire : 1. On

la méthode

l’activité

exécuter

l’aide

doit

startActivityForResult(Intent,int)

(cid:1) Le premier argument correspond à l’activité que vous souhaitez lancer (cid:1) Le second argument correspond à un code permettant d’identifier le résultat obtenu. Si cet argument est négatif, votre appel équivaut à un appel à la méthode startActivity.

2. On surcharge la méthode onActivityResult(int requestCode, int resultCode,

intent data ). Cette méthode possède trois arguments :

(cid:1) Le premier argument permet d’identifier la provenance du résultat

(identifiant utilisé dans la méthode startActivityForResult)

(cid:1) Le second permet de spécifier le type de résultat (KO/OK). Il est setResult

l’activité cible grâce à

la méthode

spécifié par (RESULT_CANCELD ou RESULT_OK) (cid:1) L’intention contient les données de résultat

Remarque On peut créer d’autres valeurs de retour à la place de celles par défaut (RESULT_CANCELD ou RESULT_OK).

Première activité

Intent intent=new Intent(A.this,B.class); startActivityForResult(intent,RESULT_SELECTION);

Deuxième activité

setResult(RESULT_OK); finish;

Remarque L’utilisation du bouton retour de startActivityResult correspond à un appel setResult(RESULT_CANCELED)

l’appareil sur

l’activité ciblée par

Page 5 sur 9

On peut spécifier des données supplémentaires à l’aide d’un intent.

Intent intent=new Intent(); Intent.putExtra(“RESULT_OK”,false); setResult(RESULT_CANCELED, intent); finish;

Dans l’activité principale, on récupère le résultat en surchargeant la méthode OnActivityResult. @Override Protected void onActivityResult(int requestCode, int resultCode, Intent data) { Super.onActivityResult(requestCode, resultCode,data); If(requestCode==RESULT_SELECTION) {if(resultCode==RESULT_OK) //traitement si ok

Else //traitement si non } }

3.3 Parcelable

Comme vu précédemment, passer des données entre activités à l’aide de Bundle est simple mais possède une limitation sur le type des données utilisables (données natives jave :Strings, int, integer, boolean,etc.). Pour pallier à cela et transférer des objets personnalisés, on utilise les parcelables. Le système de parcel permet de transférer les objets entre les activités. Il ressemble à la sérialisation en java. Pour pouvoir transférer des objets personnalisés, l’objet cible doit implémenter l’interface parcelable. Exemple : faire passer un objet user (Nom, prénom, Tel, email, Twitter)

Création de la classe User

public class User implements Parcelable {

private String nom; private String prenom; private String pseudo; private String email; private String twitter; public User(String nom,String prenom,String pseudo,String email,String

Page 6 sur 9

twitter) { super(); this.nom=nom; this.prenom=prenom; this.email=email; this.pseudo=pseudo; this.twitter=twitter;

} // les methods get et set

public String getNom() {return this.nom;} public void setNom(String nom) {this.nom=nom;}

public String getPrenom() {return this.prenom;} public void setPrenom(String prenom) {this.prenom=prenom;}

public String getPseudo() {return this.pseudo;} public void setPseudo(String pseudo) {this.pseudo=pseudo;}

public String getEmail() {return this.email;} public void setEmail(String email) {this.email=email;}

}

Cette classe doit implémenter l’interface parcelable, il faut pour cela ajouter les deux méthodes suivantes describeContent(),writeToParcel(Parcel par, int drapeaux). La méthode writeToParcel permet d’écrire les paramètres dans le parcel.

@Override public int describeContent() { return 0; }

@Override public void writeToParcel(Parcel par, int drapeaux) { par.writeString(nom); par.writeString(prenom); par.writeString(email); par.writeString(twitter); par.writeString(pseudo);

}

La prochaine étape correspond à la création d’un objet CREATOR permettant de créer

une instance de l’objet User depuis un Parcel dans la classe User.

Page 7 sur 9

public static final Parcelable.Creator<User> CREATOR=new Parcelable.Creator<User>(){ @Override public User createFromParcel(Parcel source) { return new User(source);

}

@Override public User[] newArray ( int size) { return new User[size]; } } ;

public User(Parcel in) { this.nom = in.readString(); this.prenom = in.readString(); this.email = in.readString(); this.twitter = in.readString(); this.pseudo = in.readString();

}

L’ordre de lecture dans la parcelle est le même que dans la méthode writeToParcel

Activité A

De la même façon que des données java, il faut créer l’intent et utiliser la méthode putExtra().

public void onClick(View v) { User user =new User(nom.getText().toString(),prenom.getText().toString(),pseudo.getText(). toString(),email.getText().toString(), twitter.getText().toString()); Intent intent = new Intent(Identification.this, Affichage.class); intent.putExtra(EXTRA_USER, user);

startActivity(intent); }

Activité B

Dans l’activité cible récupérer l’objet user par la method getParcelableExtra() comme suit:

Intent intent =getIntent(); User user=intent.getParcelableExtra(EXTRA_USER);

4. Appeler d’autres applications

Page 8 sur 9

Android permet d’utiliser d’autres applications disponibles sur un appareil afin d’effectuer un traitement. Par exemple, appel à l’application paramètre pour activer ou désactiver un paramètre quelconque. La manière la plus simple est d’utiliser le PackageManager d’android. Il suffit de connaitre le nom de package de l’application cible.

public void onClick(View v) { PackageManager pm=getPackageManager(); Intent intent=pm.getLaunchIntentForPackage("com.android.settings"); if(intent!=null) startActivity(intent);

else { AlertDialog.Builder alert = new AlertDialog.Builder(MainActivity.this); alert.setTitle("Error"); alert.setMessage("Impossible de lancer l'application paramètres"); alert.setNeutralButton("ok", new DialogInterface.OnClickListener() {@Override publ ic void onClick(DialogInterface dialog,int which){dialog.cancel(); }}); } }

recupère une

instance du PackageManager à

(cid:1) on getPackageManager. (cid:1) Recupérer l’intent à l’aide de la méthode getLaunchIntentForPackage en spécifiant le nom du package de l’application cible. (cid:1) On exécute l’application si l’intent est non null si non on affiche un message d’erreur

la méthode

l’aide de

Page 9 sur 9

Navigation and Data Sharing in Android Applications