android 桌面组件 App widget的使用

1、AppWidgetProvider ：AppWidgetProvider只接收和这个App Widget相关的事件广播，比如这个App Widget被更新，删除，启用，以及禁用。当这些广播事件发生时，AppWidgetProvider 将接收到下面的方法调用：

    onUpdate(Context, AppWidgetManager, int[]);
     这个方法调用来间隔性的更新App Widget，间隔时间用AppWidgetProviderInfo 里的updatePeriodMillis属性定义（参见添加AppWidgetProviderInfo元数据）。这个方法也会在用户添加App Widget时被调用，因此它应该执行基础的设置，比如为视图定义事件处理器并启动一个临时的服务Service，如果需要的话。但是，如果你已经声明了一个配置活动，这个方法在用户添加App Widget时将不会被调用，而只在后续更新时被调用。配置活动应该在配置完成时负责执行第一次更新。（参见下面的创建一个App Widget配置活动Creating an App Widget Configuration Activity。）

    onDeleted(Context, int[])

    当App Widget从宿主中删除时被调用。

    onEnabled(Context)

    当一个App Widget实例第一次创建时被调用。比如，如果用户添加两个你的App Widget开发实例，只在第一次被调用。如果你需要打开一个新的数据库或者执行其他对于所有的App Widget实例只需要发生一次的设置，那么这里是完成这个工作的好地方。

    onDisabled(Context)

     当你的App Widget的最后一个实例被从宿主中删除时被调用。你应该在onEnabled(Context)中做一些清理工作，比如删除一个临时的数据库。

    onReceive(Context, Intent)

    这个接收到每个广播时都会被调用，而且在上面的回调函数之前。你通常不需要实现这个方法，因为缺省的AppWidgetProvider 实现过滤所有App Widget 广播并恰当的调用上述方法。

2、widget基本功能实现

新建一个Activity继承AppWidgetProvider类，实现代码：

package com.example.appwidget;


import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.widget.RemoteViews;

public class MainActivity extends AppWidgetProvider {

	   //没接收一次广播消息就调用一次，使用频繁  
    public void onReceive(Context context, Intent intent) {  
        // TODO Auto-generated method stub  
        System.out.println("recrive");  
        super.onReceive(context, intent);  
    }  
    //每次更新都调用一次该方法，使用频繁  
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,  
            int[] appWidgetIds) {  
        // TODO Auto-generated method stub  
        System.out.println("update--->");  
        
        for (int i = 0; i < appWidgetIds.length; i++) {
    		//这里TargetActivity为Intent跳转到的Activity，这个Activity类需要另外编写
    		Intent intent = new Intent(context,TestActivity.class);
    		PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
    		RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.a_main);
    		//PendingIntent为事件触发是所要执行的PendingIntent
    		remoteViews.setOnClickPendingIntent(R.id.clock, pendingIntent);
    		appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
    	}
        
        super.onUpdate(context, appWidgetManager, appWidgetIds);  
    }  
    //没删除一个就调用一次  
    public void onDeleted(Context context, int[] appWidgetIds) {  
        // TODO Auto-generated method stub  
        System.out.println("Deleted");  
        super.onDeleted(context, appWidgetIds);  
    }  
    //当该Widget第一次添加到桌面是调用该方法，可添加多次但只第一次调用  
    public void onEnabled(Context context) {  
        // TODO Auto-generated method stub  
        System.out.println("OnEnable");  
        super.onEnabled(context);  
    }  
    //当最后一个该Widget删除是调用该方法，注意是最后一个  
    public void onDisabled(Context context) {  
        // TODO Auto-generated method stub  
        System.out.println("onDisable");  
        super.onDisabled(context);  
    }      
}

3、布局代码：a_main.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" >
    <!--  
    <Button 
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
    <TextView 
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="sdfasfasfasd"/>  -->
    <AnalogClock 
        android:id="@+id/clock"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>

</LinearLayout>

4、在res目录下新建一个xml文件，然后新建一个widget_info.xml文件

android:updatePeriodMillis="86400000"设置刷新时间（毫秒），minWidth和minHeight为设置widget的最小宽高

android:initialLayout="@layout/a_main"引用的布局文件

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

5、需要修改AndroidManifest.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.appwidget"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="18" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        
        <receiver android:name=".MainActivity"
            android:label="@string/app_name">  
            <intent-filter>     <!--这个是接收广播时的过滤器 Android定义的  -->     
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>  
            </intent-filter>  <!--android:name="android.appwidget.provider"  //Android系统定义的格式，不能更改，不能打错 -->
            <meta-data 
                android:name="android.appwidget.provider" 
                android:resource="@xml/widget_info">              
            </meta-data> <!-- 引用的在res/xml下创建的文件 -->
            
        </receiver>  
        <activity android:name=".TestActivity"></activity>
    </application>

</manifest>

5、添加了一个点击widget按钮跳转到另外一个Activity添加了一个TestActivty.java

package com.example.appwidget;
import android.app.Activity;
import android.os.Bundle;

public class TestActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		// TODO Auto-generated method stub
		super.onCreate(savedInstanceState);
		setContentView(R.layout.testactivity);
	}
	
}

布局代码就添加一个按钮 testactivity.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" >
    <Button 
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="这是测试acticity！"/>

</LinearLayout>

代码下载地址：http://download.csdn.net/detail/u011324501/9533906