Android的Launcher启动器中添加快捷方式及小部件实例

时间:2022-01-26 14:43:01

前言: 最近一直在看launcher模块,经过差不多两个月学习,终于摸透了launcher的一些主要功能实现,目前继续还处于
摸索状态。未看launcher时,于我而言,只能膜拜,以为所有功能都是它实现的 ;入门后,才发现,launcher的很多功能只是
集成了框架/应用程序提供的功能。很多陌生的东西,只有接触了才感叹:“oh ,原来是这样的!”

添加快捷方式

今天先给大家分享下launcher如何实现添加快捷方式(shortcut) ,后续会慢慢增加其他方面的功能,帮助大家“一叶而知秋”。
具体来说,launcher中的快捷方式有两种类型:
1 、"伪"快捷方式 —— 应用程序类型
2 、"真"快捷方式 —— activity具备<action/>为action_create_shortcut的配置信息
这两种类型的快捷方式是怎么勾搭在一起的,在下面大家通过代码自己理解,也不方便细说了。
知识点介绍:
知识点一 、action_pick_activity使用说明 ,具体可以参考sdk intent类
功能:显示匹配附加值为extra_intent的所有activity,并将它们以列表呈现给用户。当用户从该列表选中一项 
时,并不会启动该activity(这与与action_chooser不同,此action会启动用户选择的activity),而是将该activity的详细信
息(可能包括action、componentname、data信息等)以intent对象返回给调用者(通常为onactivityresult方法)。

附加值:extra_intent  显示所有匹配显示所有匹配附加值为extra_intent的activity,
extra_title     作为显示列表即所有activity的标题 。

因此,根据action_pick_activity的特性,真正地创建快捷方式需要两步走:

第一步:发送action_pick_activity以及extra_intent,找到我们希望能创建快捷方式的activity列表。
第二步:根据第一步所选择的activity返回的intent对象,再次发送此intent对象,即可创建该activity提供给
我们快捷方式了。

例如,下面我们只是简单的发送一个请求显示所有应用程序的intent,如下:

?
1
2
3
4
5
6
7
8
9
10
11
//重新发送一个action为pick_activity的intent,获取所有应用程序信息
    intent pickintent = new intent(intent.action_pick_activity);
    intent mainintent = new intent () ;
    mainintent.setaction(intent.action_main);
    mainintent.addcategory(intent.category_launcher);
    
    pickintent.putextra(intent.extra_intent, mainintent);
    pickintent.putextra(intent.extra_title, "选择应用程序"); //设置界面title
    
    //继续选择所有应用程序
    startactivityforresult(pickintent,my_request_all_application );

 
action_pick_activity效果图如下:

Android的Launcher启动器中添加快捷方式及小部件实例

点击某一具体activity  , 即可选择创建该activity的快捷方式了。

知识点二、 intent.shortcuticonresource类介绍
功能: 为快捷方式(shortcut)和文件夹(live folder)提供图片资源
常用方法为:
public static intent.shortcuticonresource fromcontext(context context, int resourceid)
功能: 创建一个 intent.shortcuticonresource 对象
参数说明:context        context类对象
resourceid  具体的图片资源id 。
常用属性:
packagename    该应用程序所在包名,类型为 packagename:type/entityname
resourcename   resourceid所对应地的资源名

例如: 某个图片资源 r.id.icon = 0x7f020000, 则resourcename 为 packagename:drawable/icon

具体怎么通过 intent.shortcuticonresource对象获取图片资源,请参考示例demo。

示例demo
说明:点击创建快捷方式对话框后, 选择某一项具体的快捷方式,即可添加至mainactivity界面中 ,继续点击每个view,则
可启动该快快捷方式的app,挺给力的吧。

ps: 由于我只是简单的利用了linearlayout去当容器,会存在局限性,大家可在此基础上,利用gridview/listview构建更好
的布局,当然更nb的是,去提供类似launcher的自定义布局。

由于执行快捷方式可能需要一些特定的权限,因此我们必须得在androidmanifest.xml里配置对应的权限。例如,直接拨打电话
需要的权限为:   <uses-permission android:name="android.permission.call_phone"></uses-permission>

如上效果图,增加几个快捷方式后截图如下,点击即可启动该应用。

