AppWidget-桌面小组件(二)

/ 0评 / 0

AppWidget-桌面小组件(一)中介绍了下AppWidget的基本方法,下面我们来介绍如何使用AppWidget来做一个简单的桌面时钟效果。老规矩,先上demo效果图。这里只是简单的使用了一个TextView用于显示时间。

2345截图20160219172107

AppWidget使用步骤

1、准备好AppWidget的布局,这里我们使用的是一个TextView而已。

<?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/time"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Widget显示时间"
        android:textColor="#ffffff"
        android:textSize="25sp" />
</LinearLayout>

2、继承AppWidgetProvider,并根据要求覆写需要使用的回调函数,这里为了演示,我全部覆写了。

public class MyAppWidget extends AppWidgetProvider {
	@Override
	public void onReceive(Context context, Intent intent) {
		super.onReceive(context, intent);
		//Log.v("MyAppWidget", "onReceive" + "接收广播,处理处理以后自动回调下面的函数");
	}
	@Override
	public void onEnabled(Context context) {
		super.onEnabled(context);
		Log.v("MyAppWidget", "onEnabled" + "第一个AppWidget被添加到桌面的时候调用");
	}
	@Override
	public void onDisabled(Context context) {
		super.onDisabled(context);
		Log.v("MyAppWidget", "onDisabled" + "所有AppWidget被删除的时候调用");
	}
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		super.onDeleted(context, appWidgetIds);
		Log.v("MyAppWidget", "onDeleted" + "AppWidget被删除的时候调用");
	}
	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) {
		super.onUpdate(context, appWidgetManager, appWidgetIds);
		Log.v("MyAppWidget", "onUpdate" + "更新的时候调用");
	}
}

关于各个回调函数的调用时机,在上一讲中已经说的很清楚了,这里注释中也注明了,自己测试下就知道了。

3、定义AppWidget的属性

定义AppWidget的属性,我们需要在res下新建名为xml的文件夹,在里面使用 appwidget-provider 标签定义AppWidget的属性。

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/widget_layout"
    android:minHeight="30dp"
    android:minWidth="200dp" >
</appwidget-provider>

更多属性设置请参看上一篇博客

4、注册AppWidget

上一篇博客中已经讲得很清楚了,AppWidget是基于广播机制的,广播是需要注册的,所以在AndroidManifest.xml文件中注册AppWidget。

<!-- 你的AppWidget包名+类名 -->
<receiver android:name="com.jay.myappwidget.MyAppWidget" >
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>

    <!-- 你的AppWidget的配置文件名 -->
    <meta-data
        android:name="android.appwidget.provider"
        android:resource="@xml/widget_provider" />
</receiver>

经过上面四步,我们就可以将AppWidget添加到桌面上了。下面的截图在小工具菜单中。

QQ截图20160219182224

动态更新AppWidget

也许你已经完成了上面四步,可是添加到桌面后你会发现,根本就没有显示时间啊,显示的在布局文件中默认的text,别急,下面就来完成动态更新AppWidget产生时钟效果。

我们知道,广播运行在主线程(UI线程)中,不能进行耗时操作,而且广播的生命很短(更多关于广播的注意事项请点这里),所以不能在广播执行定时刷新操作,而桌面小组件在运行的时候,Activity也许没有运行,所以这里我们得使用后台服务Service,在Service中去定时刷新时间。关于Service的用法就不在赘述,需要的请查看Android四大组件之Service。下面直接贴出Service代码。

public class MyService extends Service {
	private Timer timer;
	private SimpleDateFormat mFormat;

	@Override
	public IBinder onBind(Intent intent) {
		return null;
	}

	/**
	 * 在服务被创建的时候创建一个定时器 使用定时器来更新AppWidget
	 */
	@Override
	public void onCreate() {
		super.onCreate();

		if (timer == null)
			timer = new Timer();
		timer.schedule(new TimerTask() {

			@Override
			public void run() {
				updateWidget();
			}
		}, 0, 1000);

		mFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
	}

	/**
	 * 销毁定时器
	 */
	@Override
	public void onDestroy() {
		super.onDestroy();
		if (timer != null)
			timer.cancel();
		timer = null;
	}

	/**
	 * 更新视图
	 */
	private void updateWidget() {
		RemoteViews views = new RemoteViews(getPackageName(),R.layout.widget_layout);
		views.setTextViewText(R.id.time, mFormat.format(new Date()));
		AppWidgetManager manager = AppWidgetManager.getInstance(getApplicationContext());
		ComponentName componentName = new ComponentName(getApplicationContext(), MyAppWidget.class);
		manager.updateAppWidget(componentName, views);

	}
}

更新视图需要一个AppWidgetManager和一个RemoteViews,上面的代码中的 updateWidget()函数就是主要的更新操作。

好了,定义好Service了什么时候使用呢?在上面的介绍中可以知道,在第一个AppWidget被添加的时候会调用onEnable,在最后一个AppWidget被删除的时候,会调用onDisable,所以我们在这两个函数中分别启动后台线程和停止后台线程。

开启后台线程

@Override
public void onEnabled(Context context) {
	super.onEnabled(context);
	context.startService(new Intent(context,MyService.class));
	Log.v("MyAppWidget", "onEnabled" + "第一个AppWidget被添加到桌面的时候调用");
}

关闭后台线程

@Override
public void onDisabled(Context context) {
	super.onDisabled(context);
	context.stopService(new Intent(context,MyService.class));
	Log.v("MyAppWidget", "onDisabled" + "所有AppWidget被删除的时候调用");
}

到此为止AppWidget的介绍就结束了,下面也许会介绍使用AppWidget制作一个天气预报的小应用,敬请关注。

Demo下载 : 360网盘  访问密码 ec81

发表评论

您的电子邮箱地址不会被公开。