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"                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中声明广播
       
四、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
    这里什么都不需要操作

点击(此处)折叠或打开

1. public class MainActivity extends Activity
   
2. {
   
3. 
   
4.     @Override
   
5.     protected void onCreate(Bundle savedInstanceState)
   
6.     {
   
7.         super.onCreate(savedInstanceState);
   
8.         setContentView(R.layout.activity_main);
   
9.     }
   
10. 
    
11.     @Override
    
12.     public boolean onCreateOptionsMenu(Menu menu)
    
13.     {
    
14.         // Inflate the menu; this adds items to the action bar if it is present.
    
15.         getMenuInflater().inflate(R.menu.main, menu);
    
16.         return true;
    
17.     }
    
18. 
    
19. }

2、myAppWidget.java
    这里操作AppWidget

点击(此处)折叠或打开

1. public class appWidget extends AppWidgetProvider
   
2. {
   
3.     //定义一个常量，用于自定义action
   
4.     private static final String UPDATE_ACTION = "appwidget.UPDATE_APPWIDGET";
   
5.     @Override
   
6.     public void onDeleted(Context context, int[] appWidgetIds)
   
7.     {
   
8.         // TODO Auto-generated method stub
   
9.         super.onDeleted(context, appWidgetIds);
   
10.     }
    
11. 
    
12.     @Override
    
13.     public void onDisabled(Context context)
    
14.     {
    
15.         // TODO Auto-generated method stub
    
16.         super.onDisabled(context);
    
17.     }
    
18. 
    
19.     @Override
    
20.     public void onEnabled(Context context)
    
21.     {
    
22.         // TODO Auto-generated method stub
    
23.         super.onEnabled(context);
    
24.     }
    
25. 
    
26.     @Override
    
27.     public void onReceive(Context context, Intent intent)
    
28.     {
    
29.         // TODO Auto-generated method stub
    
30.         String action = intent.getAction();
    
31.         if(UPDATE_ACTION.equals(action))
    
32.         {
    
33.             System.out.println(action);
    
34.             //得到remoteViews
    
35.             RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
    
36.             //给remoteViews设置动作
    
37.             remoteViews.setTextViewText(R.id.widgetText, "hello");
    
38.             //创建AppWidgetManager
    
39.             AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
    
40.             //创建ComponentName
    
41.             ComponentName compenentName = new ComponentName(context, appWidget.class);
    
42.             appWidgetManager.updateAppWidget(compenentName, remoteViews);
    
43.         }
    
44.         else
    
45.         {
    
46.             super.onReceive(context, intent);    
    
47.         }
    
48.     }
    
49. 
    
50.     @Override
    
51.     public void onUpdate(Context context, AppWidgetManager appWidgetManager,
    
52.             int[] appWidgetIds)
    
53.     {
    
54.         //每创建一个appwidget就会添加一个id
    
55.         for(int i=0; i<appWidgetIds.length; i++)
    
56.         {
    
57.             System.out.println(appWidgetIds[i]);
    
58.             //创建一个intent对象
    
59.             Intent intent = new Intent(context, targetActivity.class);
    
60.             //创建一个pendingIntent对象,利用getActivity创建，用于启动新的activity
    
61.             PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
    
62.             //创建remoteViews
    
63.             RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
    
64.             //为remoteViews绑定事件处理器，当发生click事件后执行pendingIntent
    
65.             //第一个参数是被绑定的控件，第二个参数指定当事件发生时执行的pendingIntent
    
66.             remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn1, pendingIntent);
    
67.             //更新appwidget
    
68.             appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
    
69.         }
    
70.         
    
71.         
    
72.         for(int i=0; i<appWidgetIds.length; i++)
    
73.         {
    
74.             System.out.println(appWidgetIds[i]);
    
75.             //创建一个intent对象
    
76.             Intent intent = new Intent();
    
77.             //设置action，这个action需要在androidManifest中声明
    
78.             intent.setAction(UPDATE_ACTION);
    
79.             //创建一个pendingIntent对象,利用getBroadcast创建，用于发送广播，发送的广播会在onReceive方法中接收
    
80.             PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
    
81.             //创建remoteViews
    
82.             RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
    
83.             //为remoteViews绑定事件处理器，当发生click事件后执行pendingIntent
    
84.             //第一个参数是被绑定的控件，第二个参数指定当事件发生时执行的pendingIntent
    
85.             remoteViews.setOnClickPendingIntent(R.id.appWidgetBtn2, pendingIntent);
    
86.             //更新appwidget
    
87.             appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
    
88.         }
    
89.         // TODO Auto-generated method stub
    
90.         super.onUpdate(context, appWidgetManager, appWidgetIds);
    
91.     
    
92.     }
    
93. }

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

点击(此处)折叠或打开

1. <?xml version="1.0" encoding="utf-8"?>
   
2. <appwidget-provider
   
3.     xmlns:android="http://schemas.android.com/apk/res/android"
   
4.     android:minWidth="294dp"
   
5.     android:minHeight="72dp"
   
6.     android:updatePeriodMillis="86400000"
   
7.     android:initialLayout="@layout/example_appwidget"
   
8.     />

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

点击(此处)折叠或打开

1. <?xml version="1.0" encoding="utf-8"?>
   
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
3.     android:layout_width="match_parent"
   
4.     android:layout_height="match_parent"
   
5.     android:orientation="vertical" >
   
6.     
   
7.     <TextView
   
8.      android:id="@+id/widgetText"
   
9.      android:layout_width="fill_parent"
   
10.      android:layout_height="wrap_content"
    
11.      android:text="myWidget"
    
12.      android:background="#000000"
    
13.      />
    
14.     <Button
    
15.      android:id = "@+id/appWidgetBtn1"
    
16.      android:layout_width="fill_parent"
    
17.      android:layout_height="wrap_content"
    
18.      android:text="test Button1"
    
19.      />
    
20.     <Button
    
21.      android:id = "@+id/appWidgetBtn2"
    
22.      android:layout_width="fill_parent"
    
23.      android:layout_height="wrap_content"
    
24.      android:text="test Button2"
    
25.      />
    
26. </LinearLayout>

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

点击(此处)折叠或打开

1. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
2.     xmlns:tools="http://schemas.android.com/tools"
   
3.     android:layout_width="match_parent"
   
4.     android:layout_height="match_parent"
   
5.     android:paddingBottom="@dimen/activity_vertical_margin"
   
6.     android:paddingLeft="@dimen/activity_horizontal_margin"
   
7.     android:paddingRight="@dimen/activity_horizontal_margin"
   
8.     android:paddingTop="@dimen/activity_vertical_margin"
   
9.     tools:context=".MainActivity" >
   
10. 
    
11.     <TextView
    
12.         android:layout_width="wrap_content"
    
13.         android:layout_height="wrap_content"
    
14.         android:text="@string/hello_world" />
    
15. 
    
16. </RelativeLayout>