什麼是AppWidget?AppWidget就是我們平常在案頭上見到的那種一個個的小視窗,利用這個小視窗可以給使用者提供一些方便快捷的操作。
今天的目標就是怎麼建立一個簡單的AppWidget。
首先我先把目錄結構展示一下,方便大家理解。
第一步:我們需要在res目錄下建立一個folder,可以命名為xml(但這並不是必須的,你也可以換成你喜歡的名字)。然後在這麼目錄下建立一個xml檔案。我的appwidget.xml檔案代碼如下:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minHeight="72dp" android:minWidth="294dp" android:updatePeriodMillis="86400000" android:initialLayout="@layout/example_widget" ></appwidget-provider>
小註解:
在android的命名空間下聲明了appwidget 的最小的高度、寬度、以及更新的時間(注意是以毫秒為單位的)和最重要的綁定的布局檔案(所謂布局檔案就是展示到案頭上的介面的外觀)。
第二步:下面的這個檔案是在上面的appwidget.xml中的initialLayout屬性中綁定的xml布局檔案,即example_widget.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="vertical" > <TextView android:id="@+id/textview1" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="MyFirst Widget Example!" > </TextView> <!--由於只是實現簡單的效果,所以就只用一個TextView吧--></LinearLayout>
第三步:實現了布局展示介面,下面自然而然的,我們就會想到要怎麼讓這個布局介面展示出來,所以就必須有一個provider,因此,下面就需要建立一個繼承了AppWidgetProvider的執行個體,來完成這一個功能。我的檔案名稱命名為Widget.java.
package com.summer.widgettest;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.Context;/***在這四個必須的方法中,只是列印出一句話,來觀察其“生命週期”即可*/public class Widget extends AppWidgetProvider { @Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { // TODO Auto-generated method stub System.out.println("onUpdate"); super.onUpdate(context, appWidgetManager, appWidgetIds);} @Override public void onDeleted(Context context, int[] appWidgetIds) { // TODO Auto-generated method stub System.out.println("onDeleted"); super.onDeleted(context, appWidgetIds); } @Override public void onDisabled(Context context) { // TODO Auto-generated method stub System.out.println("onDisabled"); super.onDisabled(context); } @Override public void onEnabled(Context context) { // TODO Auto-generated method stub System.out.println("onEnabled"); super.onEnabled(context); }}
第四步:這也是最為關鍵的一步,因為前面的工作都是為這一步來打基礎的。那麼要怎麼做捏?答案就是資訊清單檔,在資訊清單檔中進行聲明就可以了。My Code如下:
<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.summer.widgettest" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="18" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="com.summer.widgettest.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="com.summer.widgettest.Widget"> <intent-filter > <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_info"/> </receiver> </application></manifest>
小註解:
在這裡我麼也不難看出,原來widget也就是個廣播事件啊,所以需要使用receiver ,然後接下來是一個inent-filter過濾器,功能就是過濾出符合要求的action,在這裡當然是widget動作了。
接下來有一個meta-data中繼資料解釋,作用就是對這個widget進行解釋的作用,也是為了讓android系統知道這到底是個什麼東西。(偷偷告訴你,一般這兩個要點是固定的表達)
好了,萬事具備,只欠”運行“了,接下來就是程式運行之後的介面。。上面的那一行文字就是程式運行之後
就可以看到的結果,也就是我們”自製“的一個AppWidget了。(說實話,真的是不太好看)。
回顧與總結:
1、怎麼實現的這個AppWidget?先是在res檔案夾下建立一個xml 檔案夾,並在裡面添加一個appwidget-provider檔案,再就是寫一個用於呈現內容的布局檔案。接下來就是一個繼承自AppWidgetProvider的類的建立,然後再資訊清單檔中進行相關項目的聲明就可以了。
2、邏輯思路很重要,每一步的銜接是思路的引導點。
3、這裡僅僅是一個簡單的小例子,接下來要做的就是如何讓這個widget和我們的系統進行互動。
4、好了,大致就是這樣,歡迎廣大博友留言評論,我一定會虛心的接受,希望能和你們一起進步!
—————————–這裡是華麗的分界線——————
上面的是建立一個簡單的appWidget的樣本,下面是關於如何?這些Widget如何?相關的動作偵聽的。
知識點準備:
我們應該知道的是,android的widget的進程與程式啟動並執行進程並不是同一個進程,這就意味著我們不能像往常一樣簡單的使用一個setOnClickListener方法了,因為這樣做是完不成相關的動作的偵聽的功能的。那麼問題來了,我們要怎麼實現這些動作的互動呢?
別著急,答案是採用RemoteViews,顧名思義就是採用”遠端“方式來實現相關的處理操作。接下來讓我們一起來看一下具體的實現流程吧。--------------------------------------------------------------------------------
第一步:在之前的appWidget的布局檔案中添加一個按鈕,用來實現布局。
<Button android:id="@+id/button1" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="Click To Renew!" > </Button>
第二步:然後再Widget.java這個AppWidgetProvider的實作類別的onUpdate方法中實現相關的代碼。為了更好地展示效果,我們可以建立一個Activity,用來呈現點擊按鈕之後跳轉的介面的展示。我命名為RenewActivity.java.相關源碼如下所示
@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { // TODO Auto-generated method stub System.out.println("onUpdate"); for(int i=0;i<appWidgetIds.length;i++){ //check which appwidget is enabled! System.out.println(appWidgetIds[i]); Intent intent=new Intent(context,RenewActivity.class); PendingIntent pendingIntent=PendingIntent.getActivity(context, 0, intent, 0); RemoteViews remoteViews=new RemoteViews(context.getPackageName(), R.layout.example_widget); remoteViews.setOnClickPendingIntent(R.id.button1, pendingIntent); appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews); } super.onUpdate(context, appWidgetManager, appWidgetIds);}RenewActivity.javapackage com.summer.widgettest;import android.app.Activity;import android.os.Bundle;public class RenewActivity extends Activity{ @Override protected void onCreate(Bundle savedInstanceState) { // TODO Auto-generated method stub super.onCreate(savedInstanceState); setContentView(R.layout.renew); } //由於renew布局是一個非常簡單的介面(一個TextView而已),所以不再貼出代碼}
第三步:不要忘記在資訊清單檔中進行Activity的聲明,否則你是看不到介面的效果的。
<activity android:name="com.summer.widgettest.RenewActivity" android:label="Renew Activity!" ></activity>
效果圖如下所示:
小總結:
在Widget的onUpdate方法中,我們使用到了RemoteViews類的執行個體,起作用就不再詳細的闡述,這裡就直接解釋代碼的功能吧。如上,建立其執行個體的時候需要兩個參數分別為內容物件的包名和widget的”布局“,然後在進行對按鈕的時間偵聽的時候使用到了一個叫pendingIntent的執行個體,其作用就是將遠端訊息資訊傳達給相應的處理邏輯中,進而實現對widget上按鈕的動作的偵聽處理。然後使用appWidgetManager進行更新操作就可以了!如此便可以完成我們的代碼的邏輯。
以上就是本文的全部內容,希望對大家的學習有所協助,也希望大家多多支援雲棲社區。