Mon premier Widget sous Android [Tutoriel Android n°25]

Ce framework permet aux développeurs de créer leurs propres Widget. Chaque widget est un BroadcastReceiver couplé avec un fichier XML de metadata qui décrit les détails du Widget. Vous pouvez aussi facilement rajouter un Widget à une application que vous avez déjà créée.

Voici les différentes méthodes que vous pouvez surcharger dans la classe AppWidget :

• OnEnabled() : Appelez quand votre Widget est créé. L’initialisation de votre Widget et ses données peuvent être effectuées ici.
• OnDisabled() : Appelez juste avant que le Widget soit supprimé et suivi de la méthode OnDeleted().
• OnUpdates() : Appelez quand le Widget nécessite une mise à jour de son interface.
• OnDeleted() : Appelez quand le WIdget est supprimé.
• OnReceive() : L’implementation par défaut de cette méthode est de récupèrer un évènement et appelle la méthode correspondante (voir au dessus).

Pour créer un Widget , nous avons besoin des éléments suivants :

• Objet AppWidgetProviderInfo : Il décrit :
  • Les metadatas pour un widget donné.
  • Le AppWidget Layout.
  • Les fréquences de mises à jour du widget
  • La classe AppWidgetProvider (Ce fichier est défini en XML).
• Implémenter la classe AppWidgetProvider : Cette classe définit comment s’effectuent les échanges avec votre Widget. Il est principalement basé sur les événements Broadcast. Donc nous aurons besoin d’un BroadCast Receiver.
• Bien sûr une vue pour votre Widget

Petite explication sur ce code :

• android:minWidth : Largeur minimum du widget.
• android:minHeight : Hauteur minimum du Widget.
• android:updatePeriodMillis : Temps de mise à jour du Widget.
• android:initialLayout : vue qui sera appliqué au Widget.

Modifiez la classe Java (HelloWorldWidgetActivity). Ce qui donnera simplement le code suivant

package com.android.tuto.widget;
import android.appwidget.AppWidgetProvider;
 
public class HelloWorldWidgetActivity extends AppWidgetProvider {
}

Pour finir il faut modifier le manifest comme ci-dessous :

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
	package="com.android.tuto.widget" android:versionCode="1"
	android:versionName="1.0">
	<application android:icon="@drawable/icon" android:label="@string/app_name">
 
 
		<receiver android:name=".HelloWorldWidgetActivity"
			android:label="@string/app_name">
			<intent-filter>
				<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
			</intent-filter>
			<meta-data android:name="android.appwidget.provider"
				android:resource="@xml/my_widget_provider" />
		</receiver>
 
	</application>
 
 
</manifest>

2. Cliquez sur Widget

3. Un autre écran apparaît, il suffit de choisir notre Widget

4. Ce qui donnera

Voila notre premier Widget Hello World est fini.

Conclusion

Donc ce tutoriel s’arrête là, en espérant qu’il vous ait aidé à comprendre comment fonctionnent les Widget et le framwork AppWidget. En espérant que cette collaboration avec tutomobile se poursuive. N’hésitez pas à me contacter sur mon site ou commenter cet article.