Android Widget @ whymca 2011

Android Widget

Fabio Collini

Speaker
Fabio Collini
@fabioCollini

Tech Leader @ OmniaGroup
http://www.omniagroup.it

Android Developer
Apps Organizer e Folder Organizer

Blogger
http://android.devapp.it
http://www.cosenonjaviste.it

Agenda

Introduzione
Esempio widget Android
Scrollable widget
Novità di Android 3.0/3.1

Widget

Cosa si intende per widget?

Il punto di vista dello sviluppatore

Package android.widget
Contiene le view utilizzabili nelle interfacce

Package android.appwidget
Contiene le classi per gestire gli widget nella home

Il punto di vista dell’utente

Pro e contro
Conviene aggiungere uno widget?
Si!
interazione facilitata con l’app
funzionalità sempre a portata di mano
categoria widget sul market

No!
impossibile spostare l’app sulla sd card

Widget minimale

Xml di deﬁnizione provider
Layout
Classe AppWidgetProvider

res/xml/appwidget_provider.xml

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android=
"http://schemas.android.com/apk/res/android"
android:minWidth="294dp"
android:minHeight="72dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/appwidget_loading"
/>

Attributi disponibili
Calcolo della dimensione
(numero di celle * 74) - 2

updatePeriodMillis
millisecondi fra due aggiornamenti

initialLayout
layout iniziale widget
può essere diverso dal layout deﬁnitivo

Android manifest
<receiver android:name=".PicturesAppWidgetProvider"
android:label="1. Normal widget">
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/appwidget_provider" />
<intent-filter>
<action android:name=
"android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
</receiver>

Layout
<LinearLayout xmlns:android=
android:id="@+id/widget_layout"
style="@style/widget_layout">

<ImageView android:id="@+id/img1"
style="@style/picture_thumbnail" />

<ImageView android:id="@+id/img2"
style="@style/picture_thumbnail" />
</LinearLayout>

Layout limitati
Layout:
FrameLayout, LinearLayout e RelativeLayout

View:
AnalogClock
Button
Chronometer
ImageButton
ImageView
ProgressBar
TextView

Stile layout
<style name="widget_layout">
<item name="android:layout_width">
fill_parent</item>
<item name="android:layout_height">
fill_parent</item>
<item name="android:orientation">horizontal</item>
<item name="android:gravity">center</item>
<item name="android:layout_marginLeft">5dip</item>
<item name="android:layout_marginRight">5dip</item>
<item name="android:background">
@drawable/background</item>
</style>

res/drawable/background.xml

<?xml version="1.0" encoding="UTF-8"?>
<shape xmlns:android=
"http://schemas.android.com/apk/res/android">
<stroke android:width="2dp"
android:color="#990634fd" />
<padding android:left="2dp" android:top="2dp"
android:right="2dp" android:bottom="2dp" />
<corners android:radius="4dp" />
<solid android:color="#99FFFFFF" />
</shape>

Android non è solo touch
Device con trackball
Gli utenti blackberry sono abituati a usarla

Device con tastiera
Possono contenere i tasti freccia

Google TV
non avrà un telecomando touch

Stile immagini
<style name="picture_thumbnail">
<item name="android:layout_width">120dip</item>
<item name="android:layout_height">90dip</item>
<item name="android:layout_margin">5dip</item>
<item name="android:focusable">true</item>
<item name="android:background">
@drawable/selection</item>
</style>

StateListDrawable

<selector xmlns:android=
"http://schemas.android.com/apk/res/android">
<item android:state_focused="true"
android:drawable="@drawable/background" />
<item android:state_pressed="true"
android:drawable="@drawable/background" />
</selector>

AppWidgetProvider
Estende BroadcastReceiver
Riscrive onReceive, mette a disposizione:
onUpdate
onDeleted
onEnabled
onDisabled

Bug su Android 1.5
http://groups.google.com/group/android-developers/msg/
e405ca19df2170e2

AppWidgetProvider
public class PicturesAppWidgetProvider
extends AppWidgetProvider {
@Override
public void onUpdate(Context context,
AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
for (int i = 0; i < appWidgetIds.length; i++) {
int appWidgetId = appWidgetIds[i];
updateAppWidget(context, appWidgetManager,
appWidgetId);
}
}
//...
}

updateAppWidget
public static void updateAppWidget(Context context,
AppWidgetManager appWidgetManager, int appWidgetId) {

RemoteViews views = new RemoteViews(context.getPackageName(),
R.layout.appwidget_provider);

views.setImageViewResource(R.id.img1, R.drawable.img1);
views.setImageViewResource(R.id.img2, R.drawable.img2);

views.setOnClickPendingIntent(R.id.img1,
AppWidgetUtils.createPendingIntent(context, 1));
views.setOnClickPendingIntent(R.id.img2,
AppWidgetUtils.createPendingIntent(context, 2));

appWidgetManager.updateAppWidget(appWidgetId, views);
}

