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

时间：2022-05-04 13:00:39

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

android 桌面小工具（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>

至此大功告成！有问题请、意见请回复，本人虚心求教android 桌面小工具（Widget）开发教程

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

相关文章