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);
}
};
}</code></pre>
上面代碼根據程序的時間字符串動態更新六個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="
<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>
最后,運行程序,在WIDGETS中找到該控件,添加到桌面,如下:

來自:http://www.jianshu.com/p/dbd0c61357fe