Android 桌面Widget (小组件)开发详解

Widget就是个桌面小组件，有了Widget，我们可以直接在桌面上进行各种操作。
Widget使用

AndroidManifest中声明AppWidget
xml中定义AppWidget配置文件
layout中定义Widget布局文件
创建类继承AppWidgetProvider类

1.AndroidManifest.xml配置

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.xinrui.fristwidget">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <!-- 声明widget对应的AppWidgetProvider -->
        <!--<receiver android:name=".ExampleAppWidgetProvider" >-->
            <!--<intent-filter>-->
                <!--<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />-->
                <!--<action android:name="com.xinrui.fristwidget.UPDATE_ALL"/>-->
            <!--</intent-filter>-->
            <!--<meta-data android:name="android.appwidget.provider"-->
                <!--android:resource="@xml/example_appwidget_info" />-->
        <!--</receiver>-->

        <!--<service android:name=".ExampleAppWidgetService" >-->
            <!--<intent-filter>-->
                <!--<action android:name="android.appwidget.action.EXAMPLE_APP_WIDGET_SERVICE" />-->
            <!--</intent-filter>-->
        <!--</service>-->
        <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=".MyWidget">

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

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

</manifest>

2.res 的xml下创建appwidget_info.xml

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/main_activity"
    android:minHeight="180dp"
    android:minWidth="350dp"
    android:previewImage="@drawable/preview"
    android:updatePeriodMillis="8640000"
    android:widgetCategory="home_screen|keyguard">

</appwidget-provider>
    <!--

    initialLayout :  widget 的布局文件
     minHeight： widget  的 最低高度
     minWidth : widget  的最低高度
     previewImage ： widget 的预览图
     android:updatePeriodMillis ： 更新的频率  google 规定最小时间30 min
                                  在这里设置 0 我们自定义
     widgetCategory ： widget 可以被添加主屏幕或者锁屏
    -->

3.layout下创建布局文件

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

    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center_vertical"
        android:orientation="horizontal"
        android:paddingLeft="30dp"
        android:paddingRight="30dp">

        <LinearLayout
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:orientation="vertical">

            <TextView
                android:id="@+id/tv_date"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:textColor="#000"
                android:text="日期："
                android:textSize="16sp" />

            <TextView
                android:id="@+id/tv_money"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:textColor="#000"
                android:text="毫秒值："
                android:textSize="16sp" />

        </LinearLayout>

        <Button
            android:id="@+id/btn_refound"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="点击"
            android:textColor="#000"
            android:textSize="16sp" />

    </LinearLayout>

</LinearLayout>

4.provider的创建

package com.xinrui.fristwidget;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;

public class MyWidget extends AppWidgetProvider {
    String TAG = "MyWidget：" ;
    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        Log.i(TAG ,"接受广播");
    }

    /**
     * 第一个widget被添加调用
     * @param context
     */
    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
        Log.i(TAG ,"widget  onEnabled 状态");
        context.startService(new Intent(context, WidgetService.class));

    }

    /**
     * widget被添加 || 更新时调用
     * @param context
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        Log.i(TAG ,"widget  onUpdate 状态");
        context.startService(new Intent(context, WidgetService.class));
    }

    /**
     * 最后一个widget被删除时调用
     * @param context
     */
    @Override
    public void onDisabled(Context context) {
        super.onDisabled(context);
        Log.i(TAG ,"widget  onDisabled 状态");
        context.stopService(new Intent(context, WidgetService.class));
    }

    /**
     * widget被删除时调用
     * @param context
     * @param appWidgetIds
     */
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        super.onDeleted(context, appWidgetIds);
        Log.i(TAG ,"widget  onDeleted 状态");

    }
}

5.service的创建

package com.xinrui.fristwidget;

import android.app.PendingIntent;
import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.os.IBinder;
import android.support.annotation.Nullable;
import android.util.Log;
import android.widget.RemoteViews;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Timer;
import java.util.TimerTask;

public class WidgetService  extends Service {

    String  TAG = "WidgetService ";
    private Timer mTimer;
    private SimpleDateFormat mFormat;

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        Log.i(TAG,"onBind");
        return null;
    }

    @Override
    public void onCreate() {
        super.onCreate();

        mFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        mTimer = new Timer();
        mTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                Log.i(TAG,"更新 widget");
                updateWidget(WidgetService.this);  //更新 widget
            }
        }, 0, 1000);

    }

    private void updateWidget(Context context) {

        //通过 RemoteViews 加载布局文件
        //通过 setTextView 等方法实现对控件的控制
        RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.main_activity);
        long millis = System.currentTimeMillis();
        String format = mFormat.format(new Date(millis));
        Log.i(TAG,"millis :" + millis + "\n"
                         + "format: " + format);
        remoteViews.setTextViewText(R.id.tv_date, "日  期：" + format);
        remoteViews.setTextViewText(R.id.tv_money, "毫秒值：" + millis);

        PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, new Intent(this, MainActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
        remoteViews.setOnClickPendingIntent(R.id.btn_refound, pendingIntent);   //点击跳转

        ComponentName componentName = new ComponentName(this, MyWidget.class);
        AppWidgetManager.getInstance(this).updateAppWidget(componentName, remoteViews);

    }


    @Override
    public void onDestroy() {
        super.onDestroy();

        mTimer.cancel();
        mTimer = null;
Log.i(TAG,"onDestory");
    }


    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        return START_STICKY;
    }

}

6.MainActivity

package com.xinrui.fristwidget;

import android.app.Activity;
import android.os.Bundle;

import android.util.Log;

public class MainActivity extends Activity {
    String TAG  = "MainActivity ";
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main_activity);
    }
}

简单的一个widget小组件就这样实现了