5月 132015
 

  App Widget是Android中可以用于显示在桌面或者锁屏中的便捷显示组件,对于一些应用来说,比如天气预报、音乐播放器、股票行情等应用,开发相应的组件放到桌面上可以让用户更快捷高效的查看内容,提高用户的效率,增强用户的体验,让应用更加受用户欢迎。

一、插件原理介绍

  因为小插件要长期在桌面上,所以小插件不能通过应用的形式来长期运行,那样会消耗很多的系统资源,所在在安卓系统中,插件是作为插件宿主的一部分而存在,而不是一个应用程序,而插件宿主由安卓系统来控制,这时插件和应用之间的数据传输就不能像Activity之间一样单纯的用Intent来控制了。那么插件的数据是通过什么形式传输的呢?答案是使用的广播的方式来传输数据,插件本身是一个BroadcastReceiver,接收到消息或数据后再进行显示。由此可见,插件并没有Activity,只是一个BroadcastReceiver,而用于处理界面的对象则是RemoteViews而不是View对象。

  Android中的桌面插件虽然拥有和Activity基本一样的布局,但插件中的组件却不能直接通过组件对象直接操作,比如在Activity中我们要改变一个TextView显示的文字,我们只需要用findViewById找到这个对象并赋给一个定义好的TextView对象,然后用这个对象的setText方法修改显示文字即可。但是在插件中却不可以这样操作,因为他本身并不存在Activity,不提供findViewById这样的方法来寻找对象。具体如何操作以后会讲到,下面我们先来看看要创建一个组件所必须的几个对象。

二、三个必要组件

  通过上面的描述我们可以知道,一个小插件至少要有两个对象才可以存在,第一就是一个可用于接收消息的BroadcastReceiver对象,在安卓中又针对插件做了一次封装,那我们需要使用的就是继承自AppWidgetProvider类;另外一个,很显而易见的就是要有一个基本的布局,一个layout对象。那么还没完,我们还需要一个对象来描述这个Provider,这就是第三个基本组件AppWidgetProviderInfo对象,一个xml描述文件。下面我们就对这三个对象进行详细描述。

1、AppWidgetProvider类

  AppWidgetProvider继承自BroadcastReceiver对象,其实就是一个广播接收对象类,它自身又实现了几个用于处理插件被更新、变可用、变不可用、被删除时的方法。下面是一个示例文件:

1) onReceive: 此方法实际上是覆盖了父类BroadcastReceiver中的onReceive方法,用于接收广播消息并根据不同的消息内容执行不同的操作。在AppWidgetProvider中已经对更新、删除等消息内容做了处理,并新建了onUpdate、onDeleted等方法用于给开发者响应消息。需要注意的是:开发者可以自定义广播消息,并在onReceive中接收并做相应的操作。
2) onAppWidgetOptionsChanged: 应该是当插件对应的配置页面更改时触发此方法
3) onUpdate: 此方法就是响应设定的定时更新触发时的消息了,用于更新界面内容。

创建方法:在项目中新建一个类,父类设置为AppWidgetProvider即可

2. AppWidgetProviderInfo对象

AppWidgetProviderInfo对象其实就是一个xml文件,存储在resxml目录下,用于定义组件的宽度、高度、组件内容更新频率、初始化布局等信息,系统会根据这些信息创建并调整组件的显示。下面是一个示例文件:

1) minWidth: 用于设置组件的最小宽度,系统会根据此值计算出插件横向所要占据的网格数量
2) minHeight: 用于设置组件的最小高度,系统会根据此值计算出插件纵向所要占据的网格数量
3) minResizeWidth: 插件缩放时允许的最小宽度
4) minResizeHeight: 插件缩放时允许的最小高度
5) updatePeriodMillis: 插件的更新频率,单位ms,此值小于半个小时的时候将按半小时计算,因为android不允许小插件过于频率的更新以节省资源和电池用量,对于更新频率要小于半个小时的情况,我们会在后面讲述如何处理
6) initialLayout: 用于指定插件所使用的布局文件
7) initialKeyguardLayout: 用于指定在锁屏界面上插件所使用的布局文件
8) configure: 用于指定插件设置窗口所使用的布局文件
9) previewImage: 用于指定添加插件页面中,插件所使用的预览图像
10) resizeMode: 用于指定插件允许的缩放模式,可选择横向、纵向或者不能缩放
11) widgetCategory: 用于指定插件都在哪个地方显示,可选择在桌面、锁屏界面或者搜索界面。

创建方法:在项目中新建一个xml文件,xml文件的类型为appwidget-provider,生成的文件将自动存储到resxml目录下

3、Widget布局文件

  首先来说,它是一个布局文件,和Activity的布局文件一样,存储在reslayout目录下,所不同的是,插件布局中并不支持所有的组件。

  可支持的部局组件如下:

  • FrameLayout
  • LinearLayout
  • RelativeLayout
  • GridLayout

  支持的内容组件如下:

  • AnalogClock
  • Button
  • Chronometer
  • ImageButton
  • ImageView
  • ProgressBar
  • TextView
  • ViewFlipper
  • ListView
  • GridView
  • StackView
  • AdapterViewFlipper

  注意:不可以支持以上组件的子类。

  创建方法:新建一个layout文件

三、使自己的第一个小组件生效

  在创建了上文所述的三个对象后,我们还需要在Android Manifest文件中对WidgetProvider对象进行一下声明,这样才可以在插件管理器中看到我们要创建的插件,所用代码如下:

  receiver 节点中的内容即为对SimpleWidgetProvider的定义,intent-filter和meta-data节点都必须添加上才可以使插件生效。

打赏