Android的Launcher启动器中添加快捷方式及小部件实例

主工程逻辑如下:

?
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
package com.qin.addshortcut;
 
import java.util.arraylist;
 
import android.app.activity;
import android.content.componentname;
import android.content.intent;
import android.content.intent.shortcuticonresource;
import android.content.pm.activityinfo;
import android.content.pm.packagemanager;
import android.content.pm.packagemanager.namenotfoundexception;
import android.content.res.resources;
import android.graphics.bitmap;
import android.graphics.rect;
import android.graphics.drawable.bitmapdrawable;
import android.graphics.drawable.drawable;
import android.os.bundle;
import android.os.parcelable;
import android.util.log;
import android.view.layoutinflater;
import android.view.view;
import android.widget.button;
import android.widget.imageview;
import android.widget.linearlayout;
import android.widget.textview;
import android.widget.toast;
/**
 *
 * @author http://http://blog.csdn.net/qinjuning
 */
public class mainactivity extends activity implements view.onclicklistener
{
 
 private linearlayout linearlayout ; //用来存放所有快捷方式的容器 --- 父视图
 private button btaddshortcut;
 
  
 private static final int my_request_short_cut = 1; // 第一步 、 显示所有能创建快捷方式的activity
 private static final int my_create_shourt_cut = 2;   //第二步、 创建 真快捷方式
 private static final int my_request_all_application = 3 ; //第二步 、创建 伪快捷方式 -- 应用程序类
 private static string tag = "addshortactivity" ;
  
 private packagemanager mpackagemanager = null ;
  
 /** called when the activity is first created. */
 @override
 public void oncreate(bundle savedinstancestate)
 {
  super.oncreate(savedinstancestate);
  setcontentview(r.layout.main);
 
  btaddshortcut = (button) findviewbyid(r.id.bt_addshortcut);
  linearlayout = (linearlayout)findviewbyid(r.id.linearlayout) ;
  linearlayout.setonclicklistener(this) ;
   
  //演示如何通过一个资源的type获取该资源文件在r文件中的整数描述符
  // getidentifier 参数为 package:type/entry . 例如求icon的资源描述符如下:
  int iconid = this.getresources().getidentifier("com.qin.addshortcut:drawable/icon", null, null);  
  log.i(tag, " icon id : " + iconid);
   
  //获取packagemanager对象
  mpackagemanager = getpackagemanager();
     
  btaddshortcut.setonclicklistener(new view.onclicklistener()
  {
 
   @override
   public void onclick(view v)
   {
    //创建快捷方式对话框
    createshortdialog() ;
   }
  });
   
 }
 private void createshortdialog(){
   
  //begin :添加创建应用程序的图标('快捷方式")
  // 此bundle值为附加的创建pick_activity的一个列表项
  bundle bundle = new bundle() ;
  //设置name
  arraylist<string> shortcutnames = new arraylist<string>();
  shortcutnames.add("应用程序");
  bundle.putstringarraylist(intent.extra_shortcut_name, shortcutnames);
  //设置对应的头像
  arraylist<shortcuticonresource> shortcuticonres= new arraylist<shortcuticonresource>();
  shortcuticonres.add(shortcuticonresource.fromcontext(mainactivity.this, r.drawable.icon));
  bundle.putparcelablearraylist(intent.extra_shortcut_icon_resource, shortcuticonres);
  // end    
   
  intent pickintent = new intent(intent.action_pick_activity);
 
  intent extraintent = new intent(intent.action_create_shortcut);
 
  pickintent.putextra(intent.extra_intent, extraintent);//所要查找的activity intent
  pickintent.putextra(intent.extra_title, "选择快捷方式"); // title
  //看到没 , 伪快捷方式 是在这儿创建地。
  pickintent.putextras(bundle);
   
  startactivityforresult(pickintent, my_request_short_cut);
 }
  
  
 protected void onactivityresult(int requestcode, int resultcode, final intent data)
 {
  super.onactivityresult(requestcode, resultcode, data);
  //未成功的选择任何一个shortcut(比如直接按back键) , 直接返回
  if(resultcode == result_canceled )
   return ;
   
   
  switch(requestcode){
  case my_request_short_cut:
   //第一次发送 pick_activity后 ,对所选列表项进行选择后,做的中间处理操作,需要判断是选择“应用程序” 抑或真正滴快捷方式
    // 获得快捷方式label
   string label = data.getstringextra(intent.extra_shortcut_name);
   //这个字段是我们之前主动添加的
   if(label.equals("应用程序")){
    //重新发送一个action为pick_activity的intent,获取所有应用程序信息
    intent pickintent = new intent(intent.action_pick_activity);
    intent mainintent = new intent () ;
    mainintent.setaction(intent.action_main);
    mainintent.addcategory(intent.category_launcher);
     
    pickintent.putextra(intent.extra_intent, mainintent);
    pickintent.putextra(intent.extra_title, "选择应用程序"); //设置界面title
     
    //继续选择所有应用程序
    startactivityforresult(pickintent,my_request_all_application );
     
   }
   else{ //重新请求创建上一次点击的activity , 启动后即可创建
    log.v(tag, "my_request_short_cut intent info--- >" + data);
    //下一步,创建某一具体的shortcut
    startactivityforresult(data, my_create_shourt_cut);
   }
   break ;
    
  //以下操作才是真正地处理添加快捷方式的操作 
  case my_create_shourt_cut:
   //data数据封装了所有快捷方式应该该附加的值
   log.v(tag, "my_create_shourt_cut intent info--- >" + data);
   completeaddshortcut(data);
   break ;
    
  case my_request_all_application: //创建一个应用程序的"快捷方式"
   //data数据封装了点击某个应用程序的intent,包括action,componentname组信息等,继而我们可以通过intent对象获取该应用程序的信息
   log.v(tag, "my_request_all_application intent info--- >" + data);
   completeaddapplication(data) ;
   break ;
  default :
   break ;
    
  }
   
 }
  
