桌面便签程序详解

 

• 小子，当你看到本文章时尼玛就是幸运儿啦！

  桌面便签软件听过吗？见过吗？

  没错，就是android上常用的软件之一，比如曾经的Sticky Note，就曾非常流行，Sticky Note的介绍可以参见 http://www.tompda.com/c/article/11778/ 

   

  而实际上使用android平台对widget开发的支持，桌面便签类软件是非常易于开发的。

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

   

  1.MyNote的最终实现效果

  Come on ！为了勾引大家阅读本文的兴趣，先白活一下最终效果。首先可以通过桌面增加我们的MyNote小部件，如下图所示：
  

  

  图中的“我的便签”就是我们之后将要开发的便签程序。 点击后启动添加日志界面，如下图所示：
  

  
  

  

  输入便签内容后，可以点击下面所列的四种图标之一作为便签图标。比如点击第一个后，桌面上就会添加一个便签：
  

  
  

  

  点击桌面上的便签，可以再次对便签内容进行修改，并更换图标。桌面上可以同时存在多个便签，并可以分别进行修改。 

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

  
  

  

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

   

  2.开发方式

  开发的目的和追求的效果已经十分明，确定一下开发方式。

  本人将采取一种渐进式的开发，尼玛听过吗？也就是说不会一口气从头做到尾。

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

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

   

  第一个阶段，首先我们会搭建一个widget原型程序，它是完全可以运行的，可以创建桌面widget。

   

  第二个阶段，我们改进 widget 配置Activity 部分的实现使其具备创建便签的功能

   

  第三个阶段，我们改进 widget 点击响应部分的实现，使其具备修改便签的功能

   

  3.搭建widget原型程序

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

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

  a. AppWidgetProvider 的实现 

  b. widget外观布局定义文件

  c. 新增widget时的配置Activity的实现（可选）

  d. widget 参数配置文件 

  以下分别讲解

   

  a. AppWidgetProvider 的实现 

  Let's go！新建一个android工程MyNote，然后修改 MyNote.java 的代码，

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

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

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

  package sun.geoffery.mynote;
  
  import android.app.Activity;
  import android.appwidget.AppWidgetManager;
  import android.appwidget.AppWidgetProvider;
  import android.content.Context;
  import android.os.Bundle;
  import android.util.Log;
  
  public class MyNote extends AppWidgetProvider {
  
  	/* 在widget创建及被更新时调用 */
  	@Override
  	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
  			int[] appWidgetIds) {
  		// TODO Auto-generated method stub
  		final int N = appWidgetIds.length;
  		for (int i = 0; i < N; i++) {
  			int appWidgetId = appWidgetIds[i];
  			Log.i("myLog", "this is [" + appWidgetId + "] onUpdate!");
  		}
  	}
  
  	/* 在widget被删除时调用 */
  	@Override
  	public void onDeleted(Context context, int[] appWidgetIds) {
  		// TODO Auto-generated method stub
  		final int N = appWidgetIds.length;
  		for (int i = 0; i < N; i++) {
  			int appWidgetId = appWidgetIds[i];
  			Log.i("myLog", "this is [" + appWidgetId + "] onDeleted!");
  		}
  	}
  
  }

  
  b. widget外观布局定义文件
  
  我们需要为widget编写一个外观布局文件，在本示例中，布局非常简单，只需要一个imageView即可
  
  编写好的 my_note_widget.xml 文件如下：
  

  <?xml version="1.0" encoding="utf-8"?>
  <ImageView xmlns:android="http://schemas.android.com/apk/res/android"
      android:id="@+id/my_widget_img"
      android:layout_width="wrap_content"
      android:layout_height="match_parent"
      android:clickable="true"
      android:src="@drawable/empty_sketchy" />

  
  这里用到了一个外部图片 sketchy_paper_008.png，来源于网络，感谢图片原作者。
  
  可以到 http://dryicons.com/free-icons/preview/sketchy-paper-icons/ 打包下载。
  
  (  注意下载下来的包中的文件名可能和我写的程序中的命名有差异，请注意自行调整。)
  
  c. 新增widget时的配置Activity的实现（可选）
  
  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的代码如下：
  
  b. widget外观布局定义文件
  
  我们需要为widget编写一个外观布局文件，在本示例中，布局非常简单，只需要一个imageView即可
  
  编写好的 my_note_widget.xml 文件如下：
  

  <?xml version="1.0" encoding="utf-8"?>
  <ImageView xmlns:android="http://schemas.android.com/apk/res/android"