桌面小部件----LED电子时钟实现

桌面控件是通过 Broadcast 的形式来进行控制的，因此每个桌面控件都对应于一个BroadcastReceiver。为了简化桌面控件的开发，Android 系统提供了一个 AppWidgetProvider类 ， 它 就 是 BroadcastReceiver 的 子 类 ， 也 就 是 说 开 发 者 开 发 桌 面 控 件 只 要 继 承
AppWidgetProvider 类即可。

为了开发桌面控件，开发者只要开发一个继承 AppWidgetProvider 的子类，并重写AppWidgetProvider 不同状态的生命周期方法即可。AppWidgetProvider 里提供如下 4 个不同的生命周期方法。

• onUpdate()：负责更新桌面控件的方法；实现桌面控件通常会考虑重写该方法。
• onDeleted()：当一个或多个桌面控件被删除时回调该方法。
• onEnabled()：当接收到ACTION_APPWIDGET_ENABLED Broadcast 时回调该方法。
• onDisabled()：当接收到 ACTION_APPWIDGET_DISABLED Broadcast 时回调该方法。

一般来说，开发桌面控件只需要定义一个 AppWidgetProvider 的子类，并重写它的onUpdate()方法即可，重写该方法按如下步骤进行。

1. 创建一个 RemoteViews 对象，创建该对象时可以指定加载指定的界面布局文件。
2. 如果需要改变上一步所加载的界面布局文件的的内容，可通过 RemoteViews 对象进行修改。
3. 创建一个 ComponentName 对象。
4. 调用 AppWidgetManager 更新桌面控件。

 

如下代码简单的将一张图片作为部件放到桌面上：

public class DesktopApp extends AppWidgetProvider

{

    @Override

    public void onUpdate(Context context, AppWidgetManager appWidgetManager,

        int[] appWidgetIds)

    {

        // 加载指定界面布局文件，创建RemoteViews对象

        RemoteViews remoteViews = new RemoteViews(

            context.getPackageName(),

            R.layout.main);  //①

        // 为show ImageView设置图片

        remoteViews.setImageViewResource(R.id.show

            , R.drawable.logo);   //②

        // 将AppWidgetProvider子类实例包装成ComponentName对象

        ComponentName componentName = new ComponentName(

            context, DesktopApp.class);  //③

        // 调用AppWidgetManager将remoteViews添加到ComponentName中

        appWidgetManager.updateAppWidget(componentName

            , remoteViews);  //④

    }

}

为了实现一个液晶时钟的桌面组件，开发者需要在程序界面上定义 8 个 ImageView，其中 6 个 ImageView 用于显示小时、分钟、秒钟的数字，另外两个 ImageView 用于显示小时、分钟、秒钟之间的冒号。
为了让桌面组件实时地显示当前时间，程序需要每隔 1 秒更新一次程序界面上的 6 个ImageView，让它们显示当前小时、分钟、秒钟的数字即可。

LED电子时钟桌面部件依赖如下代码实现：

main.xml

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:orientation="horizontal"

    android:layout_width="fill_parent"

    android:layout_height="fill_parent"

    >

<!-- 定义5个ImageView来显示液晶数字 -->

<ImageView

    android:id="@+id/img01"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />

<ImageView

    android:id="@+id/img02"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />

<ImageView

    android:id="@+id/img03"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    android:src="@drawable/su00"

    />

<ImageView

    android:id="@+id/img04"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />

<ImageView

    android:id="@+id/img05"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />

<ImageView

    android:id="@+id/img06"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content"

    android:src="@drawable/su00"     

    />

<ImageView

    android:id="@+id/img07"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />

<ImageView

    android:id="@+id/img08"  

    android:layout_width="wrap_content" 

    android:layout_height="wrap_content" 

    />                        

</LinearLayout>

Manifest.xml

<?xml version="1.0" encoding="utf-8"?>

