Utilisation d'Intents

Imprimer
Détails
Catégorie : Intentions et récepteurs de diffusion
Affichages : 8

Utiliser Intents pour lancer des activités

L'intention la plus courante d'Intents est de connecter vos composants d'application et de communiquer entre eux. Par exemple, les intentions sont utilisées dans Activités pour démarrer de nouvelles activités, vous permettant de créer un flux de travail composé de plusieurs écrans.

 Remarque  Les instructions de cette section concernent le démarrage de nouvelles activités, mais la même approche s'applique également aux services. Des informations détaillées sur le démarrage (et la création) de services sont disponibles au chapitre 11, «Utilisation de l’arrière-plan» Pour créer et afficher une activité, appelez startActivity en transmettant une intention, comme suit:

  1. startActivity(myIntent);
voir

 La méthode startActivity recherche et démarre l'activité unique qui correspond le mieux à votre intention. Vous pouvez construire une intention qui spécifie explicitement le démarrage d'une classe d'activité particulière ou inclure une action que l'activité cible doit pouvoir effectuer. Dans ce dernier cas, le temps d'exécution choisira dynamiquement une activité à travers la résolution de l'intention.  Lorsque vous utilisez startActivity, votre application ne reçoit aucune notification à la fin de l'activité récemment lancée. Pour suivre les commentaires d'une sous-activité, utilisez startActivityForResult, comme décrit plus loin dans ce chapitre.

 Commencer explicitement de nouvelles activités

 «Applications et activités et fragments, Oh My!», Vous avez appris que les applications sont composées d'un certain nombre d'écrans interdépendants (Activités) qui doivent être inclus dans le manifeste de l'application. Pour passer d’une activité à l’autre, vous pouvez indiquer explicitement le début d’une activité en créant une nouvelle intention, en spécifiant le contexte de l’activité en cours et la classe de l’activité à lancer. Une fois défini, transmettez cette intention à startActivity, comme indiqué dans le Listing 6-1, pour lancer la nouvelle activité.

 LISTING 6-1: Lancer explicitement une activité spécifique

  1. Intent intent = new Intent(MyActivity.this, MyOtherActivity.class); startActivity(intent);
voir

 Une fois que startActivity a été appelée, la nouvelle activité (dans cet exemple, MyOtherActivity) est créée, démarrée et reprise - remplaçant MyActivity en haut de la pile d’activités. Lorsque vous appelez la fin de la nouvelle activité ou que vous appuyez sur le bouton de retour du matériel, la ferme et la retire de la pile. Vous pouvez également continuer à naviguer vers d'autres activités à l'aide de startActivity.  Notez que chaque fois que vous appelez startActivity, une nouvelle activité sera ajoutée à la pile. En appuyant sur retour (ou en appelant terminer), chacune de ces activités sera supprimée; Si une activité n'est pas fermée de cette manière, elle restera sur la pile pendant l'exécution de l'application. En conséquence, il est possible d’avoir plusieurs instances de la même activité dans votre pile d’activités.

 Intention implicite et liaison tardive

Une intention implicite est utilisée pour demander au système de rechercher et de démarrer une activité pouvant exécuter une action particulière, sans que vous sachiez exactement quelle application, ou quelle activité, sera démarrée. Par exemple, pour permettre aux utilisateurs de passer des appels depuis votre application, vous pouvez implémenter un nouveau numéroteur ou (si vous ne vous détestez pas), vous pouvez utiliser une intention implicite qui demande que l'action (numérotation) soit effectuée sur un numéro de téléphone ( représenté sous forme d'URI):

 

  1. if (somethingWeird && itDontLookGood) {
  2.  
  3.   Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse("tel:555-2368"));
  4.  
  5.   startActivity(intent); }
voir

 Android résout cette intention en recherchant, puis en démarrant, une activité pouvant exécuter l'action de numérotation sur un URI de numéro de téléphone - dans ce cas, généralement l'application de numérotation téléphonique fournie.  Lors de la construction d'une nouvelle intention implicite, vous spécifiez une action à effectuer et l'URI des données sur lesquelles effectuer cette action. Vous pouvez envoyer des données supplémentaires à l'activité cible en ajoutant des extras à l'intention.  Les suppléments sont un mécanisme utilisé pour attacher des valeurs primitives à une intention. Vous pouvez utiliser la méthode putExtra surchargée sur n’importe quelle intention pour associer une nouvelle paire nom / valeur (NVP):

  1.  intent.putExtra("STRING_EXTRA", "Beverly Hills"); intent.putExtra("INT_EXTRA", 90210);
voir

 Les extras sont stockés dans l’intention sous la forme d’un objet Bundle, disponible à partir de l’activité démarrée à l’aide de la méthode getExtras. Vous pouvez extraire chaque valeur supplémentaire directement de l'intention à l'aide de la méthode get [type] Extra correspondante:

 

  1. Intent intent = getIntent();
  2.  
  3. String myStringExtra = intent.getStringExtra("STRING_EXTRA"); int myIntExtra = intent.getIntExtra("INT_EXTRA", DEFAULT_INT_VALUE);
