android 桌面小工具（Widget）开发教程

刚学做了个Widget，感觉不错哦，先来秀下效果（用朋友手机截的图）

这个Widget会每隔5秒钟自动切换内容和图片，图片最好使用小图，大图会导致你手机桌面（UI）线程卡顿

教程开始：

1、首先创建一个布局（layout），用以显示Wdiget

activity_main.xml

 "http://schemas.android.com/apk/res/android"
     android:layout_width="wrap_content"
     android:layout_height="wrap_content"
     android:background="@drawable/ddz_gameend_frame"
     >


         android:id="@+id/textview_1"
         android:layout_width="60.0dp"
         android:layout_height="90.0dp"
         android:layout_marginLeft="35.0dp"
         android:layout_marginTop="34.0dp"
         android:textColor="#000000"
         android:text=""
         />

         android:id="@+id/imageview_1"
         android:layout_width="136.0dp"
         android:layout_height="92.0dp"
         android:layout_toRightOf="@+id/textview_1"
         android:layout_marginLeft="5.0dp"
         android:layout_marginTop="42.0dp"
         />

         android:id="@+id/button_1"
         android:layout_width="50.0dp"
         android:layout_height="20.0dp"
         android:layout_below="@+id/textview_1"
         android:layout_marginTop="10.0dp"
         android:layout_marginLeft="35.0dp"
         android:text="详情"
         />

2、然后创建一个appwidget-provider 的XML文件，点击资源目录的Res文件夹，鼠标右键选择New- android xml file

mywidget_provider.xml

 "1.0" encoding="utf-8"?>
 "http://schemas.android.com/apk/res/android"
     android:resizeMode="horizontal"
     android:minWidth="250.0dp"
     android:minHeight="110.0dp"
     android:updatePeriodMillis="86400000"
     android:initialLayout="@layout/activity_main"
     android:widgetCategory="home_screen|keyguard"
     >

android:updatePeriodMillis指示了更新间隔,86400000为24小时，也就是一天一次，本程序自己采用后台服务更新，所以该设置其实对本程序来说关系不大。 android:initialLayout就是指向的Widget布局
android:widgetCategory指示该Widget可以用作桌面和锁屏

3、在src目录创建代码文件(本实例建了包  com.feature.test;)