 //添加一个应用程序的"快捷方式"
 private void completeaddapplication(intent data){
   
  //打印应用程序返回的intent信息, 一个完整的启动应用程序的intent
  log.i(tag, "application intent info ---->" +data) ;
   
  componentname componentname = data.getcomponent() ;
  log.i(tag, "componentname info ----> " + componentname) ;
   
  try
  {
   //获取资源图片
   activityinfo activityinfo = mpackagemanager.getactivityinfo(componentname, 0);
   charsequence applabel = activityinfo.loadlabel(mpackagemanager) ;
   drawable appicon = activityinfo.loadicon(mpackagemanager) ;
    
   //创建一个view对象
   view view = makeviewforshortcut(applabel , appicon) ;
   //为该快捷方式的view设置onclick监听
   view.setonclicklistener(this) ;
   //将该intent对象设置为view的tag属性 , onclick时获取该tag , --->gettag()
   view.settag(data) ;
    
   //将该view对象添加至linearlayout中,由于大小发生了变化,系统会重新走”measure“ , ”layout“, ”draw“ 过程
   //设置长宽高
   linearlayout.layoutparams llparams = new linearlayout.layoutparams(80,90) ;
   linearlayout.addview(view,llparams) ;
  }
  catch (namenotfoundexception e)
  {
    log.e(tag, "namenotfoundexception at completeaddapplication method") ;
  }  
 }
  
