appwidget-provider

android:initialLayout="@layout/example_appwidget"

　　android:configure="com.example.android.ExampleAppWidgetConfigure" >

　　< /appwidget-provider>

　　下面是< appwidget-provider>属性的总结：

　　· minWidth 和minHeight 属性的值指定了这个App Widget布局须要的最小区域。

　　缺省的App Widgets所在窗口的桌面位置基于有确切高度和宽度的单元网格。若是App Widget的最小长宽和这些网格单元的尺寸不匹配，那么这个App Widget将收缩到最接近的单元尺寸。(参见App Widget Design Guidelines 以获取更多关于桌面单元尺寸的信息)

　　由于桌面布局方向(由此，单元的尺寸)能够变化，按照拇指规则，你应该假设最坏状况单元尺寸是74像素高和宽。不过，你必须从最后的尺寸中减去2以把像素计算过程当中产生的任何的整数舍入偏差考虑在内。要找到像素密度无关的最小宽度和高度，使用这个公式：

　　(number of cells * 74) - 2

　　遵循这个公式，你应该使用72dp为每个单元高度，294dp为四个单元宽度。

　　· updatePerdiodMillis 属性定义了App Widget框架调用onUpdate()方法来从AppWidgetProvider请求一次更新的频度。实际更新时间并不那么精确，并且咱们建议更新频率越低越好-也许每小时不超过一次以节省电源。你也许还会容许用户在配置中调整这个频率-一些人可能想每15分钟一次股票报价，或者一天只要四次。

　　· initialLayout属性指向定义App Widget布局的资源。

　　· configure属性定义了Activity ，当用户添加App Widget时启动，觉得他或她配置App Widget特性。这是可选的(阅读下面的Creating an App Widget Configuration Activity)。

　　参见AppWidgetProviderInfo 类以获取更多能够被< appwidget-provider>元素接受的属性信息。

　　建立App Widget布局

　　你必须在XML中为你的App Widget定义一个初始布局并保存到项目的res/layout/ 目录下。你可使用以下所列的视图对象来设计你的App Widget，可是在此以前，请先阅读并理解App Widget Design Guidelines.

　　若是你熟悉在XML中声明布局，那么建立这个App Widget布局是很简单的。可是，你必须意识到那个App Widget布局是基于RemoteViews, 这并不支持全部类型的布局或视图小部件。

　　一个RemoteViews对象(以及，相应的，一个App Widget)能够支持下面这个布局类：