（原创 开源）AppWidge的使用—桌面便利贴

Android平台的一大特色就是支持桌面插件——AppWidget。

且不说，AppWidget是否会影响系统的流畅性，AppWidget确实是满足了用户个性化和快捷操作的需要。

常见的AppWidget有四种基本形态：

信息型：

想当年HTC的翻页时钟就大红大紫过好长一阵子。

控制型：

集合型：

混合型：

其实大部分的AppWidget都是属于这个类型的，即能够显示信息，又提供控制功能。

总结一下：

AppWidget提供了一个快速的途径去获得我们想要的信息

提供一个快捷的手段去控制应用

一些设计良好的AppWidget确实可以为手机增色不少

本人有一定的“应用洁癖”，一般只用那些没有太多乱七八糟功能的应用。一直在找一款简单实用的便签应用。对于我个人而言，语音记录、云同步之类的功能都是比较鸡肋的。我之前用过两款：OPPO的NearMe笔记和小米便签。都还可以，至少，没有太多没用的功能。

其中小米便签还是开源的：https://github.com/MiCode/Notes（开源什么的最有爱了~~~）可以学到不少的东西。

当程序员有一个好处，就是当用其他应用都不爽的时候，可以自己开发一个~~~

我自己的需求如下：

尽可能的轻量：不常用的功能一律不要。

界面要好看一点：毕竟，程序员也是要装X的~~~

最终的效果是这样的：

点击可以进入编辑：

点击左上角可以换肤，点击那个“T”可以进行字体调节：

调节过程还可以实时预览。

好了，下面不废话了，进入开发时间！！！

官方文档地址：http://developer.android.com/intl/zh-cn/guide/topics/appwidgets/index.html

一个AppWidget需要用到下面的东东：

AppWidgetProviderInfo：这货是描述整个AppWidget的元信息的。比如更新的频率，初始大小等。它被放在/res/xml/目录下，是一个xml文件。比如我的这个应用的代码如下：

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

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

    android:configure="com.stickynote.EditActivity"

    android:initialLayout="@layout/widget_note"

    android:minHeight="40dp"

    android:minWidth="250dp"

    android:previewImage="@drawable/icon_app"

    android:updatePeriodMillis="0" />

它的一些属性解释如下：

configure：当一个AppWidget第一次生成时可以启动一个Activity来配置它，该属性是可选的。

initialLayout：AppWidget的布局文件。

minHeight和minWidth：这两个参数比较复杂，最好参看官方文档，因为不同版本下还是不同的，比如从4.1开始还支持AppWidget大小的改变这些。

previewImage：就是AppWidget的预览图，不设置的话就是App的图标。

UpdatePeriodMillis：更新频率，这个也需要特别说明一下，在新版本的系统中（貌似是4.0）开始，更新频率是不能设置过小的，因为要考虑到耗电问题。所以，如果需要做到“实时”更新的话，就需要通过其他手段了。

其他属性看文档吧~~~

AppWidgetProvider：这家伙封装了BroadcastReceiver，并重写了onReceive方法。所以一般情况下，我们不需要再去重写onReceive方法了。而是按需要去重写以下的几个方法：

onEnabled：当这个App的第一个AppWidget创建时调用，也就是说添加第十个AppWidget时，是不会调用的。

onUpdate：当AppWidget更新时调用，比如到了更新的时间。注意，比如当手机重新启动时，这个方法也会被调用的。

onDeleted：当AppWidget被删除时调用。

onDisabled：当最后一个AppWidget被删除时调用。与onEnabled对应。

View layout：AppWidget的布局文件，与Activity的布局文件类似。但不是所有的控件、容器都可以用于AppWidget的。具体支持的控件请看文档：http://developer.android.com/intl/zh-cn/guide/topics/appwidgets/index.html#CreatingLayout

其实上面的东西都是官方文档的“中文简化版”，阅读英文文档还是相当重要的。

项目的文件结构：

其实本人不是怎么喜欢贴代码，因为我自己的看博客的习惯就不喜欢看代码（算法博文除外），所以我一般只写原理，代码的话自己下载运行一下应该我觉得更好~~~

AppWidgetProvider的配置：

AppWidgetProvider的本质还是一个广播接收器，所以在AndroidManifest.xml中还是使用一个receiver标签来配置：

<receiver android:name="com.stickynote.widget.NoteWidgetProvider" >

         <!-- 固定写法 -->

         <intent-filter>

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

         </intent-filter>

         <!-- name也是固定的，resource就是那个AppWidget的配置文件 -->

         <meta-data

                   android:name="android.appwidget.provider"

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

</receiver>

添加AppWidget进弹出编辑Activity：

这个过程分为二步，第一：在AppWidgetProviderInfo中添加

android:configure="com.stickynote.EditActivity"

注意，这个Activity一定要带包名的！

第二：在Activity的配置中，一定要添加一个intent-filter：

<activity

         android:name="com.stickynote.EditActivity"

         android:theme="@android:style/Theme.Holo.NoActionBar" >

         <intent-filter>

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

         </intent-filter>

</activity>

更新（设置）AppWidget：

更新AppWidget是通过AppWidgetManager的updateAppWidget(int appWidgetId, RemoteViews views)这个方法来实现的。

其中，RemoteViews就是AppWidget的视图，我们要对其中的“子控件”进行设置，只能通过它提供的setXxx方法实现，有些方法是可以直接使用的，比如其中的TextView：

如果想对其中的布局设置背景，这时就只有通过比如setInt这个方法来“曲线救国”了：

views.setInt(R.id.rl_widget_note, "setBackgroundResource", bgRes); // 设置背景

同理，设置字体大小可以通过如下方法实现：

views.setFloat(R.id.tv_widget_note_content, "setTextSize", note.textSize); // 设置字体大小

注意：在AppWidget启动时调用的Activity更新之后，一定要setResult！否则没有结果。

Intent resultValue = new Intent();

resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, note.appWidgetId);

setResult(RESULT_OK, resultValue);

finish();

AppWidget的东西差不多了，剩下的东西就是数据库啊，还有一些界面之类的东西，应该说，东西不大，但该有的都有了，而且个人觉得把要把整个应用的代码用合理优雅的方法来实现，其实比单纯的学会调用API理重要。

本人菜鸟一个，欢迎各位的批评指正。

如果有疑问，请直接留言或通过475500230@qq.com这个邮箱与我交流。

图片资源大部分来自小米便签，在此表示感谢。

个人练习作品，欢迎转载！但请注意原作者与出处。

源码下载：http://pan.baidu.com/share/link?shareid=1065236481&uk=1812042723

安装包下载：http://pan.baidu.com/share/link?shareid=1152653812&uk=1812042723