Tutoriel Android : apprendre à investir l'écran d'accueil avec les AppWidgets

android:minWidth="180dp"
android:minHeight="250dp"

//Affecte un texte à un TextView (équivalent de TextView.setText)
views.setTextViewText(R.id.textView, context.getString(R.string.app_name) + " : " + i);
//Appelle la méthode passée en paramètre (setClickable) sur le composant en lui passant le paramètre true
views.setBoolean(R.id.checkBox, "setClickable", true);
//Appelle la méthode passée en paramètre (setClickable) sur le composant en lui passant le paramètre true
views.setString(R.id.imageButton, "setText", "La string a afficher");
//Définit la couleur du Texte
views.setTextColor(R.id.textView, Color.GREEN);
//Affiche ou cache un composant
views.setViewVisibility(R.id.imageButton, true);

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName componentName = new ComponentName(context, SimpleWidget.class);
int[] appWidgetIds = appWidgetManager.getAppWidgetIds(componentName);
final int N = appWidgetIds.length; 

// Mise à jour de la vue de l'AppWidget dont l'identifiant est appWidgetId
appWidgetManager.updateAppWidget(appWidgetId, views);

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
  //Nombre d'instances installées
  final int N = appWidgetIds.length;
  //L'objet RemoteViews
  RemoteViews views; 
  // identifiant de l'instance courante
  int appWidgetId

  // Mise à jour de toutes les instances du widget installées (donc une boucle for)
  for (int i = 0; i < N; i++) {
    // identifiant de l'instance courante
    appWidgetId = appWidgetIds[i];
    // Création de la vue
    views = new RemoteViews(context.getPackageName(), R.layout.widget_layout_two);
    //Il n'est pas possible de récupérer un élément de la RemoteViews pour le modifier
    //Il faut utiliser les méthodes de la RemoteViews
    //Affecte une image à un composant (équivalent à ImageView.setImageResource)
    views.setImageViewResource(R.id.imageView, R.drawable.ic_android2ee_bleu_inv);
    //Affecte un texte à un TextView (équivalent de TextView.setText)
    views.setTextViewText(R.id.textView, context.getString(R.string.app_name) + " : " + i);
    // Et surtout demande de mettre à jour l'instance de l'AppWidget dont l'identifiant est appWidgetId avec cette vue
    appWidgetManager.updateAppWidget(appWidgetId, views);
  }
}

/*** The constant to ask to rebuild all the instance of the widget     */
private static final Integer ALL_WIDGETS = -1;

private void updateWidget(Context context, int widgetId) {
  //Retrouver l'instance courante du AppWidgetManager associé à notre context
  AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
  //Instancier le ComponentName qui n'est autre que le nom de la classe relative à notre contexte
  ComponentName componentName = new ComponentName(context, SimpleWidget.class);
  //Retrouver les identifiants des instances de notre AppWidget installées
  int[] appWidgetIds = appWidgetManager.getAppWidgetIds(componentName);
  //Calculer le nombre de ces instances
  final int N = appWidgetIds.length;
  // Déclarer l'objet RemoteView
  RemoteViews views;
  //Trouver l'identifiant de l'image qui mettra à jour l'image dans le widget
  int drawableId= R.drawable.ic_android2ee_blc;
  //identifiant de l'instance courante
  int appWidgetId ;
  // Parcourir toutes les instances et les mettre à jour si l'identifiant correspond
  for (int i = 0; i < N; i++) {
    //Mise à jour de l'identifiant de l'instance
    appWidgetId = appWidgetIds[i];
    //Si cet identifiant est celui passé en paramètre ou si l'identifiant passé en paramètre est la constante pour
    // tous les widgets on met à jour
    if ((widgetId == ALL_WIDGETS) || (widgetId == appWidgetId)) {
      //Instanciation de la RemoteView
      views = new RemoteViews(context.getPackageName(), R.layout.widget_layout_two);
      // Reconstruction de cette RemoteViews
      views.setImageViewResource(R.id.imageView, drawableId);
      views.setTextViewText(R.id.textView, context.getString(R.string.app_name) + " : " + i);
      // Et surtout demande de mettre à jour l'instance de l'instance  avec cette vue
      appWidgetManager.updateAppWidget(appWidgetId, views);
    }
  }
}

        <!-- Broadcast Receiver that will process AppWidget updates -->
        <receiver
            android:label="@string/widget_name"
            android:name=".SimpleWidget" >
            <intent-filter >
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            
            <intent-filter >
                <action android:name="com.android.tuto.widget.simple.sample1.click1" />
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/widget_properties_definition" />
        </receiver>

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
  //Nombre d'instances installées
  final int N = appWidgetIds.length;
  //L'objet RemoteViews
  RemoteViews views; 
  // identifiant de l'instance courante
  int appWidgetId

  // Mise à jour de toutes les instances du widget installées (donc une boucle for)
  for (int i = 0; i < N; i++) {
    // identifiant de l'instance courante
    appWidgetId = appWidgetIds[i];
    // Création de la vue
    views = new RemoteViews(context.getPackageName(), R.layout.widget_layout_two);
    //Il n'est pas possible de récupérer un élément de la RemoteViews pour le modifier
    //Il faut utiliser les méthodes de la RemoteViews
    //Affecte une image à un composant (équivalent à ImageView.setImageResource)
    views.setImageViewResource(R.id.imageView, R.drawable.ic_android2ee_bleu_inv);
    //Affecte un texte à un TextView (équivalent de TextView.setText)
    views.setTextViewText(R.id.textView, context.getString(R.string.app_name) + " : " + i);


    // ->Début de la partie qui nous intéresse&nbsp;:
    //----------------------------------------------------
    // Ajout d'un listener de click
    // Déclaration de l'Intent où INTENT_CLICK1&nbsp;est défini comme suit
    //private static final String INTENT_CLICK1 = "com.android.tuto.widget.simple.sample1.click1";
    Intent intentClick1 = new Intent(INTENT_CLICK1);
    // Ajout de l'identifiant de l'appWidget pour savoir quelle instance envoie cet Intent
    intentClick1.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
    // Création du PendingIntent qui sera envoyé. J'attire votre attention sur le deuxième paramètre
    //qui permet d'associer un unique PendingIntent à votre composant, sinon ils seront identiques 
    // pour toutes les instances de vos widgets et vous ne retrouverez jamais votre paramètre extra de 
    // l'Intent initial
    PendingIntent pendingIntent = PendingIntent.getBroadcast(context, appWidgetId, intentClick1, 0);
    // Affectation de ce PendingIntent à l'action du clic sur le composant souhaité
    views.setOnClickPendingIntent(R.id.imageView, pendingIntent);

    // <-Fin de la partie qui nous intéresse.
    //------------------------------------------------

    // Et surtout demande de mettre à jour l'instance de l'AppWidget dont l'identifiant est appWidgetId avec
    // cette vue
    appWidgetManager.updateAppWidget(appWidgetId, views);
  } 
}

