android窗体小部件

Widget 窗体小部件

应用:如桌面天气、桌面时钟、桌面音乐等等。被很多应用所采用。方便用户操作,更好的得到消息。如下图

 

实现:

你需要知道一下两个对象:

AppWidgetProviderInfo对象

描述了一个小部件的元数据,如小部件的布局,更新频率,和AppWidgetProvider类。这需要在XML中自定义。

AppWidgetProvider类的实现

自定义基本方法,允许你实现App Widget接口。基于广播事件。通过此方法,当Widget更新、启动、禁用和删除时,将接收到广播。

 

对于Widget小部件的界面通过自定义XML文件进行实现。

实现步骤:

一、在AppAndroidManifest.xmlAppWidgetProvider类的声明

例如:

<receiver android:name="ExampleAppWidgetProvider" >
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/example_appwidget_info" />
</receiver>

The <receiver> element requires the android:name attribute, which specifies the AppWidgetProvider used by the App Widget.

The <intentfilter> element must include an <action> element with the android:name attribute. This attribute specifies that the AppWidgetProvider accepts the ACTION_APPWIDGET_UPDATE broadcast. This is the only broadcast that you must explicitly declare. The AppWidgetManager automatically sends all other App Widget broadcasts to the AppWidgetProvider as necessary.

The <meta-data> element specifies the AppWidgetProviderInfo resource and requires the following attributes:

android:name - 指定元数据名称。 使用android。 窗口小部件。数据提供程序确定为theAppWidgetProviderInfo描述符。

android:resource -指定AppWidgetProviderInfo的布局文件.xml

二、该AppWidgetProviderInfo定义了小部件的基本信息,如其最小尺寸布局,其初始布局资源时,小部件的更新频率,和(可选)创建时配置活动正在展开。AppWidgetProviderInfo对象定义在XML资源使用单个元素并将其保存在xml项目的res/xml/文件夹下。

例如:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:updatePeriodMillis="86400000"
    android:previewImage="@drawable/preview"
    android:initialLayout="@layout/example_appwidget"
    android:configure="com.example.android.ExampleAppWidgetConfigure" 
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen">
</appwidget-provider>

 

三、对widget布局文件xml的自定义,这里就不在阐述。

四、AppWidgetProvider类的实现,通过继承AppWidgetProvider进行实现,

例如:

public class ExampleAppWidgetProvider extends AppWidgetProvider {

    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        final int N = appWidgetIds.length;
        // Perform this loop procedure for each App Widget that belongs to this provider
        for (int i=0; i<N; i++) {
            int appWidgetId = appWidgetIds[i];
            // Create an Intent to launch ExampleActivity
            Intent intent = new Intent(context, ExampleActivity.class);
            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
            // Get the layout for the App Widget and attach an on-click listener
            // to the button
            RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);
            views.setOnClickPendingIntent(R.id.button, pendingIntent);
            // Tell the AppWidgetManager to perform an update on the current app widget
            appWidgetManager.updateAppWidget(appWidgetId, views);
        }
    }
}

注意点:由于AppWidgetProvider是一个以广播的形式进行的,您的线程不能保证在该回调方法返回后,继续运行(见广播支持有关广播的信息生命周期)。

如果您的应用程序构件安装过程可能需要几秒钟(也许在执行web请求),并且需要您的流程仍在继续,考虑启动一个Service在onUpdate()方法中进行。从服务中,您可以执行您自己的小部件的更新,不用担心AppWidgetProvider关闭由于应用程序没有响应(ANR)错误。

五、接收Widget的广播

可以通过实现自己的BroadcastReceiver或者重写onReceiver(Context,Intent)返回,对于意图你需要关心如下:

· ACTION_APPWIDGET_UPDATE

· ACTION_APPWIDGET_DELETED

· ACTION_APPWIDGET_ENABLED

· ACTION_APPWIDGET_DISABLED

· ACTION_APPWIDGET_OPTIONS_CHANGED

具体实现可以参考以下widgetDemo示例:

 点击打开链接

更多帮助可以参照google官方文档。

你可能感兴趣的:(widget,androidWidget,android窗口小部件)