Android的widget初入门径

最新推荐文章于 2023-09-07 17:06:45 发布

原创最新推荐文章于 2023-09-07 17:06:45 发布 · 767 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#android #widget #控件

android 专栏收录该内容

7 篇文章

订阅专栏

本文详细介绍Android平台上的Widget组件，包括Widget的概念、作用及使用方法。文章深入解析如何创建Widget，并通过实例展示了如何利用RemoteViews进行界面操作及如何通过Intent接收事件。

1.什么事widget
widget就是android中的小插件或者控件，像音乐播放器为我们提供的播放音乐时候在主页显示上曲、暂停、下一曲的控件，像天气APP提供可以显示天气的控件等等。Android手机可以长按桌面空白部分就可以看到预览的各个APP提供的控件，长按控件拖动到你想放的位置就能用啦。android四大组建Activity（活动）、Service（服务）、ContentProvider（数据提供）、BroadcastProvider（广播）。widget继承BroadcastProvider（广播）本质上是一个广播。

2.widget能干什么事
widget是一个小控件，主要是以控件形式显示在锁屏页面或者系统启动时候进入的界面（我把他称为桌面）。想象一下你听着歌，当你亮屏时候看到了是歌曲封面和歌词这就是widget在锁屏时候用处。

3.怎么用widget

3.1首先建一个继承AppWidgetProvider自己的类MyAppWidgetProvider

public class MyAppWidgetProvider 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.updateAppWidget(appWidgetIds, views);
    }

    @Override
    public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
        super.onAppWidgetOptionsChanged(context, 
    }

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

    @Override
    public void onEnabled(Context context) {
        super.onEnabled(context);
    }

    @Override
    public void onDisabled(Context context) {
        super.onDisabled(context);
    }

    @Override
    public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
        super.onRestored(context, oldWidgetIds, newWidgetIds);
    }
}

顾名思义就知道这几个方法干什么用的，详细讲解看下面。

3.2在AndroidManifest.xml中注册我们新建的widget（广播）

<receiver
            android:name=".MyAppWidgetProvider">
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/app_widget_config" >
            </meta-data>

            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
                <action android:name="Widget_Button_Click"/>
            </intent-filter>
        </receiver>

标签就是注册BroadcastProvider（广播）的，widget本质是广播所以要在配置文件中注册，android：name=“.MyAppWidgetProvider”指的就是我们刚刚建立的类MyAppWidgetProvider。

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/widget_layout"
    android:minWidth="300dp"
    android:minHeight="250dp"
    android:updatePeriodMillis="6890000"
    android:previewImage="@drawable/map">
</appwidget-provider>

标签提供配置widget信息。

android:initialLayout=“”提供我们widget显示效果，上文配置的widget显示效果是layout文件夹下面widget_layout.xml文件控制。

android:minWidth控制显示组件最小宽度

android:minHeight控制widget组件最小高度

android:updatePeriodMillis控制widget更新频率单位是毫秒

android:previewImage控制长按桌面空白处调出控件添加按钮时组件显示的样子。上文组件显示的是在drawable文件下面的一张名map.png的图片

更多具体标签下属性设置感兴趣可以自行百度。

3.3编写widget显示的文件widget_layout.xml

在layout文件下面新建widget_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
                      android:layout_width="390dp"
                      android:layout_height="177dp"
                      android:layout_gravity="center"
                      android:gravity="center">

        <ImageButton
            android:id="@+id/MapWidgetButton"
            android:layout_width="390dp"
            android:layout_height="177dp"
            android:paddingLeft="37dp"
            android:background="@drawable/map">
        </ImageButton>

</FrameLayout>

此文件是显示一个能响应事件的图片。这之后你的widget就能显示在安卓桌面上啊。当然只有能显示而已，但是并不能响应事件，不要急，一口吃不成胖子，前面挖的坑会一一填上。

4.讲解MyAppWidgetPrivoder类中各个方法
4.1方法讲解