 //添加快捷方式(真正地,非应用程序)
 private void completeaddshortcut(intent data){
   
  drawable shortcuticon = null; //快捷方式的图标 , 可以有两种方式获取,如下 if else 判断
  
  // 获得快捷方式label
  string label = data.getstringextra(intent.extra_shortcut_name);
   
  parcelable bitmap = data.getparcelableextra(intent.extra_shortcut_icon);
  // 直接了图片 , 即设置了 extra_shortcut_icon 参数值
  if (bitmap != null && bitmap instanceof bitmap)
  {
   shortcuticon = new bitmapdrawable((bitmap) bitmap);
  }
  else //设置了extra_shortcut_icon_resource 附加值
  {
   parcelable iconparcel = data .getparcelableextra(intent.extra_shortcut_icon_resource);
   if(iconparcel != null && iconparcel instanceof shortcuticonresource)
   {
    // 获得shortcuticonresource对象
    shortcuticonresource iconres = (shortcuticonresource) iconparcel;
    //获得inconres对象的resource对象
    try
    {
     //获取对应packagename的resources对象
     resources resources = mpackagemanager.getresourcesforapplication(iconres.packagename);    
     //获取对应图片的id号
     int iconid = resources.getidentifier(iconres.resourcename, null, null);
     log.i(tag, "icon identifier is " + iconres.resourcename) ;
     //获取资源图片
     shortcuticon = resources.getdrawable(iconid);
    }
    catch (namenotfoundexception e)
    {
      log.e(tag, "namenotfoundexception at completeaddshortcut method") ;
    }
 
   }
  }
  //可能快捷方式没有为我们设置任何图像以及shortcuticonresource对象,我们需要重置快捷方式的头像
  if ( shortcuticon == null) {
   // 一定会有图片,这儿我简单的处理了 .
   toast.maketext(mainactivity.this, "sorry , we could not shortcut image", toast.length_short) ;
   return ;
  }
 
  // 获得快捷方式intent , 直接startactivity 即可
  intent shortcut_intent = data.getparcelableextra(intent.extra_shortcut_intent);
   
  if (shortcut_intent != null)
   log.i(tag, "shortcut intent info ----> "+shortcut_intent) ;
     
  //创建一个view对象
  view view = makeviewforshortcut(label , shortcuticon) ;
  //为该快捷方式的view设置onclick监听
  view.setonclicklistener(this) ;
  //将该intent对象设置为view的tag属性 , onclick时获取该tag , --->gettag()
  view.settag(shortcut_intent) ;
   
  //将该view对象添加至linearlayout中,由于大小发生了变化,系统会重新走”measure“ , ”layout“, ”draw“ 过程
  //设置长宽高
  linearlayout.layoutparams llparams = new linearlayout.layoutparams(100,90) ;
   
  linearlayout.addview(view,llparams) ;
  
 }
 
 //点击事件
 @override
 public void onclick(view v) {
  object tag = v.gettag() ;
  if(tag !=null && tag instanceof intent){
   intent intent = (intent)tag ;
   startactivityforsafely(intent) ;
  }
   
 }
 //安全启动一个activity
 private void startactivityforsafely(intent data) {
  intent launchintent = data ;
   
  //有些启动后的activity需要设置该选项,即为启动的activity设置一个界面,例如联系人的快捷方式, so , 我们加上它吧
  launchintent.setsourcebounds(new rect(0,0,300,300));
  launchintent.setflags(intent.flag_activity_new_task);
   
  startactivity(launchintent) ;
 }
  
 //为每个快捷方式创建一个view对象
 private view makeviewforshortcut(charsequence label , drawable icon){
  layoutinflater inflater = layoutinflater.from(this) ;
  view shortcut_view = inflater.inflate(r.layout.shortcut_view, null) ;
   
  textview tv = (textview)shortcut_view.findviewbyid(r.id.shortcut_label) ;
  tv.settext(label) ;
   
  imageview img = (imageview)shortcut_view.findviewbyid(r.id.shortcut_img) ;
  img.setimagedrawable(icon) ;
  return shortcut_view ; 
 }
  
  
}


添加窗口小部件
我们知道:

1、每个appwidget都有一个appwidgetproviderinfo对象,该对象描述了每个appwidget的基本数据(meta-data)信息 ,
其定义在<appwidget-provider>节点信息。

2、每个appwidget都对应一个remoteviews视图对象,该remoteviews提供了特定appwidget的展示(view视图)和操作
(例如,点击该remoteviews会跨进程处理一些事情)。

3、appwidgetmanager类维护了应用程序中所有的appwidget,并且为给每个appwidget特定的id去标识他们(一般我们
用 appwidgetid去标识)。通过给定的appwidgetid,appwidgetmanager可以管理对应的appwidget,例如:更新该
appwidgetid的remoteviews视图,删除该appwidget对象等 。

4、appwidgetprovider广播类从来说是一个监听器,系统把对appwidget的操作(例如,创建和更新等)分发给
appwidgetprovider类去处理。


对每个appwidget,我们可以创建多个其多个实例,当然这些实例对应于不同的appwidgetid。 假设存在这么个
myappwidgetprovider广播类,以及对应的myappwidgetproviderinfo对象。 那么,则存在如下关系:

myappwidgetprovider.class : 代表了由该myappwidgetprovider创建的窗口小部件(appwidget)的类型,一般用
compontentname对象形式表示 。 那么存在如下关系:

