关闭

桌面便签程序的实现详解和源码 (下)

标签: layoutandroidjava存储xhtml敏捷开发
1862人阅读 评论(0) 收藏 举报
分类:
来自:http://blog.csdn.net/silenceburn/article/details/6094705

 

在上半部分中,已经实现了一个可以运行的widget,但是没有任何业务功能,

因此下半部分中的任务就是逐步实现业务功能,最终完成此桌面便签程序。

 


5. 利用widget的配置Activtiy,实现新增便签功能

由于配置Activity由系统确保在新增widget时一定会调用,因此我们正好用此界面完成新增便签的功能。

 

我们同样采用渐进式的开发方式,分为如下几个阶段

a. 实现layout

b. 实现按键点击

c. 实现数据存储

以下分步讲解

a.实现layout

首先我们要为配置Activity定制一个layout,用于实现新增便签功能。观察第一节中的最终效果图,

在我们的Layout上,主要由 提示文本TextView 、 编辑文本框EditText 、四个图片按钮ImageButton  三部分组成。

 

编写一个layout文件起名为 my_note_conf.xml 放在layout文件夹下,在文件中,

首先用一个垂直的LinearLayout 把这三部分组织起来,通过使用weight权重设置,使EditText自动扩大到占满屏幕。

然后把四个图片按钮ImageButton 用一个水平的内嵌LinerLayout组织起来,并调整 gravity、margin 等属性使其更加美观。

 

编写好的layout文件如下:

  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout android:orientation="vertical"  
  3.     android:layout_width="fill_parent" android:layout_height="fill_parent"  
  4.     xmlns:android="http://schemas.android.com/apk/res/android">  
  5.     <TextView android:layout_height="wrap_content" android:text="@string/note_title"  
  6.         android:layout_width="wrap_content" android:padding="10dp"></TextView>  
  7.     <LinearLayout android:layout_height="fill_parent"  
  8.         android:layout_width="fill_parent" android:layout_weight="1">  
  9.         <EditText android:id="@+id/EditText02" android:layout_width="fill_parent"  
  10.             android:layout_height="fill_parent" android:gravity="left"  
  11.             android:hint="@string/edithint"></EditText>  
  12.     </LinearLayout>  
  13.     <LinearLayout android:layout_height="fill_parent"  
  14.         android:layout_width="fill_parent" android:layout_weight="2"  
  15.         android:gravity="center">  
  16.         <ImageButton android:id="@+id/ImageButton01"  
  17.             android:layout_width="72dp" android:layout_height="72dp"  
  18.             android:src="@drawable/sketchy_paper_003" android:layout_margin="3dp"></ImageButton>  
  19.         <ImageButton android:id="@+id/ImageButton02"  
  20.             android:layout_width="72dp" android:layout_height="72dp"  
  21.             android:src="@drawable/sketchy_paper_004" android:layout_margin="3dp"></ImageButton>  
  22.         <ImageButton android:id="@+id/ImageButton03"  
  23.             android:layout_width="72dp" android:layout_height="72dp"  
  24.             android:src="@drawable/sketchy_paper_007" android:layout_margin="3dp"></ImageButton>  
  25.         <ImageButton android:id="@+id/ImageButton04"  
  26.             android:layout_width="72dp" android:layout_height="72dp"  
  27.             android:src="@drawable/sketchy_paper_011" android:layout_margin="3dp"></ImageButton>  
  28.     </LinearLayout>  
  29. </LinearLayout>  

 

注意其中调用了外部图片,下载参考第3节的b小节。

还调用了strings.xml中的字符串定义。关于字符串定义常量,你可以用values-zh实现国际化,此处不再敷述。

 

至此layout编写完成,记得在配置Activity中增加 setContentView(R.layout.my_note_conf); 语句指定使用该layout文件。

 

b.实现按键点击

接下来我们实现四个ImageButton上的按键点击事件,由于按键事件基本相同,

因此我们只编写一个OnClickListener,然后把它绑定到四个按钮上去。

 

