Android桌面小部件AppWidget开发
16lz
2021-01-23
Android桌面小部件AppWidget开发
在Android我们经常可以看到各种桌面小部件,比如时钟、天气、音乐播放器等等。我们可以使用AppWidgetProvider来实现小部件的开发。
AppWidgetProvider是Android中提供的用于实现桌面小工具的类,其本质是一个广播,即BroadcastReceiver。
开发一个桌面小部件的步骤:
一、自定义小部件界面
在res/layout/下新建一个布局文件,名称和内容自定义,看你想把小工具做成什么样。需要注意的是系统默认的小工具布局中只支持以下这些标签,如果用了列表以外的标签,会导致小工具加载错误:
- FrameLayout、LinearLayout、RelativeLayout
- TextClock、Button、Chronometer、ImageButton、ImageView、ProgressBar、TextView
比如,我们创建了一个名为widget_layout.xml的布局文件:
<?xml version="1.0" encoding="utf-8"?>
二、定义小部件配置信息
定义小部件的配置信息需要在res目录下新建一个xml目录,然后在res/xml/目录下创建一个配置文件,配置文件名称随意。新建app_widget_provider_info.xml:
<?xml version="1.0" encoding="utf-8"?>
上面的参数意义很明确,initialLayout指小部件的初始化布局,一般与最终布局相同;minHeight和minWidth定义了小部件的最小宽高,与小部件所占网格大小有关;previewImage可以指定在添加小部件时看到的预览图;updatePeriodMillis指定了小部件的自动更新周期,单位为毫秒。
其中minHeight和minWidth的定义可以参考官方文档:https://developer.android.com/guide/practices/ui_guidelines/widget_design.html#design
小部件最小宽高选取.png三、定义小部件类,继承自AppWidgetProvider
import android.app.PendingIntent;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.Context;import android.content.Intent;import android.os.Bundle;import android.widget.RemoteViews;import android.widget.Toast;/** * @author zhengxuze * @date 2017/1/10 create */public class TestWidgetProvider extends AppWidgetProvider { public static final String CLICK_ACTION = "com.seewo.appwidgettest.action.CLICK"; // 点击事件的广播ACTION /** * 每次窗口小部件被更新都调用一次该方法 */ @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { super.onUpdate(context, appWidgetManager, appWidgetIds); RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout); Intent intent = new Intent(CLICK_ACTION); PendingIntent pendingIntent = PendingIntent.getBroadcast(context, R.id.doge_imageView, intent, PendingIntent.FLAG_UPDATE_CURRENT); remoteViews.setOnClickPendingIntent(R.id.doge_imageView, pendingIntent); for (int appWidgetId : appWidgetIds) { appWidgetManager.updateAppWidget(appWidgetId, remoteViews); } } /** * 接收窗口小部件点击时发送的广播 */ @Override public void onReceive(Context context, Intent intent) { super.onReceive(context, intent); if (CLICK_ACTION.equals(intent.getAction())) { Toast.makeText(context, "hello dog!", Toast.LENGTH_SHORT).show(); } } /** * 每删除一次窗口小部件就调用一次 */ @Override public void onDeleted(Context context, int[] appWidgetIds) { super.onDeleted(context, appWidgetIds); } /** * 当最后一个该窗口小部件删除时调用该方法 */ @Override public void onDisabled(Context context) { super.onDisabled(context); } /** * 当该窗口小部件第一次添加到桌面时调用该方法 */ @Override public void onEnabled(Context context) { super.onEnabled(context); } /** * 当小部件大小改变时 */ @Override public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) { super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions); } /** * 当小部件从备份恢复时调用该方法 */ @Override public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) { super.onRestored(context, oldWidgetIds, newWidgetIds); }}
四、在AndroidManifest.xml中声明小部件
OK,小部件完成了,运行一下看看效果:
更多相关文章
- Android桌面小部件与RemoteViews
- Android 在安装完成界面,点击打开应用程序。在应用程序点击home键
- android 修改桌面widget开机后,加载慢的问题
- Android简单实现更换桌面背景的方法
- android 创建桌面快捷方式 、插件
- android 开机直接运行app并当做手机桌面
- Android Widget 小部件(三) 在Activity中添加Widget
- Android关于桌面快捷方式工具类!