Android_UI：AppWidget

介绍

AppWidgetProvider继承自BroadcastReceiver

必须的3个元素：
AppWidgetProvider+AppWidgetProviderInfo+layout
步骤：
1. 创建类继承AppWidgetProvider
2. 在res/xml下创建文件my_appwidget_info.xml（文件名随意）
3. 创建AppWidget的layout
4. 在AndroidManifest.xml中添加已创建的AppWidgetProvider

Demo:https://git.oschina.net/AndroidUI/AppWidget01.git

步骤

Step1: AppWidgetProvider

public class MyAppWidgetProvider extends AppWidgetProvider {    
    //可以什么都不用写
}

Step2: AppWidgetProviderInfo

res/xml/my_appwidget_info.xm

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/layout_appwidget"
    android:minHeight="50dp"
    android:minWidth="100dp"
    android:previewImage="@mipmap/ic_launcher"
    android:resizeMode="horizontal|vertical"
    android:updatePeriodMillis="60000"
    android:widgetCategory="home_screen"/>

Step3: View layout

res/layout/layout_appwidget：

<?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">

    <TextView
        android:id="@+id/tv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@color/colorPrimaryDark"
        android:gravity="center"
        android:maxLines="1"
        android:text=""
        android:textColor="@android:color/white"/>

</LinearLayout>

Step4: 在AndroidManifest.xml注册

<receiver android:name=".MyAppWidgetProvider">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/my_appwidget_info" />
</receiver>

其它

AppWidgetProvider的声明周期

public class MyAppWidgetProvider extends AppWidgetProvider {

    public MyAppWidgetProvider() {
        super();
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        LogUtil.d("onReceive");
    }

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        LogUtil.d("onUpdate");
    }

    @Override
    public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
        super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
        LogUtil.d("onAppWidgetOptionsChanged");
    }

    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        super.onDeleted(context, appWidgetIds);
        LogUtil.d("onDeleted");
    }

    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
        LogUtil.d("onEnabled");
    }

    @Override
    public void onDisabled(Context context) {
        super.onDisabled(context);
        LogUtil.d("onDisabled");

    }

    @Override
    public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
        super.onRestored(context, oldWidgetIds, newWidgetIds);
        LogUtil.d("onRestored");
    }
}

定时更新AppWidget

WidgetService

android:updatePeriodMillis="6000"是无效的，一般采用Service+Timer实现定时更新。
如我们让AppWidget显示时间，每隔一秒更新一次。

public class WidgetService extends Service {

    private Timer timer;

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }

    @Override
    public void onCreate() {
        super.onCreate();
        timer = new Timer();

        TimerTask task = new TimerTask() {
            @Override
            public void run() {
                SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
                Date date = new Date();

                RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.layout_appwidget);
                remoteViews.setTextViewText(R.id.tv, format.format(date));
                Intent intent = new Intent();
                intent.setAction("com.cqc.appwidget01.action.UPDATE");
                PendingIntent pendingIntent = PendingIntent.getBroadcast(getBaseContext(), 0, intent, 0);
                remoteViews.setOnClickPendingIntent(R.id.tv, pendingIntent);
                //注意：第二个参数是MyAppWidgetProvider
                ComponentName name = new ComponentName(getPackageName(), "com.cqc.appwidget01.MyAppWidgetProvider");
                AppWidgetManager.getInstance(getBaseContext()).updateAppWidget(name, remoteViews);
            }
        };
        timer.schedule(task, 0, 1000);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        if (timer != null) {
            timer.cancel();
            timer = null;
        }
    }
}

不要忘记在AndroidManifest.xml注册

<service android:name=".WidgetService"/>

下面介绍如何更新AppWidget
用RemoteViews展示布局

RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.layout_appwidget);

设置文字

remoteViews.setTextViewText(R.id.tv, format.format(date));

创建PendingIntent

Intent intent = new Intent();
intent.setAction("com.cqc.appwidget01.action.UPDATE");
PendingIntent pendingIntent = PendingIntent.getBroadcast(getBaseContext(), 0, intent, 0);

给RemoteViews中的view设置点击事件

remoteViews.setOnClickPendingIntent(R.id.tv, pendingIntent);

创建ComponentName

ComponentName name = new ComponentName(getPackageName(), "com.cqc.appwidget01.MyAppWidgetProvider");

更新AppWidget

AppWidgetManager.getInstance(getBaseContext()).updateAppWidget(name, remoteViews);

AppwidgetClickReceiver

点击AppWidget后，在广播中收到消息。

public class AppwidgetClickReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        LogUtil.d("点击事件");
    }
}

注册：

<receiver android:name=".AppwidgetClickReceiver">
    <intent-filter>
        <action android:name="com.cqc.appwidget01.action.UPDATE"/>
    </intent-filter>
</receiver>