Android應(yīng)用界面開(kāi)發(fā)——Widget（實(shí)現(xiàn)液晶時(shí)鐘）

在Android桌面上首先看到的是壁紙，接著可以看到手機(jī)桌面上規(guī)則排列的多個(gè)圖標(biāo)，分別代表快捷方式與桌面控件（Widget），每個(gè)快捷方式只占桌面的一個(gè)擺放位置，桌面控件則可以很大，一個(gè)桌面控件可以占據(jù)多個(gè)擺放位置。

一.什么是桌面控件？

桌面控件就是能直接顯示在Android系統(tǒng)桌面上的小程序，比如時(shí)鐘等。

在桌面上添加桌面控件，可以按以下步驟：

  • 長(zhǎng)按手機(jī)桌面，然后單擊屏幕右下角的“WIDGETS”按鈕，系統(tǒng)進(jìn)入如下圖所示的Widget列表界面。
  • 長(zhǎng)按需要添加的桌面控件，此時(shí)可以看到桌面控件會(huì)自動(dòng)切換到桌面，拖動(dòng)該桌面控件，放到指定位置即可，如下圖：

二.開(kāi)發(fā)桌面控件

桌面控件是通過(guò)BroadcastReceiver的形式進(jìn)行控制的，因此每個(gè)桌面控件都對(duì)應(yīng)于一個(gè)BroadcastReceiver。開(kāi)發(fā)桌面控件時(shí)，只需繼承BroadcastReceiver的子類APPWidgetProvider，并重寫(xiě)APPWidgetProvider不同狀態(tài)的生命周期方法即可。

APPWidgetProvider提供了四個(gè)不同的生命周期方法：

  • onUpdate()：負(fù)責(zé)更新桌面控件的方法。
  • onDelete()：當(dāng)一個(gè)或多個(gè)桌面控件被刪除時(shí)回調(diào)該方法。
  • onEnabled()：當(dāng)接收到ACTION_APPWIDGET_ENABLED Broadcast時(shí)回調(diào)該方法。
  • onDisabled()：當(dāng)接收到ACTION_APPWIDGET_DISABLED Broadcast時(shí)回調(diào)該方法。

一般，開(kāi)發(fā)桌面控件只需定義一個(gè)APPWidgetProvider的子類，并重寫(xiě)它的onUpdate()方法即可，重寫(xiě)該方法的步驟：

  • 創(chuàng)建一個(gè)RemoteViews對(duì)象，創(chuàng)建該對(duì)象時(shí)可以指定加載指定的界面布局文件。
  • 如果需要改變上一步所加載的界面布局文件的內(nèi)容，則可通過(guò)RemoteViews對(duì)象進(jìn)行修改。
  • 創(chuàng)建一個(gè)ComponentName對(duì)象。
  • 調(diào)用APPWidgetManager更新桌面控件。

歸納起來(lái)，其核心代碼就是使用APPWidgetManager通過(guò)RemoteViews來(lái)更新APPWidgetProvider的子類實(shí)例（需要將它包裝成ComponentName對(duì)象）。

由于APPWidgetProvider繼承了BroadcastReceiver，因此APPWidgetProvider本質(zhì)還是一個(gè)BroadcastReceiver，需要在AndroidManifest.xml中使用<receiver.../>元素配置，配置該元素還需要為它指定相應(yīng)的<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，因此還需要在應(yīng)用的res/xml目錄下添加appwidget_provider.xml文件，該文件內(nèi)容如下：

<?xml version="1.0" encoding="utf-8"?>
<!--
    minWidth：桌面控件的最小寬度
    minHeight：桌面控件的最小高度
    updatePeriodMillis：更新頻率
    initialLayout：初始時(shí)顯示的布局-->
<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.../>元素來(lái)描述桌面控件的基本信息，其中的注釋詳細(xì)說(shuō)明了各屬性的作用。

三.實(shí)現(xiàn)液晶時(shí)鐘

程序界面包含8個(gè)ImageView，其中六個(gè)用于顯示小時(shí)、分鐘、秒鐘的數(shù)字，另外兩個(gè)用于顯示冒號(hào)。

為了讓桌面控件實(shí)時(shí)顯示當(dāng)前時(shí)間，需要每隔一秒更新一次界面上的六個(gè)ImageView，讓它們顯示當(dāng)前小時(shí)、分鐘、秒鐘的數(shù)字即可。

代碼如下：

public class LedClockWidget extends AppWidgetProvider {

    private Timer mTimer = new Timer();
    private AppWidgetManager mAppWidgerManager;
    private Context mContext;
    //將0-9的液晶數(shù)字圖片定義為數(shù)組
    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,
    };
    //將顯示小時(shí)、分鐘、秒鐘的ImageView定義為數(shù)組
    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;
        //定義計(jì)時(shí)器
        mTimer = new Timer();
        //啟動(dòng)周期性調(diào)度
        mTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                //發(fā)送空消息，通知界面更新
                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對(duì)象
                SimpleDateFormat df = new SimpleDateFormat("HHmmss");
                //將當(dāng)前時(shí)間格式化為HHmmss的形式
                String timeStr = df.format(new Date());
                for (int i = 0; i < timeStr.length(); i++) {
                    //將第i個(gè)數(shù)字字符zh轉(zhuǎn)換為對(duì)應(yīng)的數(shù)字
                    int num = timeStr.charAt(i) - 48;
                    //將第i個(gè)圖片設(shè)為對(duì)應(yīng)的液晶數(shù)字圖片
                    views.setImageViewResource(digitViews[i], digits[num]);
                }
                //將APPWidgetProvider子類實(shí)例包裝成ComponentName對(duì)象
                ComponentName componentName = new ComponentName(mContext, LedClockWidget.class);
                //調(diào)用APPWidgetManager將RemoteViews添加到ComponentName中
                mAppWidgerManager.updateAppWidget(componentName, views);
            }
            super.handleMessage(msg);
        }
    };
}

上面代碼根據(jù)程序的時(shí)間字符串動(dòng)態(tài)更新六個(gè)ImageView所顯示的液晶數(shù)字圖片，這樣就可以顯示當(dāng)前時(shí)間了。

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>

配置文件中指定了液晶時(shí)鐘的meta-data為@xml/my_lock，還需要在res/xml路徑下添加一個(gè)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中又引用了液晶時(shí)鐘顯示的布局@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>

最后，運(yùn)行程序，在WIDGETS中找到該控件，添加到桌面，如下：


最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容