Android -- Widget

AppWidget 就是HomeScreen上显示的小部件，提供直观的交互操作。通过在HomeScreen中长按，在弹出的对话框中选择Widget部件来进行创建，长按部件后并拖动到垃圾箱里进行删除。同一个Widget部件可以同时创建多个。

AppWidget的实现主要涉及到以下类：

• AppWidgetProvider
• RemoteViews
• AppWidgetManager

布局                                                                                           

首先需要提供一个定义了Widget界面布局的XML文件，需要注意的是使用的组件必须是RemoteViews所支持的，目前原生API中支持的组件如下：

FrameLayout/LinearLayout/RelativeLayout/AnalogClock/Button/Chronmeter/ImageButton/ImageView/ProgressBar/TextView

注意：如果使用了除此之外的组件，则在Widget创建时会导致android.view.InflateExceptionn异常。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    android:orientation="vertical"

    android:background="@drawable/rectangle" >

    <TextView 

        android:layout_width="match_parent"

        android:layout_height="match_parent"

        android:id="@+id/tv"

        android:text="lalala"/>



</LinearLayout>

属性                                                                                           

需要提供一个xml文件来定义Widget的基本属性，放置到res/xml/..目录下。操作：

• 在res/目录下创建xml/目录
• 创建xml文件（名字可任意），选择类型为AppWidgetProvider
• 在弹出的便捷界面进行参数设置

主要设置的参数如下:

minWidth: 定义Wdiget组件的宽度

minHeight: 定义Wdiget组件的高度

updatePeriodMillis: 更新的时间周期

initialLayout: Widget的布局文件

configure: 如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名(后面会说到，与一般Activity的实现有些许差别)

<?xml version="1.0" encoding="utf-8"?>

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

    android:initialLayout="@layout/time_appwidget"

    android:minHeight="72dp"

    android:minWidth="294dp"

    android:updatePeriodMillis="0" >



</appwidget-provider>

周期                                                                                           

xml都定义好后，接下来就是创建一个继承自AppWidgetProvider的子类，AppWidgetProvider实际上就是一个BroadcastReceiver，里面提供了以下函数：

onReceive(Context, Intent)

onUpdate(Context , AppWidgetManager, int[] appWidgetIds)

onEnabled(Context)

onDeleted(Context, int[] appWidgetIds)

onDisabled(Context)

可通过重写以上函数来监听Widget状态的变化并进行相应的处理。

• 启动 - 无confiure Activity

onReceive –> onEnabled —— 第一个widget被显示 –> onReceive –> onUpdate —— 刷新界面

• 启动 - 带confiuration Activity

onReceive –> onUpdate

• 拖动

<无状态变化>

• 周期更新

onReceive –> onUpdate

• 删除

onReceive –> onDeleted —— widget被删除 –> onReceive –> onDisabled —— 最后一个widget被移除

• 启动时位置不够

onReceive –> onEnabled –> onReceive –> onUpdate –> onReceive –> onDeleted –> onReceive –> onDisabled

配置                                                                                            

<receiver android:name=".WidgetsStudy" >

            <intent-filter >

                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />

            </intent-filter>

            <meta-data android:name="android.appwidget.provider"

                android:resource="@xml/appwidget_info"/>

        </receiver>

        <service android:name=".TimeService"></service>

代码                                                                                            

在服务中更新Widget中的内容：

public class TimeService extends Service {



    private Timer timer;



    @Override

    public IBinder onBind(Intent intent) {

        // TODO 自动生成的方法存根

        return null;

    }



    @Override

    public void onCreate() {

        timer = new Timer();

        timer.scheduleAtFixedRate(new TimeUpdateTask(), 0, 1000);

        super.onCreate();

    }



    private final class TimeUpdateTask extends TimerTask {



        @Override

        public void run() {

            SimpleDateFormat dateFormat = new SimpleDateFormat(

                    "yyyy-MM-dd HH:mm:ss");

            String time = dateFormat.format(new Date());

            RemoteViews rom = new RemoteViews(getPackageName(),

                    R.layout.time_appwidget);

            rom.setTextViewText(R.id.tv, time);

            AppWidgetManager awm = AppWidgetManager

                    .getInstance(getApplicationContext());

            awm.updateAppWidget(new ComponentName(getApplicationContext(),

                    WidgetsStudy.class), rom);

        }



    }



    @Override

    public void onDestroy() {

        timer.cancel();

        timer = null;

        super.onDestroy();

    }



}

AppWidgetProvider中：

public class WidgetsStudy extends AppWidgetProvider {



    @Override

    public void onUpdate(Context context, AppWidgetManager appWidgetManager,

            int[] appWidgetIds) {



        super.onUpdate(context, appWidgetManager, appWidgetIds);

    }



    @Override

    public void onDeleted(Context context, int[] appWidgetIds) {

        // TODO 自动生成的方法存根

        super.onDeleted(context, appWidgetIds);

    }



    @Override

    public void onEnabled(Context context) {

        context.startService(new Intent(context, TimeService.class));

        super.onEnabled(context);

    }



    @Override

    public void onDisabled(Context context) {

        context.stopService(new Intent(context, TimeService.class));

        super.onDisabled(context);

    }



}

我是天王盖地虎的分割线                                                                 

源代码：http://pan.baidu.com/s/1dD1Qx01

Widgets学习.zip

 

 

 

 

 

转载请注明出处：http://www.cnblogs.com/yydcdut