Constant.class   (用来定义一些常量的类）

 package com.feature.test;

 public class Constant {

     //更新广播
     public static final String ACTION_UPDATE_ALL="com.feature.test.update_all";

     //intent integer data
     public static final String INTEGER_DATA="integer_data";
 }

MyAppWidgetProvider.class    （用来处理Widget更新的类）

 package com.feature.test;

 import java.util.HashSet;
 import java.util.Iterator;

 import android.app.PendingIntent;
 import android.appwidget.AppWidgetManager;
 import android.appwidget.AppWidgetProvider;
 import android.content.Context;
 import android.content.Intent;
 import android.net.Uri;
 import android.util.Log;
 import android.widget.RemoteViews;
 import android.widget.Toast;

 public class MyAppWidgetProvider extends AppWidgetProvider{

     private static final Intent AppWidget_Service=new Intent("com.feature.test.MyAppWidgetService");

     //保存WidgetId HashSet  可能有用户创建了多个Widget
     private static HashSet hashSet=new HashSet();
     //图片资源,作者请自行修改成自己的图片
     private static final int[] ResId={R.drawable.a1,R.drawable.a2,R.drawable.a3,R.drawable.a4,R.drawable.a5};
     //文本资源
     private static final String[] intro={"神挡杀神，佛挡杀佛","仿佛兮若轻云之蔽月，飘飘兮若流风之回雪",
                                  "此乃驱狼吐虎之计，敬你之手他一搏吧","汝等小儿,可敢杀我",
                                  "汝等看好了"};
     private static int iCur=-1;

     //周期更新时调用
     @Override
     public void onUpdate(Context context,AppWidgetManager appWidgetProvider,int[] appWidgetIds)
     {
         Log.v("创建Widget", "OK");
         // 每次 widget 被创建时，对应的将widget的id添加到set中
         for(int id:appWidgetIds)
             hashSet.add(Integer.valueOf(id));

     }

     //当桌面组件删除时调用
     @Override
     public void onDeleted(Context context,int[] appWidgetIds)
     {
         for(int id:appWidgetIds)
             hashSet.remove(id);

         super.onDeleted(context, appWidgetIds);
     }

     //当桌面提供的第一个组件创建时调用
     @Override
     public void onEnabled(Context context)
     {
         //启动服务
         context.startService(AppWidget_Service);

         super.onEnabled(context);
     }

     //当桌面提供的最后一个组件删除时调用
     @Override
     public void onDisabled(Context context)
     {
         //停止服务
         context.stopService(AppWidget_Service);

         super.onDisabled(context);
     }

     /*
      * 重写广播接收方法
      * 用于接收除系统默认的更新广播外的  自定义广播（本程序由服务发送过来的，一个是更新UI，一个是按钮事件消息）
      */
     @Override
     public void onReceive(Context context,Intent intent)
     {
         String getAction=intent.getAction();
         if(getAction.equals(Constant.ACTION_UPDATE_ALL))
         {
             //更新广播

             updateAllWidget(context,AppWidgetManager.getInstance(context), hashSet);
         }
         else if(intent.hasCategory(Intent.CATEGORY_ALTERNATIVE))
         {
             Uri data=intent.getData();
             Log.v("button",data.toString()+" ");
             int buttonid=Integer.parseInt(data.getSchemeSpecificPart());
             Toast.makeText(context, intro[buttonid],Toast.LENGTH_SHORT).show();
         }

         super.onReceive(context, intent);
     }

     //更新UI
     public void updateAllWidget(Context context,AppWidgetManager manager,HashSet set)
     {
         int AppId;
         Iterator iterator=set.iterator();

         iCur=iCur+1>=intro.length? 0: iCur+1;

         while(iterator.hasNext())
         {
             AppId=((Integer)iterator.next()).intValue();

             RemoteViews remoteViews=new RemoteViews(context.getPackageName(),R.layout.activity_main);
             //设置显示的文字图片
             remoteViews.setTextViewText(R.id.textview_1, intro[iCur]);
             remoteViews.setImageViewResource(R.id.imageview_1, ResId[iCur]);
             //添加按钮事件处理
             remoteViews.setOnClickPendingIntent(R.id.button_1, getPendingIntent(context, iCur));
             //更新
             manager.updateAppWidget(AppId, remoteViews);
         }
     }

     //设置按钮事件处理
     private PendingIntent getPendingIntent(Context context,int buttonid)
     {
         Intent intent=new Intent("test.test");
         intent.setClass(context, MyAppWidgetProvider.class);
         intent.addCategory(Intent.CATEGORY_ALTERNATIVE);
         intent.setData(Uri.parse("custom:"+buttonid));
         //进行广播
         PendingIntent pi=PendingIntent.getBroadcast(context, 0, intent, 0);
         return pi;
     }
 }

4、创建后台服务，用来定时发送广播，通知Widget需要更新了

MyAppWidgetService。class

 package com.feature.test;

 import android.app.Service;
 import android.content.Context;
 import android.content.Intent;
 import android.os.IBinder;

 public class MyAppWidgetService extends Service{

     private Context context;
     //更新周期
     private static final int UPDATE_TIME=5000;
     //周期性更新的Widget 线程
     private WidgetThread widgetThread;

     @Override
     public IBinder onBind(Intent intent) {
         // TODO Auto-generated method stub
         return null;
     }

     @Override
     public void onCreate()
     {
         widgetThread=new WidgetThread();
         widgetThread.start();

         context=this.getApplicationContext();
         super.onCreate();
     }

     @Override
     public void onDestroy()
     {
         if(widgetThread!=null&&widgetThread.isAlive())
             widgetThread.interrupt();

         super.onDestroy();
     }

     private class WidgetThread extends Thread
     {
         @Override
         public void run()
         {
             try
             {
                 while(true)
                 {
                     Intent intent=new Intent(Constant.ACTION_UPDATE_ALL);
                     context.sendBroadcast(intent);

                     sleep(UPDATE_TIME);
                 }
             }catch(InterruptedException error)
             {
                 // 将 InterruptedException 定义在while循环之外，意味着抛出 InterruptedException 异常时，终止线程。
             }
         }
     }
 }

5、在AndroidManifest.xml注册Widget和服务

 "1.0" encoding="utf-8"?>
 "http://schemas.android.com/apk/res/android"
     package="com.feature.test"
     android:versionCode="1"
     android:versionName="1.0" >

     "8"  android:targetSdkVersion="8"/>

         android:allowBackup="true"
         android:icon="@drawable/ic_launcher"
         android:label="@string/app_name"
         android:theme="@android:style/Theme.Black" >


             android:name="com.feature.test.MyAppWidgetProvider">
             "android.appwidget.provider"
                        android:resource="@xml/mywidget_provider"
                        />

                 "android.appwidget.action.APPWIDGET_UPDATE" />
                 "com.feature.test.update_all" />




         ".MyAppWidgetService">

                 "com.feature.test.MyAppWidgetService"/>

至此大功告成！有问题请、意见请回复，本人虚心求教

另外：

1、如果你手机安装了自己做的Widget，在添加-窗口小工具显示不出来，那是因为你把它装到SD卡导致的，请在应用程序里找到自己的Widget将其移至手机存储即可显示

2、如果你安装的Widget放到桌面上，一直在显示“正在加载窗口小工具”，说明该Widget使用了您手机版本不支持的Widget控件，如EditText，使用它就会报错

转载地址：http://blog.csdn.net/tabactivity/article/details/9923281