android应用开发(十):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)

 

  该方法会在用户添加widget后调用

 

  (2)onUpdate(Context context, AppWidgetManager

 

  appWidgetManager,int[] appWidgetIds)

 

  该方法会在用户添加widget后调用,用来刷新界面已经安装的widget(在onEnabled之后调用)。

 

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

 

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

 

  (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);

 

  }

 

  }

 

  8、 widget生命周期(android1.6)

 

  (1) 当用户拖拽widget到界面时,会按照顺序分别调用如下几个方法:onReceive-onEnabled-onReceive-onUpdate-onReceive-onReceive

 

  (2) 当用户拖拽widget删除时,会按照顺序分别调用如下几个方法:

 

  onReceive-onDeleted-onReceive-onDisabled

 

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。