creez-des-applications-pour-android

5.4 Créer un AppWidget
la taille de la ligne à la résolution de l’écran.
5.4.2 Définir les propriétés
Maintenant, il faut préciser différents paramètres de l’AppWidget dans un fichier XML. Ce fichier
XML représente un objet de type AppWidgetProviderInfo.
Tout d’abord, la racine est de type et doit définir l’espace de nommage
android, comme ceci :
Vous pouvez définir la hauteur minimale de l’AppWidget avec android:minHeight et sa largeur
minimale avec android:minWidth. Les valeurs à indiquer sont en dp comme pour le layout.
Ensuite, on utilise android:updatePeriodMillis pour définir la fréquence de mise à
jour voulue, en millisecondes. Ainsi, android:updatePeriodMillis="60000" fait une
minute, android:updatePeriodMillis="3600000" fait une heure, etc. Puis on utilise
android:initialLayout pour indiquer la référence au fichier XML qui indique le layout de
l’AppWidget. Enfin, vous pouvez associer une activité qui permettra de configurer l’AppWidget
avec android:configure.
Voici par exemple ce qu’on peut trouver dans un fichier du genre res/xml/appwidget_info.xml :
5.4.3 Le code
5.4.3.1 Le receiver
Le composant de base qui permettra l’interaction avec l’AppWidget est AppWidgetProvider. Il
permet de gérer tous les évènements autour de la vie de l’AppWidget. AppWidgetProvider est
une classe qui dérive de BroadcastReceiver, elle va donc recevoir les divers broadcast intents
qui sont émis et qui sont destinés à l’AppWidget. On retrouve quatre évènements pris en compte :
l’activation, la mise à jour, la désactivation et la suppression. Comme d’habitude, chaque période
de la vie d’un AppWidget est représentée par une méthode de callback.
5.4.3.1.1 La mise à jour La méthode la plus importante est celle relative à la mise à jour, vous
devrez l’implémenter chaque fois. Il s’agit de public void onUpdate(Context context,
AppWidgetManager appWidgetManager, int[] appWidgetIds) avec comme paramètres :
— Le context dans lequel le receiver s’exécute.
— appWidgetManager représente le gestionnaire des AppWidgets, il permet d’avoir des informations
sur tous les AppWidgets disponibles sur le périphérique et de les mettre à jour.
— Les identifiants des AppWidgets à mettre à jour sont contenus dans appWidgetIds.
379