Android的桌面组件App Widget的使用方法 AppWidgetProvider RemoteViews
本文由发表于6年前 | Android | 评论数 2 |  被围观 17,010 views+


What is App Widget?

在手机桌面上放置的控件,即Android的桌面组件

AppWidgetProviderInfo
public class
AppWidgetProviderInfo
extends Object
implements Parcelable

Describes the meta data for an installed AppWidget provider. The fields in this class correspond to the fields in the <appwidget-provider> xml tag.


AppWidgetProvider

public class
AppWidgetProvider
extends BroadcastReceiver

A convenience class to aid in implementing an AppWidget provider. Everything you can do with AppWidgetProvider, you can do with a regularBroadcastReceiver. AppWidgetProvider merely parses the relevant fields out of the Intent that is received in onReceive(Context,Intent), and calls hook methods with the received extras.

创建一个简单的App Widget的基本步骤:


① 在res文件夹下创建一个xml文件夹,里面创建一个xml文件(这里创建了一个test_appwidget_info.xml文件)用于提供元数据:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="200dp"
    android:minHeight="80dp"
    android:updatePeriodMillis="10000"
    android:initialLayout="@layout/test_appwidget"
 >
</appwidget-provider>

其中的test_appwidget为App Widget的布局文件,在第二步创建。

② 创建App Widget的布局文件test_appwidget.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:layout_height="fill_parent"
    >
<TextView
	android:id="@+id/widgetId"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="This is an AppWidget"
    android:background="#000"
    />
</LinearLayout>


③ 创建一个类继承AppWidgetProvider并覆盖里面的几个常用的方法:

onDeleted(Context context, int[] appWidgetIds) 删除App Widget是调用此方法
onDisabled(Context context) 最后一个App Widget实例删除后调用此方法
onEnabled(Context context) App WIdget实例第一次被创建是调用此方法
onReceive(Context context, Intent intent) 接收广播事件
onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 到达指定更新时间或用户向桌面添加了App Widget时调用此方法
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;

public class TestAppWidgetProvider extends AppWidgetProvider{

	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {
		System.out.println("onUpdate");
		super.onUpdate(context, appWidgetManager, appWidgetIds);
	}
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		System.out.println("onDeleted");
		super.onDeleted(context, appWidgetIds);
	}
	@Override
	public void onDisabled(Context context) {
		System.out.println("onDisabled");
		super.onDisabled(context);
	}
	@Override
	public void onEnabled(Context context) {
		System.out.println("onEnabled");
		super.onEnabled(context);
	}
}


④ 在AndroidManifest.xml文件中声明一个receiver,注意intent和meta-data子标签的设置:

<receiver android:name=".TestAppWidgetProvider">
	<intent-filter>
		<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
	</intent-filter>
	<meta-data android:name="android.appwidget.provider"
		android:resource="@xml/test_appwidget_info" />
</receiver>

PendingIntent

public final class
PendingIntent
extends Object
implements Parcelable

A description of an Intent and target action to perform with it. Instances of this class are created with getActivity(Context, int, Intent, int),getBroadcast(Context, int, Intent, int), getService(Context, int, Intent, int); the returned object can be handed to other applications so that they can perform the action you described on your behalf at a later time.

RemoteViews

public class
RemoteViews
extends Object
implements Parcelable LayoutInflater.Filter

A class that describes a view hierarchy that can be displayed in another process. The hierarchy is inflated from a layout resource file, and this class provides some basic operations for modifying the content of the inflated hierarchy.

使用PendingIntent和RemoteViews对App Widget绑定监听器:

创建PendingIntent的基本方法:

getActivity(Context context, int requestCode, Intent intent, int flags)
getBroadcast(Context context, int requestCode, Intent intent, int flags)
getService(Context context, int requestCode, Intent intent, int flags)

在创建一个简单的App Widget的基本步骤基础之上进行一下操作:

① 在test_appwidget.xml文件中添加一个按钮

<Button
	android:id="@+id/widgetButtonId"
	android:layout_width="fill_parent"
	android:layout_height="wrap_content"
	android:text="click me?"
	/>


② 通过RemoteViews在TestAppWidgetProvider的onUpdate()方法中为Botton绑定监听器

@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
		int[] appWidgetIds) {
	for (int i = 0; i < appWidgetIds.length; i++) {
		//这里TargetActivity为Intent跳转到的Activity,这个Activity类需要另外编写,在第三步创建
		Intent intent = new Intent(context,TargetActivity.class);
		PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
		RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.test_appwidget);
		//PendingIntent为事件触发是所要执行的PendingIntent
		remoteViews.setOnClickPendingIntent(R.id.widgetButtonId, pendingIntent);
		appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
	}
	super.onUpdate(context, appWidgetManager, appWidgetIds);
}


