Android桌面插件App Widget用法分析
本文實(shí)例講述了Android桌面插件App Widget用法。分享給大家供大家參考,具體如下:
應(yīng)用程序窗口小部件App Widgets
應(yīng)用程序窗口小部件(Widget)是微小的應(yīng)用程序視圖,可以被嵌入到其它應(yīng)用程序中(比如桌面)并接收周期性的更新。你可以通過一個(gè)App Widget provider來發(fā)布一個(gè)Widget。可以容納其它App Widget的應(yīng)用程序組件被稱為App Widget宿主。下面的截屏顯示了一個(gè)音樂App Widget。
appwidget
這篇文章描述了如何使用App Widget Provider發(fā)布一個(gè)App Widget。
基礎(chǔ)知識(shí)The Basics
為了創(chuàng)建一個(gè)App Widget,你需要下面這些:
AppWidgetProviderInfo 對(duì)象
描述一個(gè)App Widget元數(shù)據(jù),比如App Widget的布局,更新頻率,以及AppWidgetProvider 類。這應(yīng)該在XML里定義。
AppWidgetProvider 類的實(shí)現(xiàn)
定義基本方法以允許你編程來和App Widget連接,這基于廣播事件。通過它,當(dāng)這個(gè)App Widget被更新,啟用,禁用和刪除的時(shí)候,你都將接收到廣播通知。
視圖布局
為這個(gè)App Widget定義初始布局,在XML中。
另外,你可以實(shí)現(xiàn)一個(gè)App Widget配置活動(dòng)。這是一個(gè)可選的活動(dòng)Activity,當(dāng)用戶添加App Widget時(shí)加載并允許他在創(chuàng)建時(shí)來修改App Widget的設(shè)置。
下面的章節(jié)描述了如何建立這些組件:
在清單中聲明一個(gè)應(yīng)用小部件
首先,在應(yīng)用程序AndroidManifest.xml文件中聲明AppWidgetProvider 類,比如:
<receiver android:name="ExampleAppWidgetProvider" > <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/example_appwidget_info < src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js" type="text/javascript"> < srcsrc="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js" type="text/javascript"> " /> </receiver>
<receiver>元素需要android:name屬性,它指定了App Widget使用的AppWidgetProvider 。
<intent-filter> 元素必須包括一個(gè)含有android:name屬性的<action>元素。該元素指定AppWidgetProvider接受ACTION_APPWIDGET_UPDATE 廣播。這是唯一你必須顯式聲明的廣播。當(dāng)需要的時(shí)候,AppWidgetManager 會(huì)自動(dòng)發(fā)送所有其他App Widget廣播給AppWidgetProvider。
<meta-data> 元素指定了AppWidgetProviderInfo 資源并需要以下屬性:
· android:name – 指定元數(shù)據(jù)名稱。
· android:resource – 指定AppWidgetProviderInfo 資源路徑。
增加AppWidgetProviderInfo元數(shù)據(jù)
AppWidgetProviderInfo定義一個(gè)App Widget的基本特性,比如最小布局尺寸,初始布局資源,刷新頻率,以及(可選的)創(chuàng)建時(shí)加載的一個(gè)配置活動(dòng)。使用單獨(dú)的一個(gè)<appwidget-provider>元素在XML資源里定義AppWidgetProviderInfo 對(duì)象并保存到項(xiàng)目的res/xml/目錄下。
比如:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="294dp" <!-- density-independent pixels --> android:minHeight="72dp" android:updatePeriodMillis="86400000" <!-- once per day --> android:initialLayout="@layout/example_appwidget" android:configure="com.example.android.ExampleAppWidgetConfigure" > </appwidget-provider>
下面是<appwidget-provider>屬性的總結(jié):
· minWidth 和minHeight 屬性的值指定了這個(gè)App Widget布局需要的最小區(qū)域。
缺省的App Widgets所在窗口的桌面位置基于有確切高度和寬度的單元網(wǎng)格。如果App Widget的最小長(zhǎng)寬和這些網(wǎng)格單元的尺寸不匹配,那么這個(gè)App Widget將收縮到最接近的單元尺寸。(參見App Widget Design Guidelines 以獲取更多關(guān)于桌面單元尺寸的信息)
因?yàn)樽烂娌季址较颍ㄓ纱?,單元的尺寸)可以變化,按照拇指?guī)則,你應(yīng)該假設(shè)最壞情況單元尺寸是74像素高和寬。不過,你必須從最后的尺寸中減去2以把像素計(jì)算過程中產(chǎn)生的任何的整數(shù)舍入誤差考慮在內(nèi)。要找到像素密度無關(guān)的最小寬度和高度,使用這個(gè)公式:
(number of cells * 74) - 2
遵循這個(gè)公式,你應(yīng)該使用72dp為每一個(gè)單元高度,294dp為四個(gè)單元寬度。
· updatePerdiodMillis 屬性定義了App Widget框架調(diào)用onUpdate()方法來從AppWidgetProvider請(qǐng)求一次更新的頻度。實(shí)際更新時(shí)間并不那么精確,而且我們建議更新頻率越低越好-也許每小時(shí)不超過一次以節(jié)省電源。你也許還會(huì)允許用戶在配置中調(diào)整這個(gè)頻率-一些人可能想每15分鐘一次股票報(bào)價(jià),或者一天只要四次。
· initialLayout屬性指向定義App Widget布局的資源。
· configure屬性定義了Activity ,當(dāng)用戶添加App Widget時(shí)啟動(dòng),以為他或她配置App Widget特性。這是可選的(閱讀下面的Creating an App Widget Configuration Activity)。
參見AppWidgetProviderInfo 類以獲取更多可以被<appwidget-provider>元素接受的屬性信息。
創(chuàng)建App Widget布局
你必須在XML中為你的App Widget定義一個(gè)初始布局并保存到項(xiàng)目的res/layout/ 目錄下。你可以使用如下所列的視圖對(duì)象來設(shè)計(jì)你的App Widget,但是在此之前,請(qǐng)先閱讀并理解App Widget Design Guidelines.
如果你熟悉在XML中聲明布局,那么創(chuàng)建這個(gè)App Widget布局是很簡(jiǎn)單的。但是,你必須意識(shí)到那個(gè)App Widget布局是基于RemoteViews, 這并不支持所有類型的布局或視圖小部件。
一個(gè)RemoteViews對(duì)象(以及,相應(yīng)的,一個(gè)App Widget)可以支持下面這個(gè)布局類:
· FrameLayout
· LinearLayout
· RelativeLayout
以及下面的小部件類:
· AnalogClock
· Button
· Chronometer
· ImageButton
· ImageView
· ProgressBar
· TextView
不支持這些類的派生。
使用AppWidgetProvider類
你必須通過在清單文件中使用<receiver>元素來聲明你的AppWidgetProvider 類實(shí)現(xiàn)為一個(gè)廣播接收器(參見上面的Declaring an App Widget in the Manifest)。
AppWidgetProvider 類擴(kuò)展BroadcastReceiver 為一個(gè)簡(jiǎn)便類來處理App Widget廣播。AppWidgetProvider只接收和這個(gè)App Widget相關(guān)的事件廣播,比如這個(gè)App Widget被更新,刪除,啟用,以及禁用。當(dāng)這些廣播事件發(fā)生時(shí),AppWidgetProvider 將接收到下面的方法調(diào)用:
onUpdate(Context, AppWidgetManager, int[])
這個(gè)方法調(diào)用來間隔性的更新App Widget,間隔時(shí)間用AppWidgetProviderInfo 里的updatePeriodMillis屬性定義(參見添加AppWidgetProviderInfo元數(shù)據(jù))。這個(gè)方法也會(huì)在用戶添加App Widget時(shí)被調(diào)用,因此它應(yīng)該執(zhí)行基礎(chǔ)的設(shè)置,比如為視圖定義事件處理器并啟動(dòng)一個(gè)臨時(shí)的服務(wù)Service,如果需要的話。但是,如果你已經(jīng)聲明了一個(gè)配置活動(dòng),這個(gè)方法在用戶添加App Widget時(shí)將不會(huì)被調(diào)用,而只在后續(xù)更新時(shí)被調(diào)用。配置活動(dòng)應(yīng)該在配置完成時(shí)負(fù)責(zé)執(zhí)行第一次更新。(參見下面的創(chuàng)建一個(gè)App Widget配置活動(dòng)Creating an App Widget Configuration Activity。)
onDeleted(Context, int[])
當(dāng)App Widget從宿主中刪除時(shí)被調(diào)用。
onEnabled(Context)
當(dāng)一個(gè)App Widget實(shí)例第一次創(chuàng)建時(shí)被調(diào)用。比如,如果用戶添加兩個(gè)你的App Widget實(shí)例,只在第一次被調(diào)用。如果你需要打開一個(gè)新的數(shù)據(jù)庫(kù)或者執(zhí)行其他對(duì)于所有的App Widget實(shí)例只需要發(fā)生一次的設(shè)置,那么這里是完成這個(gè)工作的好地方。
onDisabled(Context)
當(dāng)你的App Widget的最后一個(gè)實(shí)例被從宿主中刪除時(shí)被調(diào)用。你應(yīng)該在onEnabled(Context)中做一些清理工作,比如刪除一個(gè)臨時(shí)的數(shù)據(jù)庫(kù)。
onReceive(Context, Intent)
這個(gè)接收到每個(gè)廣播時(shí)都會(huì)被調(diào)用,而且在上面的回調(diào)函數(shù)之前。你通常不需要實(shí)現(xiàn)這個(gè)方法,因?yàn)槿笔〉腁ppWidgetProvider 實(shí)現(xiàn)過濾所有App Widget 廣播并恰當(dāng)?shù)恼{(diào)用上述方法。
注意: 在Android 1.5中, 有一個(gè)已知問題,onDeleted()方法在該調(diào)用時(shí)不被調(diào)用。為了規(guī)避這個(gè)問題,你可以像Group post中描述的那樣實(shí)現(xiàn)onReceive() 來接收這個(gè)onDeleted()回調(diào)。
最重要的AppWidgetProvider 回調(diào)函數(shù)是onUpdated(), 因?yàn)樗窃诿總€(gè)App Widget添加進(jìn)宿主時(shí)被調(diào)用的(除非你使用一個(gè)配置活動(dòng))。如果你的App Widget 要接受任何用戶交互事件,那么你需要在這個(gè)回調(diào)函數(shù)中注冊(cè)事件處理器。如果你的App Widget不創(chuàng)建臨時(shí)文件或數(shù)據(jù)庫(kù),或者執(zhí)行其它需要清理的工作,那么onUpdated() 可能是你需要定義的唯一的回調(diào)函數(shù)。比如,如果你想要一個(gè)帶一個(gè)按鈕的App Widget,當(dāng)點(diǎn)擊時(shí)啟動(dòng)一個(gè)活動(dòng),你可以使用下面的AppWidgetProvider實(shí)現(xiàn):
public class ExampleAppWidgetProvider extends AppWidgetProvider { public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { final int N = appWidgetIds.length; // Perform this loop procedure for each App Widget that belongs to this provider for (int i=0; i<N; i++) { int appWidgetId = appWidgetIds[i]; // Create an Intent to launch ExampleActivity Intent intent = new Intent(context, ExampleActivity.class); PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0); // Get the layout for the App Widget and attach an on-click listener to the button RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout); views.setOnClickPendingIntent(R.id.button, pendingIntent); // Tell the AppWidgetManager to perform an update on the current App Widget appWidgetManager.updateAppWidget(appWidgetId, views); } } }
這個(gè)AppWidgetProvider 僅定義了onUpdated() 方法,為了定義一個(gè)PendingIntent,來啟動(dòng)一個(gè)活動(dòng)并使用setOnClickPendingIntent(int, PendingIntent)方法把它附著到這個(gè)App Widget的按鈕上。注意它包含了一個(gè)遍歷appWidgetIds中所有項(xiàng)的循環(huán),這是一個(gè)IDs數(shù)組,每個(gè)ID用來標(biāo)識(shí)由這個(gè)Provider創(chuàng)建的一個(gè)App Widget。這樣,如果用戶創(chuàng)建多于一個(gè)這個(gè)App Widget的實(shí)例,那么它們將被同步更新。不過,對(duì)于所有的App Widget實(shí)例,只有一個(gè)updatePeriodMillis 時(shí)間表被管理。比如,如果這個(gè)更新時(shí)間表被定義為每隔兩個(gè)小時(shí),而且App Widget的第二個(gè)實(shí)例是在第一個(gè)后面一小時(shí)添加的,那么它們將按照第一個(gè)所定義的周期來更新而第二個(gè)被忽略(它們將都是每2個(gè)小時(shí)進(jìn)行更新,而不是每小時(shí))。
注意: 因?yàn)檫@個(gè)AppWidgetProvider 是一個(gè)廣播接收器BroadcastReceiver,不能保證你的進(jìn)程在回調(diào)函數(shù)返回后仍然繼續(xù)運(yùn)行(參見應(yīng)用程序基礎(chǔ)>廣播接收器的生命周期Application Fundamentals > Broadcast Receiver Lifecycle以獲取更多信息)。如果你的App Widget設(shè)置過程能持續(xù)幾秒鐘(也許當(dāng)執(zhí)行網(wǎng)頁(yè)請(qǐng)求時(shí))而且你要求你的進(jìn)程繼續(xù),考慮在onUpdated()方法里啟動(dòng)一個(gè)服務(wù)Service 。從這個(gè)服務(wù)里,你可以執(zhí)行自己的App Widget更新,而不必?fù)?dān)心AppWidgetProvider 由于一個(gè)應(yīng)用程序無響應(yīng)錯(cuò)誤Application Not Responding (ANR)而關(guān)閉。參見Wiktionary sample's AppWidgetProvider,這是個(gè)App Widget運(yùn)行一個(gè)Service的例子。
同樣參見ExampleAppWidgetProvider.java 例子類。
接收App Widget廣播意圖
AppWidgetProvider 只是一個(gè)簡(jiǎn)便類。如果你想直接接收App Widget 廣播,你可以實(shí)現(xiàn)自己的BroadcastReceiver 或者重寫 onReceive(Context, Intent) 回調(diào)函數(shù)。你需要注意的4個(gè)意圖如下:
· ACTION_APPWIDGET_UPDATE
· ACTION_APPWIDGET_DELETED
· ACTION_APPWIDGET_ENABLED
· ACTION_APPWIDGET_DISABLED
創(chuàng)建一個(gè)App Widget 配置活動(dòng)
如果你想讓用戶在添加一個(gè)新的App Widget時(shí)調(diào)整設(shè)置,你可以創(chuàng)建一個(gè)App Widget配置活動(dòng)。這個(gè)活動(dòng)將被App Widget宿主自動(dòng)啟動(dòng)并允許用戶在創(chuàng)建時(shí)配置可用的設(shè)置,比如App Widget顏色,尺寸,更新周期或者其它功能設(shè)置。
這個(gè)配置活動(dòng)應(yīng)該在Android清單文件中聲明為一個(gè)通用活動(dòng)。不過,它將被通過ACTION_APPWIDGET_CONFIGURE活動(dòng)而被App Widget宿主啟動(dòng),因此這個(gè)活動(dòng)需要接受這個(gè)意圖。比如:
<activity android:name=".ExampleAppWidgetConfigure"> <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" /> </intent-filter> </activity>
同樣的,活動(dòng)必須在AppWidgetProviderInfo XML 文件中聲明,通過android:configure屬性(參見上面的添加AppWidgetProviderInfo元數(shù)據(jù)Adding the AppWidgetProviderInfo Metadata)。比如,配置活動(dòng)可以聲明如下:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" ... android:configure="com.example.android.ExampleAppWidgetConfigure" ... > </appwidget-provider>
注意這個(gè)活動(dòng)是用全名聲明的,因?yàn)樗鼘哪愕某绦虬獗灰谩?br /> 這就是所有關(guān)于配置活動(dòng)你一開始需要了解的?,F(xiàn)在你需要一個(gè)真實(shí)的活動(dòng)。這兒就有,不過,當(dāng)你實(shí)現(xiàn)這個(gè)活動(dòng)時(shí)記住兩件重要的事情:
• App Widget 宿主調(diào)用配置活動(dòng)而且配置活動(dòng)應(yīng)該總是返回一個(gè)結(jié)果.這個(gè)結(jié)果應(yīng)該包含這個(gè)通過啟動(dòng)該活動(dòng)的意圖傳遞的App Widget ID(以EXTRA_APPWIDGET_ID保存在意圖的附加段Intent extras中)
• 當(dāng)這個(gè) App Widget 被創(chuàng)建時(shí)將不會(huì)調(diào)用onUpdate() 方法(當(dāng)一個(gè)配置活動(dòng)啟動(dòng)時(shí),系統(tǒng)將不會(huì)發(fā)送ACTION_APPWIDGET_UPDATE廣播).配置活動(dòng)應(yīng)該在 App Widget 第一次被創(chuàng)建時(shí)負(fù)責(zé)從AppWidgetManager請(qǐng)求一個(gè)更新.不過, onUpdate() 將在后續(xù)更新中被調(diào)用-只忽略第一次.
參見下面章節(jié)的代碼片斷,該示例說明了如何從配置中返回一個(gè)結(jié)果并更新這個(gè)App Widget.
從配置活動(dòng)中更新一個(gè)App Widget
當(dāng)一個(gè)App Widget使用一個(gè)配置活動(dòng),那么當(dāng)配置結(jié)束時(shí),就應(yīng)該由這個(gè)活動(dòng)來更新這個(gè)App Widget.你可以直接AppWidgetManager里請(qǐng)求一個(gè)更新來這么做.
下面是恰當(dāng)?shù)母翧pp Widget 以及關(guān)閉配置活動(dòng)這個(gè)過程的一個(gè)概要描述:
1. 首先,從啟動(dòng)這個(gè)活動(dòng)的意圖中獲取App Widget ID:
Intent intent = getIntent(); Bundle extras = intent.getExtras(); if (extras != null) { mAppWidgetId = extras.getInt( AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); }
2. 實(shí)施你的App Widget 配置。
3. 當(dāng)配置完成后,通過調(diào)用getInstance(Context)獲取一個(gè)AppWidgetManager實(shí)例:
4. 以一個(gè)RemoteViews布局調(diào)用updateAppWidget(int, RemoteViews)更新App Widget:
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.example_appwidget); appWidgetManager.updateAppWidget(mAppWidgetId, views);
5. 最后,創(chuàng)建返回意圖,設(shè)置活動(dòng)結(jié)果,并結(jié)束這個(gè)活動(dòng):
Intent resultValue = new Intent(); resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, mAppWidgetId); setResult(RESULT_OK, resultValue); finish();
提示: 當(dāng)你的配置活動(dòng)第一次打開時(shí),設(shè)置活動(dòng)結(jié)果為RESULT_CANCELED。這樣,如果用戶在結(jié)束之前從活動(dòng)外返回,這個(gè)App Widget 宿主會(huì)接收到配置取消通知而不會(huì)添加這個(gè)App Widget。
更多關(guān)于Android相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《Android視圖View技巧總結(jié)》、《Android編程之a(chǎn)ctivity操作技巧總結(jié)》、《Android操作SQLite數(shù)據(jù)庫(kù)技巧總結(jié)》、《Android操作json格式數(shù)據(jù)技巧總結(jié)》、《Android數(shù)據(jù)庫(kù)操作技巧總結(jié)》、《Android文件操作技巧匯總》、《Android編程開發(fā)之SD卡操作方法匯總》、《Android開發(fā)入門與進(jìn)階教程》、《Android資源操作技巧匯總》及《Android控件用法總結(jié)》
希望本文所述對(duì)大家Android程序設(shè)計(jì)有所幫助。
- 解析離線安裝Eclipse的Android ADT開發(fā)插件的具體操作(圖文)
- Android實(shí)現(xiàn)QQ搶紅包插件
- Android中微信搶紅包插件原理解析及開發(fā)思路
- 為Android Studio編寫自定義Gradle插件的教程
- 分享Android微信紅包插件
- Android搶紅包插件實(shí)現(xiàn)原理淺析
- Android上使用jspf插件框架的方法
- APP添加CNZZ統(tǒng)計(jì)插件教程 Android版添加phonegap
- Android微信自動(dòng)搶紅包插件優(yōu)化和實(shí)現(xiàn)
- Android系統(tǒng)實(shí)現(xiàn)DroidPlugin插件機(jī)制
相關(guān)文章
Android AIDL實(shí)現(xiàn)兩個(gè)APP間的跨進(jìn)程通信實(shí)例
這篇文章主要為大家詳細(xì)介紹了Android AIDL實(shí)現(xiàn)兩個(gè)APP間的跨進(jìn)程通信實(shí)例,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-04-04Android launcher中模擬按home鍵的實(shí)現(xiàn)
這篇文章主要介紹了Android launcher中模擬按home鍵的實(shí)現(xiàn)的相關(guān)資料,需要的朋友可以參考下2017-05-05Android 在 res/layout 文件夾 下創(chuàng)建一個(gè) 子文件夾實(shí)例
這篇文章主要介紹了Android 在 res/layout 文件夾 下創(chuàng)建一個(gè) 子文件夾實(shí)例,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-03-03Android dataBinding與ListView及事件詳解
這篇文章主要介紹了Android dataBinding與ListView及事件詳解的相關(guān)資料,需要的朋友可以參考下2016-10-10Android中創(chuàng)建快捷方式代碼實(shí)例
這篇文章主要介紹了Android中創(chuàng)建快捷方式代碼實(shí)例,本文分為三個(gè)步驟實(shí)現(xiàn),并分別給出對(duì)應(yīng)實(shí)現(xiàn)代碼,需要的朋友可以參考下2015-04-04Android開發(fā)實(shí)現(xiàn)模仿微信小窗口功能【Dialog對(duì)話框風(fēng)格窗口】
這篇文章主要介紹了Android開發(fā)實(shí)現(xiàn)模仿微信小窗口功能,結(jié)合實(shí)例形式分析了Android實(shí)現(xiàn)微信風(fēng)格Dialog對(duì)話框窗口相關(guān)功能與布局操作技巧,需要的朋友可以參考下2019-03-03Android recyclerview實(shí)現(xiàn)縱向虛線時(shí)間軸的示例代碼
本文主要介紹了Android recyclerview實(shí)現(xiàn)縱向虛線時(shí)間軸的示例代碼,文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-07-07