美文网首页安卓知识点
Android桌面小部件开发,及注意事项

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

作者: 打酱油的日光灯 | 来源:发表于2019-05-20 17:19 被阅读0次

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

    首先看下效果
    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),从数据库中拉数据进行显示

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

    相关文章

      网友评论

        本文标题:Android桌面小部件开发,及注意事项

        本文链接:https://www.haomeiwen.com/subject/kwohzqtx.html