Android AppWidgets的简单说明与应用

最新推荐文章于 2021-05-27 22:22:47 发布

李修远RoSLonG

最新推荐文章于 2021-05-27 22:22:47 发布

阅读量491

点赞数 1

本文链接：https://blog.youkuaiyun.com/ExpertU/article/details/51998842

版权

刚接触到时Widget，我想很多人内心是忍不住兴奋的。似乎与这它有着某种熟悉而又陌生的亲切感。最近研究了下appwidget，在这里与大家简单分享、交流下，也算是对自己所学的一段小总结。

首先，如何构建自己想要的widget？大概可以分为三步走：

1、创建一个AppWidgetProviderInfo对象：这个对象主要用来描述该小组件的源数据，例如： ①组件的布局信息（关联布局文件）、②组件更新频率（多久自动更新）、③以及组件关联的AppWidgetProvider类、④组件被拖拽到手机屏幕上时的尺寸...等等。这个对象是被定义为一个在res/xml目录下的一个xml文件。

2、创建widget的布局文件：res/layout目录下的xml文件。

3、创建一个AppWidgetProvider的继承类：该类中几个方法，是实现业务的主要途径，比如：

①在安装第一个同类小组件时，自动回调的方法(业务中，经常用来启动一个特定服务)

onEnabled(Context context)

②每个同类小组件在安装时都会自动回调的方法(同时此方法也是业务实现中手动调用较多的方法)

onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)

③删除一个小组件时自动回调的方法(用的不多)

onDeleted(Context context, int[] appWidgetIds)

④删除最后一个同类小组件时，自动回调该方法(关闭指定服务，经常会写在该方法中)

onDisabled(Context context)

⑤接收在应用的配置文件中注册过的action时，会回调该方法(此方法在业务中用的也会比较频繁)

onReceive(Context context, Intent intent)

其次，如下以时间小组件为例，简单说明具体用法：

1、创建一个AppWidgetProviderInfo对象timewidget_provider_info.xml，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="220dp"
    android:minHeight="55dp"
    android:updatePeriodMillis="0"
    android:initialLayout="@layout/timewidget_view" >
</appwidget-provider>

2、创建widget的布局文件timewidget_view.xml，代码如下：

<?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"
    android:background="@drawable/timewidget_shape"
    android:gravity="center" >
    <TextView 
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#FFFFFF"
        android:textSize="22sp"
        android:text="2015-02-24 12:35:52"/>
</LinearLayout>

3、创建AppWidgetProvider的继承类TimeWidgetProvider.class，代码如下：

 <span style="font-size:12px;color:#000000;">package com.dnd.lin;

import java.text.SimpleDateFormat;
import java.util.Date;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;

/**
 * @author DND
 * */
public class TimeWidgetProvider extends AppWidgetProvider{
	/**
	 * 该方法在安装第一个同类小组件时自动回调：
	 * 故此，把给小组件发送时间的service，在此方法中启动
	 * */
	@Override
	public void onEnabled(Context context) {
		super.onEnabled(context);
		Intent service = new Intent(context, TimeProviderService.class);
		context.startService(service);
		Log.i("TAG", "启动服务器");
	}
	/**
	 * 在每一个小组件安装时，都会回调该方法：
	 * 在该方法中写入更新小组件view的代码
	 * */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
    		int[] appWidgetIds) {
    	super.onUpdate(context, appWidgetManager, appWidgetIds);
    	SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
    	String currentTime = format.format(new Date());
    	RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.timewidget_view);
    	views.setTextViewText(R.id.tv_content, currentTime);
    	appWidgetManager.updateAppWidget(appWidgetIds[0], views);
    }
    
    
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
    	// TODO Auto-generated method stub
    	super.onDeleted(context, appWidgetIds);
    }
    /**
     * 在最后一个同类小组件从手机屏幕上删除时，自动回调该方法：
     * 把关闭发送时间的服务，写在该方法中
     * */
    @Override
    public void onDisabled(Context context) {
    	super.onDisabled(context);
    	Intent service = new Intent(context, TimeProviderService.class);
		context.stopService(service );
    }
    /**
     * 接收到每一个在应用配置文件中，该AppWidgetProvider注册过的action时，会回调该方法：
     * 发送指定action的Intent，来实现指定交互
     * */
    @Override
    public void onReceive(Context context, Intent intent) {
    	// TODO Auto-generated method stub
    	super.onReceive(context, intent);
    }
}</span>

4、创建一个定时给小组件发送时间的TimeProviderService.class，代码如下：

package com.dnd.lin;

import java.text.SimpleDateFormat;
import java.util.Date;

import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.content.ComponentName;
import android.content.Intent;
import android.os.IBinder;
import android.util.Log;
import android.widget.RemoteViews;

public class TimeProviderService extends Service{
	Thread timeProviderThread;
    @Override
    public void onCreate() {
    	super.onCreate();
    	timeProviderThread = new Thread(new Runnable() {
			
			@Override
			public void run() {
				Log.i("TAG", "启动线程");
				try {
					while(!timeProviderThread.isInterrupted()){
						AppWidgetManager manager = AppWidgetManager.getInstance(getApplicationContext());
						RemoteViews views = new RemoteViews(getApplication().getPackageName(), R.layout.timewidget_view);
						ComponentName comp = new ComponentName(getApplicationContext(), TimeWidgetProvider.class);
						SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
						String currentTime = format.format(new Date());
						views.setTextViewText(R.id.tv_content, currentTime);
						manager.updateAppWidget(comp , views);
						Log.i("TAG", "更新时间小组件");
					}
					timeProviderThread.sleep(990);
				} catch (InterruptedException e) {
					e.printStackTrace();
				}
			}
		});
    	timeProviderThread.start();
    }
    
	@Override
	public IBinder onBind(Intent intent) {
		return null;
	}
	
	@Override
	public void onDestroy() {
		Log.i("TAG", "服务器关闭");
		super.onDestroy();
		timeProviderThread.interrupt();
		Log.i("TAG", "结束循环进程");
		
	}
}

Note:

1、我们实现的AppWidgetProvider类是继承了Service类的，可以说它也是一个service,所以一定要在应用的配置文件中，静态注册该AppWidgetProvider:

<span style="color:#000000;"> <receiver android:name="com.dnd.lin.TimeWidgetProvider" >
           <intent-filter>
               <action   android:name="android.appwidget.action.APPWIDGET_UPDATE" />
           </intent-filter>
        <meta-data android:name="android.appwidget.provider"
                   android:resource="@xml/timewidget_provider_info" />
</receiver></span>

1.1我们也可以看到这里的意图过滤，每一个在此过滤过的action，接收到该action时，都会自动回调 onReceive（）方法；

1.2 meta-data标签关联的是小组件的源数据，name不用改，resource要改

2、我们自定义的service也别忘了在配置文件中，静态注册：

<service android:name="com.dnd.lin.TimeProviderService"/>

————————因为最近学习比较紧张，总结的不是特别到位，希望朋友们可以多交流，指正，谢谢！