Widget con Pulsanti su Android

By massimo|Android

L’obbiettivo è creare un semplice widget, contenete due pulsanti: il primo inizializzerà una notifica nella barra delle notifiche, il secondo avvierà un Activity.

Indice

• Generalità sull’App Widget
• Android Manifest: AndroidManifest.xml
• AppWidgetProviderInfo: button_widget_provider.xml
• AppWidgetProvider
• Activity
• Le View
• Riferimenti e Allegati

Generalità sull’App Widget

Per Creare un widget abbiamo bisogno di 3 cose:

• AppWidgetProvider : Una Classe Java che implementa i metodi del nostro widget
• AppWidgetProviderInfo : Un Oggetto Java che descrive i metadati std per il nostro Widget.
• Una View Per l’interfaccia grafica iniziale.

Android Manifest: AndroidManifest.xml

Iniziamo introducendo nell’AndroidManifest.xml 2 sezioni (evidenziate nel codice)

<!--?xml version="1.0" encoding="utf-8"?-->
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="tests.ButtonWidget"
      android:versionCode="1"
      android:versionName="1.0">
    <uses-sdk android:minSdkVersion="10" />

    <application android:icon="@drawable/icon" android:label="@string/app_name">

 		<!-- Broadcast Receiver that will process AppWidget updates -->
		<receiver android:name=".ButtonWidget" android:label="@string/app_name">
			<intent-filter>
				<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
				<!-- Broadcast Receiver that will also process our self created action -->
				<action android:name="tests.HelloWidget.ButtonWidget.ACTION_WIDGET_RECEIVER"/>
			</intent-filter>
			<meta-data android:name="android.appwidget.provider"
				android:resource="@xml/button_widget_provider" />
		</receiver>

		<!-- this activity will be called, when we fire our self created ACTION_WIDGET_CONFIGURE -->
		<activity android:name=".ClickOneActivity">
			<intent-filter>
				<action android:name="tests.HelloWidget.ButtonWidget.ACTION_WIDGET_CONFIGURE"/>
			</intent-filter>
		</activity>

    </application>
</manifest>

AppWidgetProviderInfo: button_widget_provider.xml

Adesso vediamo un’altro file descrittivo, passiamo a definire il nostro AppWidgetProviderInfo, cioè quell’oggetto che descrive i metadati per un App Widget, come ad esempio il layout iniziale dell’App Widget, la frequenza di aggiornamento, etc…

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
	android:minWidth="146dip"
	android:minHeight="72dip"
	android:updatePeriodMillis="0"
	android:initialLayout="@layout/main"
/>

In questo descrittore xml viene definito:
le dimensioni: Espresse in “dip” (Density Independent Pixels) Px relativi ad uno schermo di 160dpi quindi 1px equivale a 1 dip su uno schermo a 160dpi.
il Periodo di update: 0 indica che il nostro widget non si aggiornarà a intervalli di tempo regolari, ma solo al momento della creazione.
initialLayout: La View iniziale assegnata al nostro widget. (Tutte le view sono definite in fondo alla pagina)

Dopo aver definito le linee base della nostra applicazione passiamo a definire nel dettaglio i metodi della classe AppWidgetProvider.

AppWidgetProvider: Classe ButtonWidget ButtonWidget.java

package tests.ButtonWidget;

import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;
import android.widget.Toast;

public class ButtonWidget extends AppWidgetProvider {
	
	public static String ACTION_WIDGET_CONFIGURE = "ConfigureWidget";
	public static String ACTION_WIDGET_RECEIVER = "ActionReceiverWidget";
	
	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
		Toast.makeText(context, "OnUpdate", Toast.LENGTH_SHORT).show();
		
		RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.main);
		
		// First Intent
		Intent configIntent = new Intent(context, ClickOneActivity.class);
		configIntent.setAction(ACTION_WIDGET_CONFIGURE);
		
		// Second Intent
		Intent active = new Intent(context, ButtonWidget.class);
		active.setAction(ACTION_WIDGET_RECEIVER);
		active.putExtra("msg", "Message for Button 1");
		
		PendingIntent actionPendingIntent = PendingIntent.getBroadcast(context, 0, active, 0);
		PendingIntent configPendingIntent = PendingIntent.getActivity(context, 0, configIntent, 0);
		
		remoteViews.setOnClickPendingIntent(R.id.button_one, actionPendingIntent);
		remoteViews.setOnClickPendingIntent(R.id.button_two, configPendingIntent);
		
		appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
	}
	
	@Override
	public void onReceive(Context context, Intent intent) {
			Toast.makeText(context, "Receive: "+intent.getAction(), Toast.LENGTH_SHORT).show();

			// v1.5 fix that doesn't call onDelete Action
			final String action = intent.getAction();

			if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) {
				final int appWidgetId = intent.getExtras().getInt(
				AppWidgetManager.EXTRA_APPWIDGET_ID,
				AppWidgetManager.INVALID_APPWIDGET_ID);
				if (appWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID) {
					this.onDeleted(context, new int[] { appWidgetId });
				}
			} else {
				// check, if our Action was called
				if (intent.getAction().equals(ACTION_WIDGET_RECEIVER)) {
					String msg = "null";
					try {
						msg = intent.getStringExtra("msg");
					} catch (NullPointerException e) {
						Log.e("Error", "msg = null");
					}
					Toast.makeText(context, msg, Toast.LENGTH_SHORT).show();
					PendingIntent contentIntent = PendingIntent.getActivity(context, 0, intent, 0);
					NotificationManager notificationManager =
						(NotificationManager)context.getSystemService(Context.NOTIFICATION_SERVICE);
					Notification noty = new Notification(R.drawable.icon, "Button 1 clicked",
					System.currentTimeMillis());
					noty.setLatestEventInfo(context, "Notice", msg, contentIntent);
					notificationManager.notify(1, noty);
				}
				super.onReceive(context, intent);
			}
	}
}

Activity:

Definiamo qui l’Activity referenziata a riga 26 dell’AppWidget Provider, sopra definito.
Questa è l’Attività che viene aperta da Sistema Operativo, nel momento in cui con il nostro Bottone lanciamo l’intent ACTION_WIDGET_CONFIGURE.
Abbiamo già associato l’intent a questa activity nel file AndroidManifest.xml.

package tests.HelloWidget;

import android.app.Activity;
import android.os.Bundle;
import android.widget.Toast;

public class ClickOneActivity extends Activity {
	
		@Override
		protected void onCreate(Bundle savedInstanceState) {
			super.onCreate(savedInstanceState);
			// change to our configure view
			setContentView(R.layout.configure);
			// don't call 'this', use 'getApplicationContext()', the activity-object is
			// bigger than just the context because the activity also stores the UI elemtents
			Toast.makeText(getApplicationContext(), "We are in ClickOneActivity",
			Toast.LENGTH_SHORT).show();
		}

}

Le View Utilizzate

main.xml

E’ Il layout utilizzato nel widget.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="fill_parent"
	android:orientation="horizontal"
	android:background="@drawable/widget_bg_normal"
	android:layout_gravity="center"
	android:layout_height="wrap_content">
	
	<Button android:text="B1" android:id="@+id/button_one"
		android:layout_gravity="center_horizontal|center"
		android:layout_height="fill_parent"
		android:layout_width="wrap_content"/>
	
	<Button android:text="B2" android:id="@+id/button_two"
		android:layout_gravity="center_horizontal|center"
		android:layout_height="fill_parent"
		android:layout_width="wrap_content"/>
	
</LinearLayout>

configure.xml

E’ il layout utilizzato nell’Activity ClickOneActivity

<TableLayout android:id="@+id/TableLayout01"
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"
	xmlns:android="http://schemas.android.com/apk/res/android">
	
		<TextView android:layout_width="wrap_content"
			android:layout_height="wrap_content"
			android:id="@+id/TextOne"
			android:text="Text"
			android:textColor="@android:color/white"
			android:textSize="15dip"
			android:textStyle="bold"
			android:layout_marginTop="5dip"/>
		
		<EditText android:layout_width="wrap_content"
			android:layout_height="wrap_content"
			android:id="@+id/txtFieldId"
			android:clickable="true"
			android:inputType="number"
			android:layout_marginTop="5dip"
			android:layout_marginBottom="20dip"/>
		
</TableLayout>

Riferimenti e Allegati