Android App widget设计

来源：互联网发布：淘宝几天可以延迟收货编辑：程序博客网时间：2024/05/18 03:17

App Widget也是一种UI组件，它可以让一小块程序（program piece）嵌入到桌面上。与普通的Widget（TextView、WebView等）相比，有以下几个不同：

App Widget是有生命的UI组件，它会自动更新自身内容；
Widget不能自动更新自身内容，只能被动的等待用户的调用；

应用上，由于App Widget自动更新的特性，所以它比较适合用来设计一些天气，新闻，日历等功能。

App Widget的设计流程：

规划App Widget的大小及更新时间，在/res/xml目录新增一份XML文件；
规划App Widget的UI，修改res/layout/main.xml；
编写App Widget的主程序；
编辑AndroidManifest.xml，设定App Widget可接受App Widget的更新事件：android.appwidget.action.APPWIDGET_UPDATE

及设计一个App Widget至少需要以下4个文件：

res/xml/appwidget_provider.xml
res/layout/main.xml
src//HelloAppWidgetProvider.java
AndroidManifest.xml

下面是一个具体实现App Widget的例子：

新建一个Android工程HelloAppWidget，在/res目录新建一个文件夹xml，在/res/xml目录下新建一个appwidget_provider.xml文件：

[html] view plaincopy
<?xml version="1.0" encoding="utf-8"?>  
     
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"  
    android:minWidth="85dp"  
    android:minHeight="30dp"  
    android:updatePeriodMillis="1000"  
    android:initialLayout="@layout/main"  
    >  
</appwidget-provider>  

说明如下：

<appwidget-provider>标签定义App Widget的属性
android:minWidth 宽度
android:minHeight 长度
android:updatePeriodMillis定义App Widget的更新频率，Android框架每隔一段时间，会callback AppWidgetProvider类的onUpdate()事件；以前android的版本设定为1毫秒为单位，现在版本为了省电，更新时间为30～60分钟，所以现在设定30分钟以内的更新意义不大，系统默认为30～60分钟更新
android:initialLayout属性指定此App Widget的UI layout定义，”@”符号在Android的XML定义档案，代表「目录」之意，因此”@layout/main”表示「layout目录下的main.xml档案」

为了界面美观，google提供了App Widget的外观设计原则，以下是官方提供的设计参考：

编辑main.xml文件：

[html] view plaincopy
<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent"  
    android:orientation="vertical" >  
  
    <TextView  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="@string/hello" />  
    <TextView    
    android:layout_width="wrap_content"   
    android:layout_height="wrap_content"   
    android:id="@+id/appwidget_text"  
    android:textColor="#ff0000"  
    />  
      
  
</LinearLayout>  

我们的App Widget使用LinearLayout來安排布局，而UI为一个TextView物件。在这里，将此TextView的id定义为”appwidget_text”。

在Android工程中添加一个新类HelloAppWidgetProvider extends AppWidgetProvider：

[java] view plaincopy
package com.android;  
  
import java.util.Date;  
  
import android.appwidget.AppWidgetManager;  
import android.appwidget.AppWidgetProvider;  
import android.content.Context;  
import android.widget.RemoteViews;  
  
public class HelloAppWidgetProvider extends AppWidgetProvider {  
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {  
        final int N = appWidgetIds.length;  
        for (int i=0; i<N; i++) {  
            int appWidgetId = appWidgetIds[i];  
            updateAppWidget(context, appWidgetManager, appWidgetId);  
        }  
    }  
        
    public void onDeleted(Context context, int[] appWidgetIds) {  
    }  
    
    static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,  
            int appWidgetId) {  
        CharSequence text;  
        java.text.DateFormat df = new java.text.SimpleDateFormat("hh:mm:ss");  
        text = "http://blog.csdn.net/imyang2007" + "    Time:" + df.format(new Date());  
          
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.main);  
        views.setTextViewText(R.id.appwidget_text, text);  
        appWidgetManager.updateAppWidget(appWidgetId, views);  
    }  
  
  
}  

HelloAppWidgetProvider.java 代码说明

