专栏首页7号代码Android应用界面开发——Widget(实现液晶时钟)

Android应用界面开发——Widget(实现液晶时钟)

在Android桌面上首先看到的是壁纸,接着可以看到手机桌面上规则排列的多个图标,分别代表快捷方式与桌面控件(Widget),每个快捷方式只占桌面的一个摆放位置,桌面控件则可以很大,一个桌面控件可以占据多个摆放位置。

一.什么是桌面控件?


桌面控件就是能直接显示在Android系统桌面上的小程序,比如时钟等。

在桌面上添加桌面控件,可以按以下步骤:

  • 长按手机桌面,然后单击屏幕右下角的“WIDGETS”按钮,系统进入如下图所示的Widget列表界面。
  • 长按需要添加的桌面控件,此时可以看到桌面控件会自动切换到桌面,拖动该桌面控件,放到指定位置即可,如下图:

二.开发桌面控件


桌面控件是通过BroadcastReceiver的形式进行控制的,因此每个桌面控件都对应于一个BroadcastReceiver。开发桌面控件时,只需继承BroadcastReceiver的子类APPWidgetProvider,并重写APPWidgetProvider不同状态的生命周期方法即可。

APPWidgetProvider提供了四个不同的生命周期方法:

  • onUpdate():负责更新桌面控件的方法。
  • onDelete():当一个或多个桌面控件被删除时回调该方法。
  • onEnabled():当接收到ACTION_APPWIDGET_ENABLED Broadcast时回调该方法。
  • onDisabled():当接收到ACTION_APPWIDGET_DISABLED Broadcast时回调该方法。

一般,开发桌面控件只需定义一个APPWidgetProvider的子类,并重写它的onUpdate()方法即可,重写该方法的步骤:

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

归纳起来,其核心代码就是使用APPWidgetManager通过RemoteViews来更新APPWidgetProvider的子类实例(需要将它包装成ComponentName对象)。

由于APPWidgetProvider继承了BroadcastReceiver,因此APPWidgetProvider本质还是一个BroadcastReceiver,需要在AndroidManifest.xml中使用<receiver.../>元素配置,配置该元素还需要为它指定相应的<intent-filter.../>和<meta-data.../>。

示例代码如下:

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

配置文件中指定该桌面控件使用@xml/appwidget_provider作为meta-data,因此还需要在应用的res/xml目录下添加appwidget_provider.xml文件,该文件内容如下:

<?xml version="1.0" encoding="utf-8"?>
<!--
    minWidth:桌面控件的最小宽度
    minHeight:桌面控件的最小高度
    updatePeriodMillis:更新频率
    initialLayout:初始时显示的布局-->
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="150dp"
    android:minHeight="70dp"
    android:updatePeriodMillis="1000"
    android:initialLayout="@layout/activity_main"/>

xml配置文件中使用了<appwidget-provider.../>元素来描述桌面控件的基本信息,其中的注释详细说明了各属性的作用。

三.实现液晶时钟


程序界面包含8个ImageView,其中六个用于显示小时、分钟、秒钟的数字,另外两个用于显示冒号。

为了让桌面控件实时显示当前时间,需要每隔一秒更新一次界面上的六个ImageView,让它们显示当前小时、分钟、秒钟的数字即可。

代码如下:

public class LedClockWidget extends AppWidgetProvider {

    private Timer mTimer = new Timer();
    private AppWidgetManager mAppWidgerManager;
    private Context mContext;
    //将0-9的液晶数字图片定义为数组
    private int[] digits = new int[]{
            R.drawable.led00,
            R.drawable.led01,
            R.drawable.led02,
            R.drawable.led03,
            R.drawable.led04,
            R.drawable.led05,
            R.drawable.led06,
            R.drawable.led07,
            R.drawable.led08,
            R.drawable.led09,
    };
    //将显示小时、分钟、秒钟的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) {
        this.mAppWidgerManager = appWidgetManager;
        this.mContext = context;
        //定义计时器
        mTimer = new Timer();
        //启动周期性调度
        mTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                //发送空消息,通知界面更新
                handler.sendEmptyMessage(0x123);
            }
        }, 0, 1000);
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

    private Handler handler = new Handler(){
        @Override
        public void handleMessage(Message msg) {
            if (msg.what == 0x123){
                RemoteViews views = new RemoteViews(mContext.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个数字字符zh转换为对应的数字
                    int num = timeStr.charAt(i) - 48;
                    //将第i个图片设为对应的液晶数字图片
                    views.setImageViewResource(digitViews[i], digits[num]);
                }
                //将APPWidgetProvider子类实例包装成ComponentName对象
                ComponentName componentName = new ComponentName(mContext, LedClockWidget.class);
                //调用APPWidgetManager将RemoteViews添加到ComponentName中
                mAppWidgerManager.updateAppWidget(componentName, views);
            }
            super.handleMessage(msg);
        }
    };
}