Android的Launcher启动器中添加快捷方式及小部件实例

从上图可是,每个appwidget都对应于一个myappwidgetprovider类,于是当任何一个appwidgetid发生变化时,我们需要
同步其他实例,保持同步性。

appwidgetproviderinfo类补充说明:
publiccomponentnameconfigure: 一般为一个activity,表明该activity复杂需要管理appwidget的创建操作。
public int updateperiodmillis:用来更新appwidget,但该属性在sdk1.5已废除

appwidgetprovider类介绍:
常用方法:
ondeleted()   : 当该类型的appwidget每次被删除时,调用此方法
ondisabled() : 当该类型的窗口小部件(appwidget)全被删除时,调用此方法
onenabled() : 当第一次创建该类型的appwidget时,调用此方法
onreceive() : 广播接受者方法  , 用来接受广播消息
onupdate()   : 每次创建该类型的appwidget都会调用此方法 , 通常来说我们需要在该方法里为该appwidget指定
remoteviews对象。

appwidgetmanager类介绍:
常用常量:
action_appwidget_pick= "android.appwidget.action.appwidget_pick“
说明:列出所有能够创建appwidget的对象,该对象一般为自定义的appwidgetprovider广播接受者。 
注意:发送该intent必须添加附加值:extra_appwidget_id 。
该extra_appwidget_id含义:该appwidgetid与我们发送action为action_appwidget_pick 后
所选择的appwidget绑定。因此,我们可以通过这个appwidgetid获取该appwidget的信息了。

action_appwidget_configure= "android.appwidget.action.appwidget_configure”
说明: 如果选择的appwidget配置了android:configure 属性,需要再次启动性对应的activity,继而进一步去选择
appwidget。同时发送该intent必须添加附加值:extra_appwidget_id,含义同上。

常用方法:

?
1
public int[] getappwidgetids(componentname provider)

功能:获取对应componentname类型的所有appwidgetid
参数说明:   provider  通常为 xxxappprovider.class类型

?
1
publicappwidgetproviderinfo getappwidgetinfo(int appwidgetid)

功能: 获取特定appwidgetid对应的appwidgetproviderinfo对象

?
1
public staticappwidgetmanager getinstance(contextcontext)

功能: 获取 appwidgetmanager对象  

?
1
public void updateappwidget(int appwidgetid, remoteviews views)


功能: 以特定的views视图更新appwidgetid的窗口小部件(appwidget) 。同时会发送action_appwidget_update广播

?
1
public void updateappwidget(int[] appwidgetids,remoteviews views)

功能:以特定的views视图更新所有appwidgetids的窗口小部件(appwidget),同时发送action_appwidget_update
广播

?
1
public void updateappwidget(componentname provider, remoteviews views)

功能: 已特定的views更新组件类型为provider的所有窗口小部件(appwidget),同时发送action_appwidget_update
广播。

示例demo :

说明:创建一个简单的appwidget实例,点击按钮后可以更该图片资源显示 ,具体代码在
截图为:

Android的Launcher启动器中添加快捷方式及小部件实例

关于如何创建一个appwidget的教材,我也不再多说了,大家可以参考上面我提到的两篇重量级博客去学习:

1、sdk对appwidget的介绍
2、android 桌面组件【widget】初探

ps: 具体代码可在后面下载 。

再次强调一点,每个appwidget都对应与appwidgetprovider , 我们需要同步更新这些appwidget对象。
在自己的应用程序中添加窗口小部件
本部分的主要功能是像launchcer那样添加appwidget 。 知识点介绍如下:

appwidgethost 类

功能:对每个应用程序app,该类提供了和appwidgetservice(该appwidgetservice用来管理所有appwidget,类似于
notificationmanagerservice系统服务管理所有notifciation,不懂?其实我也不懂,知其大意即可)交互,用来更新、管理
appwidget。打个比喻:appwidgethost是宿主对象,每个appwidget都是寄生虫,可以附加在(显示)appwidgethost上。
每个能添加、显示appwidget的activity都是一个appwidgethost对象,比如launcher.java(activity对象),以及我们后面自定
义的mainactivity.java(activity对象)。