在OnClickListener中,首先我们获取被点击的按钮的id,由此得知用户希望使用那一个图片作为widget图标,

然后获取 RemoteViews 关联到我们的widget,设置widget的imageSrc为新的图片,

设置完成后需要获取AppWidgetManager,对指定的widget进行更新,才能使设置生效。

 

最后不要忘记把onCreate中返回RESULT_OK和finish的代码移到OnClickListener中来。

 

b小节部分编写完成后的代码如下:

  1. package com.silenceburn;  
  2.   
  3. import android.app.Activity;  
  4. import android.appwidget.AppWidgetManager;  
  5. import android.content.Intent;  
  6. import android.os.Bundle;  
  7. import android.util.Log;  
  8. import android.view.View;  
  9. import android.view.View.OnClickListener;  
  10. import android.widget.ImageButton;  
  11. import android.widget.RemoteViews;  
  12.   
  13. public class MyNoteConf extends Activity {  
  14.   
  15.     int mAppWidgetId;  
  16.     ImageButton mImBtn1, mImBtn2, mImBtn3, mImBtn4;  
  17.   
  18.     @Override  
  19.     protected void onCreate(Bundle savedInstanceState) {  
  20.         // TODO Auto-generated method stub  
  21.         super.onCreate(savedInstanceState);  
  22.         setContentView(R.layout.my_note_conf);  
  23.         Log.i("myLog"" on WidgetConf ... ");  
  24.   
  25.         setResult(RESULT_CANCELED);  
  26.         // Find the widget id from the intent.  
  27.         Intent intent = getIntent();  
  28.         Bundle extras = intent.getExtras();  
  29.         if (extras != null) {  
  30.             mAppWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID,  
  31.                     AppWidgetManager.INVALID_APPWIDGET_ID);  
  32.         }  
  33.   
  34.         // If they gave us an intent without the widget id, just bail.  
  35.         if (mAppWidgetId == AppWidgetManager.INVALID_APPWIDGET_ID) {  
  36.             finish();  
  37.         }  
  38.   
  39.         mImBtn1 = (ImageButton) findViewById(R.id.ImageButton01);  
  40.         mImBtn2 = (ImageButton) findViewById(R.id.ImageButton02);  
  41.         mImBtn3 = (ImageButton) findViewById(R.id.ImageButton03);  
  42.         mImBtn4 = (ImageButton) findViewById(R.id.ImageButton04);  
  43.   
  44.         mImBtn1.setOnClickListener(mBtnClick);  
  45.         mImBtn2.setOnClickListener(mBtnClick);  
  46.         mImBtn3.setOnClickListener(mBtnClick);  
  47.         mImBtn4.setOnClickListener(mBtnClick);  
  48.     }  
  49.   
  50.     OnClickListener mBtnClick = new OnClickListener() {  
  51.         @Override  
  52.         public void onClick(View v) {  
  53.             int srcId = R.drawable.sketchy_paper_008;  
  54.             switch (v.getId()) {  
  55.             case R.id.ImageButton01:  
  56.                 srcId = R.drawable.sketchy_paper_003;  
  57.                 break;  
  58.             case R.id.ImageButton02:  
  59.                 srcId = R.drawable.sketchy_paper_004;  
  60.                 break;  
  61.             case R.id.ImageButton03:  
  62.                 srcId = R.drawable.sketchy_paper_007;  
  63.                 break;  
  64.             case R.id.ImageButton04:  
  65.                 srcId = R.drawable.sketchy_paper_011;  
  66.                 break;  
  67.             }  
  68.             Log.i("myLog""mAppWidgetId is: " + mAppWidgetId);  
  69.   
  70.             RemoteViews views = new RemoteViews(MyNoteConf.this  
  71.                     .getPackageName(), R.layout.my_note_widget);  
  72.             views.setImageViewResource(R.id.my_widget_img, srcId);  
  73.   
  74.             AppWidgetManager appWidgetManager = AppWidgetManager  
  75.                     .getInstance(MyNoteConf.this);  
  76.             appWidgetManager.updateAppWidget(mAppWidgetId, views);  
  77.   
  78.             // return OK  
  79.             Intent resultValue = new Intent();  
  80.             resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,  
  81.                     mAppWidgetId);  
  82.   
  83.             setResult(RESULT_OK, resultValue);  
  84.             finish();  
  85.         }  
  86.     };  
  87. }  

 

