android学习之AppWidget

一、 什么是AppWidget

      桌面上见到的那种一个个的小窗口，利用这个小窗口可以给用户提供一些方便快捷的操作，有点像快捷方式。。。

二、 与AppWidget相关的数据

    1、AppWidgetProviderInfo对象，为appWidget提供元数据，包括布局、更新频率等等，这个对象被定义在xml文件中

    2、appWidgetProvider，定义了appWidget的基本生命周期

三、创建一个AppWidget的方法

    1、定义AppWidgetProviderInfo对象

        在res/xml文件夹中定义一个名为example_appwidget_info.xml的文件

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

               android:minWidth="294dp" <?最小宽度 ?>

               android:minHeight="72dp" <?最小高度 ?>

               android:updatePeriodMillis="86400000" <?更新时间 ，单位ms?>

                android:initialLayout="@layout/example_appwidget" <?appwidget初始化的布局文件 ?>

               />

    2、为AppWidget添加布局文件

           android:id="@+id/widgetText"

           android:layout_width="fill_parent"

           android:layout_height="wrap_content"

           android:text="myWidget"

           />

    3、实现appWidgetProvider的方法

        onUpdate： 在大道指定更新时间后，或者用户想桌面添加appwidget时会调用

        onDelete： 当appWidget被删除时调用

        onEnabled： 当第一次创建appwidget时调用

        onDisabled：当最后一个appwidget被删除时调用

        onRecieve： 接收广播                  appwidget是依靠广播机制的

    4、在AndroidManifest中声明广播

               android:name="android.appwidget.provider"

               android:resource="@xml/example_appwidget_info"

               />

四、AppWidget如何使用

     1、pendingIntent  用于appwidget和其他activity交换数据，appwidget和创建它的activity并不在同一个进程

     2、创建pendingIntent的方法：

        （1）、 getActivity（）       //用于启动新的activity

        （2）、 getBroadcast（）    //用于启动新的广播，广播会在onReceive方法中接收

        （3）、 getService（）         //用于启动新的服务

    3、 remoteViews 表示一系列的view对象，这些view对象在另一个线程

    4、为remoteViews 添加监听器的方法 ：setOnClickPendingIntent

五、源代码

1、MainActivity.java

    这里什么都不需要操作

点击(此处)折叠或打开

public class MainActivity extends Activity

{

    @Override

    protected void onCreate(Bundle savedInstanceState)

    {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

    }

    public boolean onCreateOptionsMenu(Menu menu)

        // Inflate the menu; this adds items to the action bar if it is present.

        getMenuInflater().inflate(R.menu.main, menu);

        return true;

}

2、myAppWidget.java

    这里操作AppWidget

public class appWidget extends AppWidgetProvider

    //定义一个常量，用于自定义action

    private static final String UPDATE_ACTION = "appwidget.UPDATE_APPWIDGET";

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

        // TODO Auto-generated method stub

        super.onDeleted(context, appWidgetIds);

    public void onDisabled(Context context)

        super.onDisabled(context);

    public void onEnabled(Context context)

        super.onEnabled(context);

    public void onReceive(Context context, Intent intent)

        String action = intent.getAction();

        if(UPDATE_ACTION.equals(action))

        {

            System.out.println(action);

            //得到remoteViews

            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);

            //给remoteViews设置动作

            remoteViews.setTextViewText(R.id.widgetText, "hello");

            //创建AppWidgetManager

            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);

            //创建ComponentName

            ComponentName compenentName = new ComponentName(context, appWidget.class);

            appWidgetManager.updateAppWidget(compenentName, remoteViews);

        }

        else

            super.onReceive(context, intent);    

    public void onUpdate(Context context, AppWidgetManager appWidgetManager,

            int[] appWidgetIds)

        //每创建一个appwidget就会添加一个id

        for(int i=0; iappWidgetIds.length; i++)

            System.out.println(appWidgetIds[i]);

            //创建一个intent对象

            Intent intent = new Intent(context, targetActivity.class);

            //创建一个pendingIntent对象,利用getActivity创建，用于启动新的activity

            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);

            //创建remoteViews

            //为remoteViews绑定事件处理器，当发生click事件后执行pendingIntent

            //第一个参数是被绑定的控件，第二个参数指定当事件发生时执行的pendingIntent

            remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn1, pendingIntent);

            //更新appwidget

            appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);

            Intent intent = new Intent();

            //设置action，这个action需要在androidManifest中声明

            intent.setAction(UPDATE_ACTION);

            //创建一个pendingIntent对象,利用getBroadcast创建，用于发送广播，发送的广播会在onReceive方法中接收

            PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);

            remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn2, pendingIntent);

        super.onUpdate(context, appWidgetManager, appWidgetIds);

4、example_appwidget_info.xml

    这个xml文件并不是布局文件，它是为AppWidget提供元数据

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

appwidget-provider

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

    android:minWidth="294dp"

    android:minHeight="72dp"

    android:updatePeriodMillis="86400000"

    android:initialLayout="@layout/example_appwidget"

    />

5、example_appwiget.xml

    这是AppWidget的布局文件

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

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    android:orientation="vertical" >

    TextView

     android:id="@+id/widgetText"

     android:layout_width="fill_parent"

     android:layout_height="wrap_content"

     android:text="myWidget"

     android:background="#000000"

     />

    Button

     android:id = "@+id/appWidgetBtn1"

     android:text="test Button1"

     android:id = "@+id/appWidgetBtn2"

     android:text="test Button2"

/LinearLayout>

6、activity_main.xml

    这是MainActivity的布局文件

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

    xmlns:tools="http://schemas.android.com/tools"

    android:paddingBottom="@dimen/activity_vertical_margin"

    android:paddingLeft="@dimen/activity_horizontal_margin"

    android:paddingRight="@dimen/activity_horizontal_margin"

    android:paddingTop="@dimen/activity_vertical_margin"

    tools:context=".MainActivity" >

        android:layout_width="wrap_content"

        android:layout_height="wrap_content"

        android:text="@string/hello_world" />

/RelativeLayout>