Android Widget 桌面组件开发介绍
Android widget 桌面组件开发
Widget是Android1.5版所引进的特性之一.Widget,可让用户在主屏幕界面及时了解程序显示的重要信息.标准的Android系统已包含几个Widget的示例,如模拟时钟,音乐播放器等.
一、AppWidget 框架类
1、AppWidgetProvider ：继承自 BroadcastRecevier ， 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中，onUpdate、onReceive 是最常用到的方法，它们接收更新通知。
2、 AppWidgetProvderInfo：描述 AppWidget 的大小、更新频率和初始界面等信息，以XML 文件形式存在于应用的 res/xml/目录下。
3、AppWidgetManger ：负责管理 AppWidget ，向 AppwidgetProvider 发送通知。
4、RemoteViews ：一个可以在其他应用进程中运行的类，向 AppWidgetProvider 发送通知。
二、AppWidget 框架的主要类介绍
1) AppWidgetManger 类
bindAppWidgetId(int appWidgetId, ComponentName provider)
通过给定的ComponentName 绑定appWidgetId
getAppWidgetIds(ComponentName provider)
通过给定的ComponentName 获取AppWidgetId
getAppWidgetInfo(int appWidgetId)
通过AppWidgetId 获取 AppWidget 信息
getInstalledProviders()
返回一个List<AppWidgetProviderInfo>的信息
getInstance(Context context)
获取 AppWidgetManger 实例使用的上下文对象
updateAppWidget(int[] appWidgetIds, RemoteViews views)
通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件
updateAppWidget(ComponentName provider, RemoteViews views)
通过 ComponentName 对传进来的 RemoeteView 进行修改，并重新刷新AppWidget 组件
updateAppWidget(int appWidgetId, RemoteViews views)
通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件
2) 继承自 AppWidgetProvider 可实现的方法为如下：
1、onDeleted(Context context, int[] appWidgetIds)
2、onDisabled(Context context)
3、onEnabled(Context context)
4、onReceive(Context context, Intent intent)
Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver 所以可以重写onRecevie 方法，当然必须在后台注册Receiver
5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
三,Demo 详解
1.建立Widget内容提供者文件，我们在res下建立xml文件夹，并且新建一个widget_provider.xml代码入下:
<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="50dip" android:minHeight="50dip" android:updatePeriodMillis="10000" android:initialLayout="@layout/main" />
Tip:上文说过AppWidgetProvderInfo 是在res/xml 的文件形式存在的，看参数不难理解，比较重要的是这里android:initialLayout="@layout/main" 此句为指定桌面组件的布局文件。
主要设置的参数如下:
minWidth: 定义Wdiget组件的宽度
minHeight: 定义Wdiget组件的高度
updatePeriodMillis: 更新的时间周期
initialLayout: Widget的布局文件
configure: 如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名(后面会说到，与一般Activity的实现有些许差别)
*Widget大小的计算 :(单元格数*74)-2，API上说是为了防止像素计算时的整数舍入导致错所以-2...不是很明白
2.修改main.xml布局，代码如下:
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" android:background="@drawable/wordcup" > <TextView android:id="@+id/wordcup" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/hello" android:textSize="12px" android:textColor="#ff0000" /> </LinearLayout>
Tips:定义了Widget界面布局的XML文件(位于res/layout/..)，需要注意的是使用的组件必须是RemoteViews所支持的，目前原生API中支持的组件如下：
FrameLayout、LinearLayout、RelativeLayout
AnalogClock、Button、Chronmeter、ImageButton、ImageView、ProgressBar、TextView
*如果使用了除此之外的组件，则在Widget创建时会导致android.view.InflateExceptionn异常。
PS:这就导致有一些功能或样式无法实现，如很基本的list或文本编辑框都是无法直接实现的。如果想自定义Widget中的View的话只能通过修改framework来提供相应组件的支持。
3.写一个类继承自AppWidgetProvider
package com.android.tutor;
import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.Timer;
import java.util.TimerTask;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.widget.RemoteViews;
public class WidetDemo extends AppWidgetProvider {
/** Called when the activity is first created. */
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
Timer timer = new Timer();
timer.scheduleAtFixedRate(new MyTime(context,appWidgetManager), 1, 60000);
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
private class MyTime extends TimerTask{
RemoteViews remoteViews;
AppWidgetManager appWidgetManager;
ComponentName thisWidget;
public MyTime(Context context,AppWidgetManager appWidgetManager){
this.appWidgetManager = appWidgetManager;
remoteViews = new RemoteViews(context.getPackageName(),R.layout.main);
thisWidget = new ComponentName(context,WidetDemo.class);
}
public void run() {
Date date = new Date();
Calendar calendar = new GregorianCalendar(2010,06,11);
long days = (((calendar.getTimeInMillis()-date.getTime())/1000))/86400;
remoteViews.setTextViewText(R.id.wordcup, "距离南非世界杯还有" + days+"天");
appWidgetManager.updateAppWidget(thisWidget, remoteViews);
}
}
}
AppWidgetProvider实际上就是一个BroadcastReceiver，里面提供了以下函数：
onReceive(Context, Intent)
onUpdate(Context , AppWidgetManager, int[] appWidgetIds)
onEnabled(Context)
onDeleted(Context, int[] appWidgetIds)
onDisabled(Context)
可通过重写以上函数来监听Widget状态的变化并进行相应的处理。
onUpdate 为组件在桌面上生成时调用，并更新组件UI，onReceiver 为接收广播时调用更新UI，一般这两个方法是比较常用的。
Widget的更新与Activity不同，必须借助于RemoteViews和AppWidgetMananger。
函数调用周期 [启动 - 无confiure Activity] onReceive onEnabled —— 第一个widget被显示 onReceive onUpdate —— 刷新界面 [启动 - 带confiuration Activity] onReceive onUpdate [拖动] <无状态变化> [周期更新] onReceive onUpdate [删除] onReceive onDeleted —— widget被删除 onReceive onDisabled —— 最后一个widget被移除 [启动时位置不够] onReceive onEnabled onReceive onUpdate onReceive onDeleted onReceive onDisabled
*每次状态的变化会触发onReceive，一般该函数是不需要重写的。
四、修改配置文件AndroidManifest.xml，后台注册Receiver,代码如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.android.tutor"
android:versionCode="1"
android:versionName="1.0">
<application android:icon="@drawable/icon" android:label="@string/app_name">
<receiver android:name=".WidetDemo"
android:label="@string/app_name">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/widget_provider"
/>
</receiver>
</application>
<uses-sdk android:minSdkVersion="7" />
</manifest>
Tips:
因为是桌面组件，所以暂时不考虑使用Activity 界面，当然你在实现做项目时可能会需要点击时跳转到Activity 应用程序上做操作，典型的案例为Android 提供的音乐播放器。
上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_provider"></meta-data> 大意为指定桌面应用程序的AppWidgetProvderInfo 文件，使其可作其管理文件。
五、添加修改资源
增加图片素材。
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="hello">Hello World, WidetDemo!</string> <string name="app_name">DaysToWorldCup</string> </resources>
以上就是对Android widget 资料的整理，希望能帮助需要的朋友。
相关文章
这篇文章主要介绍了Android亮屏和熄屏控制的方法,结合实例形式较为详细的分析了Android亮屏与息屏的原理,实现技巧与相关注意事项,需要的朋友可以参考下2016-02-02
这篇文章主要为大家详细介绍了Android实现蓝牙聊天功能，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-06-06
本文主要介绍Android 应用更换皮肤，Android应用如果想更换皮肤这里帮大家整理了相关资料，有需要的小伙伴可以参考下2016-08-08
这篇文章主要介绍了Android架构组件LiveData使用详解的相关资料,需要的朋友可以参考下2023-07-07
这篇文章主要介绍了Android之事件分发机制与冲突详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-09-09
音频是个专业术语,音频一词已用作一般性描述音频范围内和声音有关的设备及其作用,人类能够听到的所有声音都称之为音频,它可能包括噪音等,下面这篇文章主要给大家介绍了关于Android音频焦点管理的相关资料,需要的朋友可以参考下2022-01-01
Android Studio真机无线连接USB设备调试运行详解流程
你在Android Studio写app时是否也有想过如果可以不用数据线连接手机调试运行就好了？如果需要取出数据线插接的话我肯定是嫌麻烦的，但是模拟器有时候需要测试一些需要硬件支持的功能时又不管用，所以最好的测试还是在真机上，本篇教你扔掉数据线来无线调试2021-11-11
Android画图之抗锯齿paint和Canvas两种方式实例
本篇文章主要介绍了Android画图之抗锯齿paint和Canvas两种方式实例，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-04-04
这篇文章主要为大家详细介绍了Android实现倒计时效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2020-10-10
这篇文章主要介绍了Android Fragment使用的相关资料，帮助大家更好的理解和学习使用Android开发，感兴趣的朋友可以了解下2021-04-04
最新评论