RemoteViews
E’ una lista di comandi da effettuare
I comandi vengono eseguiti in un altro processo

Metodi con 3 parametri
id di una view contenuta nel layout
setter da richiamare
valore da impostare

Esempi di metodi
setInt(int viewId, String methodName, int value)
setString(int viewId, String methodName, String value)

PendingIntent
Intent da passare a una app esterna
Creati con un metodo statico
getActivity(Context context, int requestCode, Intent intent, int flags)
getBroadcast(Context context, int requestCode, Intent intent, int
flags)
getService(Context context, int requestCode, Intent intent, int flags)

Attenzione alla cache!
requestCode: private request code for the sender (currently not
used).

PendingIntent

public static Intent createIntent(Context ctx, int pos) {
Intent intent = new Intent(ctx, PictureViewer.class);
intent.putExtra(PictureViewer.IMAGE, "img" + pos);
return intent;
}

public static PendingIntent createPendingIntent(
Context ctx, int pos) {
Intent intent = createIntent(ctx, pos);
return PendingIntent.getActivity(ctx, pos, intent, 0);
}

Activity di configurazione
Può essere configurata nel file xml
Utile quando il widget è configurabile
Alla fine aggiorna manualmente il widget
Aggiungiamo una configurazione al nostro
esempio:
checkbox per nascondere lo sfondo del widget

appwidget_provider_conﬁg.xml

android:configure="org.whymca.appwidget.config.
PicturesAppWidgetConfigure"
/>

Conﬁgurazione nel manifest
<activity
android:name=".config.PicturesAppWidgetConfigure"
android:theme="@android:style/Theme.Dialog"
android:label="@string/Configure_widget">
<intent-filter>
<action
android:name=
"android.appwidget.action.APPWIDGET_CONFIGURE"
/>
</intent-filter>
</activity>

PicturesAppWidgetConﬁgure
public void save(View v) {
boolean checked = showBackgroundCheck.isChecked();
PrefsSaver.saveShowBackground(this,
mAppWidgetId, checked);

PicturesAppWidgetProviderConfig.updateAppWidget(
this, AppWidgetManager.getInstance(this),
mAppWidgetId, checked);

Intent resultValue = new Intent();
resultValue.putExtra(
AppWidgetManager.EXTRA_APPWIDGET_ID, mAppWidgetId);
setResult(RESULT_OK, resultValue);
finish();
}

Impostazione sfondo

if (showBackground) {
views.setInt(R.id.widget_layout,
"setBackgroundResource",
R.drawable.background);
} else {
views.setInt(R.id.widget_layout,
"setBackgroundResource",
0);
}

Attenzione su Android < 2.2

05‐02 22:35:41.544: WARN/AppWidgetHostView(108): 
android.widget.RemoteViews$AcDonExcepDon: view: 
android.widget.LinearLayout can't use method with RemoteViews: 
setBackgroundResource(int)

Home in landscape
Alcune home non hanno orientation ﬁssa
A differenza delle Activity non è possibile decidere l’orientation

I tablet sono in landscape
Device con tastiera
Occorre gestire i layout
directory layout-landscape

Immagini esterne

E se prendiamo le immagini dalla scheda
sd o dagli asset?

