Module de Programmation Android (LP PRISM AirFrance)

TD8 - Widgets

• la mise en place d'un widget ;
• la mise à jour de l'affichage du widget lors d'évenements ;
• la communication via des intentions asynchrones ;
• la persistance d'un petit jeu de données.

Mise en place

Notre premier widget

• Dans l'arborescence de l'application sous Android Studio, faire un clic droit sur app et aller dans New/Widget/App Widget. Choisissez le nom que vous voulez (par exemple, TD8AppWidget) et regarder les différentes options possibles, sans les modifier.
• Installer l'application sur la tablette ou l'émulateur et attacher le widget au bureau (pour cela, appuyer longtemps sur une partie vide du bureau, et choisir Widgets puis le widget du TD8 dans la liste).

• Le fichier manifests/AndroidManifest.xml déclare un nouveau receveur correspondant à notre widget, avec comme action possible APPWIDGET_UPDATE, car le widget peut être régulièrement mis à jour par le système.
• Le fichier res/xml/td8_app_widget_info.xml contient les méta-données du widget : ce sont notamment les options que l'on a choisies lors de la création du widget, ainsi que d'autres données, comme par exemple l'attribut android:updatePeriodMillis qui donne en millisecondes la période de rafraîchissement du widget (qui est au minimum de 1800000ms, à savoir 30min).
• Le fichier res/layout/td8_app_widget.xml décrit comme toujours l'interface du widget.
• Le fichier java/TD8AppWidget est la partie Java du widget, héritant de la classe AppWidgetProvider. Par défaut, Android Studio surcharge trois méthodes :
  • La méthode onUpdate est appelée à l'installation du widget sur le bureau et à chaque rafraîchissement du widget. Elle sert donc à mettre en place des évènements lorsque l'utilisateur installe le widget, et à effectuer des actions lors des rafraîchissements ; malheureusement, nous n'allons pas pouvoir tester ce deuxième point pendant le TD, car cela se recharge au maximum toutes les 30min (mais je vous invite à tester chez vous). On peut commenter cette méthode (et celle qu'elle appelle) pour l'instant.
  • Les méthodes onEnabled et onDisabled sont appelées respectivement lorsque le premier widget de ce type est ajouté au bureau et lorsque le dernier widget de ce type est supprimé du bureau. On ne s'en servira pas dans ce TD.

Mise à jour du widget

Diffusion d'une intention

• Dans la méthode appelée lorsqu'on clique sur le bouton (clickTheButton dans l'archive fournie), créer une intention destinée à la classe TD8AppWidget et lui associer le score et le niveau (souvenez-vous du TD3).
• Associer également une action à cette intention : c'est une chaîne de caractères non mutable (final static String) identifiant l'action à effectuer.
• Diffuser cette intention.

Réception d'une intention

• Faire appel à la méthode de la super-classe.
• Tester si l'action de l'intention est celle qui nous intéresse.

• Récupérer le score et le niveau de l'intention (toujours comme au TD3).
• Effectuer la mise à jour de la façon suivante :
  
     // Récupération des vues du widget : on n'a accès qu'à quelque chose de restreint
   // (RemoteViews) car ce n'est pas nous qui gérons directement l'interface du widget,
   // mais le bureau sur lequel il est
   RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.td8_app_widget);

   // On modifie les zones du texte en fonction du score et du niveau (remplacer les ids
   // et les variables par ceux que vous aurez choisis) : on ne peut pas accéder
   // directement au vues avec RemoteViews, mais en contrepartie, on a des méthodes
   // effectuant les modifications sur les vues
   views.setTextViewText(R.id.textViewScore, "" + score);
   views.setTextViewText(R.id.textViewLevel, "" + level);

   // On lance la mise à jour du widget
   AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
   ComponentName watchWidget = new ComponentName(context, TD8AppWidget.class);
   appWidgetManager.updateAppWidget(watchWidget, views);

  en remplaçant les noms des variables score, level, R.id.textViewScore et R.id.textViewLevel par ceux que vous avez choisis.

Sauvegarde du score

Sauvegarde lors d'une modification

• Ouvrir les préférences partagées. (On pourra utiliser comme entier MODE_PRIVATE, car on ne veut pas que d'autres applications puissent lire notre score.)
• Démarrer un éditeur pour ces préférences.
• Associer à la clé de votre choix (qui doit être une variable contenant une chaîne de caractères non mutable) le score, puis faire de même avec le niveau.
• Enregistrer ces modifications.

Chargement du score et du niveau au lancement de l'application

• Charger le score et le niveau au lancement de l'application, en lisant ces valeurs dans les préférences partagées.
• Tester.

À vous de jouer

1. Arrêter et relancer l'émulateur (ou éteindre et allumer la tablette). Que se passe-t-il au niveau du widget ? Faites en sorte qu'il retrouve les bonnes valeurs au lancement de l'application.
2. Surcharger la méthode onUpdate pour que l'application se lance lorsqu'on clique sur le widget.

Pour aller plus loin

• tester la mise à jour périodique du widget ;
• fournir un menu de préférences au widget.

• sauvegarder des fichiers ;
• utiliser des bases de données SQL.