本文翻译自Android Developers Blog:Introducing home screen widgets and the AppWidget framework
Android 1.5 SDK一个令人开心的新特性是AppWidget framework,这个框架容许开辟者开辟widgets，这些widgets可以被利用者拖到利用者的桌面并且可以交互。widgets可以提供一个full-featured apps的预览，比喻可以表现即将到来的日历变乱，大概一首背景播放的歌曲的过细信息。
当widgets被拖到桌面上，他们被指定一个生存的空间来表现应用提供的自定义内容。利用者可以通过这个widget来和你的应用交互，比喻停息或切换歌曲。要是你有一个背景办事，你可以根据你本身的schedule更新你的widget，大概利用AppWidget framework提供的一个主动的更新机制。
在更高层次上，每个widget便是一个BroadcastReceiver，他们用XML metadata来形貌widget的细节。AppWidget framework通过broadcast intents和你的widget通讯，比喻当须要更新的时间。Widget更新利用RemoteViews被构建和发送。这个RemoteViews被包装成一个layout和特定内容来表现到桌面上。
你可以非常容易的增长widgets到你的应用中，在这篇文章里我将给一个大抵的例子：写一个widget来表现Wiktionary “Word of the day.”你可以从这里获取全部的源代码，我将在这里表明Appwidget干系的代码。
起首，你须要一个XML metadata形貌这个widget,包括你想在桌面上生存的地区，一个你想展示的初始的layout，和你操持何时更新。Android桌面默认利用cell-based layout,因而它会rounds你恳求的尺寸为最靠近的cell的尺寸。这是有点利诱，不过这里有个公式可以资助你：
Minimum size in dip = (Number of cells * 74dip) – 2dip
在这个例子中，我想使我们的widget占用2 cells的宽度和1 cell的高度，这意味着我应该恳求的最小尺寸为146dip * 72dip。我们将要每天更新一次我们的widget，约莫是每86,400,000毫秒更新一次。以下是我们的widget的XML metadata:
接下来，让我们把XML metadata捆绑到AndroidManifest的BroadcasrReicever:
着末，让我们写BroadcastReceiver的代码来处理惩罚处罚AppWidget的恳求。为了资助widgets办理全部
broadcasr变乱，有个helper class叫AppWidgetProvider，这里我们将利用这个类。此中须要过细的最告急的一件事是我们将调用一个背景办本相行定期的更新。这是因BroadcastReceivers是一个Application Not Responding(ANR) timer,这意味着要是运行时间太长，大概须要提示利用者陵暴封闭我们的应用。制作一个web恳求大概须要淹灭一些时间，因此我们利用办事来克制ANR timeouts.
/**
* Define a simple widget that shows the Wiktionary “Word of the day.” To build
* an update we spawn a background {@link Service} to perform the API queries.
*/
public class WordWidget extends AppWidgetProvider {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
// To prevent any ANR timeouts, we perform the update in a service
context.startService(new Intent(context, UpdateService.class));
}
public static class UpdateService extends Service {
@Override
public void onStart(Intent intent, int startId) {
// Build the widget update for today
RemoteViews updateViews = buildUpdate(this);
// Push update for this widget to the home screen
ComponentName thisWidget = new ComponentName(this, WordWidget.class);
AppWidgetManager manager = AppWidgetManager.getInstance(this);
manager.updateAppWidget(thisWidget, updateViews);
}
/**
* Build a widget update to show the current Wiktionary
* “Word of the day.” Will block until the online API returns.
*/
public RemoteViews buildUpdate(Context context) {
// Pick out month names from resources
Resources res = context.getResources();
String[] monthNames = res.getStringArray(R.array.month_names);
// Find current month and day
Time today = new Time();
today.setToNow();
// Build today’s page title, like “Wiktionary:Word of the day/March 21″
String pageName = res.getString(R.string.template_wotd_title,
monthNames[today.month], today.monthDay);
RemoteViews updateViews = null;
String pageContent = “”;
try {
// Try querying the Wiktionary API for today’s word
SimpleWikiHelper.prepareUserAgent(context);
pageContent = SimpleWikiHelper.getPageContent(pageName, false);
} catch (ApiException e) {
Log.e(”WordWidget”, “Couldn’t contact API”, e);
} catch (ParseException e) {
Log.e(”WordWidget”, “Couldn’t parse API response”, e);
}
// Use a regular expression to parse out the word and its definition
Pattern pattern = Pattern.compile(SimpleWikiHelper.WORD_OF_DAY_REGEX);
Matcher matcher = pattern.matcher(pageContent);
if (matcher.find()) {
// Build an update that holds the updated widget contents
updateViews = new RemoteViews(context.getPackageName(), R.layout.widget_word);
String wordTitle = matcher.group(1);
updateViews.setTextViewText(R.id.word_title, wordTitle);
updateViews.setTextViewText(R.id.word_type, matcher.group(2));
updateViews.setTextViewText(R.id.definition, matcher.group(3).trim());
// When user clicks on widget, launch to Wiktionary definition page
String definePage = res.getString(R.string.template_define_url,
Uri.encode(wordTitle));
Intent defineIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(definePage));
PendingIntent pendingIntent = PendingIntent.getActivity(context,
0 /* no requestCode */, defineIntent, 0 /* no flags */);
updateViews.setOnClickPendingIntent(R.id.widget, pendingIntent);
} else {
// Didn’t find word of day, so show error message
updateViews = new RemoteViews(context.getPackageName(),
R.layout.widget_message);
CharSequence errorMessage = context.getText(R.string.widget_error);
updateViews.setTextViewText(R.id.message, errorMessage);
}
return updateViews;
}
@Override public IBinder onBind(Intent intent) {
// We don’t need to bind to this service
return null;
}
}
}
到这里，你已经完成了一个大抵的widget，它将表现Wiktionary “Word of the day.”。当一个更新被恳求时，我们读在线API将最新的数据push到widget上。AppWidget framework会按我们的须要主动更新，比喻当一个新的widget增长时，大概新的一天加载新的Word of the day.”。
着末，这里给出一些提倡。Widgets保举被筹划成longer-term的内容，不该该通常的被更新。超过跨过每小时的频繁更新会快速斲丧失电量和带宽。提倡尽大概的不要频繁更新，大概让你的利用者自定义一个更新周期。比喻有些人大概想stock ticker每15分钟更新一次，大概大概是一天更新四次。我将在我的另一篇文章giving at Google I/O讨论节流电量的一些分外的战略。
着末要提的一件比较酷的事是AppWidget framework对方向并不体贴(is abstracted in both directions).这意味着你可以在两个home screen都可以包括widgets。你的widgets可以被增长到恣意一个增援AppWidgetframework的home screen上。
我们已经开辟了几个本身的widgets，比喻Calendar和Music widgets,但是我们更渴望看到你开辟的widgets.
QQ登录
支付宝登录