public class MyAppWidgetProvider extends AppWidgetProvider {  
    private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click";  
    public static final String TAG = "widget";   
    public static  RemoteViews rv;  
    /**  
     * 更新（Widget的更新与Activity不同，必须借助于RemoteViews和AppWidgetMananger。）  
     */    
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds){    
          Log.i(TAG, "onUpdate");  
          int N = appWidgetIds.length; // 可能启动了多个Widget，appWidgetIds记录了这些Widget的ID    
          for(int i=0; i<N; i++){   
              int appWidgetId = appWidgetIds[i];  
              rv = new RemoteViews(context.getPackageName(), R.layout.main);  
              Intent intentClick = new Intent(CLICK_NAME_ACTION);  
              PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,  
                      intentClick, 0);  
              rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);  
              appWidgetManager.updateAppWidget(appWidgetId, rv);  
          }     
    }    
    /**  
     * 第一个Widget组件启动时触发  
     */    
    public void onEnabled(Context context){    
          Log.i(TAG, "onEnabled");    
    }    
    /**  
     * 最后一个Widget组件关闭时触发  
     */    
    public void onDisabled(Context context){    
          Log.i(TAG, "onDisabled");    
    }    
    /**  
     * 任一Widget组件被删除时触发  
     */    
    public void onDeleted(Context context, int[] appWidgetIds){    
          Log.i(TAG, "onDeleted");    
    }    
    /**  
     * 以上函数触发前会先触发该函数，一般不需要重写  
     */    
    public void onReceive(Context context, Intent intent){    
          Log.i(TAG, "onReceive");    
          super.onReceive(context, intent);    
          if (rv == null) {  
              rv = new RemoteViews(context.getPackageName(), R.layout.main);  
          }  
          if (intent.getAction().equals(CLICK_NAME_ACTION)) {  
              rv.setTextViewText(R.id.TextView01, context.getResources()  
                      .getString(R.string.load));  
          }  
          AppWidgetManager appWidgetManger = AppWidgetManager.getInstance(context);  
          int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(context, widgetProvider.class));  
          appWidgetManger.updateAppWidget(appIds, rv);  
    }

onReceive（）方法接受各个方法消息并处理
onUpdate（）当第一个widget创建时执行本方法，widget更新时执行本方法。
onDeleted（）方法，任意一个widget被删除时候执行此方法
onEnabled（）方法，当第一个widget被创建时候，执行此方法
onDisabled（）方法，当最后一个widget被执行时候执行此方法
无论怎么样onReceive（）方法总会执行的，去看下AppWidgetProvider类源代码，onReceive（）更像是个控制中心，根据不同的方法执行结果调用不同方法。比如：当onUpdate（）方法被执行会发出一个android.appwidget.action.APPWIDGET_UPDATE的action给onUpdate（）接收到action调用相应的方法。所以在自己类MyAppWidgetProvider的onReceive（）方法中一定要在方法最后面加上super.onReceive（）;否则除了onReceive（）方法外其他方法都不能执行。

之前有人问为什么不在android中是用spring。spring的最重要之一就是aop解耦，而android已经为了开发者提供了四大组件，已经解耦。这四大组件是由android系统控制执行时间和顺序而不是由开发者，和javaWEB中的servlet一样是由服务器控制执行。只需要记住四大组件类提供方法的执行顺序和功能，如果提供的类不能满足需求就去继承重写你想要的方法。有什么不懂得去看官方API和源代码，大部分问题都能解决。

4.2如何获取视图并对它操作
widget本质上是在另一个进程中运行，不能用findViewById（）方法获得widget视图对象。android为我们提供了remoteView类来获取不是本进程视图对象并对操作。

 RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
        Intent intent = new Intent();                                                           //定义intent
        intent.setAction(ACTION);
        PendingIntent pendingIntentOne = PendingIntent.getBroadcast(context, 0, intent, 0);     //用PendingIntent将Intent包裹起来
        views.setOnClickPendingIntent(R.id.MapWidgetButton, pendingIntentOne);