voir

 Lorsque vous utilisez une intention implicite pour démarrer une activité, Android la résoudra, au moment de l'exécution, dans la classe d'activité la mieux adaptée à l'exécution de l'action requise sur le type de données spécifié. Cela signifie que vous pouvez créer des projets qui utilisent les fonctionnalités d'autres applications sans savoir exactement quelle application vous empruntez à l'avance.  Dans les cas où plusieurs activités peuvent potentiellement effectuer une action donnée, un choix est présenté à l'utilisateur. Le processus de résolution de l’intention est déterminé par une analyse des filtres d’intention des activités, décrits en détail plus loin dans ce chapitre.  Diverses applications natives fournissent des activités capables d'effectuer des actions sur des données spécifiques. Les applications tierces, y compris les vôtres, peuvent être enregistrées pour prendre en charge de nouvelles actions ou fournir un autre fournisseur d'actions natives. Vous serez présenté à certaines des actions natives, ainsi qu'à la façon d'enregistrer vos propres activités pour les prendre en charge, plus loin dans ce chapitre.

 Déterminer si une intention résoudra

Incorporer les activités et les services d'une application tierce à votre propre est incroyablement puissant. Cependant, rien ne garantit qu'une application particulière sera installée sur un périphérique, ni même qu'une application installée est capable de traiter votre demande. Par conséquent, il est recommandé de vérifier si votre intention implicite sera résolue en activité avant de la transmettre à startActivity. Vous pouvez utiliser le gestionnaire de packages pour demander quelle activité, le cas échéant, sera lancée en réponse à une intention particulière en appelant resolActivity sur votre objet Intent, en passant par le gestionnaire de packages, comme indiqué dans le listing 6-2.

 

  1. if (somethingWeird && itDontLookGood) {
  2.   // Create the implicit Intent to use to start a new Activity.
  3.   Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse("tel:555-2368"));
  4.   // Check if an Activity exists to perform this action.
  5.   PackageManager pm = getPackageManager();
  6.   ComponentName cn = intent.resolveActivity(pm);
  7.   if (cn == null) {
  8.     // There is no Activity available to perform the action
  9.     // Log an error and modify app behavior accordingly,
  10.     // typically by disabling the UI element that would allow 
  11.     // users to attempt this action.
  12.     Log.e(TAG, "Intent could not resolve to an Activity.");
  13.   }   else
  14.     startActivity(intent); 
  15. }
voir

Si aucune activité n'est trouvée, vous pouvez choisir de désactiver la fonctionnalité associée (et les contrôles d'interface utilisateur associés) ou de diriger les utilisateurs vers une application appropriée dans le Google Play Store. Notez que Google Play n’est pas disponible sur tous les appareils. C’est donc une bonne pratique de vérifier cela également.

 Retour des résultats des activités

Une activité lancée via startActivity est indépendante de l'activité appelante et ne fournit aucun retour à la fermeture. Lorsqu'un commentaire est requis, vous pouvez démarrer une activité en tant que sous-activité pouvant transmettre les résultats à son parent. Les sous-activités ne sont en réalité que des activités ouvertes différemment; en tant que tel, vous devez toujours les enregistrer dans le manifeste de l'application de la même manière que pour toute autre activité. Toute activité inscrite dans le manifeste peut être ouverte en tant que sous-activité, y compris celles fournies par le système ou des applications tierces. Lorsqu'une sous-activité est terminée, elle déclenche le gestionnaire d'événements onActivityResult dans l'activité parent appelante. Les sous-activités sont particulièrement utiles dans les situations où une activité fournit des données pour une autre, telle qu'un utilisateur qui remplit un formulaire ou sélectionne un élément dans une liste.

 Lancer des sous-activités

La méthode startActivityForResult fonctionne un peu comme startActivity, mais avec une différence importante. En plus de transmettre l'intention explicite ou implicite utilisée pour déterminer quelle activité à lancer, vous transmettez également un code de demande. Cette valeur sera ultérieurement utilisée pour identifier de manière unique la sous-activité qui a renvoyé un résultat. Le Listing 6-3 montre le code squelette pour lancer une sous-activité de manière explicite.

 LISTING 6-3 : Explicitly starting a sub-Activity for a result

 

  1. private static final int SHOW_SUBACTIVITY = 1;
  2. private void startSubActivity() {
  3.   Intent intent = new Intent(this, MyOtherActivity.class); 
  4.   startActivityForResult(intent, SHOW_SUBACTIVITY); 
  5. }
voir

Comme pour les activités ordinaires, vous pouvez démarrer des sous-activités implicitement ou explicitement. Le Listing 6-4 utilise une intention implicite de lancer une nouvelle sous-activité pour choisir un contact. 

