android 桌面小工具（Widget）开发教程
刚学做了个Widget，感觉不错哦，先来秀下效果（用朋友手机截的图）
这个Widget会每隔5秒钟自动切换内容和图片，图片最好使用小图，大图会导致你手机桌面（UI）线程卡顿
教程开始：
1、首先创建一个布局（layout），用以显示Wdiget
activity_main.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@drawable/ddz_gameend_frame"
>
<!--Relativelayout 的 android:background请自行更换你的图片-->
<TextView
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=""
/>
<ImageView
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"
/>
<Button
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="详情"
/>
<!--本人的程序用了android:background="@drawable/mybutton"，为了简化示例在此不使用-->
</RelativeLayout>
2、然后创建一个appwidget-provider 的XML文件，点击资源目录的Res文件夹，鼠标右键选择New- android xml file
mywidget_provider.xml
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="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"
>
</appwidget-provider>
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<Integer> hashSet=new HashSet<Integer>();
//图片资源,作者请自行修改成自己的图片
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<Integer> 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和服务
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.feature.test"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk android:minSdkVersion="8" android:targetSdkVersion="8"/>
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@android:style/Theme.Black" >
<!-- 注册AppWidget Provider -->
<receiver
android:name="com.feature.test.MyAppWidgetProvider">
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/mywidget_provider"
/>
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<action android:name="com.feature.test.update_all" />
</intent-filter>
</receiver>
<!-- 注册服务 -->
<service android:name=".MyAppWidgetService">
<intent-filter>
<action android:name="com.feature.test.MyAppWidgetService"/>
</intent-filter>
</service>
</application>
</manifest>
至此大功告成！有问题请、意见请回复，本人虚心求教
另外：
1、如果你手机安装了自己做的Widget，在添加-窗口小工具显示不出来，那是因为你把它装到SD卡导致的，请在应用程序里找到自己的Widget将其移至手机存储即可显示
2、如果你安装的Widget放到桌面上，一直在显示“正在加载窗口小工具”，说明该Widget使用了您手机版本不支持的Widget控件，如EditText，使用它就会报错
