一、在Manifast.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" />
</receiver>
receiver name 屬性為自定義的類,需繼承 AppWidgetProvider,resource 屬性指明AppWidgetProviderInfo所在的檔案位置;該類對小部件的基本屬性做定義。
二、在res檔案夾下建立xml檔案夾,建立metadata resource屬性指定的檔案:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="40dp"
android:minHeight="40dp"
android:updatePeriodMillis="86400000"
android:previewImage="@drawable/preview"
android:initialLayout="@layout/example_appwidget"
android:configure="com.example.android.ExampleAppWidgetConfigure"
android:resizeMode="horizontal|vertical"
android:widgetCategory="home_screen">
</appwidget-provider>
minWidth與minHeight屬性表示了App Widget所需的最小布局區域。
updatePeriodMillis屬性定義了App
Widget架構調用AppWidgetProvider的onUpdate方法的頻率。
linitialLayout屬性辨別了初始布局檔案。
configure屬性定義了當使用者添加App Widget時調用的Activity。(這是可選的)
previewImage定義了App Widget的縮略圖,當使用者從widget清單中選擇時,顯示的就是這張圖。如果沒設定,使用者将看見的是你的應用的預設圖示。
resizeMode屬性辨別了widget重新布局的規則。
三、在layout檔案夾下建立initialLayout屬性值指定的xml檔案,定義widget的布局:
<FrameLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="@dimen/widget_margin">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
android:background="@drawable/my_widget_background">
…
</LinearLayout>
</FrameLayout>
四、實作自定義的AppWidgetProvider類,覆寫其中的方法:
onEnabled():小部件第一次建立的時候調用;
onUpdate():小部件更新時調用,如使用者添加小部件的時候,指定的更新時間到的時候;
onDeleted():删除一個小部件時調用;
onDisabled():最後一個小部件被删除時調用。