Android应用界面开发——Widget（实现液晶时钟）
ubuz3910
8年前
<blockquote> <p>在Android桌面上首先看到的是壁纸，接着可以看到手机桌面上规则排列的多个图标，分别代表快捷方式与桌面控件（Widget），每个快捷方式只占桌面的一个摆放位置，桌面控件则可以很大，一个桌面控件可以占据多个摆放位置。</p> </blockquote> <h2>一.什么是桌面控件？</h2> <p>桌面控件就是能直接显示在Android系统桌面上的小程序，比如时钟等。</p> <p>在桌面上添加桌面控件，可以按以下步骤：</p> <ul> <li>长按手机桌面，然后单击屏幕右下角的“WIDGETS”按钮，系统进入如下图所示的Widget列表界面。</li> </ul> <p><img alt="Android应用界面开发——Widget（实现液晶时钟）" src="https://simg.open-open.com/show/03a6f8656d0fed4d28b8d3edbc4e5e58.png"></p> <ul> <li>长按需要添加的桌面控件，此时可以看到桌面控件会自动切换到桌面，拖动该桌面控件，放到指定位置即可，如下图：</li> </ul> <p><img alt="Android应用界面开发——Widget（实现液晶时钟）" src="https://simg.open-open.com/show/b9a42a023a02a0c97c6c4287e303ebc2.png"></p> <h2>二.开发桌面控件</h2> <p>桌面控件是通过BroadcastReceiver的形式进行控制的，因此每个桌面控件都对应于一个BroadcastReceiver。开发桌面控件时，只需继承BroadcastReceiver的子类APPWidgetProvider，并重写APPWidgetProvider不同状态的生命周期方法即可。</p> <p>APPWidgetProvider提供了四个不同的生命周期方法：</p> <ul> <li>onUpdate()：负责更新桌面控件的方法。</li> <li>onDelete()：当一个或多个桌面控件被删除时回调该方法。</li> <li>onEnabled()：当接收到ACTION_APPWIDGET_ENABLED Broadcast时回调该方法。</li> <li>onDisabled()：当接收到ACTION_APPWIDGET_DISABLED Broadcast时回调该方法。</li> </ul> <p>一般，开发桌面控件只需定义一个APPWidgetProvider的子类，并重写它的onUpdate()方法即可，重写该方法的步骤：</p> <ul> <li>创建一个RemoteViews对象，创建该对象时可以指定加载指定的界面布局文件。</li> <li>如果需要改变上一步所加载的界面布局文件的内容，则可通过RemoteViews对象进行修改。</li> <li>创建一个ComponentName对象。</li> <li>调用APPWidgetManager更新桌面控件。</li> </ul> <p>归纳起来，其核心代码就是使用APPWidgetManager通过RemoteViews来更新APPWidgetProvider的子类实例（需要将它包装成ComponentName对象）。</p> <p>由于APPWidgetProvider继承了BroadcastReceiver，因此APPWidgetProvider本质还是一个BroadcastReceiver，需要在AndroidManifest.xml中使用<receiver.../>元素配置，配置该元素还需要为它指定相应的<intent-filter.../>和<meta-data.../>。</p> <p>示例代码如下：</p> <pre> <code class="language-xml"><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></code></pre> <p>配置文件中指定该桌面控件使用@xml/appwidget_provider作为meta-data，因此还需要在应用的res/xml目录下添加appwidget_provider.xml文件，该文件内容如下：</p> <pre> <code class="language-java"><?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"/></code></pre> <p>xml配置文件中使用了<appwidget-provider.../>元素来描述桌面控件的基本信息，其中的注释详细说明了各属性的作用。</p> <h2>三.实现液晶时钟</h2> <p>程序界面包含8个ImageView，其中六个用于显示小时、分钟、秒钟的数字，另外两个用于显示冒号。</p> <p>为了让桌面控件实时显示当前时间，需要每隔一秒更新一次界面上的六个ImageView，让它们显示当前小时、分钟、秒钟的数字即可。</p> <p>代码如下：</p> <pre> <code class="language-java">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); } }; }</code></pre> <p>上面代码根据程序的时间字符串动态更新六个ImageView所显示的液晶数字图片，这样就可以显示当前时间了。</p> <p>AndroidManifest.xml代码：</p> <pre> <code class="language-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></code></pre> <p>配置文件中指定了液晶时钟的meta-data为@xml/my_lock，还需要在res/xml路径下添加一个my_lock.xml文件，如下：</p> <pre> <code class="language-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"/></code></pre> <p>该xml中又引用了液晶时钟显示的布局@layout/下的main.xml，代码如下：</p> <pre> <code class="language-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></code></pre> <p>最后，运行程序，在WIDGETS中找到该控件，添加到桌面，如下：</p> <p><img alt="Android应用界面开发——Widget（实现液晶时钟）" src="https://simg.open-open.com/show/e54f8738281bb3ff87def8478c7570dd.gif"></p> <p><br> 来自：http://www.jianshu.com/p/dbd0c61357fe<br> </p>