Android桌面小部件开发,及注意事项

抓住人生中的一分一秒,胜过虚度中的一月一年!

首先看下效果
demo.gif
背景

Android手机中,我们经常会看到各种桌面小部件,天气、音乐播放器、时间表盘等,虽然常见,但是我们着手开发的还是较少,其实桌面小部件开发起来很简单,但是还是可能会走一些弯路,下面给大家介绍一下如何实现桌面小部件

分析 官方文档直通车

桌面小部件AppWidget开发,需要使用官方提供的AppWidgetProvider来实现,点卡源码会看到AppWidgetProvider继承的是BroadcastReceiver,其实它就是一个广播,可以理解为通过广播去修改UI

一、新建UI布局

说到小部件,那必然会有UI,首先我们在Xml下建个小部件UI布局,如my_app_widget.xml,内容随便写,但注意事项是:Widget并不支持所有的控件跟布局,而仅仅只是支持Android布局和控件的一个子集
1、支持布局:FrameLayoutLinearLayoutRelativeLayoutGridLayout
2、支持控件:AnalogClockButtonChronometerImageButtonImageViewProgressBarTextViewViewFlipperListViewGridViewStackViewAdapterViewFlipper

二、定义小部件配置信息

在项目res目录下,新建一个名字为xml目录,然后在res/xml/目录下创建一个配置文件,名称随意如my_app_widget_info.xml

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/new_app_widget"
    android:minHeight="@dimen/dp_80"
    android:minWidth="@dimen/dp_400"
    android:previewImage="@drawable/ic_zuomian"

    android:updatePeriodMillis="864000"
    android:widgetCategory="home_screen|keyguard">

    <!--android:resizeMode="horizontal|vertical"-->

</appwidget-provider>

针对上述文件中的配置信息来做下介绍。

1、minHeight、minWidth 定义Widget的最小高度和最小宽度(Widget可以通过拉伸来调整尺寸大小)
2、previewImage 定义添加小部件时显示的图标
3、initialLayout 定义了小部件使用的布局。
4、updatePeriodMillis定义小部件自动更新的周期,单位为毫秒。
5、resizeMode 指定了 widget 的调整尺寸的规则。可取的值有: “horizontal”,“vertical”,“none”。”horizontal”意味着widget可以水平拉伸,“vertical”意味着widget可以竖值拉伸,“none”意味着
widget 不能拉伸;默认值是”none”。
6、widgetCategory 指定了 widget 能显示的地方:能否显示在 home Screen 或 lock screen 或 两者都可以。它的取值包括:”home_screen” 和 “keyguard”。Android 4.2 引入。

注意事项:android:previewImage定义的图标,本人测试了下,如果图片放到mipmap中,图片虽是矩形,但是显示出来还是圆形,故如果图片是矩形需要放到drawable

三、定义小部件类MyAppWidget,继承自AppWidgetProvider
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;


public class MyAppWidget extends AppWidgetProvider {
    /**
     * 接收窗口小部件点击时发送的广播
     */
    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
    }
    /**
     * 每次窗口小部件被更新都调用一次该方法
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        Log.i("AppWidget", "开始了更新");
 RemoteViews rv = new RemoteViews(AppUMS.mContent.getPackageName(), R.layout.my_app_widget);
//这里获得当前的包名,并且用AppWidgetManager来向NewAppWidget.class发送广播。
        AppWidgetManager manager = AppWidgetManager.getInstance(AppUMS.mContent);
        ComponentName cn = new ComponentName(AppUMS.mContent, NewAppWidget.class);
        manager.updateAppWidget(cn, rv);
    }
    /**
     * 每删除一次窗口小部件就调用一次
     */
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        super.onDeleted(context, appWidgetIds);
        //context.stopService(new Intent(context, WidgetService.class));
        Log.i("AppWidget", "删除成功!");
    }
    /**
     * 当该窗口小部件第一次添加到桌面时调用该方法
     */
    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
       // Intent mTimerIntent = new Intent(context, WidgetService.class);
       // context.startService(mTimerIntent);
        Log.i("AppWidget", "创建成功!");
    }
    /**
     * 当最后一个该窗口小部件删除时调用该方法
     */
    @Override
    public void onDisabled(Context context) {
        super.onDisabled(context);
      //  Intent mTimerIntent = new Intent(context, WidgetService.class);
       // context.stopService(mTimerIntent);
        Log.i("AppWidget", "删除成功!");
    }
    /**
     * 当小部件大小改变时
     */
    @Override
    public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
        super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
    }
    /**
     * 当小部件从备份恢复时调用该方法
     */
    @Override
    public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
        super.onRestored(context, oldWidgetIds, newWidgetIds);
    }
}
四、在AndroidManifest.xml中注册小部件
 <!--广播接收参数-->
        <receiver android:name=".receiver.MyAppWidget">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
                <action android:name="com.bwkj.qcxbm.widget.UPDATE_ALL" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/my_app_widget_info" />
        </receiver>

通过上述各种步骤运行完毕即可实现桌面小部件样式,细节问题还需要优化

问题1:如何更新桌面小部件内容信息?
答:其实关键性的是这一步

 RemoteViews rv = new RemoteViews(AppUMS.mContent.getPackageName(), R.layout.my_app_widget);``
//这里获得当前的包名,并且用AppWidgetManager来向NewAppWidget.class发送广播。
        AppWidgetManager manager = AppWidgetManager.getInstance(AppUMS.mContent);
        ComponentName cn = new ComponentName(AppUMS.mContent, NewAppWidget.class);
        manager.updateAppWidget(cn, rv);

执行一次这个方法,相当于给桌面小部件发了个更新广播,对应桌面部件也会相应改变,所以我们可以将上述方法封装成一个工具类

问题2:对如何获取并设置布局中控件样式,如颜色,字体大小,内容等
答:RemoteViews没有提供findViewById方法,因为RemoteViews在远程进程中显示,因此无法直接访问里面的View元素,而必须通过RemoteViews所提供的一系列set方法来完成,部分set方法如下所示:

picture.png

问题3:如果app被杀死了,布局该如何设置之前的内容,因为是动态的,暂时缓存的数据都已获取不到
答:我目前是这样操作的,只供参考,将从服务器拉下来的最新数据保存到sp中(请求一次服务器保存一次最新的,更新一次小部件UI),从数据库中拉数据进行显示

有发现的问题提出我将进行继续完善,祝大家开发顺利!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,117评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,963评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,897评论 0 240
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,805评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,208评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,535评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,797评论 2 311
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,493评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,215评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,477评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,988评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,325评论 2 252
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,971评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,807评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,544评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,455评论 2 266

推荐阅读更多精彩内容