android widget的研究(一)

最新推荐文章于 2024-09-30 15:37:45 发布

izard999

最新推荐文章于 2024-09-30 15:37:45 发布

阅读量809

点赞数

分类专栏： android 文章标签： android layout 文档 button service encoding

本文链接：https://blog.csdn.net/izard999/article/details/6691425

版权

android 专栏收录该内容

113 篇文章 0 订阅

订阅专栏

新进了一个项目组，有个需求是要求在桌面上有个widget直接提用户操作，而不必麻烦每次用户进入应用去设置某些东西.!

关于如何订制widget, 官方文档的位置:/guide/topics/appwidgets/index.html

一:什么是app widget?

官方的解释翻译来就是: ()窗口小部件（Widget）是微小的应用程序视图，可以被嵌入到其它应用程序中（比如桌面）并接收周期性的更新。你可以通过一个App Widget provider来发布一个Widget。可以容纳其它App Widget的应用程序组件被称为App Widget宿主。

二:如何订制自己的widget.?

订制自己的widget很容易-----

1:在AndroidManifest.xml中配置我们的Widget, 从官方文档我得知其实所谓widget其实就是一个BroadcastReceiver, 而我们所继承的AppWidgetProvider继承了BroadcastReceiver,所以我更加确信了它就是一个广播接受者

<receiver android:name=".MyWidget">
            <intent-filter>
                <action android:name = "android.appwidget.action.APPWIDGET_UPDATE"></action>
                </intent-filter>
            <meta-data android:name ="android.appwidget.provider" android:resource="@xml/widget_info">
            </meta-data>
        </receiver>

2: 添加AppWidgetIInfo MetaDate(元数据)

在/res/xml文件夹下新建一个widget_info.xml文件, 取这个名字是因为我在receiver中配置<meta-data>的时候就是写的widget_info, 取什么名字都是可以的, 只是<meta-data>的android:resource属性相应的引用就可以了!

<?xml version="1.0" encoding="UTF-8"?>
<appwidget-provider
    android:minWidth="294dp" 
    android:minHeight="72dip" 
    android:updatePeriodMillis="600000" 
    android:initialLayout="@layout/my_widget"
    xmlns:android="http://schemas.android.com/apk/res/android" />

关于<appwidget-provider>的一些属性设置, 不过多的解释了, 网上一搜一堆, 不过个人还是推荐看官方文档, 说的已经够详细了, 例如这个最小的宽和高怎么算之类的都有

3: 为widget创建layout, 这里在/res/layout文件夹下创建my_widget.xml, 与上面的保持一致

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="horizontal" android:layout_width="294dp"
	android:layout_height="72dp" android:background="@drawable/widget_shape"
	android:gravity="left|center_vertical">
        <Button android:layout_width="wrap_content" android:text="widget_button" android:id="@+id/button"
        android:layout_weight="1" android:textAppearance="?android:attr/textAppearanceLarge"
        android:layout_height="fill_parent" android:gravity="left" />
	<TextView android:layout_width="wrap_content" android:id="@+id/tvName"
		android:textAppearance="?android:attr/textAppearanceLarge"
		android:layout_height="fill_parent" android:gravity="left"></TextView>
</LinearLayout>

注意: 这里我自己给布局加了个背景, 而这个背景是一个渐变颜色, 是自己在/drawbale文件夹下创建了一个widge_shape.xml

<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle"> 
    <gradient android:startColor="#FFFF0000" android:endColor="#80FF00FF" 
            android:angle="270"/> 
    <padding android:left="50dp" android:top="20dp" 
            android:right="7dp" android:bottom="7dp" /> 
    <corners android:radius="8dp" /> 
    
</shape>

4: 创建MyWidget类

public class MyWidget extends AppWidgetProvider {
	
	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {
		RemoteViews remoteView = new RemoteViews(context.getPackageName(), R.layout.my_widget);
        String name = "my first widget";        
        remoteView.setTextViewText(R.id.tvName, name);
        appWidgetManager.updateAppWidget(appWidgetIds, remoteView);
		//super.onUpdate(context, appWidgetManager, appWidgetIds);
	}
	
}

这里没有调用super.onUpdate()是因为我跟源码进去看了, 父类的这个方法是个空实现, 所以没必要调用

做到这里的时候, 被button的点击事件卡了一下, broadcastReceiver是不能像Activity那样获取到按钮并且为其设置onClick事件的, 也无法在xml中为Button设置android:onClick属性! 我很着急, 于是我静下心来继续读文档, 发现文档上有教阿, 所以在资料甚少的时候, 挖掘官方文档绝对是正解!

文档中点击的时候是去打开一个Activity, 而我这里是做demo,只想它弹一个Toast就够了, 所以我选择调用一个服务!

在onUpdate中添加如下代码:

Intent intent = new Intent(context, MyService.class);
        PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
        remoteView.setOnClickPendingIntent(R.id.button, pendingIntent);

我没有跟这个setOnClickPendingIntent的源码, 因为我猜也猜的出来这个方法就是让你去指定widget中某个控件的点击事件, 我在想, 这个RemoteViews会提供这个方法的原因是我们无法像在Activity中那样去指定点击事件, 如果没有这个API去指定, 那widget中的按钮就将无法点击(当然google早考虑到了!)

至于Service的代码就不贴了, 里面就一句代码:Toast.make().show();而已!

说一下：如果你向我上面没有什么特殊需求，那么重写Service的onCreate()方法就可以了，但是当我们用PendingIntent去让别人启服务的时需要用到Intent的话，到底是该重写onStart()还是onBind()呢.? 答案是应该重写onStart方法, 因为在官方文档PendingIntent.getService()处该方法的描述是:

Retrieve a PendingIntent that will start a service, like calling Context.startService(). The start arguments given to the service will come from the extras of the Intent.

文档上还说可以创建配置widget的Activity, 可以从配置Activity中更新widget等. 这次就研究到这里, 基本上有这类需求的童鞋应该够用了! 如果满足不了的话自己读读文档应该能出来, 懒得读的话就期待我下一篇研究widget的文章