Android中的AppWidget入門教程
什么是AppWidget?AppWidget就是我們平常在桌面上見到的那種一個個的小窗口,利用這個小窗口可以給用戶提供一些方便快捷的操作。本篇打算從以下幾個點來介紹AppWidget:
1.如何創(chuàng)建一個簡單的AppWidget
2.如何使得AppWidget與客戶端程序交互
創(chuàng)建簡單的AppWidget
在介紹之前給大家看一下程序運行的最后結(jié)果和項目結(jié)構(gòu)圖,以便大家有個整體的印象。
運行結(jié)果圖:
項目結(jié)構(gòu)圖:
第一步:
首先在res文件夾下新建一個名字為xml的文件夾,然后在xml目錄下創(chuàng)建一個名為appwidget01的xml文件(如上圖所示)。這個appwidget01中的內(nèi)容如下:
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth = "294dp"
android:minHeight = "72dp"
android:updatePeriodMillis = "86400000"
android:initialLayout = "@layout/appwidgetlayout"
>
</appwidget-provider>
這個xml是用來描述你所要創(chuàng)建的appWidget的一些描述信息的,比如高度、寬度、刷新間隔、布局文件等等。僅僅這個描述文件還不夠,我們看到的appWidget可都是有界面元素的呀,比如說文本,圖片,按鈕等等,這些東西的定義都需要放到layout文件夾下面。這個文件就是上面代碼中寫到的那個appwidgetlayout。
第二步:
在layout文件夾下面新建一個appwidgetlayout.xml文件,在這個文件中描述了appWidget的控件和布局等等信息,就和我們平常創(chuàng)建的一個activity的布局文件沒什么兩樣,因為只是簡單的演示,所以僅用一個文本和一個按鈕。xml的內(nèi)容如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent" android:layout_height="fill_parent">
<TextView android:id="@+id/txtapp" android:text="test" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:background="#ffffff"></TextView>
<Button android:id="@+id/btnSend" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:text="Send"></Button>
</LinearLayout>
第三步:
既然appWidget中存在按鈕等等控件,那么就肯定少不了處理這些控件事件的處理代碼啦。這些代碼被放在一個繼承于AppWidgetProvider的類中,在本例子中我新建了一個AppWidget的類,該類繼承于AppWidgetProvider,以后所有的AppWidget上面的控件事件都會在這個類中處理。看一下類的內(nèi)容:
public class AppWidget extends AppWidgetProvider
{
private final String broadCastString = "com.qlf.appWidgetUpdate";
/**
* 刪除一個AppWidget時調(diào)用
* */
@Override
public void onDeleted(Context context, int[] appWidgetIds)
{
super.onDeleted(context, appWidgetIds);
}
/**
* 最后一個appWidget被刪除時調(diào)用
* */
@Override
public void onDisabled(Context context)
{
super.onDisabled(context);
}
/**
* AppWidget的實例第一次被創(chuàng)建時調(diào)用
* */
@Override
public void onEnabled(Context context)
{
super.onEnabled(context);
}
/**
* 接受廣播事件
* */
@Override
public void onReceive(Context context, Intent intent)
{
super.onReceive(context, intent);
}
/**
* 到達指定的更新時間或者當(dāng)用戶向桌面添加AppWidget時被調(diào)用
* */
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds)
{
}
}
各個方法的作用大家一看上面的注釋就明白了。我們暫時不需要實現(xiàn)里面的方法。
第四步:
在AndroidManifest.xml中定義一些創(chuàng)建AppWidget必要的東西,先看代碼:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.qlf.widget" android:versionCode="1" android:versionName="1.0">
<application android:icon="@drawable/icon" android:label="@string/app_name">
<activity android:name=".MainActivity" android:label="@string/app_name">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name="AppWidget">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/appwidget01" />
</receiver>
</application>
<uses-sdk android:minSdkVersion="8" />
</manifest>
可以看到我們在配置文件里面定義了一個receiver,他的名字是上面創(chuàng)建處理控件代碼的那個類,下面那個intent-filter中的action是系統(tǒng)自帶的用于更新所有appwidget的廣播動作。然后meta-data標(biāo)簽是一個描述我們創(chuàng)建appwidget的元數(shù)據(jù),那個android:name="android.appwidget.provider"是固定的,android:resource="@xml/appwidget01"指定創(chuàng)建的appWidget的描述信息的位置。這樣程序就知道到哪里去初始化這些appWidget啦。
經(jīng)過上面四個步驟,我想您已經(jīng)能夠成功在桌面上添加小工具了,效果就是我們最前面發(fā)出的樣子。
AppWidget與程序交互
前面我們只是簡單的介紹了如何創(chuàng)建一個appWidget,但是目前這個appWidget還沒有任何的交互功能。下面我們介紹一下appWidget如何與程序進行交互。首先要介紹一個對象,這個對象在appwidget和程序的交互中很重要,他就是RemoteViews。因為appwidget運行的進程和我們創(chuàng)建的應(yīng)用不在一個進程中,所以我們也就不能像平常引用控件那樣來獲得控件的實例。這個時候RemoteViews出場了,從字面上看他的意思是遠程的視圖,也就是說通過這個東西我們能夠獲得不在同一進程中的對象,這也就為我們編寫appwidget的處理事件提供了幫助。我們使用一下代碼來創(chuàng)建一個RemoteViews :
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);
remoteViews.setOnClickPendingIntent(R.id.btnSend, pendingIntent); //為小工具上的按鈕綁定事件
可以看到上面又出現(xiàn)了一個陌生的對象pendingIntent,這個又是用來干嘛的呢?我們知道在一般的程序中綁定按鈕的點擊事件是直接在實現(xiàn)了OnClickListener接口的類中中完成的。不過因為appwidget并不在我們應(yīng)用的進程中,所以當(dāng)然他也訪問不到我們在應(yīng)用中設(shè)置的onclick代碼啦。而PendingIntent就是被用來解決這個問題的。PendingIntent可以看成是一個特殊的Intent,如果我們把Intent看成一封信,那么PendingIntent就是一封被信封包裹起來的信。這封信在remoteViews.setOnClickPendingIntent()中被“郵寄”到了appwidget, 當(dāng)appwidget中的按鈕單擊時他知道將這封信打開,并執(zhí)行里面的內(nèi)容。這樣就避免了直接從appwidget中執(zhí)行本地代碼。我們來看看PendingIntent是如何定義的:
//創(chuàng)建一個Intent對象
Intent intent = new Intent();
intent.setAction(broadCastString);
//這一步相當(dāng)于寫信,說明這個信的作用到底是什么,在這里表示將發(fā)送一個廣播
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
有了上面的介紹,我們在創(chuàng)建appwidget的交互應(yīng)用時就簡單不少了。我們剩下要做的工作就是在appwidget在創(chuàng)建的時候調(diào)用上面說到的方法為appwidget中的控件綁定事件,也就是在AppWidget類下的onUpdate方法中完成這個過程。
/**
* 到達指定的更新時間或者當(dāng)用戶向桌面添加AppWidget時被調(diào)用
* */
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds)
{
//創(chuàng)建一個Intent對象
Intent intent = new Intent();
intent.setAction(broadCastString);
//設(shè)置pendingIntent的作用
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);
//綁定事件
remoteViews.setOnClickPendingIntent(R.id.btnSend, pendingIntent);
//更新Appwidget
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
}
通過上面的代碼我們就為button按鈕綁定了一個事件,這個事件的作用是發(fā)送一個廣播便于其他應(yīng)用接收、更新信息。這是appwidget發(fā)送廣播,那么appwidget如何接受來自其他程序發(fā)送的廣播呢?這就是public void onReceive(Context context, Intent intent)的功能啦。這個方法會接收來自其他應(yīng)用發(fā)出的廣播,我們只要在這個程序中過濾我們需要的廣播就能響應(yīng)其他應(yīng)用的操作來更新appwidget的信息了。要注意的是,因為appwidget運行的進程和我們創(chuàng)建的應(yīng)用不在一個進程中的限制,所以更新的appwidget的時候也要通過遠程對象來操作,具體代碼如下:
/**
* 接受廣播事件
* */
@Override
public void onReceive(Context context, Intent intent)
{
if (intent.getAction().equals(broadCastString))
{
//只能通過遠程對象來設(shè)置appwidget中的控件狀態(tài)
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.appwidgetlayout);
//通過遠程對象將按鈕的文字設(shè)置為”hihi”
remoteViews.setTextViewText(R.id.btnSend, "hihi");
//獲得appwidget管理實例,用于管理appwidget以便進行更新操作
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
//相當(dāng)于獲得所有本程序創(chuàng)建的appwidget
ComponentName componentName = new ComponentName(context,AppWidget.class);
//更新appwidget
appWidgetManager.updateAppWidget(componentName, remoteViews);
}
super.onReceive(context, intent);
}
總結(jié)下就是appwidget上的操作都必須借助遠程對象來操作。最后看一下運行的圖片吧:
按之前:
按之后:
相關(guān)文章
Android中CountDownTimer倒計時器用法實例
這篇文章主要介紹了Android中CountDownTimer倒計時器用法,以實例形式分析了Android中CountDownTimer類的相關(guān)使用技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-10-10Android多點觸控技術(shù)實戰(zhàn) 針對圖片自由縮放和移動
這篇文章主要為大家詳細介紹了Android多點觸控技術(shù)實戰(zhàn),自由地對圖片進行縮放和移動,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-10-10Android中的動態(tài)加載機制的學(xué)習(xí)研究
本篇文章主要介紹了Android中的動態(tài)加載機制,對android項目開發(fā)有著一定的幫助,有興趣的同學(xué)可以了解一下。2016-11-11Android中ListView Item布局優(yōu)化技巧
這篇文章主要介紹了Android中ListView Item布局優(yōu)化技巧,以實例形式分析了ListView Item布局的相關(guān)實現(xiàn)技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-10-10Android--SQLite(增,刪,改,查)操作實例代碼
Android--SQLite(增,刪,改,查)操作實例代碼,需要的朋友可以參考一下2013-02-02Android ListView與RecycleView的對比使用解析
這篇文章主要介紹了Android ListView與RecycleView的對比使用解析,需要的朋友可以參考下2017-12-12Android開發(fā)實現(xiàn)的保存圖片到相冊功能示例
這篇文章主要介紹了Android開發(fā)實現(xiàn)的保存圖片到相冊功能,結(jié)合實例形式分析了Android圖片命名、保存、權(quán)限控制等相關(guān)操作技巧,需要的朋友可以參考下2019-03-03Android 使用AsyncTask實現(xiàn)多任務(wù)多線程斷點續(xù)傳下載
這篇文章主要介紹了Android 使用AsyncTask實現(xiàn)多任務(wù)多線程斷點續(xù)傳下載的相關(guān)資料,需要的朋友可以參考下2018-05-05