Android Widget(窗口小部件)

时间 2019-11-11

原文原文链接

Android Widget简介

应用程序窗口小部件（Widget）是微型的应用程序视图，它能够被嵌入到其它应用程序中（好比桌面）并接收周期性的更新。你能够经过一个App Widget Provider来发布一个Widget。能够容纳其它App Widget的应用程序组件被称为App Widget宿主程序.

为了建立一个App Widget，你须要使用下面这些：

　　1.AppWidgetProviderInfo 对象(定义在XML文件里面)
描述一个App Widget元数据，好比App Widget的布局，更新频率，以及AppWidgetProvider 类。这个应该在XML里定义。
　　2.AppWidgetProvider 类的实现(主要是接收广播并进行相应操做)
定义基本方法以容许你经过编程来和App Widget通讯，这基于广播事件。经过它，当App Widget被更新、可用、禁用和删除的时候，都将接收到广播通知。
　　3.视图布局
在XML中定义App Widget初始布局。
另外，你能够实现App Widget配置Activity 。这是一个可选的Activity，当用户添加App Widget时加载它并容许用户修改App Widget的设置。(当用户添加到桌面时会自动调用该Activity)

Android Widget具体使用

1.首先，在应用程序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>

说明：html

　　<receiver>元素须要android:name属性，指定了App Widget使用的AppWidgetProvider 。

　　<intent-filter>元素必须包括一个含有android:name属性的<action>元素。该元素指定AppWidgetProvider接受ACTION_APPWIDGET_UPDATE 广播。这是惟　　　　一你必须显式声明的广播。当须要的时候，必要时AppWidgetManager会自动发送全部其它App Widget广播给AppWidgetProvider。
　　<meta-data> 元素指定了AppWidgetProviderInfo 资源并须要如下属性：

- android:name–指定元数据名称，使用android.appwidget.provider 来肯定AppWidgetProviderInfo描述的数据。
- android:resource–指定AppWidgetProviderInfo 资源路径。

2.添加AppWidgetProviderInfo元数据

AppWidgetProviderInfo定义一个App Widget的基本特性，好比最小布局尺寸，初始布局资源，刷新频率，以及建立时加载的一个配置Activity（可选的）。使用单独的一个<appwidget-provider>元素在XML资源里定义AppWidgetProviderInfo 对象并保存到项目的res/xml/目录下

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

　　下面是<appwidget-provider>属性的总结： java

　　a)minWidth 和minHeight 属性的值指定了App Widget布局须要的最小区域。android

　　缺省的App Widgets所在窗口的桌面位置基于有肯定高度和宽度的单元网格中。若是App Widget的最小长度或宽度和这些网格单元的尺寸不匹配，那么这个App Widget将上舍入（上舍入即取比该值大的最接近的整数——译者注）到最接近的单元尺寸。数据库

　　通常说来桌面布局方向能够变化（由此单元的尺寸也会变化），你应该假设最坏状况即单元尺寸高和宽是74像素。不过，你必须从最终的尺寸中减去2以把像素计算过程当中产生的任何的整数舍入偏差考虑在内。要找到像素密度无关的最小宽度和高度，使用这个公式：(number of cells * 74) - 2.依据这个公式，你应该使用72dp做为高度，294dp做为宽度。编程

　　b)updatePerdiodMillis 属性定义了App Widget框架调用onUpdate()方法来从AppWidgetProvider请求一次更新的频度。实际更新时间并不那么精确，并且咱们建议更新频率越低越好——最好每小时不超过一次以节省电源。你也许还会容许用户在配置中调整这个频率——一些人可能想每15分钟一次股票报价，或者一天只要四次。app

　　注意：当到个更新的时间时，若是设备处于休眠状态，则设备将会被唤醒来执行更新操做。若是更新频率每小时不超过一次，这可能对电池的寿命不会产生值得注意的问题。可是，若是更新的很频繁，或者当设备处于休眠状态时不更新，那么你最好使用一个alarm来代替执行更新操做，这样不会唤醒设备。这种方式能够经过使用AlarmManager类实现。设置alarm的类型为 ELAPSED_REALTIME或者RTC，这两种类型只有在设备处于唤醒状态时才会传递alarm，同时设置updatePeriodMillis 为0.框架

