本文实例讲述了android桌面组件app widget用法。分享给大家供大家参考。具体如下:
android开发应用除了程序应用,还有app widget应用。好多人会开发程序应用而不会开发app widget应用。本帖子就是帮助大家学习如何开发app widget应用的。
先简单说说app widget的原理。app widget是在桌面上的一块显示信息的东西,通过单击app widget跳转到程序入口类。而系统自带的程序,典型的app widget是music,这个android内置的音乐播放小程序。这个是典型的app widget+app应用。就是一个程序既可以通过app widget启动,也可以通过app启动。app widget就是一个appwidgetprovider+一个ui界面显示(预先绑定了好多intent),界面上的信息可以通过程序控制而改变,单击widget上的控件只能激发发送一个intent,或发出一个service的启动通知。而appwidgetprovider可以拦截这个intent,而进行相应的处理(比如显示新的信息)。
以下模拟一下app widget的应用
通过两种方式启动应用程序
1、app widget启动
长按空白的桌面主屏幕会弹出“添加到主屏幕”,然后选择“窗口小部件”选项进入“选择窗口小部件”,最后选择想要的小部件就会添加到桌面主屏幕,当点击刚才添加的桌面控件就会进入到程序主入口。
2、app启动:跟普通的activity一样
以下为实现代码
main.xml布局文件,程序入口类的界面
my_layout.xml布局文件:带一个图片的按钮
1
2
3
4
5
6
7
8
|
<?xml version= "1.0" encoding= "utf-8" ?>
<linearlayout xmlns:android= "http://schemas.android.com/apk/res/android"
android:orientation= "vertical" android:layout_width= "fill_parent"
android:layout_height= "fill_parent" >
<textview android:layout_width= "fill_parent"
android:layout_height= "wrap_content"
android:text= "程序入口" />
</linearlayout>
|
类mainactivity程序入口类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
package com.ljq.activity;
import android.app.activity;
import android.os.bundle;
/**
* 主程序入口类
*
* @author jiqinlin
*
*/
public class mainactivity extends activity{
@override
protected void oncreate(bundle savedinstancestate) {
super .oncreate(savedinstancestate);
setcontentview(r.layout.main);
}
}
|
下面的代码才是开发appwidget用到的代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<?xml version= "1.0" encoding= "utf-8" ?>
<linearlayout xmlns:android= "http://schemas.android.com/apk/res/android"
android:orientation= "vertical"
android:layout_width= "fill_parent"
android:layout_height= "fill_parent" >
<!-- <imageview
xmlns:android= "http://schemas.android.com/apk/res/android"
android:id= "@+id/imageview"
android:gravity= "center"
android:layout_width= "fill_parent"
android:layout_height= "wrap_content" /> -->
<button android:id= "@+id/btn"
android:layout_width= "fill_parent"
android:layout_height= "wrap_content"
android:gravity= "center"
android:background= "@drawable/png1" />
</linearlayout>
|
my_appwidget.xml布局文件:
1
2
3
4
5
6
7
8
9
10
11
|
<?xml version= "1.0" encoding= "utf-8" ?>
<!--
appwidgetprovderinfo: 描述appwidget的大小、更新频率和初始界面等信息,以xml文件形式存在于应用的res/xml/目录下。
注意:sdk1. 5 之后此android:updateperiodmillis就失效了,要自己创建service更新
-->
<appwidget-provider
xmlns:android= "http://schemas.android.com/apk/res/android"
android:minwidth= "75dip"
android:minheight= "45dip"
android:updateperiodmillis= "1000"
android:initiallayout= "@layout/my_layout" />
|
testactivity类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
package com.ljq.activity;
import android.app.pendingintent;
import android.appwidget.appwidgetmanager;
import android.appwidget.appwidgetprovider;
import android.content.componentname;
import android.content.context;
import android.content.intent;
import android.widget.remoteviews;
/**
* 为手机添加桌面控件,当点击桌面控件时则进入主程序
*
* appwidgetprovider:继承自broadcastrecevier,在appwidget应用update、enable、disable和delete时接收通知。
* 其中,onupdate、onreceive是最常用到的方法,它们接收更新通知
*
* @author jiqinlin
*
*/
public class testactivity extends appwidgetprovider {
/**
* 用来间隔的更新app widget,间隔时间用appwidgetproviderinfo里的updateperiodmillis属性定义(单位为毫秒)。
* 注意:sdk1.5之后此android:updateperiodmillis就失效了,要自己创建service更新。
* 这个方法也会在用户添加app widget时被调用,因此它应该执行基础的设置,比如为视图定义事件处理器并启动一个临时的服务service,如果需要的话。
* 但是,如果你已经声明了一个配置活动,这个方法在用户添加app widget时将不会被调用,
* 而只在后续更新时被调用。配置活动应该在配置完成时负责执行第一次更新。
*/
@override
public void onupdate(context context, appwidgetmanager appwidgetmanager, int [] appwidgetids) {
system.out.println( "onupdate" );
//点击桌面组件时进入主程序入口
intent intent= new intent(context, mainactivity. class );
pendingintent pendingintent=pendingintent.getactivity(context, 0 , intent, 0 );
//remoteviews类描述了一个view对象能够显示在其他进程中,可以融合layout资源文件实现布局。
//虽然该类在android.widget.remoteviews而不是appwidget下面,但在android widgets开发中会经常用到它,
//主要是可以跨进程调用(appwidget由一个服务宿主来统一运行的)。
remoteviews myremoteviews = new remoteviews(context.getpackagename(), r.layout.my_layout);
//myremoteviews.setimageviewresource(r.id.imageview, r.drawable.png1);//设置布局控件的属性(要特别注意)
myremoteviews.setonclickpendingintent(r.id.btn, pendingintent);
componentname mycomponentname = new componentname(context, testactivity. class );
//负责管理appwidget,向appwidgetprovider发送通知。提供了更新appwidget状态,获取已经安装的appwidget提供信息和其他的相关状态
appwidgetmanager myappwidgetmanager = appwidgetmanager.getinstance(context);
myappwidgetmanager.updateappwidget(mycomponentname, myremoteviews);
}
/**
* 当app widget从宿主中删除时被调用。
*/
@override
public void ondeleted(context context, int [] appwidgetids) {
system.out.println( "ondeleted" );
super .ondeleted(context, appwidgetids);
}
/**
* 当一个app widget实例第一次创建时被调用。
* 比如,如果用户添加两个app widget实例,只在第一次被调用。
* 如果你需要打开一个新的数据库或者执行其他对于所有的app widget实例只需要发生一次的设置,
* 那么这里是完成这个工作的好地方。
*/
@override
public void onenabled(context context) {
system.out.println( "onenabled" );
super .onenabled(context);
}
/**
* 当你的app widget的最后一个实例被从宿主中删除时被调用。你应该在onenabled(context)中做一些清理工作,比如删除一个临时的数据库
*/
@override
public void ondisabled(context context) {
system.out.println( "ondisabled" );
super .ondisabled(context);
}
/**
* 接收到每个广播时都会被调用,而且在上面的回调函数之前。
* 你通常不需要实现这个方法,因为缺省的appwidgetprovider实现过滤所有app widget广播并恰当的调用上述方法。
* 注意: 在android 1.5中,有一个已知问题,ondeleted()方法在调用时不被调用。
* 为了规避这个问题,你可以像group post中描述的那样实现onreceive()来接收这个ondeleted()回调。
*/
@override
public void onreceive(context context, intent intent) {
system.out.println( "onreceive" );
super .onreceive(context, intent);
}
}
|
清单文件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<?xml version= "1.0" encoding= "utf-8" ?>
<manifest xmlns:android= "http://schemas.android.com/apk/res/android"
package = "com.ljq.activity" android:versioncode= "1"
android:versionname= "1.0" >
<application android:icon= "@drawable/icon" android:label= "@string/app_name" >
<activity android:name= ".mainactivity" android:label= "主程序" >
<intent-filter>
<action android:name= "android.intent.action.main" />
<category android:name= "android.intent.category.launcher" />
</intent-filter>
</activity>
<!-- testactivity类为一个广播接收器,因为testactivity继承自appwidgetprovider -->
<receiver android:name= ".testactivity" android:label= "添加桌面控件" >
<intent-filter>
<action android:name= "android.appwidget.action.appwidget_update" />
</intent-filter>
<meta-data android:name= "android.appwidget.provider"
android:resource= "@xml/my_appwidget" />
</receiver>
</application>
<uses-sdk android:minsdkversion= "7" />
</manifest>
|
希望本文所述对大家的android程序设计有所帮助。