上图是目前的HelloAppWidget范例设计，说明如下：

onUpdate(): 收到ACTION_APPWIDGET_UPDATE广播时，框架会callback此method
onDelete(): 收到ACTION_APPWIDGET_DELETE广播时，框架会callback此method
AppWidgetManager: 管理App Widget的类

在AndroidManifest.xml里我们要让HelloAppWidgetProider类可以接收ACTION_APPWIDGET_UPDATE广播事件；ACTION_APPWIDGET_UPDATE是最主要的App Widget事件，当AppWidgetProvider被要求为App Widget提供”RemoteView”时，就会收到这个事件。

RemoteViews 就是表示UI的类。res/layout/main.xml描述了应用程序的UI，UI里当然包含许多组件(Widget)，Android应用程序的UI就是一个View tree，view tree就是View Hierarchy。总结来说，RemotViews是一个用来表示View Hierarchy的类。通过RemoteViews可以找到UI里的每一个组件。

onUpdate()负责更新已经安装在桌面上的App Widget內容，因此我们实现一个updateAppWidget()來进行真正更新的工作。onUpdate()的第二个参数为AppWidgetManager，这是一个管理AppWidgetProvider的类，我们必須通过框架callback本方法时回传给我们的AppWidgetProvider，来更新桌面上的App Widget。onUpdate()第三个参数appWidgetIds阵列，存放需要更新的App Widget ID；框架会将需要更新的App Widget的ID回传给onUpdate()，程序必須负责更新每一个需要更新的App Widget。

updateAppWidget()说明：

通过UI layout取得自已的「View Hierarchy」(UI)，以RemoteViews表示；
调用RemoteView的setTextViewText()方法，修改UI里的「R.id.appwidget_text」组件，更改文字内容；
调用AppWidgetProvider的updateAppWidget()方法，更新指定的App Widget，将其UI更新为RemoteView的UI；
updateAppWidget()的第二个参数为RemoteView，即说明1.取得的UI，说明2.修改了此UI里的”R.id.appwidget_text”组件，最后通过App Widget Manager更新App Widget的UI。

App Widget的最后一步，编辑AndroidManifest.xml文件：

[html] view plaincopy
<?xml version="1.0" encoding="utf-8"?>  
<manifest xmlns:android="http://schemas.android.com/apk/res/android"  
    package="com.android"  
    android:versionCode="1"  
    android:versionName="1.0" >  
  
    <uses-sdk android:minSdkVersion="10" />  
  
    <application  
        android:icon="@drawable/ic_launcher"  
        android:label="@string/app_name" >  
        <receiver android:name=".HelloAppWidgetProvider" >  
            <meta-data  
                android:name="android.appwidget.provider"  
                android:resource="@xml/appwidget_provider" />  
  
            <intent-filter>  
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />  
            </intent-filter>  
        </receiver>  
  
        <activity  
            android:name=".HelloAppWidgetActivity"  
            android:label="@string/app_name" >  
            <intent-filter>  
                <action android:name="android.intent.action.MAIN" />  
  
                <category android:name="android.intent.category.LAUNCHER" />  
            </intent-filter>  
        </activity>  
    </application>  
  
</manifest>  

说明如下：

在<application>里加入<receiver>标签，指定android:name属性为主要的provider类，即”HelloAppWidgetProvider”，注意「.」表示后面的字符串为一个「类别名」，不要忽略了这个重要的小数点
在<receiver>里加入<meta-data>标签，指定android:resource属性为App Widget的资源名称，就是「@xml/appwidget_provider」，即「xml目录的appwidget_provider.xml文档」
在<receiver>里加入<intent-filter>标签，让App Widget可以接收APPWIDGET_UPDATE事件(event)

至此，一个简单的App Widget设计完成，运行效果为：

最后，发现一个问题，程序并没有实现我们的预想的每秒更新一次App Widget，而是在30～60分钟更新一次，这是1.6之后的android版本为了使设备不那么耗电，把App Widget的更新时间增加到了30分钟以上。

转自http://blog.csdn.net/imyang2007/article/details/7611805

0 0