Android 自定义桌面空间 AppWidget

本篇文章主要是记录自己学习Android自定义桌面悬浮控件，AppWidget的过程。

现在很多App都支持悬浮桌面的控件，我们可以通过系统菜单长按，或者别的方式来设置，例如自带的备忘录，就可以写完后挂在手机桌面上。
现在我们看看运行效果：

在安装应用后，设置桌面悬浮的时候会看到我们刚才安装的应用：

然后我们点击这个控件，让他显示在桌面上：

可以看到他已经现在我们桌面上了，而且长按可以拖动摆放他的位置。

现在来记录一下学习过程，
一.设置简单的自定义桌面控件:

1.在Layout下新建widget_setting.xml文件，用于设置桌面控件属性:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:initialLayout="@layout/layout_widget"
    android:minHeight="140dp"
    android:minWidth="140dp"
    android:previewImage="@mipmap/ic_launcher"
    android:updatePeriodMillis="20000"
    android:widgetCategory="home_screen"
    >
</appwidget-provider>

这里面设置了minHeight minWidth 和previreImage还有他的update函数时间间隔。

2.设计自己的AppWidget界面:

layout_widget.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">
   <LinearLayout
       android:orientation="horizontal"
       android:layout_width="match_parent"
       android:layout_height="wrap_content">
    <ImageView
        android:id="@+id/iamge_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@mipmap/ic_launcher"/>
    <Button
        android:id="@+id/btn"
        android:textAllCaps="false"
        android:text="sure"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
   </LinearLayout>
    <TextView
        android:id="@+id/text_view"
        android:textSize="20sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

这里我们的界面设计就是图二显示在桌面上的布局设计。

3.建立TestWidget类继承自AppWidgetProvider并且建立服务并且按时更新界面
就和广播一样，我们需要实现其方法onReceive;
在AppWidgetManager中有很多系统广播，例如ACTION_APPWIDGET_UPDATE,
ACTION_APPWIDGET_DELETED
等，会在桌面控件更新，创建，和删除时候发出广播给广播接收器，我们可以在里面做一些操作。

TestWidget.java

public class TestWedigt extends AppWidgetProvider {
    private static final String WIDGET_BTN_ACTION = "WIDGET_BTN_ACTION";
    private static final int UPDATE_DURATION = 2 * 1000;
    private PendingIntent pendingIntent = null;
   static  int time =0;
    private WedigetService service  ;
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        String action = intent.getAction();//获取到广播的Action
        if(intent!=null&& TextUtils.equals(intent.getAction(),WIDGET_BTN_ACTION))//广播的Action为按钮按下
        {
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);//注意：需要【重新】构造一个RemoteViewstime++;
            remoteViews.setTextViewText(R.id.text_view,"Hello Andoird"+time);
            remoteViews.setTextColor(R.id.text_view, Color.GRAY);
            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);// 单例模式
            ComponentName componentName = new ComponentName(context,TestWedigt.class);
            appWidgetManager.updateAppWidget(componentName, remoteViews);//setText之后，记得更新一下,传入自定义界面
        }
        if(AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)){//广播为更新广播
            Bundle bundle = intent.getExtras();
            if(bundle!=null){
                int[] appWidgetIds = bundle.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);
                if( appWidgetIds!=null&&appWidgetIds.length>0){
                    this.onUpdate(context,AppWidgetManager.getInstance(context),appWidgetIds);
                }
            }
        }else if(AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)){//广播为删除控件广播
            Bundle bundle =  intent.getExtras();
            if(bundle!=null&&bundle.containsKey(AppWidgetManager.EXTRA_APPWIDGET_ID)){
                final int appWidgetIds = bundle.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID);
                this.onDeleted(context,new int[]{appWidgetIds});
            }
        }
    }
/*
* 重写onUpdate方法，
* */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
        Intent intent = new Intent();
        intent.setClass(context, TestWedigt.class);
        intent.setAction(WIDGET_BTN_ACTION);//设置广播Action为BuutonAction
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
        remoteViews.setOnClickPendingIntent(R.id.btn, pendingIntent);//设置按钮的点击监听
        appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
        context.startService(new Intent(context, WedigetService.class));//开启服务
    }

}

因为AppWidget的更新时间系统有个默认值，好像是二三十分钟，所以我们为了实现到时间自动更新，我们就要自己设置。但是在widget_setting我们设置的那个时间间隔，是不起作用的，所以我们需要通过服务来达到计时，到时间，然后更新界面的操作，这样一直循环。
我们这个类里面，还设置了界面中Button的监听事件，通过发送广播并且设置Action然后在onReceive中接受广播，判断Action的方法来设置监听。

 RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
        Intent intent = new Intent();
        intent.setClass(context, TestWedigt.class);
        intent.setAction(WIDGET_BTN_ACTION);//设置广播Action为BuutonAction
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
        remoteViews.setOnClickPendingIntent(R.id.btn, pendingIntent);//设置按钮的点击监听

 public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        String action = intent.getAction();//获取到广播的Action
        if(intent!=null&& TextUtils.equals(intent.getAction(),WIDGET_BTN_ACTION))//广播的Action为按钮按下
        {
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);//注意：需要【重新】构造一个RemoteViewstime++;
            remoteViews.setTextViewText(R.id.text_view,"Hello Andoird"+time);
            remoteViews.setTextColor(R.id.text_view, Color.GRAY);
            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);// 单例模式
            ComponentName componentName = new ComponentName(context,TestWedigt.class);
            appWidgetManager.updateAppWidget(componentName, remoteViews);//setText之后，记得更新一下,传入自定义界面
        }

下面看看服务类

WeidgetService.java

public class WedigetService extends Service {

    static int time=0;
    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
/*
*    每次重复启动服务后，后会调用这个方法。
* */
    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {

        time++;
        buildUpdate();
        AlarmManager alarmManager = (AlarmManager) getSystemService(Context.ALARM_SERVICE);
        Intent i = new Intent(this,WedigetService.class);
        long cuutime = SystemClock.elapsedRealtime()+1000;//时间间隔
        PendingIntent pi = PendingIntent.getService(this,0,i,0);
        alarmManager.setExact(AlarmManager.ELAPSED_REALTIME_WAKEUP,cuutime,pi);//设置Alarm然后到时间再次启动服务，达成循环目的。
        return super.onStartCommand(intent, flags, startId);
    }
    /*
    * 更新控件的数据
    * */
    private void buildUpdate() {
        RemoteViews view = new RemoteViews(getPackageName(), R.layout.layout_widget);
        RemoteViews remoteViews = new RemoteViews(getApplicationContext().getPackageName(), R.layout.layout_widget);
        remoteViews.setTextViewText(R.id.text_view,""+time);
        AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(getBaseContext());
        appWidgetManager.updateAppWidget(new ComponentName(getBaseContext(), TestWedigt.class), remoteViews);
    }
}

这里面没什么东西，主要就是在多次启动服务的时候会重复调用onStartCommand方法，
所以我们在onStartCommand里，设置了Alarm，然后设定时间间隔，每次到达时间后就进行更新界面操作和服务自启动操作，这样就可以让服务一直运行并且自己到达时间后更新界面的目的。

4.添加注册。
我们需要注册服务和我们刚才写的TestWidget.

    <receiver android:name=".TestWedigt">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@layout/widget_setting"
                ></meta-data>
        </receiver>
        <service android:name=".WedigetService">
        </service>

<meta-data
                android:name="android.appwidget.provider"
                android:resource="@layout/widget_setting"
                ></meta-data>

要注意这里的写法哦。