这时我们可以运行一下看看效果了,添加我们开发的MyNote的widget后,

会停止在配置界面等待用户输入便签内容,并选择桌面图标。用户选择后会在桌面上添加相应图标了!

 

c.实现数据存储

虽然用户可以指定桌面图标了,但是用户的便签内容还没有存储起来,需用把用户的便签内容持久化。

要把数据持久化,在android中最简单的办法是使用 SharedPreferences,更好的做法是使用SQLite,

更更好的做法是使用ContentProvider包装。

 

本实例侧重于讲解widget开发,因此偷个懒,使用最简单的方法 SharedPreferences 实现。

 

SharedPreferences 使用非常简单,首先用一个特定的 Prefix 获取我们自用的 Preferences 空间。

这个特定的 Prefix 一般使用当前类的全限定名,以免和其他程序冲突。

获取到的Preferences 空间可以想象为一个哈希表,可以使用putXXXX(key,content)系列方法向其中放入名值对。

 

因此我们要做的事情就非常简单了,首先指定一个特定前缀:  final String mPerfName = "com.silenceburn.MyNoteConf";

然后获取EditText的内容,获得一个Preferences引用,使用putString将EditText的内容放入Preferences,代码加下:

  1. TextView mTextView = (TextView) MyNoteConf.this  
  2.         .findViewById(R.id.EditText02);  
  3. SharedPreferences.Editor prefs = MyNoteConf.this  
  4.         .getSharedPreferences(mPerfName, 0).edit();  
  5. prefs.putString("DAT" + mAppWidgetId, mTextView.getText()  
  6.         .toString());  
  7. prefs.commit();  

注意这里putString时使用的Key是  "DAT" + mAppWidgetId ,

由于mAppWidgetId 是每个widget的唯一标示,这样就可以有效的区分不同的widget的内容进行分别存储了。

 

将上述代码加入onClick 即完成了配置Activity部分的编写。

 


6.增加 widget 点击响应,实现修改便签功能

 

OK,终于来到了最后一步,就要大功告成了。这一步中的分阶段目标有:

a. 增加widget点击响应

b. 实现修改便签的Activity界面

以下分阶段说明

a. 增加widget点击响应

首先我们新建一个Activity类,起名为 MyNoteEdit,widget被点击时,将调用该Activity。

由于是对便签内容进行修改,所以我们这里可以取巧偷个懒,布局直接复用 my_note_conf.xml。

在本阶段,重点问题是可以点击widget调用MyNoteEdit,因此不需要进行更多处理,所以代码很简单:

  1. package com.silenceburn;  
  2.   
  3. import android.app.Activity;  
  4. import android.os.Bundle;  
  5.   
  6. public class MyNoteEdit extends Activity {  
  7.     @Override  
  8.     protected void onCreate(Bundle savedInstanceState) {  
  9.         // TODO Auto-generated method stub  
  10.         super.onCreate(savedInstanceState);  
  11.         setContentView(R.layout.my_note_conf);  
  12.     }  
  13. }  

 

 

之后,为了给widget增加点击响应,我们要再次修改一下第5小节中配置Activity的代码,

为widget附着上一个pendingIntent,这样当widget被点击时,就可以触发我们指定的Intent了。

代码片段如下:

  1. Intent intent = new Intent(MyNoteConf.this, MyNoteEdit.class);  
  2. intent.setAction(mPerfName + mAppWidgetId);  
  3. intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,mAppWidgetId);  
  4. PendingIntent pendingIntent = PendingIntent.getActivity(MyNoteConf.this0,  
  5.         intent, 0);  
  6. views.setOnClickPendingIntent(R.id.my_widget_img, pendingIntent);  

