源码网商城,靠谱的源码在线交易网站 我的订单 购物车 帮助

源码网商城

Android Widget 桌面组件开发介绍

  • 时间:2020-05-12 05:11 编辑: 来源: 阅读:
  • 扫一扫,手机访问
摘要:Android Widget 桌面组件开发介绍
Android widget 桌面组件开发 Widget是Android1.5版所引进的特性之一.Widget,可让用户在主屏幕界面及时了解程序显示的重要信息.标准的Android系统已包含几个Widget的示例,如模拟时钟,音乐播放器等. [b]一、AppWidget 框架类[/b] 1、[b]AppWidgetProvider [/b]:继承自 BroadcastRecevier , 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中,onUpdate、onReceive 是最常用到的方法,它们接收更新通知。 2、[b]AppWidgetProvderInfo[/b]:描述 AppWidget 的大小、更新频率和初始界面等信息,以XML 文件形式存在于应用的 res/xml/目录下。 3、[b]AppWidgetManger [/b]:负责管理 AppWidget ,向 AppwidgetProvider 发送通知。 4、[b]RemoteViews[/b] :一个可以在其他应用进程中运行的类,向 AppWidgetProvider 发送通知。 [b]二、AppWidget 框架的主要类介绍[/b]  1)[b] AppWidgetManger 类[/b] 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) 继承自[b]AppWidgetProvider [/b]可实现的方法为如下: [b]1、onDeleted(Context context, int[] appWidgetIds) [/b] [b]2、onDisabled(Context context) [/b] [b]3、onEnabled(Context context) [/b] [b]4、onReceive(Context context, Intent intent) [/b]  Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver  所以可以重写onRecevie 方法,当然必须在后台注册Receiver [b]5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)[/b] [b]三,Demo 详解[/b] [b] 1.建立Widget内容提供者文件,我们在res下建立xml文件夹,并且新建一个widget_provider.xml代码入下:[/b]
<?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" 此句为指定桌面组件的布局文件。 [b] 主要设置的参数如下: [/b] [b]minWidth:[/b] 定义Wdiget组件的宽度 [b]minHeight: [/b]定义Wdiget组件的高度 [b]updatePeriodMillis:[/b] 更新的时间周期 [b]initialLayout: Widget[/b]的布局文件 [b]configure:[/b] 如果需要在启动前先启动一个Activity进行设置,在这里给出Activity的完整类名(后面会说到,与一般Activity的实现有些许差别) *Widget大小的计算 :(单元格数*74)-2,API上说是为了防止像素计算时的整数舍入导致错所以-2...不是很明白 [b] 2.修改main.xml布局,代码如下:[/b]
<?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中支持的组件如下: [b]FrameLayout、LinearLayout、RelativeLayout[/b] [b]AnalogClock、Button、Chronmeter、ImageButton、ImageView、ProgressBar、TextView [/b] *如果使用了除此之外的组件,则在Widget创建时会导致android.view.InflateExceptionn异常。 PS:这就导致有一些功能或样式无法实现,如很基本的list或文本编辑框都是无法直接实现的。如果想自定义Widget中的View的话只能通过修改framework来提供相应组件的支持。 [b] 3.写一个类继承自AppWidgetProvider[/b]
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,里面提供了以下函数: [b]onReceive(Context, Intent) [/b] [b]onUpdate(Context , AppWidgetManager, int[] appWidgetIds)[/b] [b]onEnabled(Context)[/b] [b]onDeleted(Context, int[] appWidgetIds)[/b] [b]onDisabled(Context)[/b] 可通过重写以上函数来监听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
[b] *每次状态的变化会触发onReceive,一般该函数是不需要重写的。 [/b] [b] 四、修改配置文件AndroidManifest.xml,后台注册Receiver,代码如下:[/b]
<?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  提供的音乐播放器。 上面代码中比较重要的是这一句[b]<meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data> [/b] 大意为指定桌面应用程序的AppWidgetProvderInfo  文件,使其可作其管理文件。 [b]五、添加修改资源[/b] 增加图片素材。
<?xml version="1.0" encoding="utf-8"?>   
<resources>   
  <string name="hello">Hello World, WidetDemo!</string>   
  <string name="app_name">DaysToWorldCup</string>   
</resources>
以上就是对Android widget 资料的整理,希望能帮助需要的朋友。
  • 全部评论(0)
联系客服
客服电话:
400-000-3129
微信版

扫一扫进微信版
返回顶部