常用方法为:
public appwidgethost(context context, int hostid)
功能:构造一个appwidgethost对象
参数:  hostid   大意是该appwidgethost(宿主对象)对应的id号,一般赋予一整数即可。
public int allocateappwidgetid()
功能:申请一个新的appwidgetid ,该id会与新创建的appwidget绑定。
public void startlistening()
功能:监听所有appwidget的变化 ,该方法必须在activity的oncreate()/onstart()调用,否则 appwidget是不会得到更新的
public void stoplistening()
功能: 对应于startlistening(),即停止对appwidget的更新监听。可以在activity的onstop()方法里调用 ,
一般无需调用此方法去停止监听。

public final  appwidgethostview    createview(context context, int appwidgetid, appwidgetproviderinfo appwidget)
功能: 根据指定的appwidgetid以及appwidgetproviderinfo对象去构建一个appwidgethostview对象(具体该对象,
参见下 文)。


appwidgethostview 与 remoteviews的区别

对每个appwidget内部而言,都有一个remoteviews对象,用于视图显示;而对于外部而已,则以appwidgethostview形式代言 这个remoteviews视图。换句话来说就是,appwidgethost对象而言,它并不知道remoteviews存在,而只是remoteviews 的代言人appwidgethostview。


好了 ,该说明的都说明了,下面最后给大家补充一下如何利用在自己的应用程序里添加窗口小部件(appwidget) 。
也是两步走:

第一步:  发送action为action_appwidget_pick的 intent ,则所有能创建窗口小部件的appwidgetprovider的广播
接收者都会显示 ,同时为该新创建的appwidget分配一个appwidgetid ,该appwidgetid即可唯一标记我们选择的
appwidget。

第二步:如果选择的appwidget对应地appwidgetproviderinfo对象配置了android:configure属性,则需要在此启动该配置
属性(一般为一个activity类) ,然后在完成添加appwidget的操作 ; 否则,没有配置android:configure属性,就可以添加
appwidget的操作。

示例demo截图:

Android的Launcher启动器中添加快捷方式及小部件实例

主工程流程如下:  

?
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
package com.qin.addappwidget;
 
 
import android.app.activity;
import android.appwidget.appwidgethost;
import android.appwidget.appwidgethostview;
import android.appwidget.appwidgetmanager;
import android.appwidget.appwidgetproviderinfo;
import android.content.intent;
import android.os.bundle;
import android.util.log;
import android.view.view;
import android.widget.button;
import android.widget.imageview;
import android.widget.linearlayout;
import android.widget.textview;
import android.widget.toast;
 
public class mainactivity extends activity
{
 
 private static string tag = "addappwidget" ;
  
 private button btaddshortcut;
 private linearlayout linearlayout ; // 装载appwidget的父视图
  
 private static final int my_request_appwidget = 1;
 private static final int my_create_appwidget = 2;
  
 private static final int host_id = 1024 ;
  
 private appwidgethost mappwidgethost = null ;
 appwidgetmanager appwidgetmanager = null;
  
 /** called when the activity is first created. */
 @override
 public void oncreate(bundle savedinstancestate)
 {
  super.oncreate(savedinstancestate);
  setcontentview(r.layout.main);
 
  btaddshortcut = (button) findviewbyid(r.id.bt_addshortcut);
 
  linearlayout = (linearlayout)findviewbyid(r.id.linearlayout) ;
  
  //其参数hostid大意是指定该appwidgethost 即本activity的标记id, 直接设置为一个整数值吧 。
  mappwidgethost = new appwidgethost(mainactivity.this, host_id) ;
   
  //为了保证appwidget的及时更新 , 必须在activity的oncreate/onstar方法调用该方法
  // 当然可以在onstop方法中,调用mappwidgethost.stoplistenering() 停止appwidget更新
  mappwidgethost.startlistening() ;
   
  //获得appwidgetmanager对象
  appwidgetmanager = appwidgetmanager.getinstance(mainactivity.this) ;
   
   
  btaddshortcut.setonclicklistener(new view.onclicklistener()
  {
   @override
   public void onclick(view v)
   {
     //显示所有能创建appwidget的列表 发送此 action_appwidget_pick 的action
     intent pickintent = new intent(appwidgetmanager.action_appwidget_pick) ;
     
     //向系统申请一个新的appwidgetid ,该appwidgetid与我们发送action为action_appwidget_pick
     // 后所选择的appwidget绑定 。 因此,我们可以通过这个appwidgetid获取该appwidget的信息了
     
     //为当前所在进程申请一个新的appwidgetid
     int newappwidgetid = mappwidgethost.allocateappwidgetid() ;
     log.i(tag, "the new allocate appwidgetid is ----> " + newappwidgetid) ;
     
     //作为intent附加值 , 该appwidgetid将会与选定的appwidget绑定    
     pickintent.putextra(appwidgetmanager.extra_appwidget_id, newappwidgetid) ;
     
     //选择某项appwidget后,立即返回,即回调onactivityresult()方法
     startactivityforresult(pickintent , my_request_appwidget) ;
         
   }
  });
 }
 
