大家好,又见面了,我是全栈君。
下面是本篇的大纲:
- 1、AppWidget 框架类
- 2、AppWidget 框架的主要类介绍
- 3、DEMO 讲解
1、AppWidget 框架类
- 1、AppWidgetProvider :继承自 BroadcastRecevier , 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中,onUpdate、onReceive 是最常用到的方法,它们接收更新通知。
- 2、 AppWidgetProvderInfo:描述 AppWidget 的大小、更新频率和初始界面等信息,以XML 文件形式存在于应用的 res/xml/目录下。
- 3、AppWidgetManger :负责管理 AppWidget ,向 AppwidgetProvider 发送通知。
- 4、RemoteViews :一个可以在其他应用进程中运行的类,向 AppWidgetProvider 发送通知。
2、AppWidget 框架的主要类介绍
1) AppWidgetManger 类
- bindAppWidgetId(int appWidgetId, ComponentName provider)
通过给定的ComponentName 绑定appWidgetId - getAppWidgetIds(ComponentName provider)
通过给定的ComponentName 获取AppWidgetId - getAppWidgetInfo(int appWidgetId)
通过AppWidgetId 获取 AppWidget 信息 - getInstalledProviders()
返回一个List<AppWidgetProviderInfo>的信息 - getInstance(Context context)
获取 AppWidgetManger 实例使用的上下文对象 - updateAppWidget(int[] appWidgetIds, RemoteViews views)
通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件 - updateAppWidget(ComponentName provider, RemoteViews views)
通过 ComponentName 对传进来的 RemoeteView 进行修改,并重新刷新AppWidget 组件 - updateAppWidget(int appWidgetId, RemoteViews views)
通过appWidgetId 对传进来的 RemoteView 进行修改,并重新刷新AppWidget 组件
2) 继承自 AppWidgetProvider 可实现的方法为如下:
- 1、onDeleted(Context context, int[] appWidgetIds)
- 2、onDisabled(Context context)
- 3、onEnabled(Context context)
- 4、onReceive(Context context, Intent intent)
Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver 所以可以重写onRecevie 方法,当然必须在后台注册Receiver - 5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
- 一般来说都是重写onUpdate就够了
-
3、Demo讲解
下面是我今天做的一个实例,提供给大家练习时做参考,效果如下:在布局中放一个 TextView 做桌面组件,然后设置TextView 的 Clickable=”true” 使其有点击的功能,然后我们点击它时改变它的字体,再点击时变回来,详细操作如下流程:
- 1、新建AppWidgetProvderInfo
- 2、写一个类继承自AppWidgetProvider
- 3、后台注册Receiver
- 4、使 AppWidget 组件支持点击事件
- 5、如何使TextView 在两种文本间来回跳转
问题抛出来了,那么一起解决它吧。
1、新建AppWidgetProvderInfo
代码如下:
<?xml version="1.0" encoding="UTF-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="60dp" android:minHeight="30dp" android:updatePeriodMillis="86400000" android:initialLayout="@layout/main"> </appwidget-provider>
Tip:上文说过AppWidgetProvderInfo 是在res/xml 的文件形式存在的,看参数不难理解,就是定义widget的大小和更新频率等信息,比较重要的是这里android:initialLayout=”@layout/main” 此句为指定桌面组件的布局文件,即规划widget里面有哪些组件,如何排列等。
-
2、写一个类继承自AppWidgetProvider
代码如下:
package com.terry; public class widgetProvider extends AppWidgetProvider { private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click"; public static boolean isChange=true; private static RemoteViews rv; @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { // TODO Auto-generated method stub final int N = appWidgetIds.length; for (int i = 0; i < N; i++) { int appWidgetId = appWidgetIds[i]; updateAppWidget(context, appWidgetManager, appWidgetId); } } @Override public void onReceive(Context context, Intent intent) { // TODO Auto-generated method stub super.onReceive(context, intent); if (rv == null) { rv = new RemoteViews(context.getPackageName(), R.layout.main); } if (intent.getAction().equals(CLICK_NAME_ACTION)) { if (isChange) { rv.setTextViewText(R.id.TextView01, context.getResources() .getString(R.string.load)); } else { rv.setTextViewText(R.id.TextView01, context.getResources() .getString(R.string.change)); } Toast.makeText(context, Boolean.toString(isChange), Toast.LENGTH_LONG).show(); isChange = !isChange; } AppWidgetManager appWidgetManger = AppWidgetManager .getInstance(context); int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName( context, widgetProvider.class)); appWidgetManger.updateAppWidget(appIds, rv); } public static void updateAppWidget(Context context, AppWidgetManager appWidgeManger, int appWidgetId) { rv = new RemoteViews(context.getPackageName(), R.layout.main); Intent intentClick = new Intent(CLICK_NAME_ACTION); PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0); rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent); appWidgeManger.updateAppWidget(appWidgetId, rv); } }
重写两个方法:1.onUpdate 为组件在桌面上生成时调用,并更新组件UI,
-
2.onReceiver 为接收广播时调用更新UI,一般这两个方法是比较常用的。
-
3、后台注册Receiver
后台配置文件代码如下:
<receiver android:name=".widgetProvider"> <meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_provider"></meta-data> <intent-filter> <action android:name="com.terry.action.widget.click"></action> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> </receiver>
Tip:因为是桌面组件,所以暂时不考虑使用Activity 界面,当然你在实现做项目时可能会需要点击时跳转到Activity 应用程序上做操作,典型的案例为Android 提供的音乐播放器。
-
上面代码中比较重要的是这一句 <meta-data android:name=”android.appwidget.provider” android:resource=”@xml/appwidget_provider”></meta-data>
-
大意为指定桌面应用程序的AppWidgetProvderInfo 文件,使其可作其管理文件,管理widget的大小更新时间等信息.
4、使 AppWidget 组件支持点击事件
先看代码:
public static void updateAppWidget(Context context, AppWidgetManager appWidgeManger, int appWidgetId) { rv = new RemoteViews(context.getPackageName(), R.layout.main); Intent intentClick = new Intent(CLICK_NAME_ACTION); PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0); rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent); appWidgeManger.updateAppWidget(appWidgetId, rv); }
此方法为创建组件时 onUpdate 调用的更新UI的方法,代码中使用RemoteView 找到组件的布局文件,同时为其设置广播接收器CLICK_NAME_ACTION并且通过RemoteView 的setOnClickPendingIntent 方法找到我想触发事件的TextView 为其设置广播。接着
@Override public void onReceive(Context context, Intent intent) { // TODO Auto-generated method stub super.onReceive(context, intent); if (rv == null) { rv = new RemoteViews(context.getPackageName(), R.layout.main); } if (intent.getAction().equals(CLICK_NAME_ACTION)) { if (isChange) { rv.setTextViewText(R.id.TextView01, context.getResources() .getString(R.string.load)); } else { rv.setTextViewText(R.id.TextView01, context.getResources() .getString(R.string.change)); } Toast.makeText(context, Boolean.toString(isChange), Toast.LENGTH_LONG).show(); isChange = !isChange; } AppWidgetManager appWidgetManger = AppWidgetManager .getInstance(context); int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName( context, widgetProvider.class)); appWidgetManger.updateAppWidget(appIds, rv); }
在onReceiver 中通过判断识别传进来的广播来触发动作。
5、如何使TextView 在两种文本间来回跳转 -
如果你发现无法实现文本的跳转变化,尝试把public static boolean isChange=true;这个boolean放在新建一个类里面试试看.
-
还有main.xml的代码如下:
-
<?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:id="@+id/layout" android:layout_height="fill_parent"> <TextView android:text="@string/load" android:id="@+id/TextView01" android:clickable="true" android:layout_width="wrap_content" android:layout_height="wrap_content"></TextView> </LinearLayout>
发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/121419.html原文链接:https://javaforall.cn
【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛
【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...