③ 创建一个TargetActivity用作Botton的跳转到的Activity

接收来自AppWidget中的广播消息:

在创建一个简单的App Widget的基本步骤基础之上进行一下操作:

1、 在AndroidManifest.xml文件中为TestAppWidgetProvider注册新的intent

<receiver android:name=".TestAppWidgetProvider">
	<intent-filter>
		<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
	</intent-filter>
	<intent-filter>
		<action android:name="com.test.UPDATE_APP_WIDGET"/>
	</intent-filter>
	<meta-data android:name="android.appwidget.provider"
		android:resource="@xml/test_appwidget_info" />
</receiver>


2、 在TestAppWidgetProvider中定义一个常量:

private static final String UPDATE_ACTION = "com.test.UPDATE_APP_WIDGET";


3、 在TestAppWidgetProvider的onUpdate()方法中使用getBroadcast()方法创建一个PendingIntent;并为AppWidget当中的控件注册监听器

@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
		int[] appWidgetIds) {
	Intent intent = new Intent();
	intent.setAction(UPDATE_ACTION);
	PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
			intent, 0);
	RemoteViews remoteViews = new RemoteViews(context.getPackageName(),
			R.layout.test_appwidget);
	remoteViews.setOnClickPendingIntent(R.id.widgetButtonId, pendingIntent);
	appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
}


4、 在onReceive()方法中接收所需要的广播:

public void onReceive(Context context, Intent intent) {
	super.onReceive(context, intent);
	String action = intent.getAction();
	if (UPDATE_ACTION.equals(action)) {
		System.out.println(UPDATE_ACTION);
	}
}
如果需要改变App Widget中控件的状,可以在TestAppWidgetProvider的onReceive()方法中通过RemoteViews对象去改变:
@Override
public void onReceive(Context context, Intent intent) {
	String action = intent.getAction();
	if (UPDATE_ACTION.equals(action)) {
		RemoteViews remoteViews = new RemoteViews(context.getPackageName(),
				R.layout.test_appwidget);
		remoteViews.setTextViewText(R.id.widgetTextId, "change");
		AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
		//区分:RemoteViews代表App Widget中的所有空间,而ComponentName代表整个App Widget对象
		ComponentName componentName = new ComponentName(context,ExampleAppWidgetProvider.class);
		appWidgetManager.updateAppWidget(componentName, remoteViews);
	} else {
		super.onReceive(context, intent);
	}
}

(特别说明:本文部分内容是在观看marschen的Android视频教程时做的笔记,感谢marschen推出的视频教程,这里也推荐给大家:http://www.marschen.com/portal.php)

除了文章中有特别说明,均为IT宅原创文章,转载请以链接形式注明出处。
本文链接:http://www.itzhai.com/android-app-widget-desktop-components-to-use-appwidgetprovider-remoteviews.html
arthinking Java技术交流群:280755654,入门群:428693174 more
分享到:
 
2011 7/13
文章评论
    2条评论
  1. xiaodai 2013年08月14日11:07:57  #-49楼 回复 回复

    您好,我想请教一下,比如系统应用就像联系人和music,我不想它们在桌面小部件生成该怎么处理呢??

给我留言

有人回复时邮件通知我
Android的相关文章
随机文章 本月热门 热评
1 Apache CXF中jaxrs.serviceClasses多个Service的配置方法 2012/4/28
2 org.hibernate.id.IdentifierGenerationException错误解决方法 2011/10/2
3 MyEclipse中修改CSS样式不起作用的解决方法 2011/6/4
4 纯Javascript打造的红色玫瑰花 1k Rose 2012/2/13
5 chrome插件编写中需要了解的几个概念和一些方法 2013/6/5
6 Java Web笔记 – Servlet中的get和post方法HTTP协议实现的区别 2011/11/8
友情推荐 更多
破博客 文官洗碗安天下,武将打怪定乾坤。多么美好的年代,思之令人泪落。
Mr.5's Life 白天是一名程序员,晚上就是个有抱负的探索者
行知-追寻技术之美 关注大数据,分布式系统
我爱编程 编程成长轨迹
Cynthia's Blog 学习笔记 知识总结 思考感悟
 
欢迎关注我的公众号 IT宅
关于IT宅 文章归档

IT宅中的文章除了标题注明转载或有特别说明的文章,均为IT宅的技术知识总结,学习笔记或随笔。如果喜欢,请使用文章下面提供的分享组件。转载请注明出处并加入文章的原链接。 感谢大家的支持。

联系我们:admin@itzhai.com

Theme by arthinking. Copyright © 2011-2015 IT宅.com 保留所有权利.