Android之初学Appwidget

本文介绍了 Android App Widget 的基础知识,包括 AppWidgetProvider 和 AppWidgetProviderInfo 的定义方式,以及如何创建布局并处理 App Widget 的更新事件。
摘要由CSDN通过智能技术生成

本次开始学习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  下载


评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值