[开发] 自己的AppWidget一个简单教程

sinxiao 2010-04-21
Android开发的应用除了程序应用,还有是Widget应用。好多人会开发程序应用而不会开发Widget应用。本帖子就是帮助大家学习如何开发Widget应用的。可要多谢您捧场。
呀。
先简单说说Widget的原理。Widget是在桌面上的一块显示信息的东西,也通过单击Widget跳转到一个程序里面。而系统自带的程序,典型的Widget是music,这个Android内置的音乐播放小程序。这个是典型的Widget+app应用。就是一个程序既可以通过Widget启动,也可以通过App启动。Widget就是一个AppWidgetProvider+一个UI界面显示(预先绑定了好多Intent),界面上的信息可以通过程序控制而改变,单击Widget,上的控件只能激发发送一个Intent,或发出一个Service的启动通知。而AppWidgetProvider可以拦截这个Intent,而进行相应的处理(比如显示新的信息)。
Android开发里要大量的通过手动的方式配置好多xml文件。这对于.net开发来说不得不说是个梦靥呀。这也许也是一般的java程序员比.net程序的工资高的一个原因吧。毕竟做Java开发,特别是Android开发,确实很累。你可以看下源码对照着源码进行讲解。

我们先开发一个比较简单的Widget应用,实现的主要功能是可以通过的不断变化,而不断的显示当前时间。首先,要自己手动建一个名为xml的文件夹。
[attach]91110[/attach] 

建一个xml文件,放进去一下东西:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

android:minHeight="72px"
android:minWidth="72px"

android:updatePeriodMillis="3800000" android:initialLayout="@layout/main">
</appwidget-provider>
这个是Widget的显示设置,是对Widget属性的一个配置文件这个android:minHeight是Widget的高,这个android:minWidth
是Widget的宽。这个android:updatePeriodMillis属性是设置Widget页面的
更新页面的时间的频率。而这个android:initialLayout属性是表示的是初始化页面的布局,Android里画UI的地方都是通过xml文件,也可以通过代码程序来画,不过这样画的太麻烦了。
看下以下的文件系统,res文件夹是系统存放资源文件的目录。以drawable开头的文件夹是存放图片资源的文件夹。而后面的hdpi和ldpi等,都是平常在不同的状态如(横屏与竖屏时)系统调用不同的图片资源。Layout就是存放的一般都是xml,UI设计就是在这个layout文件夹里。Value里放的strings.xml就是从程序里分离的字符串,在实现国际化的时候可能会用到。
[attach]91109[/attach] 
看看layout里的main.xml ,只有一个空间就是TextView,这个是用来显示时间用的。

建一个类TestAppWidget继承于AppWidgetProvider,而AppWidgetProvider继承与android.content.BroadcastReceiver,所以TestAppWidget就是一个拦截处理Intent的BroadcastReceiver,这些Intent只能在Androidmainfest里设置来拦截处理。
package com.sinxiao.widgetapp.setting;
import java.util.Calendar;
import com.sinxiao.widgetapp.R;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;
public class TestAppWidget extends AppWidgetProvider {

private String tag="--------TestAppWidget";

private static
final String FRESH="com.sinxiao.app.fresh";

private Context mContext ;

private boolean run = true ;

/**


* 获得系统每秒


*/

BroadcastReceiver mBroadcast =newBroadcastReceiver() {

public void onReceive(Contextcontext, Intent intent) {

String action =intent.getAction();

if(action.equals(Intent.ACTION_TIME_TICK)) {

mContext.sendBroadcast(newIntent(FRESH));

}

}

};

/**


* 通知Widget每个1秒刷新一次


*/

Thread myThread = new
Thread(){

public void run() {

while (run) {

try {

Thread.sleep(1000);


} catch (InterruptedException e) {

e.printStackTrace();

}

mContext.sendBroadcast(newIntent(FRESH));//通知刷新Widget的Intent

}

};

};

@Override

public void onUpdate(Contextcontext, AppWidgetManager appWidgetManager,

int[] appWidgetIds) {//这个是每次Widget更新时调用的函数
用来给Widget刷新界面显示

Log.d(tag,"onUpdate");

super.onUpdate(context,appWidgetManager, appWidgetIds);

mContext = context;

RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);

Calendar
cal=Calendar.getInstance();

System.out.println(cal.getTime().toLocaleString());

views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());

appWidgetManager.updateAppWidget(appWidgetIds,views);

myThread.start();

/**


* 本类作为一个bracastReveiver能自己再,注册个监听器
(可以取消注释,看报什么错误)


*/
//
context.registerReceiver(mBroadcast,new IntentFilter(Intent.ACTION_TIME_TICK));

}

