• 首先感谢这篇博客的博主,通过他的博客才学会的如何使用小组件。
  • 效果图如下
  • android桌面天气小部件 手机4x2桌面天气小插件_ui

  • 关于小组件的原理已经在 UI控件–桌面小组件(1)介绍过了,又需要的自行去浏览。

1.在res/xml下创建配置文件appwidget_provider.xml

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="250dp"
    android:minHeight="50dp"
    android:updatePeriodMillis="86400000"
    android:initialLayout="@layout/layout_widget">
</appwidget-provider>

2.配置文件布局appwidget_provider.xml

  • 布局就是简单的相对布局和线性布局的简单组合

android桌面天气小部件 手机4x2桌面天气小插件_ui_02

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/widget_bg"
    android:orientation="vertical"
    android:padding="5dp">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true">

        <TextView
            android:id="@+id/textView_widget_time"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="10:25"
            android:textColor="@color/colorWhite"
            android:textSize="50dp" />

        <ImageView
            android:id="@+id/imageView_widget_location"
            android:layout_width="15dp"
            android:layout_height="15dp"
            android:layout_below="@+id/textView_widget_time"
            android:layout_marginLeft="10dp"
            android:layout_marginTop="3dp"
            android:src="@mipmap/widget_local" />

        <TextView
            android:id="@+id/textView_widget_location"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_below="@+id/textView_widget_time"
            android:layout_toRightOf="@+id/imageView_widget_location"
            android:text="位置"
            android:textColor="@color/colorWhite"
            android:textSize="15dp" />


        <ImageView
            android:id="@+id/imageView_widget_weather_ic1"
            android:layout_width="50dp"
            android:layout_height="50dp"
            android:layout_centerHorizontal="true"
            android:layout_marginTop="20dp"
            android:src="@mipmap/wind_power_pic" />


        <TextView
            android:id="@+id/textView_widget_avgTemp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_marginTop="5dp"
            android:text="30℃ 阴"
            android:textColor="@color/colorWhite"
            android:textSize="20dp" />

        <TextView
            android:id="@+id/textView_widget_lowHighTemp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_below="@+id/textView_widget_avgTemp"
            android:text="18/30℃"
            android:textColor="@color/colorWhite"
            android:textSize="20dp" />

        <TextView
            android:id="@+id/textView_widget_date"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_below="@+id/textView_widget_lowHighTemp"
            android:text="4-24 星期日"
            android:textColor="@color/colorWhite"
            android:textSize="20dp" />
    </RelativeLayout>

</RelativeLayout>

通过扩展系统类AppWidgetProvider来实现,主要是重写里面的函数来完成你所需要的功能。

  • 这一部分是重点
  • 由于这个组件是我写的一个天气相关的小软件里的,所以里面会有一些从数据库获取的数据操作,不过大体给相对控件设置内容的操作都是一个原理。
public class MyWedget01 extends AppWidgetProvider {
    //这些是我的数数据库的获取数据的实例
    private CoolWeatherDB coolWeatherDB;
    private List<CountyWeather> listWeather;

    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
    }
    //初始化我的数据库相关的实例
    private void initDB(Context context) {
        coolWeatherDB = CoolWeatherDB.newInstance(context);
        listWeather = coolWeatherDB.loadCountyWeather();
    }

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

    //update是我用来更新小组件上内容提取的一个方法
    private void updateMywidget(Context context, AppWidgetManager appWidgetManager) {
        initDB(context);
        //定义了一个RemoteViews 实例,加载的布局就是我们刚刚定义的小组件的布局
        RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
        //这些代码是不是看着很眼熟,没错,这里和自定义notification很是相似
        //就是更具刚才定义的RemoteViews 设置其当中的各种子控件的内容,这里不用数据库,直接设置内容也是可以的
        rv.setTextViewText(R.id.textView_widget_time, new SimpleDateFormat("hh:mm").format(System.currentTimeMillis()));
        rv.setTextViewText(R.id.textView_widget_location, listWeather.get(0).getCitynm());
        rv.setTextViewText(R.id.textView_widget_avgTemp, ((Integer.parseInt(listWeather.get(0).getTemp_high()) + (Integer.parseInt(listWeather.get(0).getTemp_low()))) / 2) + "℃ " + listWeather.get(0).getWeather());
        rv.setTextViewText(R.id.textView_widget_lowHighTemp, listWeather.get(0).getTemp_low() + "/" + listWeather.get(0).getTemp_high() + "℃");
        String date = listWeather.get(0).getDays().substring(5, 10);
        rv.setTextViewText(R.id.textView_widget_date, date + " " + listWeather.get(0).getWeek());
        String weather;
        //下面这就是我根据天气的不同,来加载不同的图片,显示在小控件上的操作
        if (listWeather.get(0).getWeather().contains("转")) {
            weather = listWeather.get(0).getWeather().substring(0, listWeather.get(0).getWeather().indexOf("转"));
        } else {
            weather = listWeather.get(0).getWeather();
        }

        if (weather.contains("晴")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_sunnay);
        } else if (weather.contains("雨")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_yu);
        } else if (weather.contains("雪")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_xue);
        } else if (weather.contains("霾")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_mai);
        } else if (weather.contains("多云")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_duoyun);
        } else if (weather.contains("阴")) {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_yintian);
        } else {
            rv.setImageViewResource(R.id.imageView_widget_weather_ic1, R.mipmap.icon_duoyun);
        }
        //最后,调用调用组件管理器的修改所有小组件,让刚才的更改生效
        ComponentName componentName = new ComponentName(context, MyWedget01.class);
        appWidgetManager.updateAppWidget(componentName, rv);
    }

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

    //我们在一篇博客中说过,小组件是基于广播实现的,所以它可以接受广播并处理,我在这里的处理是我收到广播后,就更新小组件
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
        updateMywidget(context, appWidgetManager);
    }

}

小组件是基于广播的,所以必须在AndroidManifest文件中注册

  • android.appwidget.action.APPWIDGET_UPDATE
  • 是系统定义的小组件的广播
<receiver
            android:name=".widget.MyWedget01"
            android:label="电雨天气4*1">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/appwidget_provider01" />
        </receiver>
  • 大概代码就是这些
  • 小组件的点击事件我没写实现,基本实现和notification是一样的
  • 通过PendingIntent我们可以发送官博,开启活动等等。
Intent intent = new Intent("update_appwidget_textview");
          intent.putExtra("appWidgetId", appWidgetId);
          PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent,
                           PendingIntent.FLAG_CANCEL_CURRENT);
          点击按钮将触发广播,当前接收器将即时接收和处理广播消息
          views.setOnClickPendingIntent(R.id.mybutton, pendingIntent);

小补充,要实现时间实时变化,我们需要接收系统的时间变化的广播

  • 系统时间变化的Action
  • android.intent.action.TIME_TICK
  • 需要注意的是,这个接收系统时间变化的广播,只能在代码动态注册,静态注册不会接收相应的广播动作,并且这个广播是分钟改变才会发送的,秒的变化不会发送广播的