android学习之AppWidget

一、 什么是AppWidget
      桌面上见到的那种一个个的小窗口，利用这个小窗口可以给用户提供一些方便快捷的操作，有点像快捷方式。。。
      
二、 与AppWidget相关的数据
    1、AppWidgetProviderInfo对象，为appWidget提供元数据，包括布局、更新频率等等，这个对象被定义在xml文件中
    2、appWidgetProvider，定义了appWidget的基本生命周期
三、创建一个AppWidget的方法
    1、定义AppWidgetProviderInfo对象
        在res/xml文件夹中定义一个名为example_appwidget_info.xml的文件
                            xmlns:android=""
               android:minWidth="294dp"
               android:minHeight="72dp"
               android:updatePeriodMillis="86400000"
                android:initialLayout="@layout/example_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);
    }

    @Override
    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";
    @Override
    public void onDeleted(Context context, int[] appWidgetIds)
    {
        // TODO Auto-generated method stub
        super.onDeleted(context, appWidgetIds);
    }

    @Override
    public void onDisabled(Context context)
    {
        // TODO Auto-generated method stub
        super.onDisabled(context);
    }

    @Override
    public void onEnabled(Context context)
    {
        // TODO Auto-generated method stub
        super.onEnabled(context);
    }

    @Override
    public void onReceive(Context context, Intent intent)
    {
        // TODO Auto-generated method stub
        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);
        }
    }

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds)
    {
        //每创建一个appwidget就会添加一个id
        for(int i=0; i<appWidgetIds.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 remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
            //为remoteViews绑定事件处理器，当发生click事件后执行pendingIntent
            //第一个参数是被绑定的控件，第二个参数指定当事件发生时执行的pendingIntent
            remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn1, pendingIntent);
            //更新appwidget
            appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
        }


        for(int i=0; i<appWidgetIds.length; i++)
        {
            System.out.println(appWidgetIds[i]);
            //创建一个intent对象
            Intent intent = new Intent();
            //设置action，这个action需要在androidManifest中声明
            intent.setAction(UPDATE_ACTION);
            //创建一个pendingIntent对象,利用getBroadcast创建，用于发送广播，发送的广播会在onReceive方法中接收
            PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
            //创建remoteViews
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
            //为remoteViews绑定事件处理器，当发生click事件后执行pendingIntent
            //第一个参数是被绑定的控件，第二个参数指定当事件发生时执行的pendingIntent
            remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn2, pendingIntent);
            //更新appwidget
            appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
        }
        // TODO Auto-generated method stub
        super.onUpdate(context, appWidgetManager, appWidgetIds);

    }
}

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

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
    xmlns:android=""
    android:minWidth="294dp"
    android:minHeight="72dp"
    android:updatePeriodMillis="86400000"
    android:initialLayout="@layout/example_appwidget"
    />

5、example_appwiget.xml
    这是AppWidget的布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns: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:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="test Button1"
     />
    <Button
        android:id = "@+id/appWidgetBtn2"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="test Button2"
     />
</LinearLayout>

6、activity_main.xml
    这是MainActivity的布局文件

<RelativeLayout xmlns:android=""
    xmlns:tools=""
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    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" >

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello_world" />

</RelativeLayout>