@Override

public void onReceive(Contextcontext, Intent intent) {

Log.d(tag,"onReceive");

String action =intent.getAction();

Log.d(tag, "theaction is "+action);

if (FRESH.equals(action)){

showTime(context);

}elseif(Intent.ACTION_TIME_TICK.equals(action)){

showTime(context);

}

super.onReceive(context,intent);

}

private void showTime(Contextcontext) {

RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);

Calendar
cal=Calendar.getInstance();

System.out.println(cal.getTime().toLocaleString());

views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());

ComponentName thisWidget =new ComponentName(context,TestAppWidget.class);

AppWidgetManager.getInstance(context).updateAppWidget(thisWidget,views);

}

@Override

public void onEnabled(Contextcontext) {

Log.d(tag, "onEnabled");

super.onEnabled(context);

run = true ;

}

@Override

public void onDeleted(Contextcontext, int[] appWidgetIds) {

Log.d(tag,"onDeleted");

super.onDeleted(context,appWidgetIds);

}

@Override

public void onDisabled(Contextcontext) {

Log.d(tag,"onDisabled");

super.onDisabled(context);

run = false ;

}
}
以上代码就是用来改变显示时间和处理刷新FRESHIntent的主程序。
看AndroidMainifest里是如何将FRESH Intent绑定到这个TestAppWidget的,看TestAppWidget这个reciever 里有个
<action android:name="com.sinxiao.app.fresh" />
这就是要拦截的Intent的一个标示。主程序里的重写了父类里的OnReceive()方法在。
private static
final StringFRESH="com.sinxiao.app.fresh";
@Override

public void onReceive(Contextcontext, Intent intent) {

Log.d(tag,"onReceive");

String action=intent.getAction();

Log.d(tag, "theaction is "+action);

if (FRESH.equals(action)){

showTime(context);

}elseif(Intent.ACTION_TIME_TICK.equals(action)){

showTime(context);

}

super.onReceive(context,intent);

}
这个FRESH就显示的就是处理我们,刚才下面绑定的这个FRESH Intent。
<?xml version="1.0"encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.sinxiao.widgetapp"

android:versionCode="1"android:versionName="1.0.0">

<application android:icon="@drawable/icon"android:label="@string/app_name">

<receiver android:name=".setting.TestAppWidget">

<intent-filter>

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

<!-- 这个Intent不支持在配置文件里的
注册
所以这个是没用的
-->

<!-- <actionandroid:name ="android.intent.action.TIME_TICK"/> -->

</intent-filter>

<intent-filter>

<!-- 将IntentAction 手动配置在 mainset文件上 -->

<action android:name="com.sinxiao.app.fresh"/>

</intent-filter>

<meta-data android:name="android.appwidget.provider"

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

</receiver>

</application>
</manifest>
这样就是Widget的简单的实现思路。需要特别说明的是Android 的Widget里有好多潜规则呀。一不小心,就可能中招。这就说明了实践是检验真理的唯一标准呀。
关于对Widget上控件如何赋值?如下所示:
RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);
Calendar
cal=Calendar.getInstance();
System.out.println(cal.getTime().toLocaleString());
views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());

appWidgetManager.updateAppWidget(appWidgetIds,views);
为什么要通过RemoteViews来向Widget设置界面呢?我也不知道,那位高人可以告诉我呢?这就是潜规则呀。在一般app应用里,直接用
setContentView(R.layout.main);
来实现。这个RemoteViews更特殊,设置Text时,必须通过
views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());
这种变态的方式才可以赋值,实在令人琢磨不透呀。
通过appWidgetManager来,更新了页面,也就刷新了Widget界面。在获得ACTION 为 com.sinxiao.app.fresh的Intent时,也是这样更新页面。在showTime();的方法里,
ComponentName thisWidget = new ComponentName(context,TestAppWidget.class);

AppWidgetManager.getInstance(context).updateAppWidget(thisWidget,views);
不过变成以上这种方式来更新了。这样的好处,是只要有个context 就可以实现了界面的刷新。
说的半天,你要是不会启动Widget就杯具了,因为这事你要骂我,我就餐具了。按menu键


然后单击Add,出现以下页面,或者长按屏幕也可以出现。


单击Widget就出现了我们的Widget小程序了。


单击选择我们的程序就成功了。


帖子有点乱,看了好好缕缕,有什么不懂的可以问我啊。如果被我带到沟里,可不要骂我啊。看我的原帖与下载源码,请看:http://www.androidin.net/bbs/viewthread.php?tid=89115&rpid=1419288&fav=yes&ordertype=0&page=1#pid1419288
newkey007 2011-01-25
  
Global site tag (gtag.js) - Google Analytics