　　c)initialLayout属性指向定义App Widget布局的资源。ide

　　d)configure属性定义了当用户添加App Widget时启动的Activity，配置App Widget特性。这是可选的函数

3.建立App Widget布局oop

你必须在XML中为你的App Widget定义一个初始布局并保存到项目的res/layout/ 目录下。你可使用以下所列的View对象来设计你的App Widget，可是，你必须注意App Widget布局是基于RemoteViews, 而RemoteViews并不支持全部类型的布局或视图小部件。

　　一个RemoteViews对象（对应的，一个App Widget）能够支持下面这个布局类(可是不支持这些类的派生)：

- FrameLayout
- LinearLayout
- RelativeLayout

　　以及下面的控件类：

- AnalogClock
- Button
- Chronometer
- ImageButton
- ImageView
- ProgressBar
- TextView

4.使用AppWidgetProvider类

    AppWidgetProvider类扩展自BroadcastReceiver ，做为处理App Widget广播一个简便类，AppWidgetProvider只接收和这个App Widget相关的事件广播，好比这个App Widget被更新、删除、启用以及禁用。当这些广播事件发生时，AppWidgetProvider 将接收到下面的方法调用：
　　onUpdate(Context, AppWidgetManager, int[]) //最经常使用的由于它是在每一个App Widget添加进宿主时被调用的（除非你使用一个配置活动）
    这个方法调用来间隔性的更新App Widget，间隔时间用AppWidgetProviderInfo 里的updatePeriodMillis属性定义。这个方法也会在用户添加App Widget时被调用，所以它应该执行必要的设置，好比为控件定义事件处理器并启动一个临时的服务Service，若是须要的话。可是，若是你已经声明了一个配置Activity，这个方法在用户添加App Widget时将不会被调用，而只在后续更新时被调用。配置Activity有责任在配置完成时负责执行第一次更新。
　　onDeleted(Context, int[])
    当App Widget从宿主App Widget 中删除时被调用。
　　onEnabled(Context)
    当一个App Widget实例第一次建立时被调用。好比，若是用户添加两个你的App Widget实例，只在第一次被调用。若是你须要打开一个新的数据库或者执行其余对于全部的App Widget实例只须要发生一次的设置，那么这里是完成这个工做的好地方。
　　onDisabled(Context)
    当你的App Widget的最后一个实例被从宿主中删除时被调用。你应该在onEnabled(Context)中作一些清理工做，好比删除一个临时的数据库。
　　onReceive(Context, Intent)
    这个接收到每一个广播时都会被调用，并且在上面的回调函数以前。你一般不须要实现这个方法，由于缺省的AppWidgetProvider 实现过滤全部App Widget 广播并恰当的调用上述方法。

public class ExampleAppWidgetProvider extends AppWidgetProvider {  
  
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {  
        final int N = appWidgetIds.length;  
  
        // Perform this loop procedure for each App Widget that belongs to this provider  
        for (int i=0; i<N; i++) {  
            int appWidgetId = appWidgetIds[i];  
  
            // Create an Intent to launch ExampleActivity  
            Intent intent = new Intent(context, ExampleActivity.class);  
            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);  
  
            // Get the layout for the App Widget and attach an on-click listener to the button  
            RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);  
            views.setOnClickPendingIntent(R.id.button, pendingIntent);  
  
            // Tell the AppWidgetManager to perform an update on the current App Widget  
            appWidgetManager.updateAppWidget(appWidgetId, views);  
        }  
    }  
}

注意: 由于这个AppWidgetProvider 是一个广播接收器BroadcastReceiver，不能保证你的进程在回调函数返回后仍然继续运行。若是你的App Widget设置过程能持续几秒钟（好比当执行网页请求时）并且你要求你的进程继续，考虑在onUpdated()方法里启动一个服务Service。从这个服务里，你能够执行本身的App Widget更新，而没必要担忧AppWidget Provider 因为一个应用程序无响应错误Application Not Responding (ANR)而关闭。

