Android中AppWidget的学习整理(附demo)
2016-02-16 21:03
369 查看
今天写的是AppWidget,这是我工作之后接触的第一个模块。乘着有时间整理下知识点。
先附上DEMO:http://download.csdn.net/detail/violetjack0808/9433218
这里实现的是一个用来计数的AppWidget桌面小部件。效果图如下:
![](http://img.blog.csdn.net/20160216164310237?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
下面是实现步骤
1.创建AppWidget配置文件
在res/xml目录下创建app_widget_config.xml文件,用来配置widget属性。
这个xml是用来描述所要创建的appWidget的一些描述信息的,所描述的属性分别有最小高度、最小宽度、刷新间隔和关联布局文件布局文件。
特别要说的是AppWidget的大小是以格为单位来计算的,手机屏幕被分为一个4*4的格阵,当宽高到达一定值时就会显示并占满相应的格数,不会出现自定义不规则的大小的。网上资料显示说N格的长宽为(74*N)-2。我设定的140*140显示的是2*2的界面。
2.创建布局文件
在res/layout中创建widget_ui.xml这个布局文件。这里画的布局就会是我们在手机桌面上看到的widget的样子啦~
3.创建AppWidgetProvider
在src目录下创建AppWidget类继承自AppWidgetProvider,用以实现widget的交互。
当我看到onReceive方法觉得奇怪,这不是广播接收器吗?结果进去一看发现AppWidgetProvider就是继承自BroadcastReceiver的
所以,widget的工作原理就是通过广播来实现对它的控制的。
3.1 AppWidgetProvider的生命周期:
onEnabled
当AppWidget实例第一次被创建时调用。
onReceive
接收广播事件。
onUpdate
到达指定的更新时间或用户向桌面添加widget时候调用。
onDeleted
当AppWidget被删除时调用。
onDisabled
当最后一个AppWidget被删除时调用。
3.2.RemoteViews和PendingIntent
在onUpDate方法中用到了RemoteViews与PendingIntent, 是因为AppWidget和其原本的App并不在同一个进程中,而是运行在HomeScreen进程当中,因此,在控件监听器的绑定,更新等操作都会与以前基本的方法有所不同。
PendingIntent是一个特殊的Intent,实际上它像一个邮包,其中包裹着真正的Intent,当邮包未打开时,Intent是被“挂起”的,所以并不执行,只有当邮包拆开时才会执行。它与Intent的区别在于:Intent 是及时启动,intent 随所在的activity 消失而消失。 进程A创建PendingIntent,发送给进程B,进程B此事并不执行,直到用户出发某一事件时,包裹被拆开,里面的Intent真正执行。所以Intent什么时候被执行是不知道的,由用户出发事件来决定。
RemoteViews表示了一系列view对象,即AppWidget所有的控件。它的应用方法如下源码所示,使用了views.setOnClickPendingIntent(所需控件的ID,定义的pendingintent)方法来为控件绑定监听器。
3.3 源码
4.注册广播
上面提到了,AppWidgetProvider其实就是广播,所以我们需要在Manifest文件中注册广播。
这里注意Action的一致。关于广播的知识可以看我的Blog:Android广播Broadcast的学习(附demo)
代码:
注意:resource要关联我们之前写的app_widget_provider.xml文件;action中第一个必须写,第二个就是自定义action了。
这样一个计数的桌面小部件就完成啦~
先附上DEMO:http://download.csdn.net/detail/violetjack0808/9433218
这里实现的是一个用来计数的AppWidget桌面小部件。效果图如下:
下面是实现步骤
1.创建AppWidget配置文件
在res/xml目录下创建app_widget_config.xml文件,用来配置widget属性。
<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:initialLayout="@layout/widget_ui" android:minHeight="140dip" android:minWidth="140dip" android:updatePeriodMillis="6890000" > </appwidget-provider>
这个xml是用来描述所要创建的appWidget的一些描述信息的,所描述的属性分别有最小高度、最小宽度、刷新间隔和关联布局文件布局文件。
特别要说的是AppWidget的大小是以格为单位来计算的,手机屏幕被分为一个4*4的格阵,当宽高到达一定值时就会显示并占满相应的格数,不会出现自定义不规则的大小的。网上资料显示说N格的长宽为(74*N)-2。我设定的140*140显示的是2*2的界面。
2.创建布局文件
在res/layout中创建widget_ui.xml这个布局文件。这里画的布局就会是我们在手机桌面上看到的widget的样子啦~
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <TextView android:id="@+id/tvTitle" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="this is a widget" /> <TextView android:id="@+id/tvResult" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="result = 0"/> <Button android:id="@+id/btnAdd" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="add one"/> </LinearLayout>
3.创建AppWidgetProvider
在src目录下创建AppWidget类继承自AppWidgetProvider,用以实现widget的交互。
当我看到onReceive方法觉得奇怪,这不是广播接收器吗?结果进去一看发现AppWidgetProvider就是继承自BroadcastReceiver的
public class AppWidgetProvider extends BroadcastReceiver
所以,widget的工作原理就是通过广播来实现对它的控制的。
3.1 AppWidgetProvider的生命周期:
onEnabled
当AppWidget实例第一次被创建时调用。
onReceive
接收广播事件。
onUpdate
到达指定的更新时间或用户向桌面添加widget时候调用。
onDeleted
当AppWidget被删除时调用。
onDisabled
当最后一个AppWidget被删除时调用。
3.2.RemoteViews和PendingIntent
在onUpDate方法中用到了RemoteViews与PendingIntent, 是因为AppWidget和其原本的App并不在同一个进程中,而是运行在HomeScreen进程当中,因此,在控件监听器的绑定,更新等操作都会与以前基本的方法有所不同。
PendingIntent是一个特殊的Intent,实际上它像一个邮包,其中包裹着真正的Intent,当邮包未打开时,Intent是被“挂起”的,所以并不执行,只有当邮包拆开时才会执行。它与Intent的区别在于:Intent 是及时启动,intent 随所在的activity 消失而消失。 进程A创建PendingIntent,发送给进程B,进程B此事并不执行,直到用户出发某一事件时,包裹被拆开,里面的Intent真正执行。所以Intent什么时候被执行是不知道的,由用户出发事件来决定。
RemoteViews表示了一系列view对象,即AppWidget所有的控件。它的应用方法如下源码所示,使用了views.setOnClickPendingIntent(所需控件的ID,定义的pendingintent)方法来为控件绑定监听器。
3.3 源码
/** * AppWidget学习demo * 个人心得: * onUpDate方法用于创建和更新AppWidget,将所需的ID通过intent进行传递。 * onReceive方法通过接收intent传送的广播事件实现AppWidget的变化操作。 */ public class AppWidget extends AppWidgetProvider { private static int i = 1; private static final String ACTION = "click"; //当AppWidget实例第一次被创建时调用。 @Override public void onEnabled(Context context) { super.onEnabled(context); } //接收广播事件。 @Override public void onReceive(Context context, Intent intent) { Log.e("widget", "onReceive + " + intent.getAction()); super.onReceive(context, intent); ComponentName thisWidget = new ComponentName(context,AppWidget.class);//定义容器 RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_ui);//定义RemoteViews //定义AppWidgetManager,用于之后更新AppWidget AppWidgetManager appWidgetManager = AppWidgetManager .getInstance(context); //通过接收广播的Intent来进行widget的UI操作 if (intent.getAction().equals(ACTION)) { views.setTextViewText(R.id.tvResult, "result = " + i); i++; } //更新AppWidget appWidgetManager.updateAppWidget(thisWidget, views); } //到达指定的更新时间或用户向桌面添加widget时候调用。 public void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) { Log.e("widget", "onUpdate"); for (int id : appWidgetIds) { RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_ui); Intent intent1 = new Intent("click");//定义intent PendingIntent pendingIntentOne = PendingIntent.getBroadcast(context, 0, intent1, 0);//用PendingIntent将Intent包裹起来 views.setOnClickPendingIntent(R.id.btnAdd, pendingIntentOne);//按钮点击事件监听 //更新AppWidget appWidgetManager.updateAppWidget(id, views); } } //当AppWidget被删除时调用。 @Override public void onDeleted(Context context, int[] appWidgetIds) { super.onDeleted(context, appWidgetIds); } //当最后一个AppWidget被删除时调用。 @Override public void onDisabled(Context context) { super.onDisabled(context); } }
4.注册广播
上面提到了,AppWidgetProvider其实就是广播,所以我们需要在Manifest文件中注册广播。
这里注意Action的一致。关于广播的知识可以看我的Blog:Android广播Broadcast的学习(附demo)
代码:
<application .... > ..... <receiver android:name=".AppWidget" > <meta-data android:name="android.appwidget.provider" android:resource="@xml/app_widget_config" /> <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> <action android:name="click" /> </intent-filter> </receiver> .... </application>
注意:resource要关联我们之前写的app_widget_provider.xml文件;action中第一个必须写,第二个就是自定义action了。
这样一个计数的桌面小部件就完成啦~
相关文章推荐
- 8大Android调试工具
- Android检查更新(是否强制更新)
- [Unity2d系列教程] 003.Unity如何调用android的方法
- Android开发学习之路--Camera之初体验
- Android开发学习之路--Camera之初体验
- AndroidManifest.xml权限设置
- iOS之旅--scrollView实现无限轮播
- iOS之旅--开始小demo+整合
- 作为新手,怎么学Cocos2d-x移动游戏开发
- android:src和android:background有什么区别
- 转Android高效加载大图、多图解决方案,有效避免程序OOM
- Android四大组件简介:Android 基础知识,开发教程
- 上传AppStore会碰到:Failed to locate or generate matching signing assets(Missing iOS Distribution signing)
- Android WebView远程代码执行漏洞简析
- Windows作业(Job)
- iOS 中KVC、KVO、NSNotification、delegate 总结及区别
- C#的null与Unity3d
- Android 仿微信图片选择器
- Android 6.0 动态权限 java反射
- Android特效专辑(十)——点击水波纹效果实现,逻辑清晰实现简单