什么是App Widget?
App Widget是桌面小控件,可以让我们在主屏幕上面放置一些有趣的面板,比如天气插件,时间插件,Wifi开关等实用的小控件。
和App Widget相关的基本概念
1.AppWidgetProviderInfo对象:为AppWidget提供元数据,包括布局、更新频率等数据。这个对象被定义在XMl文件当中。
2.AppWidgetProvider:定义了AppWidget的基本生命周期函数。
创建一个App Widget步骤
1.定义一个新的布局文件example_appwidget.xml,为App Widget指定样式和布局。
2.在res/xml文件夹当中定义xml文件example_appwidget_info.xml,定义AppWidgetProviderInfo,设置元数据格式。
3.创建一个类ExampleAppWidgetProvider继承AppWidgetProvider类并重写下列五个方法:
onUpdate:在到达指定的更新时间之后或者当用户向桌面添加App Widget时会调用该方法。
onDeleted:当App Widget被删除时,会调用该方法。
onEnabled:当第一个App Widget的实例第一次被创建时,会调用该方法。(如果创建多个App Widget则只调用一次该方法)
onDisabled:当最后一个App Widget实例被删除后,会调用该方法。
onReceive:接收广播事件。
4.在AndroidManifest文件中注册reciver。
example_appwidget.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/widgetTextId"
android:text="第一个WidgetText"
android:background="#000000"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
</LinearLayout>
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="200dp"
android:minHeight="70dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/example_appwidget">
</appwidget-provider>
package com.mycompany.appwidget;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
public class ExampleAppWidgetProvider extends AppWidgetProvider{
// 在到达指定的更新时间之后或者当用户向桌面添加App Widget时调用
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
System.out.println("------>onUpdate");
}
// 当App Widget被删除时调用
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
System.out.println("------>onDeleted");
}
// 当第一个App Widget的实例第一次被创建时调用
@Override
public void onEnabled(Context context) {
super.onEnabled(context);
System.out.println("------>onEnabled");
}
// 当最后一个App Widget实例被删除后调用
@Override
public void onDisabled(Context context) {
super.onDisabled(context);
System.out.println("------>onDisabled");
}
// 接收广播事件
@Override
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
}
}
AndroidManifest.xml:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.mycompany.appwidget">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name=".ExampleAppWidgetProvider">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/example_appwidget_info"/>
</receiver>
</application>
</manifest>