　　 AppWidgetProvider 只是一个简便类。若是你想直接接收App Widget广播，你能够实现本身的BroadcastReceiver 或者重写 onReceive(Context, Intent) 回调函数。你须要注意以下4个Intents

ACTION_APPWIDGET_UPDATE
ACTION_APPWIDGET_DELETED
ACTION_APPWIDGET_ENABLED
ACTION_APPWIDGET_DISABLED

5.建立一个App Widget 配置Activity()

　　若是你想让用户在添加一个新的App Widget时调整设置，你能够建立一个App Widget配置Activity 。这个Activity 将被App Widget宿主自动启动并容许用户在建立时配置可用的设置，好比App Widget颜色，尺寸，更新周期或者其它功能设置。

　　这个配置Activity应该在Android清单文件中声明为一个通用Activity。不过，它将被经过ACTION_APPWIDGET_CONFIGUREaction而被App Widget宿主启动，所以这个Activity须要接受这个Intent 。好比：

<activity android:name=".ExampleAppWidgetConfigure">  
　　<intent-filter>  
　　　　<action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" /> 
　　</intent-filter>  
</activity>

　　固然，Activity必须在AppWidgetProviderInfo XML 文件中声明，经过android:configure属性。好比，配置Activity能够声明以下：

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"  
    ...  
    android:configure="com.example.android.ExampleAppWidgetConfigure"   
    ... >  
</appwidget-provider>

　　注意这个Activity是用全包名声明的，由于它将从你的程序包外被引用。

　　这就是全部关于配置活动你一开始须要了解的。如今你须要一个真实的Activity。这儿就有，不过，当你实现这个Activity时记住两件重要的事情：

- App Widget 宿主调用配置Activity并且配置Activity应该老是返回一个结果.这个结果应该包含这个经过启动该活动的意图传递App Widget ID(以EXTRA_APPWIDGET_ID保存在Intent的附加段Intent extras中)
- 当这个 App Widget 被建立时将不会调用onUpdate() 方法(当一个配置活动启动时,系统将不会发送ACTION_APPWIDGET_UPDATE广播).配置活动应该在 App Widget 第一次被建立时负责从AppWidgetManager请求一个更新.不过, onUpdate() 将在后续更新中被调用-只忽略第一次.

从配置Activity中更新一个App Widget

　　当一个App Widget使用一个配置Activity,那么当配置结束时,就应该由这个Activity来更新这个App Widget.你能够直接经过AppWidgetManager请求一次更新操做.下面是恰当的更新App Widget 以及关闭配置Activity这个过程的一个概要描述:

　　1.首先，从启动这个Activity的Intent中获取App Widget ID：　　

Intent intent = getIntent();  
Bundle extras = intent.getExtras();  
if (extras != null) {  
    mAppWidgetId = extras.getInt(  
            AppWidgetManager.EXTRA_APPWIDGET_ID,   
            AppWidgetManager.INVALID_APPWIDGET_ID);  
}

　　2.实施你的App Widget 配置。

　 3.当配置完成后，经过调用getInstance(Context)获取一个AppWidgetManager实例:　　　

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);

　　4.以一个RemoteViews布局调用updateAppWidget(int, RemoteViews)更新App Widget:

RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);  
appWidgetManager.updateAppWidget(mAppWidgetId, views);

　　5.最后，建立返回Intent ，设置到Activity结果，并结束这个Activity:

Intent resultValue = new Intent();  
resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, mAppWidgetId);  
setResult(RESULT_OK, resultValue);  
finish();

　　提示: 当你的配置Activity 第一次打开时，设置Activity 结果为RESULT_CANCELED。这样，若是用户在结束以前从Activity 外返回，这个App Widget宿主会接收到配置取消通知而不会添加这个App Widget。

实例代码位于APIDemos中。