public void onReceive(Context context, Intent intent) {
  super.onReceive(context, intent);
  // ici on traite les intents:
  if (INTENT_CLICK1.equals(intent.getAction())) {
    //Récupération de l'identifiant de l'instance de l'AppWidget qui a envoyé l'Intent
    int appWidgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,ALL_WIDGETS);
    //Appel de la méthode de traitement en lui passant le contexte si elle doit mettre à jour l'IHM
    updateWidget(context,appWidgetId); 
  }
} 

private void updateWidget(Context context, int widgetId) {
  //Retrouver l'instance courante du AppWidgetManager associé à notre context
  AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
  //Instancier le ComponentName qui n'est autre que le nom de la classe relative à notre contexte
  ComponentName componentName = new ComponentName(context, SimpleWidget.class);
  //Retrouver les identifiants des instances de notre AppWidget installées
  int[] appWidgetIds = appWidgetManager.getAppWidgetIds(componentName);
  //Calculer le nombre de ces instances
  final int N = appWidgetIds.length;
  // Déclarer l'objet RemoteView
  RemoteViews views;
  //Trouver l'identifiant de l'image qui mettra à jour l'image dans le widget
  int drawableId= R.drawable.ic_android2ee_blc;
  //identifiant de l'instance courante
  int appWidgetId ;
  // Parcourir toutes les instances et les mettre à jour si l'identifiant correspond
  for (int i = 0; i < N; i++) {
    //Mise à jour de l'identifiant de l'instance
    appWidgetId = appWidgetIds[i];
    //Si cet identifiant est celui passé en paramètre ou si l'identifiant passé en paramètre est la constante pour
    // tous les widgets on met à jour
    if ((widgetId == ALL_WIDGETS) || (widgetId == appWidgetId)) {
      //Instanciation de la RemoteView
      views = new RemoteViews(context.getPackageName(), R.layout.widget_layout_two);
      // Reconstruction de cette RemoteViews
      views.setImageViewResource(R.id.imageView, drawableId);
      views.setTextViewText(R.id.textView, context.getString(R.string.app_name) + " : " + i);
      // Ajout d'un listener de click
      // Déclaration de l'Intent où INTENT_CLICK1&nbsp;est défini comme suit
      //private static final String INTENT_CLICK1 = "com.android.tuto.widget.simple.sample1.click1";
      Intent intentClick1 = new Intent(INTENT_CLICK1);
      // Ajout de l'identifiant de l'appWidget pour savoir quelle instance envoie cet Intent
      intentClick1.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
      // Création du PendingIntent qui sera envoyé. J'attire votre attention sur le deuxième paramètre
      //qui permet d'associer un unique PendingIntent à votre composant, sinon ils seront identiques 
      // pour toutes les instances de vos widgets et vous ne retrouverez jamais votre paramètre extra de 
      // l'Intent initial
      PendingIntent pendingIntent = PendingIntent.
      getBroadcast(context, appWidgetId, intentClick1, 0);
      // Affectation de ce PendingIntent à l'action du clic sur le composant souhaité
      views.setOnClickPendingIntent(R.id.imageView, pendingIntent);

      // Et surtout demande de mettre à jour l'instance de l'instance  avec cette vue
      appWidgetManager.updateAppWidget(appWidgetId, views);
    }
  }
}

<resources>

    ...
    <string name="INTENT_CLICK1">com.android2ee.tuto.appwidget.sample1.click1</string>
    <string name="INTENT_UPDATE">com.android2ee.tuto.appwidget.sample1.update</string>
    ...

</resources>

<receiver
            android:label="@string/widget_name"
            android:name=".AppWidgetTuto" >
            <intent-filter >
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            
            <intent-filter >
                <action android:name="@string/INTENT_CLICK1" />
            </intent-filter>
            
            <intent-filter >
                <action android:name="@string/INTENT_UPDATE" />
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/widget_properties_definition" />
        </receiver>

// Define its Intent
Intent intent = new Intent(context.getResources().getString(R.string.INTENT_UPDATE)); 
.
// Manage the Intent
if (context.getResources().getString(R.string.INTENT_CLICK1).equals(intent.getAction())) {
...