widget的使用

同事QJL找的,还没看

 

 

widget的使用

1、自定义widget必须继承AppWidgetProvider

2、AndroidManifest.xml中必须注册

 <receiver android:name=".widget.AppWidget" >

            <meta-data

                android:name="android.appwidget.provider"

                android:resource="@xml/guide_widget" />

            <intent-filter>

                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />

            </intent-filter>

        </receiver> 

(1)receiver的name必须为自定义widget类名

(2)meta-data的name必须为android.appwidget.provider 

(3)meta-data 的resource为该widget的描述文件,该文件必须放在res/xml路径下

(4)需要添加action增加监听receiver种类android.appwidget.action.APPWIDGET_UPDATE

3、 res/xml

<?xml version="1.0" encoding="utf-8"?>

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

    android:initialLayout="@layout/guide_widget"

    android:minHeight="294.0dip"

    android:minWidth="294.0dip"

    android:updatePeriodMillis="1801000" />

(1)最外层标签必须为appwidget-provider

(2) android:initialLayout指定了widget使用的布局文件

(3)android:minHeight指定了widget的高度,android:minWidth指定了widget的宽度。这两个数值不能随意指定,最好根据需要放置的widget所占据的屏幕行列数设定。例如,某widget为3行2列,则minHeight应为(3*74)-2=220,minWidth应为(2*74)-2=146

(4)android:updatePeriodMillis该值为widget刷新时间,最好设置1小时以上,否则会严重浪费系统资源,耗电量会很大。每隔固定的该时间,系统就会调用该widget的onUpdate方法,如果该值为0,则表示不更新widget

4、widget继承自父类方法

(1)onEnabled(Context context)

该方法只会在程序被安装到手机后调用一次,因此可以在里面执行一些初始化

2onUpdate(Context context, AppWidgetManager 

appWidgetManager,int[] appWidgetIds)

该方法会在用户添加widget后调用;另外在程序被安装后,也会调用一次,用来刷新界面已经安装的widget(在onEnabled之后调用)。

appWidgetManager参数用来执行刷新界面的操作

appWidgetIds是该应用程序所有widgetid(用户可能添加多个,因此此处为数组)

(3)onDeleted(Context context, int[] appWidgetIds)

该方法会在widget被删除后调用(注意,是删除后,也就是说,该方法不是执行删除动作的)

(4)onReceive(Context context, Intent intent)

该方法是继承自receiver的,尽量不要使用,如果要使用,就需要你自己处理一些特殊代码,否则widget就会出问题

5、界面widget的刷新及点击事件

(1)在widget中,不能再使用findviewbyid方法获取组件,需要使用其他的方式。RemoteViews rv = new RemoteViews(context.getPackageName(),

R.layout.guide_widget);

RemoteViews 是一个虚构的组件,用它来承载layout。

(2) 点击layout中的某个组件启动activity或service

Intent intent = new Intent(context, WidgetDemoActivity.class);

PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);

rv.setOnClickPendingIntent(R.id.guide_0, pendingIntent);

(3) 界面刷新

appWidgetManager.updateAppWidget(appWidgetId, rv);

6、 widget支持在layout中使用的组件

FrameLayout、LinearLayout、RelativeLayout

AnalogClock、Button、Chronometer、ImageButton、ImageView、ProgressBar、TextView

7、 自定义widget类完整代码

public class AppWidget extends AppWidgetProvider {

RemoteViews rv;

@Override

public void onUpdate(Context context, AppWidgetManager appWidgetManager,

int[] appWidgetIds) {

System.out.println(context.getPackageName());

final int N = appWidgetIds.length;

// 因为有可能用户添加了多个窗口小部件,所以这里需要遍历appWidgetIds

for (int i = 0; i < N; i++) {

System.out.println(appWidgetIds[i]);

int appWidgetId = appWidgetIds[i];

rv = new RemoteViews(context.getPackageName(),

R.layout.guide_widget);

Intent intent = new Intent(context, WidgetDemoActivity.class);

intent.setAction(context.getPackageName() + appWidgetId);

PendingIntent pendingIntent = PendingIntent.getActivity(context, 0,

intent, 0);

rv.setOnClickPendingIntent(R.id.guide_0, pendingIntent);

appWidgetManager.updateAppWidget(appWidgetId, rv);

}

super.onUpdate(context, appWidgetManager, appWidgetIds);

}

}

你可能感兴趣的:(widget)