上面代码根据程序的时间字符串动态更新六个ImageView所显示的液晶数字图片,这样就可以显示当前时间了。

AndroidManifest.xml代码:

<receiver
            android:name=".LedClockWidget"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/my_lock" />
</receiver>

配置文件中指定了液晶时钟的meta-data为@xml/my_lock,还需要在res/xml路径下添加一个my_lock.xml文件,如下:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="150dp"
    android:minHeight="70dp"
    android:updatePeriodMillis="1000"
    android:initialLayout="@layout/main"/>

该xml中又引用了液晶时钟显示的布局@layout/下的main.xml,代码如下:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal">

    <ImageView
        android:id="@+id/img01"
        android:layout_width="30dp"
        android:layout_height="30dp" />

    <ImageView
        android:id="@+id/img02"
        android:layout_width="30dp"
        android:layout_height="30dp" />

    <ImageView
        android:background="@drawable/maohao"
        android:layout_width="10dp"
        android:layout_height="30dp" />

    <ImageView
        android:id="@+id/img04"
        android:layout_width="30dp"
        android:layout_height="30dp" />

    <ImageView
        android:id="@+id/img05"
        android:layout_width="30dp"
        android:layout_height="30dp" />

    <ImageView
        android:background="@drawable/maohao"
        android:layout_width="10dp"
        android:layout_height="30dp" />

    <ImageView
        android:id="@+id/img07"
        android:layout_width="30dp"
        android:layout_height="30dp" />

    <ImageView
        android:id="@+id/img08"
        android:layout_width="30dp"
        android:layout_height="30dp" />

</LinearLayout>

最后,运行程序,在WIDGETS中找到该控件,添加到桌面,如下:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Android应用界面开发——ListView,GridView,ScrollView

    ListView的意思是列表视图,是应用最广泛的一种视图,例如联系人,功能列表,菜单等等都会用到ListView。

    trampcr
  • 自定义View实现设置中心的功能视图

    实现电话短信拦截是否开启就需要以上几十行代码,如果在下面还需实现版本更新是否开启,我们可能会复制以上几十行代码,修改其中的文本即可,但是如果还有同样的10个功能...

    trampcr
  • Android开发高级进阶——多线程(实现简单下载器)

    Android3.0以及以后的版本中,禁止在主线程执行网络请求,否则会抛出异常,可见在UI线程中执行耗时操作是不推荐的行为。所以,在进行与耗时操作同步进行的操作...

    trampcr
  • [android] 手机卫士自定义对话框布局

    点击手机防盗,进行判断,如果没有设置密码,显示一个设置密码的对话框,如果已经设置密码了,弹出输入密码对话框

    陶士涵
  • Android 基础动画之 scale 渐变缩放

    和尚最近在学习 ViewPager 的小动画,说来惭愧,工作这么久了一直没有认真了解过动画这部分,今天特意学习一下 Android 的基本动画。

    阿策
  • Material Design整理(六)——SearchView及FlexboxLayout

    蜻蜓队长
  • 第一个Android应用Android应用界面开发

    给项目取名First Application 主界面命名FirstAty,xml文件命名就自动使用activity_first_aty吧。

    爱因斯坦福
  • 线性布局LinearLayout(二)

    线性布局,顾名思义,指的是整个Android布局中的控件摆放方式是以线性的方式摆放的, 代码中加载主界面布局是从onCreate开始的:

    李小白是一只喵
  • Android自定义View

    前几天在郭霖大神的博客上看了自定义View的知识,感觉受益良多,大神毕竟大神。在此总结一下关于Android 自定义View的用法:

    指点
  • 【Unity】QQ登录SDK接入(Unity&Android)

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。

    bering

扫码关注云+社区

领取腾讯云代金券