<manifest

    xmlns:android="http://schemas.android.com/apk/res/android"

    package="org.crazyit.desktop"

    android:versionCode="1"

    android:versionName="1.0">

    <uses-sdk

        android:minSdkVersion="10"

        android:targetSdkVersion="17" />

    <application

        android:icon="@drawable/ic_launcher"

        android:label="@string/app_name">

        <receiver

            android:name=".LedClock"

            android:label="@string/app_name">

            <!-- 将该BroadcastReceiver当成桌面控件 -->

            <intent-filter>

                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />

            </intent-filter>

            <!-- 指定桌面控件的meta-data -->

            <meta-data

                android:name="android.appwidget.provider"

                android:resource="@xml/my_clock" />

        </receiver>

    </application>

</manifest>

my_clock.xml

<?xml version="1.0" encoding="utf-8"?>

<!-- 指定该桌面组件的基本配置信息：

    minWidth：桌面控件的最小宽度。

    minWidth：桌面控件的最小高度。

    updatePeriodMillis：更新频率

    initialLayout：初始时显示的布局 -->

<appwidget-provider

    xmlns:android="http://schemas.android.com/apk/res/android"

    android:minWidth="800px"

    android:minHeight="30px"

    android:updatePeriodMillis="1000"

    android:initialLayout="@layout/main"/>

LedClock.java

package org.crazyit.desktop;



import java.text.SimpleDateFormat;

import java.util.Date;

import java.util.Timer;

import java.util.TimerTask;



import android.appwidget.AppWidgetManager;

import android.appwidget.AppWidgetProvider;

import android.content.ComponentName;

import android.content.Context;

import android.os.Handler;

import android.os.Message;

import android.widget.RemoteViews;



/**

 * Description:

 * <br/>site: <a href="http://www.crazyit.org">crazyit.org</a>

 * <br/>Copyright (C), 2001-2014, Yeeku.H.Lee

 * <br/>This program is protected by copyright laws.

 * <br/>Program Name:

 * <br/>Date:

 * @author  Yeeku.H.Lee [email protected]

 * @version  1.0

 */

public class LedClock extends AppWidgetProvider

{

    private Timer timer = new Timer();

    private AppWidgetManager appWidgetManager;

    private Context context;

    // 将0～9的液晶数字图片定义成数组

    private int[] digits = new int[]

    {

        R.drawable.su01,

        R.drawable.su02,

        R.drawable.su03,

        R.drawable.su04,

        R.drawable.su05,

        R.drawable.su06,

        R.drawable.su07,

        R.drawable.su08,

        R.drawable.su09,

        R.drawable.su10,

    };

    // 将显示小时、分钟、秒钟的ImageView定义成数组

    private int[] digitViews = new int[]

       {

           R.id.img01,

           R.id.img02,

           R.id.img04,

           R.id.img05,

           R.id.img07,

           R.id.img08

       };

    @Override

    public void onUpdate(Context context, AppWidgetManager appWidgetManager,

            int[] appWidgetIds)

    {

        System.out.println("--onUpdate--");

        this.appWidgetManager = appWidgetManager;

        this.context = context;

        // 定义计时器

        timer = new Timer();

        // 启动周期性调度

        timer.schedule(new TimerTask()

        {

            public void run()

            {

                // 发送空消息，通知界面更新

                handler.sendEmptyMessage(0x123);

            }

        }, 0, 1000);

    }



    private Handler handler = new Handler()

    {

        public void handleMessage(Message msg)

        {

            if (msg.what == 0x123)

            {

                RemoteViews views = new RemoteViews(context

                        .getPackageName(), R.layout.main);

                // 定义SimpleDateFormat对象

                SimpleDateFormat df = new SimpleDateFormat(

                        "HHmmss");

                // 将当前时间格式化成HHmmss的形式

                String timeStr = df.format(new Date());

                for(int i = 0 ; i < timeStr.length() ;i++)

                {

                    // 将第i个数字字符转换为对应的数字,charAt函数返回的是ASCII编码，1的ASCII编码是49,所以需要减去偏移量48。

                    int num = timeStr.charAt(i) - 48;

                    // 将第i个图片的设为对应的液晶数字图片

                    views.setImageViewResource(digitViews[i], digits[num]);

                }

                // 将AppWidgetProvider子类实例包装成ComponentName对象

                ComponentName componentName = new ComponentName(context,

                    LedClock.class);

                // 调用AppWidgetManager将remoteViews添加到ComponentName中

                appWidgetManager.updateAppWidget(componentName, views);

            }

            super.handleMessage(msg);

        }

    };

}

效果：