Android--桌面组件AppWidget
AppWidget通常被称为桌面插件,是Android系统应用开发层上的重要部分,是把一个进程的控件嵌入到别外一个进程的窗口里的一种方法,是与客户端程序交互的组件程序。
先看看效果图:
下面进行实例记录如何创建AppWidget,它是如何与客户端程序进行交互:
第一步:在res目录下新建xml文件夹并创建
ywx_appwidget_info.xml
<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="100dp" android:minHeight="30dp" android:updatePeriodMillis="86400000" android:initialLayout="@layout/ywx_appwidget"> </appwidget-provider>
第二步:新建布局文件ywx_appwidget.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<TextView
android:id="@+id/widgetText"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/appwidget"
android:background="#000000"/>
<ImageView
android:id="@+id/imageId"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:src="@drawable/load"
android:contentDescription="@id/imageId"/>
<Button
android:id="@+id/widgetBut"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/widgetText"/>
</LinearLayout>
第三步:新建一个ExampleAppWidgetProvider.java,实现AppWidgetProvider中的方法
package com.ywx.appwidget_04; import android.app.PendingIntent; import android.appwidget.AppWidgetManager; import android.appwidget.AppWidgetProvider; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.widget.RemoteViews; public class ExampleAppWidgetProvider extends AppWidgetProvider{ private static final String UPDATE_ACTION = "com.ywx.appwidget_04.UPDATE_APP_WIDGET"; //接收广播事件 @Override public void onReceive(Context context, Intent intent) { super.onReceive(context, intent); } //在到达指定的更新时间之后或者当用户向桌面添加App Widget时会调用该方法 @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { super.onUpdate(context, appWidgetManager, appWidgetIds); } //当AppWidget被删除时,会调用该方法 @Override public void onDeleted(Context context, int[] appWidgetIds) { super.onDeleted(context, appWidgetIds); } //当一个AppWidget的实例第一次被创建时会调用该方法 @Override public void onEnabled(Context context) { super.onEnabled(context); } //当最后一个AppWidget实例被删除后调用该方法 @Override public void onDisabled(Context context) { super.onDisabled(context); } }
第四步:在AndroidManifest.xml中声明:这里有两个actiong,一个是系统的,一个是自定义的,只要满足任何一个action就会触发事件
<receiver android:name="ExampleAppWidgetProvider"> <intent-filter > <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/> </intent-filter> <intent-filter > <action android:name="com.ywx.appwidget_04.UPDATE_APP_WIDGET"/> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/ywx_appwidget_info"/> </receiver>
完成以上四步就能够完成简单的AppWidget示例。
在AppWidget开发过程中主要运用到了PendingIntent和RemoteViews,下面将用法记录如下:
PendingIntent主要的三个方法:
1.getActivity(Context context,int requestCode,Intent intent,int flags)
2.getBroadcast(Context context,int requestCode,Intent intent,int flags)
3.getService(Context context,int requestCode,Intent intent,int flags)
RemoteViews的作用:表示一系列的view对象及所表示的对象运行在另外的进程当中。
appwidget组件程序并不是处在当前的进程当中,所以对于监听器的绑定事件与原来的有所区别:
在onUpdate()方法中添加
Intent intent = new Intent(); intent.setAction(UPDATE_ACTION); //使用getBroadcast生成PendingIntent,当对象执行时,发送广播 PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0); RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.ywx_appwidget); remoteViews.setOnClickPendingIntent(R.id.widgetBut, pendingIntent); appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
在onRecive()方法中添加
String action = intent.getAction();
if(UPDATE_ACTION.equals(action)){
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.ywx_appwidget);
remoteViews.setImageViewResource(R.id.imageId, R.drawable.upload);
remoteViews.setTextViewText(R.id.widgetText, "娃哈哈");
AppWidgetManager appWidgeManager = AppWidgetManager.getInstance(context);
ComponentName componentName = new ComponentName(context,ExampleAppWidgetProvider.class);
appWidgeManager.updateAppWidget(componentName, remoteViews);
}else{
super.onReceive(context, intent);
}