Android之初学Appwidget

本次开始学习App Widgets

App Widgets 是一个小型应用程序的View  他可以嵌入到其他应用程序中(如 桌面程序) 并且可以得到周期性刷新。

在创建App Widget之前需要了解以下几个概念

AppWidgetProviderInfo对象

      它是对App Widget 元数据的一个描述，譬如 AppWidget的布局，刷新频率，以及   AppWidgetProvider 类  这些元数据都是定义在XML中。

AppWidgetProvider 类的实现

       对于App Widget定义了(回调接口)一些基本的方法，这些方法都是基于广播事件    (broadcast events ),，通过它，当App Widget更新，创建，无       效，卸载时，你可以接收广播。

View layout

       为App Widget定义初始布局，用XML来布局

       另外，你可以为App Widget 实现一个配置的Activity，这是一个可选择的Activity，在用户添加你的App Widget 准备创建时允许他修改或者配           置App Widget 。

下面我们就开始创建一个App Widget

① 在Manifest声明App Widget

     首先，在AndroidManifest.xml中声明  AppWidgetProvider  

 

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

<receiver>元素需要android:name 属性，AppWidgetProvider作为引用

<intent-filter>  元素务必要包含 <action>元素 然后Action中要有android:name 属性，这个属性需要指定能接

  收 ACTION_APPWIDGET_UPDATE 广播的AppWidgetProvider，也就是ExampleAppWidgetProvider 这个广播必须唯一 必须明确

  声明，因为AppWidgetManager会自动的发送所有其他应用程序的广播给AppWidgetProvider，所以很重要。

<meta-data> 元素指定AppWidgetProviderInfo资源需要以下属性

  Android:name -指定了元数据的名字，用android.appwidget.provider代表数据是AppWidgetProviderInfo描述。

  Android:resource -引用AppWidgetProviderInfo 资源的位置

  总之一句话：在AndroidManifest.xml主要声明概念中AppWidgetProvider 和AppWidgetProviderInfo

②添加AppWidgetProviderInfo元数据

  AppWidgetProviderInfo为AppWidgeet定义了一些最基本的数据，譬如布局的最小尺寸，初始化布局资源，怎样更新App Widget，

  以及在创建app Widget时的可配置Activity(可选) 

  要定义一个AppWidgetProviderInfo对象可以用XML资源文件定义，保存在res/xml/自己的文件名 ，XML文件中用一个单一的元

  素<appwidget-provider> 请看下面的例子：

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="294dp"
    android:minHeight="72dp"
    android:updatePeriodMillis="86400000"
    android:previewImage="@drawable/preview"
    android:initialLayout="@layout/example_appwidget"
    android:configure="com.example.android.ExampleAppWidgetConfigure" 
    android:resizeMode="horizontal|vertical">
</appwidget-provider>

  initialLayout：指定App Widget布局资源文件

  Configure：在创建App Widget时为他配置属性的activity

  updatePeriodMillis: appwidget更新频率

③ 创建App Widget 布局

  你必须为你的App Widget定义个初始化布局文件，可以将布局文件放在 res/layout/directory。 你可以设计你的App Widget用下面列出来

  的View对象，但是在你设计开始之前，请你熟读

App Widget Design Guidelines. 

  如果你熟悉XML Layouts ,那么创建一个App Widget将会是简单的， 然而，你必须意识到App Widget布局是基于 RemoteViews ，它

  并不是支持每一种layout和View widget。

  一个RemoteView对象只能支持下面几种layout布局类：

 FrameLayout  LinearLayout   RelativeLayout

  支持下面几种widget 类：

 AnalogClock   Button  Chronometer  ImageButton  ImageView  ProgressBar  TextView  ViewFlipper  ListView  GridView

 StackView  AdapterViewFlipper

 PS：这些类的继承类也是不被支持的。

 

下面是我本次写的demo中的Appwidget

     功能很简单只为初步理解AppWidget ，响应Appwidget上按钮事件

package com.manymorere.appwidget;

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

public class ExampleAppWidgetProvider extends AppWidgetProvider{

	private static final String ACTION = "com.manymore.appwidget"; 
	private int id;
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		
 		System.out.println("onDeleted");

 		super.onDeleted(context, appWidgetIds);
	}

	
	@Override
	public void onDisabled(Context context) {
		// TODO Auto-generated method stub
		System.out.println("onDisabled");

		super.onDisabled(context);
	}

	
	@Override
	public void onEnabled(Context context) {
		// TODO Auto-generated method stub
		System.out.println("onEnabled");

		super.onEnabled(context);
	}

	
	@Override
	public void onReceive(Context context, Intent intent) {
 		System.out.println("onReceive");

 		// 自己定义的ACTION
 		if(intent.getAction().equals(ACTION))
 		{
 			RemoteViews remoteView = new RemoteViews(context.getPackageName(),R.layout.appwidget_layout);
 			remoteView.setCharSequence(R.id.button, "setText", "22222222222222");
 			AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
 			ComponentName componentName = new ComponentName(context, ExampleAppWidgetProvider.class);
 			
 			appWidgetManager.updateAppWidget(componentName	, remoteView);
 			
 			
 			System.out.println("收到自定义ACTION");
 			
 		}else{
 			super.onReceive(context, intent);
 		}
		
		
	}

    
	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {
		
		int N = appWidgetIds.length;
		
		for(int i = 0; i<N; i++)
		{
			int appWidgetId = appWidgetIds[i];
			
			Intent intent = new Intent(ACTION);
		
			PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
			
			RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidget_layout);
		
			remoteViews.setOnClickPendingIntent(R.id.button, pendingIntent);
		
			appWidgetManager.updateAppWidget(appWidgetId, remoteViews);
			
			System.out.println(appWidgetId);
 
		}

		super.onUpdate(context, appWidgetManager, appWidgetIds);
	}
	
	

}

         每次添加Appwidget实例 都会调用onUpdate()方法 然后会注册里面的Button Onclick事件，当你点击该按钮时会发送一个broadcast，

    这个broadcast是自己定义的，然后onReceive方法会收到该broadcast，然后再做出一些反应，我这里是把修改了TextView上的text。

         由于Appwidget和本身的应用，虽然是在一个程序中，但运行时，它们并不是在一个进程中，所以在在调用方法和修改界面上多少会 

    有点限制，没有普通的(Activity上对View的一些操作)那么自由，所以想对Appwidget上的View做一些操作，或者更新Appwidget，一

    般需要用到RemoteViews，AppWidgetManager 同时可能还会用到ComponentName

    个人理解：RemoteViews在创建时主要代表一个Appwidget实例中View的一个集合 ，而ComponentName则代表一个整个Appwidget实例                           Src\appwidgetTest  下载