Android的桌面小图标Widget的学习

android提供向桌面上放置一个远程布局的功能。最近学了一下，在这里记录一下学习笔记。

public class MyWidget extends AppWidgetProvider{
    public static String TAG = "MyWidget";
    @Override
    public void onReceive(Context context, Intent intent) {
        Log.i(TAG, "onReceive: ");
        super.onReceive(context, intent);
    }

    @Override
    public void onEnabled(Context context) {
        Log.i(TAG, "onEnabled: ");
        super.onEnabled(context);
    }

    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        Log.i(TAG, "onDeleted: ");
        super.onDeleted(context, appWidgetIds);
    }

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        Log.i(TAG, "onUpdate: ");
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

    @Override
    public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
        Log.i(TAG, "onRestored: ");
        super.onRestored(context, oldWidgetIds, newWidgetIds);
    }

    @Override
    public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
        Log.i(TAG, "onAppWidgetOptionsChanged: ");
        super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
    }

    @Override
    public void onDisabled(Context context) {
        Log.i(TAG, "onDisabled: ");
        super.onDisabled(context);
    }
}

1，首先要建一个类MyWidget继承AppWidgetProvider，通过查看他的源码可以知道它是一个BroadcastReceiver。所以要在清单文件当中注册。

它的action为：android.appwidget.action.APPWIDGET_UPDATE。 

<receiver android:name=".MyWidget"
    android:icon="@mipmap/desk_play"
    android:label="音乐">
    <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>

<meta-data>元素中定义了Widget的AppWidgetInfo的信息。appwidget_info.xml文件在res/xml文件夹下。内容是：

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:updatePeriodMillis="86400000"
    android:previewImage="@drawable/play_ic"
    android:initialLayout="@layout/my_widget"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen|keyguard">
</appwidget-provider>
<!--
<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|keyguard"
    android:initialKeyguardLayout="@layout/example_keyguard">
</appwidget-provider>
minWidth和minHeight是widget在桌面上的的最小的宽高
updatePeriodMillis是Widget的刷新时间，单位是：ms。如果要是需要频繁的更新。可以用AlarmManager，并且设置Type为ELAPSED_REALTIME或者RTC。
initialLayout是一个布局就是Widget的布局。
configure的是一个Activity。当向桌面上添加Widget的时候就会启动，用来提示这个Widget的作用
previewImage是当选择该Widget添加到桌面的时候的的显示图片。拖动widget向桌面的图片
resizeMode是widget在桌面上调整大小的时候的模式，水平方向，垂直方向。
widgetCategory是widget显示的位置，桌面或锁屏的界面
initialKeyguardLayout是锁屏的时候的显示布局
-->

然后就可以在布局文件当中设置widget的显示布局。在Widget的布局要依赖RemoteViews ，RemoteViews对指定的控件进行支持

<?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"
    android:background="@drawable/play_ic">

</LinearLayout>
<!--
Widget的布局中只支持一下的布局和控件。不支持这些控件的子类是不支持的：
FrameLayout
LinearLayout
RelativeLayout
GridLayout
AnalogClock
Button
Chronometer
ImageButton
ImageView
ProgressBar
TextView
ViewFlipper
ListView
GridView
StackView
AdapterViewFlipper
-->

做完这些就可以在桌面上添加Widget了。

2，Widget的生命周期。

第一次创建一个Widget：
04-03 10:26:13.416 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:26:13.416 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onEnabled: 
04-03 10:26:13.416 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:26:13.420 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onUpdate: 
第二次创建一个Widget：
04-03 10:26:39.515 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:26:39.515 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onUpdate: 
第三次创建一个Widget
04-03 10:29:07.485 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:29:07.485 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onUpdate:
修改Widget在桌面上的大小的时候
04-03 10:30:09.057 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:30:09.057 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onAppWidgetOptionsChanged: 
移除一个Widget
04-03 10:30:34.692 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:30:34.692 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onDeleted: 
再移除一个：
04-03 10:30:34.692 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:30:34.692 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onDeleted: 
当最后一个被移除的时候：
04-03 10:31:44.211 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:31:44.211 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onDeleted: 
04-03 10:31:44.219 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onReceive: 
04-03 10:31:44.219 1300-1300/com.example.yyw.appwidgetdemo I/MyWidget: onDisabled:

从上面的log可以看出：

onReceive在每一次的创建和移除都会调用。

onEnabled只有在第一的时候才会调用。

onUpdate在每次创建都会调用的。而且在android：updatePeriodMillis的时间到的时候也会调用。

onDeleted在每次移除一个Widget的时候会被调用。

onDisabled在全部移除Widget的时候会调用到。

onAppWidgetOptionsChanged会在改变Widget大小的时候调用。

3，添加桌面view的点击事件。

 @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        for (int id : appWidgetIds ) {
            Log.i(TAG, "onUpdate: " + id);
            AppWidgetManager am = AppWidgetManager.getInstance(context);
            //Widget是在其他应用上面显示的所以要用RemoteViews来管理
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.my_widget);
            Intent intent = new Intent(context,MainActivity.class);
            PendingIntent pendingIntent = PendingIntent.getActivity(context,2016,intent,0);
            //设置点击图片的点击事件，打开一个Activity
            remoteViews.setOnClickPendingIntent(R.id.iv,pendingIntent);
            //把Widget更新
            am.updateAppWidget(id,remoteViews);
        }
//
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

用PendingIntent做为管理点击事件的的处理事件，可以打开Activity，service，broadcast。