 // 如果
 protected void onactivityresult(int requestcode, int resultcode, intent data)
 {
  //直接返回,没有选择任何一项 ,例如按back键
  if(resultcode == result_canceled)
   return ;
   
  switch(requestcode){
   case my_request_appwidget :
    log.i(tag, "my_request_appwidget intent info is -----> "+data ) ;
    int appwidgetid = data.getintextra(appwidgetmanager.extra_appwidget_id , appwidgetmanager.invalid_appwidget_id) ;
     
    log.i(tag, "my_request_appwidget : appwidgetid is ----> " + appwidgetid) ;
     
    //得到的为有效的id
    if(appwidgetid != appwidgetmanager.invalid_appwidget_id){
     //查询指定appwidgetid的 appwidgetproviderinfo对象 , 即在xml文件配置的<appwidget-provider />节点信息
     appwidgetproviderinfo appwidgetproviderinfo = appwidgetmanager.getappwidgetinfo(appwidgetid) ;
      
     //如果配置了configure属性 , 即android:configure = "" ,需要再次启动该configure指定的类文件,通常为一个activity
     if(appwidgetproviderinfo.configure != null){
       
      log.i(tag, "the appwidgetproviderinfo configure info -----> " + appwidgetproviderinfo.configure ) ;
       
      //配置此action
      intent intent = new intent(appwidgetmanager.action_appwidget_configure) ;
      intent.setcomponent(appwidgetproviderinfo.configure) ;
      intent.putextra(appwidgetmanager.extra_appwidget_id, appwidgetid);
       
       
      startactivityforresult(intent , my_create_appwidget) ;    
     }
     else //直接创建一个appwidget
      onactivityresult(my_create_appwidget , result_ok , data) ; //参数不同,简单回调而已      
    }   
    break ;
   case my_create_appwidget:
    completeaddappwidget(data) ;
    break ;
  }
   
 }
  
 //向当前视图添加一个用户选择的
 private void completeaddappwidget(intent data){
  bundle extra = data.getextras() ;
  int appwidgetid = extra.getint(appwidgetmanager.extra_appwidget_id , -1) ;
  //等同于上面的获取方式
  //int appwidgetid = data.getintextra(appwidgetmanager.extra_appwidget_id , appwidgetmanager.invalid_appwidget_id) ;
   
  log.i(tag, "completeaddappwidget : appwidgetid is ----> " + appwidgetid) ;
   
  if(appwidgetid == -1){
   toast.maketext(mainactivity.this, "添加窗口小部件有误", toast.length_short) ;
   return ;
  }
   
  appwidgetproviderinfo appwidgetproviderinfo = appwidgetmanager.getappwidgetinfo(appwidgetid) ;
   
  appwidgethostview hostview = mappwidgethost.createview(mainactivity.this, appwidgetid, appwidgetproviderinfo);
     
  //linearlayout.addview(hostview) ;
   
  int widget_minwidht = appwidgetproviderinfo.minwidth ;
  int widget_minheight = appwidgetproviderinfo.minheight ;
  //设置长宽 appwidgetproviderinfo 对象的 minwidth 和 minheight 属性
  linearlayout.layoutparams linearlayoutparams = new linearlayout.layoutparams(widget_minwidht, widget_minheight);
  //添加至linearlayout父视图中
  linearlayout.addview(hostview,linearlayoutparams) ;  
 }
}

        
最后 ,关于appwidget点击后触发的相应事件,是通过设置该appwidget的remoteviews的某个控件点击事件而触发的。