Se le immagini sono troppo grandi:
Errore di memoria nella RemoteViews! :(

Uri per ContentProvider
views.setImageViewUri(R.id.img1, createUri("img1"));

private static Uri createUri(String imageName) {
return Uri.parse(
"content://org.whymca.appwidget.pictures/" +
imageName);
}

ContentProvider
<provider android:name=".ImageContentProvider"
android:authorities="org.whymca.appwidget.pictures" />

@Override
public ParcelFileDescriptor openFile(Uri uri, String mode) throws
FileNotFoundException {
String imageName = uri.getPath().substring(1);
File tmpFile = getTempFile(getContext(), imageName);
if (!tmpFile.exists()) {
copyAssetFile(getContext(), imageName, imageName + ".JPG");
}

try {
return ParcelFileDescriptor.open(tmpFile,
ParcelFileDescriptor.MODE_READ_ONLY);
} catch (FileNotFoundException e) {
return null;
}
}

Timeout aggiornamento
onUpdate viene eseguito nel thread
principale
possibili timeout
al riavvio del device ci sono molte app in esecuzione

pratica da seguire: spostare la logica in un
service esterno

Service
public void onUpdate(Context context,
AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
Intent intent = new Intent(context,
PicturesAppWidgetService.class);
intent.putExtra("appWidgetIds", appWidgetIds);
context.startService(intent);
}

updatePeriodMillis
Poco flessibile
tutti gli widget sono aggiornati insieme e con la stessa frequenza

Configurazione fissa
è cablato in un xml

Minimo 30 minuti
anche se nel file xml viene specificato un valore minore

Attivato anche con il telefono in stand by
consumo eccessivo della batteria

AlarmManager
creare un nuovo alarm in onUpdate
BroadcastReceiver deﬁnito nel manifest
un alarm per ogni widget
ogni widget viene aggiornato con frequenza diversa
alarm non eseguito con telefono in stand by

cancellare l’alarm in onDeleted

Widget scrollable

Forum
http://groups.google.com/group/android-appwidget-extensions

Esempio di utilizzo
http://code.google.com/p/scrollablecontacts/

Widget scrollable
Vantaggi
permettono di usare liste e griglie
resize migliore

Difetti
funzionano solo con home replacement (ADW, LauncherPro,
GoLauncher, Home++, ...)
su LauncherPro devono essere abilitati manualmente
lag dovuto a un bug (o feature!) di android
http://code.google.com/p/android/issues/detail?id=4536

Widget Honeycomb
Nuove view utilizzabili:
ListView
GridView
StackView
ViewFlipper
AdapterViewFlipper

Provider con controllo versione
@Override
public void onUpdate(Context context, AppWidgetManager
appWidgetManager, int[] appWidgetIds) {
if (Build.VERSION.SDK_INT >= 11) {
for (int i = 0; i < appWidgetIds.length; i++) {
HoneycombUtils.onUpdateTablet(context,
appWidgetManager, appWidgetIds[i]);
}
} else {
super.onUpdate(context,
appWidgetManager, appWidgetIds);
}
}

HoneycombUtils
public static void onUpdateTablet(Context ctx,
AppWidgetManager appWidgetManager, int id) {
RemoteViews views = new RemoteViews(ctx.getPackageName(),
R.layout.scrollable_layout);

Intent adapterIntent = new Intent(ctx, PicturesService.class);
adapterIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, id);
adapterIntent.setData(Uri.parse(adapterIntent.toUri(
Intent.URI_INTENT_SCHEME)));
views.setRemoteAdapter(id, R.id.grid, adapterIntent);

PendingIntent clickPending = PendingIntent.getActivity(ctx, 0,
new Intent(ctx, PictureViewer.class),
PendingIntent.FLAG_UPDATE_CURRENT);
views.setPendingIntentTemplate(R.id.grid, clickPending);

appWidgetManager.updateAppWidget(id, views);
}

scrollable_layout.xml

<GridView xmlns:android=
android:id="@+id/grid"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:numColumns="auto_fit"
android:columnWidth="120dip"
android:background="@drawable/background" />

PictureService
public class PicturesService
extends RemoteViewsService {
@Override
public RemoteViewsFactory onGetViewFactory(
Intent intent) {
return new PicturesViewsFactory(
this.getApplicationContext(),
intent);
}
}

PicturesViewFactory
public class PicturesViewsFactory implements
RemoteViewsService.RemoteViewsFactory {
@Override
public RemoteViews getViewAt(int position) {
RemoteViews row = new RemoteViews(ctxt.getPackageName(),
R.layout.scrollable_cell);

row.setImageViewUri(R.id.appwidget_image,
createUri("img" + (position + 1)));

Intent intent = new Intent();
intent.putExtra(PictureViewer.IMAGE, "img" + (position + 1));
row.setOnClickFillInIntent(R.id.appwidget_image, intent);

return row;
}
//...

Preview di uno widget
L’emulatore Honeycomb contiene
l’applicazione widget preview
Conﬁgurazione preview
android:previewImage="@drawable/widget_preview" />

Il futuro
“Nuova” feature su Android 3.1
resize degli widget

Tablet / Google TV
su schermi grandi hanno più spazio nella home
molto simile a un sistema operativo desktop

Risorse
Android developer
http://developer.android.com/guide/topics/appwidgets/
index.html
http://developer.android.com/guide/practices/ui_guidelines/
widget_design.html

Scrollable widget
http://groups.google.com/group/android-appwidget-extensions

Honeycomb
http://developer.android.com/sdk/android-3.0-highlights.html

Thanks for your attention!
Questions?
Slide
Presto disponibili su http://www.slideshare.net/

Sorgenti
https://github.com/fabioCollini/whymca2011

Fabio Collini @fabioCollini
http://www.omniagroup.it
http://android.devapp.it
http://www.cosenonjaviste.it

Android Widget @ whymca 2011

More Related Content

Viewers also liked (7)

Similar to Android Widget @ whymca 2011 (20)

More from Fabio Collini (17)

Android Widget @ whymca 2011

Editor's Notes