注意这里我们使用intent.setAction(mPerfName + mAppWidgetId);为每个widget赋予了独一无二的Action。

否则获得的pendingIntent实际是同一个实例,仅extraData不同,根据创建pendingIntent方法的不同,

extraData可能会被覆盖或者只初始化一次不再改变(getActivity的最后一个参数flags决定)。

这样我们在pendingIntent中就只能得到第一个新增的widget的Id,或者最后一次新增的widget的Id,

这显然不是我们希望看到的。

 

最后千万不要忘记在AndroidManifest.xml中添加我们新增的MyNoteEdit的声明,  <activity android:name=".MyNoteEdit"/>

 

至此点击响应增加完成,可以运行一下看看效果,生成widget到桌面后,可以点击widget激活修改窗口。

修改窗口复用了my_note_conf.xml 作为layout,所以和配置Activity看起来是一摸一样的。 

 

b. 实现修改便签的Activity界面

到目前为止,绝大多数功能已经实现完毕,就差最后一小步了,就是修改便签内容。

 

因为在第五节的c小节中,我们putString时使用的Key是  "DAT" + mAppWidgetId ,

所以我们在MyNoteEdit的onCreate里面,获取激发了此Activity的Intent,

从Intent中取出放在extraData里的widgetId,就可以用此ID从perference中取出便签内容,并setText到EditText控件中。

这部分代码片段如下:

  1. Intent t = getIntent();  
  2. Log.i("myLog",t.getAction());  
  3. mAppWidgetId = t.getExtras().getInt(AppWidgetManager.EXTRA_APPWIDGET_ID,-1);  
  4. Log.i("myLog","it's [" + mAppWidgetId + "] editing!");  
  5.   
  6. mPref = getSharedPreferences(mPerfName, 0);  
  7. String noteContent = mPref.getString("DAT"+ mAppWidgetId, "");  
  8.   
  9. TextView mTextView= (TextView) findViewById(R.id.EditText02);  
  10. mTextView.setText(noteContent);   

 

而对于四个imageButton的点击事件,则几乎可以完全照抄MyNoteConf的实现。去掉一些无关代码即可。

