设为首页 加入收藏

TOP

Android Widget 开发实例:桌面便签程序的实现详解和源码
2014-11-24 12:40:09 来源: 作者: 【 】 浏览:0
Tags:Android Widget 开发实例 桌面 程序 实现 详解 源码

本文通过逐步实现一个简单的桌面便签软件,和大家分享进行widget开发的过程和方法。


同时本程序提供完整的工程源码下载


具体下载目录在 /pub/Android源码集锦/2011年/10月/Android Widget 开发实例:桌面便签程序的实现详解和源码/


为了提起大家阅读本文的兴趣,先介绍一下最终实现的效果。


首先可以通过桌面增加我们的MyNote小部件,如下图所示:



图中的“我的便签”就是我们之后将要开发的便签程序。


点击后启动添加日志界面,如下图所示:




输入便签内容后,可以点击下面所列的四种图标之一作为便签图标。


比如点击第一个后,桌面上就会添加一个便签:




点击桌面上的便签,可以再次对便签内容进行修改,并更换图标。


桌面上可以同时存在多个便签,并可以分别进行修改。


如下图所示,我们将刚才创建的便签的图标修改一下,并新增了一个便签:




每个便签的内容都是分别独立保存的,可以随时点击桌面图标修改。


开发的目的和追求的效果已经十分清楚了,首先我们确定一下开发方式。


在本文中,将采取一种渐进式的开发,也就是说不会一口气从头做到尾。


而是分为好几个阶段。每个阶段都完成一定的目标,然后下个阶段增加更多的功能,


每个阶段都离最终目标更进一步,OK,你可以说这是一次敏捷开发 :)


第一个阶段,首先我们会搭建一个widget原型程序,


它是完全可以运行的,可以创建桌面widget。


第二个阶段,我们改进 widget 配置Activity 部分的实现


使其具备创建便签的功能


第三个阶段,我们改进 widget 点击响应部分的实现,


使其具备修改便签的功能


本节我们会做一个最简单的widget程序原型,但是它是可以运行的。


一般来说 widget 程序由以下部分组成:


a. AppWidgetProvider 的实现


b. widget外观布局定义文件


c. 新增widget时的配置Activity的实现(可选)


d. widget 参数配置文件


以下分别讲解


首先我们新建一个android工程起名为MyNote,然后修改 MyNote.java 的代码,


使MyNote继承自 AppWidgetProvider ,并重写 onUpdate 和 onDeleted 方法。


其中onUpdate 会在widget创建及被更新时调用, onDeleted 会在widget被删除时调用。


目前我们不需要在这里实现任何功能,只是简单的记录日志以便我们观察其运行,编写好的代码如下:



b. widget外观布局定义文件


我们需要为widget编写一个外观布局文件,在本示例中,布局非常简单,只需要一个imageView即可


编写好的 my_note_widget.xml 文件如下:


这里用到了一个外部图片 sketchy_paper_008.png,来源于网络,感谢图片原作者。


可以到 http://dryicons.com/free-icons/preview/sketchy-paper-icons/ 打包下载。


( 注意下载下来的包中的文件名可能和我写的程序中的命名有差异,请注意自行调整。)


android平台为widget提供一个配置界面的功能,我们可以自定义一个Activity,


在widget参数配置文件中配置好相关参数后,此Activity会在用户新增widget时自动调用。


一般来说,这个配置界面的作用是用户新建widget时,让用户配置widget的一些属性,比如颜色、大小等等。


但是在我们的这个示例程序中,我们用它来当做创建便签的地方!


不过本节只是先实现一个原型程序,所以暂时不做处理,我们只是新建一个Activity即可。


新建名为MyNoteConf的Activity,重写onCreate方法,在OnCreate方法中,


由于这个Activity是由系统在新增widget时自动调用的,


所以我们可以用getIntent获取到传入的widgetId。可以判断其是否是一个有效的widgetId,


最后我们必须返回一个RESULT_OK的Intent,并结束当前Activity,系统才会认为配置成功,在桌面上放置这个widget。


如果返回RESULT_CANCELED,系统会认为配置失败,终止widget的创建过程。


编写好的MyNoteConf的代码如下:



d. widget 参数配置文件


最后我们需要编写一个widget参数配置文件,将布局文件、配置Activity关联起来。


我们在res下新建目录xml,在xml目录下新增文件 my_note_widget.xml ,编写如下:



其中 minWidth minHeight 用来指定widget的大小,如果我们只占用一个格子,也就是俗称的1X1,


那么72dp的长宽是android平台推荐的一个最佳实践值。


然后用 initialLayout 参数关联了我们编写好的 layout 文件,


用 configure 参数关联了我们编写好的配置用Activity:MyNoteConf,


此外还有一个参数 updatePeriodMills 指定widget的刷新周期,


从省电角度考虑,一般都把此值设置的比较大,如果一定要对widget做周期性的事情,可以使用AlarmManager。


至此所有widget的要素都已经准备好,我们运行一下来看看吧。




为了运行widget,我们还需要修改一下 AndroidManifest.xml 来声明我们的widget。


声明一个receiver,过滤 android.appwidget.action.APPWIDGET_UPDATE ,


并且用metadata关联到我们自己编写的 appWidgetProvider 实现。


声明一个activity关联到我们的配置类 MyNoteConf,过滤 android.appwidget.action.APPWIDGET_CONFIGURE。


最后修改一下应用图标,此图标会出现在系统的新增widget列表中。


编写好的AndroidManifest.xml 如下:



至此原型程序全部开发完成,运行一下看看效果吧!


在桌面上长点,可以选择我们刚刚写的原型widget“MyNote”了,


选择后出现我们定义的配置界面MyNoteConf,


但是由于我们在onCreate中finish了,所以是一闪而过的。


之后MyNote就出现在桌面上了。


我们可以随便拖动它,或者把它丢进垃圾箱,观察一下日志输出。




上半部分主要完成了一个widget的原型,它没有任何业务功能,


但是已经是一个可以运行的骨架了。


在下半部分中我们为它添加血和肉,让它真正具备业务功能。


希望大家喜欢这种先写骨架,再逐步丰富的开发方式 :)


】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
分享到: 
上一篇Android安装过程对话框更新Demo 下一篇Android 获取图片的亮度

评论

帐  号: 密码: (新用户注册)
验 证 码:
表  情:
内  容:

·C++中智能指针的性能 (2025-12-25 03:49:29)
·如何用智能指针实现c (2025-12-25 03:49:27)
·如何在 C 语言中管理 (2025-12-25 03:20:14)
·C语言和内存管理有什 (2025-12-25 03:20:11)
·为什么C语言从不被淘 (2025-12-25 03:20:08)