LISTING 6-4 : Implicitly starting a sub-Activity for a result

 

  1. private static final int PICK_CONTACT_SUBACTIVITY = 2;
  2. private void startSubActivityImplicitly() {  
  3.   // Create an Intent that requests an Activity capable 
  4.   // of allowing users to pick a contact.
  5.   Uri uri = Uri.parse("content://contacts/people");
  6.   Intent intent = new Intent(Intent.ACTION_PICK, uri); 
  7.   startActivityForResult(intent, PICK_CONTACT_SUBACTIVITY); 
  8. }
voir

Renvoi des résultats d'une sous-activité

Lorsque votre sous-activité est prête à être renvoyée, appelez setResult avant la fin pour renvoyer un résultat à l'activité appelante. La méthode setResult prend deux paramètres: le code de résultat et les données de résultat elles-mêmes, représentées en tant qu'intention. Le code de résultat indique le succès de l'exécution de la sous-activité, généralement l'une ou l'autre. RESULT_OK ou Activity.RESULT_CANCELED. Dans certaines circonstances, où ni le résultat obtenu, ni le résultat obtenu ne sont corrects ou annulés, vous souhaiterez utiliser vos propres codes de réponse pour gérer les choix spécifiques à l’application; setResult prend en charge toute valeur entière. Le résultat recherché comprend souvent un URI de données pointant vers un élément de contenu (tel que le contact sélectionné, le numéro de téléphone ou le fichier multimédia) et un ensemble d’extras utilisés pour renvoyer des informations supplémentaires.Le Listing 6-5, tiré de la méthode onCreate d’une sous-activité, montre comment les boutons OK et Annuler peuvent retourner des résultats différents à l’activité appelante.

 LISTING 6-5: Returning a result from a sub-Activity

 

  1. Button okButton = findViewById(R.id.ok_button); 
  2. okButton.setOnClickListener(new View.OnClickListener() {
  3.   public void onClick(View view) {
  4.     // Create a URI that points to the currently selected item
  5.     Uri selectedHorse = Uri.parse("content://horses/" + selected_horse_id); 
  6.     Intent result = new Intent(Intent.ACTION_PICK, selectedHorse);
  7.     setResult(RESULT_OK, result);
  8.     finish();
  9.   }
  10. }) ;
  11. Button cancelButton = findViewById(R.id.cancel_button); 
  12. cancelButton.setOnClickListener(new View.OnClickListener() { 
  13.   public void onClick(View view) { 
  14.     setResult(RESULT_CANCELED);
  15.     finish();
  16.   }
  17. }) ;
voir

Si l'activité est fermée lorsque l'utilisateur appuie sur la touche de retour matérielle ou si finish est appelé sans qu'un appel à setResult n'ait été préalablement effectué, le code de résultat est défini sur RESULT_CANCELED et le résultat Intent est défini sur null.

 Gestion des résultats de sous-activité

Lorsqu'une sous-activité se ferme, le gestionnaire d'événements onActivityResult est déclenché dans l'activité appelante. Remplacez cette méthode pour gérer les résultats renvoyés par les sous-activités.

 Le gestionnaire onActivityResult reçoit un certain nombre de paramètres:

Le listing 6-6 montre le code squelette pour l'implémentation du gestionnaire d'événements onActivityResult dans une activité. 

LISTING 6-6: Implementing an On Activity Result handler

  1. private static final int SELECT_HORSE = 1; 
  2. private static final int SELECT_GUN = 2;
  3. Uri selectedHorse = null;
  4. Uri selectedGun = null;
  5. @Override
  6. public void onActivityResult(int requestCode,int resultCode,Intent data) {  
  7.  super.onActivityResult(requestCode,resultCode,data);
  8.   switch(requestCode) { 
  9.     case (SELECT_HORSE):
  10.       if (resultCode == Activity.RESULT_OK) 
  11.         selectedHorse = data.getData(); 
  12.       break;
  13.     case (SELECT_GUN):
  14.       if (resultCode == Activity.RESULT_OK)
  15.        selectedGun = data.getData();
  16.       break;
  17.     default: break;
  18.   }
  19. }
voir


Utilisation d'actions natives de la plate-forme pour lancer des activités

Les applications distribuées dans le cadre de la plateforme Android utilisent également Intents pour lancer des activités et des sous-activités. La liste suivante (non exhaustive) répertorie certaines des actions natives disponibles en tant que constantes de chaîne statiques dans la classe d'intention. Lors de la création d'intentions implicites, vous pouvez utiliser ces actions, appelées intentions d'activité, pour démarrer des activités et des sous-activités au sein de vos propres applications.

Remarque Plus tard, vous découvrirez les filtres d'intention et la manière d'enregistrer vos propres activités en tant que gestionnaires pour ces actions.

Remarque Outre ces actions d'activité, Android inclut un grand nombre d'actions de diffusion utilisées pour créer des intentions diffusées afin d'annoncer des événements système.