最终完成的MyNoteEdit的代码如下:

  1. package com.silenceburn;  
  2.   
  3. import android.app.Activity;  
  4. import android.appwidget.AppWidgetManager;  
  5. import android.content.Intent;  
  6. import android.content.SharedPreferences;  
  7. import android.os.Bundle;  
  8. import android.util.Log;  
  9. import android.view.View;  
  10. import android.view.View.OnClickListener;  
  11. import android.widget.ImageButton;  
  12. import android.widget.RemoteViews;  
  13. import android.widget.TextView;  
  14.   
  15. public class MyNoteEdit extends Activity {  
  16.     int mAppWidgetId;  
  17.     TextView mTextView;  
  18.     ImageButton mImBtn1, mImBtn2, mImBtn3, mImBtn4;  
  19.   
  20.     final String mPerfName = "com.silenceburn.MyNoteConf";  
  21.     SharedPreferences mPref;  
  22.   
  23.     @Override  
  24.     protected void onCreate(Bundle savedInstanceState) {  
  25.         // TODO Auto-generated method stub  
  26.         super.onCreate(savedInstanceState);  
  27.         setContentView(R.layout.my_note_conf);  
  28.   
  29.         Intent t = getIntent();  
  30.         Log.i("myLog", t.getAction());  
  31.         mAppWidgetId = t.getExtras().getInt(  
  32.                 AppWidgetManager.EXTRA_APPWIDGET_ID, -1);  
  33.         Log.i("myLog""it's [" + mAppWidgetId + "] editing!");  
  34.   
  35.         mPref = getSharedPreferences(mPerfName, 0);  
  36.         String noteContent = mPref.getString("DAT" + mAppWidgetId, "");  
  37.   
  38.         mTextView = (TextView) findViewById(R.id.EditText02);  
  39.         mTextView.setText(noteContent);  
  40.         mImBtn1 = (ImageButton) findViewById(R.id.ImageButton01);  
  41.         mImBtn2 = (ImageButton) findViewById(R.id.ImageButton02);  
  42.         mImBtn3 = (ImageButton) findViewById(R.id.ImageButton03);  
  43.         mImBtn4 = (ImageButton) findViewById(R.id.ImageButton04);  
  44.   
  45.         mImBtn1.setOnClickListener(mBtnClick);  
  46.         mImBtn2.setOnClickListener(mBtnClick);  
  47.         mImBtn3.setOnClickListener(mBtnClick);  
  48.         mImBtn4.setOnClickListener(mBtnClick);  
  49.   
  50.     }  
  51.   
  52.     OnClickListener mBtnClick = new OnClickListener() {  
  53.   
  54.         @Override  
  55.         public void onClick(View v) {  
  56.   
  57.             SharedPreferences.Editor prefsEdit = mPref.edit();  
  58.             prefsEdit.putString("DAT" + mAppWidgetId, mTextView.getText()  
  59.                     .toString());  
  60.             prefsEdit.commit();  
  61.   
  62.             int srcId = R.drawable.sketchy_paper_008;  
  63.             switch (v.getId()) {  
  64.             case R.id.ImageButton01:  
  65.                 srcId = R.drawable.sketchy_paper_003;  
  66.                 break;  
  67.             case R.id.ImageButton02:  
  68.                 srcId = R.drawable.sketchy_paper_004;  
  69.                 break;  
  70.             case R.id.ImageButton03:  
  71.                 srcId = R.drawable.sketchy_paper_007;  
  72.                 break;  
  73.             case R.id.ImageButton04:  
  74.                 srcId = R.drawable.sketchy_paper_011;  
  75.                 break;  
  76.             }  
  77.   
  78.             RemoteViews views = new RemoteViews(MyNoteEdit.this  
  79.                     .getPackageName(), R.layout.my_note_widget);  
  80.             views.setImageViewResource(R.id.my_widget_img, srcId);  
  81.   
  82.             AppWidgetManager appWidgetManager = AppWidgetManager  
  83.                     .getInstance(MyNoteEdit.this);  
  84.             appWidgetManager.updateAppWidget(mAppWidgetId, views);  
  85.   
  86.             MyNoteEdit.this.finish();  
  87.         }  
  88.     };  
  89. }  

 

至此修改功能也已经完成,本程序的所有功能添加完毕。我们可以如文初所述的那样,

可以通过桌面增加我们的MyNote小部件,输入便签内容,指定图标,

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

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

 


7.总结

本文通过介绍android便签软件的开发过程,讲解了android widget开发的一般方法和过程。

在开发过程中,我故意强调了分阶段渐进式的开发方法,力求每阶段都有可运行的可交付产品,

某种程度上实践了敏捷开发的理念。

 

不过由于本文只是个示例程序,因此对程序的美化、优化都很不足,在编程规范上也有散漫的地方。

这都是本程序的不足之处。

 

审视整个程序,会发现大量代码集中于配置界面和修改界面,

反而在appWidgetProvider中只有记录日志、清理Perferences等简单工作。

这虽然与本程序的需求目的有关,但是也跟为了省电android要求尽量降低自动update频率有关。(推荐值是至多一个小时一次)

所以我们尽量只在需要时,才用RemoteViews和appWidgetManager.updateAppWidget方法显式的去要求widget更新。

 

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

csdn的位于 http://download.csdn.net/source/2932457

eoe的位于  http://www.eoeandroid.com/thread-52530-1-1.html


0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:434558次
    • 积分:4903
    • 等级:
    • 排名:第6013名
    • 原创:41篇
    • 转载:158篇
    • 译文:0篇
    • 评论:28条
    最新评论