android widget 桌面插件的简单事例讲解
想要做个可以在桌面上显示的插件需要3个步骤:
1. 继承AppWidgetProvider
2. 编写widget的界面xml, 编写mywidget属性xml
3. AndroidManifest.xml 注册插件
先上图
这个案例是一个会自增的数字, 非常的简单。
1. 继承AppWidgetProvider
public class MyWidgetProvider extends AppWidgetProvider{private static Timer myTimer;private static int index = 0;private final String broadCastString = "knowheart.wd.appWidgetUpdate"; @Overridepublic void onDeleted(Context context, int[] appWidgetIds){// TODO Auto-generated method stubsuper.onDeleted(context, appWidgetIds);}@Overridepublic void onEnabled(Context context){// TODO Auto-generated method stubsuper.onEnabled(context);}@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds){// TODO Auto-generated method stubsuper.onUpdate(context, appWidgetManager, appWidgetIds);}@Overridepublic void onReceive(Context context, Intent intent){super.onReceive(context, intent);}}
首先我们添加一个类, 用于继承AppWidgetProvider, 它就是用来控制我们的插件更新删除的一些操作
这里会用到onEnabled、onUpdate、onReceive三个方法
2. 编写widget的界面xml, 编写mywidget属性xml
layout/widget_layout.xml
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:orientation="vertical"android:background="#000000"android:layout_gravity="center_horizontal"android:layout_width="300dp"android:layout_height="wrap_content"><TextViewandroid:id="@+id/update"android:text="0" android:layout_width="fill_parent"android:layout_height="wrap_content" android:gravity="center" /></LinearLayout>
新建一个文件夹命名xml, 再添加一个xml文件
xml/mywidget.xml
<?xml version="1.0" encoding="UTF-8"?><appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="300dip" android:minHeight="72dp" android:updatePeriodMillis="86400000" android:initialLayout="@layout/widget_layout" > </appwidget-provider>
这里设置插件的长宽、刷新时间, 0为手动刷新、以及插件的界面xml
3. AndroidManifest.xml 注册插件
<!-- 注册该插件 --> <receiver android:name="MyWidgetProvider" > <intent-filter > <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> <action android:name="com.wd.appWidgetUpdate" > </action> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/mywidget" /> </receiver>
<action android:name="com.wd.appWidgetUpdate" > 这一段是向系统注册一个广播, 我们会在逻辑处理时将该广播发送给AppWidgetProvider的更新方法, 以实现手动刷新。
那么完成上面三部基本上就可以显示一个插件在桌面上了。
如果我们想让插件显示的数字每秒加一的话, 我们需要做后台处理
public class MyWidgetProvider extends AppWidgetProvider{private static Timer myTimer;private static int index = 0;//定义我们要发送的事件private final String broadCastString = "com.wd.appWidgetUpdate"; @Overridepublic void onDeleted(Context context, int[] appWidgetIds){// TODO Auto-generated method stubsuper.onDeleted(context, appWidgetIds);System.out.println("onDeleted");}@Overridepublic void onEnabled(Context context){System.out.println("onEnabled");// TODO Auto-generated method stubsuper.onEnabled(context);//在插件被创建的时候这里会被调用, 所以我们在这里开启一个timer 每秒执行一次MyTask mMyTask = new MyTask(context);myTimer = new Timer();myTimer.schedule(mMyTask, 1000, 1000);System.out.println("onEnabled2");}@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds){System.out.println("onUpdate");// TODO Auto-generated method stubsuper.onUpdate(context, appWidgetManager, appWidgetIds);}@Overridepublic void onReceive(Context context, Intent intent){//当判断到是该事件发过来时, 我们就获取插件的界面, 然后将index自加后传入到textview中System.out.println("onReceive");if(intent.getAction().equals(broadCastString)){index++;RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.widget_layout);rv.setTextViewText(R.id.update, Integer.toString(index));//将该界面显示到插件中AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);ComponentName componentName = new ComponentName(context,MyWidgetProvider.class);appWidgetManager.updateAppWidget(componentName, rv);}// TODO Auto-generated method stubsuper.onReceive(context, intent);}class MyTask extends TimerTask{private Context mcontext = null;private Intent intent = null;public MyTask(Context context) {//新建一个要发送的Intentmcontext = context;intent = new Intent();intent.setAction(broadCastString);}@Overridepublic void run(){System.out.println("2");//发送广播(由onReceive来接收)mcontext.sendBroadcast(intent);}}}
最后, 附上工程源码:
http://download.csdn.net/detail/knowheart/5003328