Android桌面组件App Widget用法入门教程

本文实例讲述了android桌面组件app widget用法。分享给大家供大家参考。具体如下：

android开发应用除了程序应用，还有app widget应用。好多人会开发程序应用而不会开发app widget应用。本帖子就是帮助大家学习如何开发app widget应用的。

先简单说说app widget的原理。app widget是在桌面上的一块显示信息的东西，通过单击app widget跳转到程序入口类。而系统自带的程序，典型的app widget是music，这个android内置的音乐播放小程序。这个是典型的app widget+app应用。就是一个程序既可以通过app widget启动，也可以通过app启动。app widget就是一个appwidgetprovider+一个ui界面显示（预先绑定了好多intent），界面上的信息可以通过程序控制而改变，单击widget上的控件只能激发发送一个intent，或发出一个service的启动通知。而appwidgetprovider可以拦截这个intent，而进行相应的处理（比如显示新的信息）。

以下模拟一下app widget的应用

通过两种方式启动应用程序

1、app widget启动

长按空白的桌面主屏幕会弹出“添加到主屏幕”，然后选择“窗口小部件”选项进入“选择窗口小部件”，最后选择想要的小部件就会添加到桌面主屏幕，当点击刚才添加的桌面控件就会进入到程序主入口。

2、app启动：跟普通的activity一样

以下为实现代码

main.xml布局文件，程序入口类的界面

my_layout.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">
  <textview android:layout_width="fill_parent"
    android:layout_height="wrap_content" 
    android:text="程序入口" />
</linearlayout>

类mainactivity程序入口类：

package com.ljq.activity;
import android.app.activity;
import android.os.bundle;
/**
 * 主程序入口类
 * 
 * @author jiqinlin
 *
 */
public class mainactivity extends activity{
  @override
  protected void oncreate(bundle savedinstancestate) {
    super.oncreate(savedinstancestate);
    setcontentview(r.layout.main);
  }
}

下面的代码才是开发appwidget用到的代码：

<?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">
  <!-- <imageview
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/imageview" 
    android:gravity="center"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content" /> -->
  <button android:id="@+id/btn"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center"
    android:background="@drawable/png1"/>
</linearlayout>

my_appwidget.xml布局文件：

<?xml version="1.0" encoding="utf-8"?>
<!-- 
appwidgetprovderinfo: 描述appwidget的大小、更新频率和初始界面等信息，以xml文件形式存在于应用的res/xml/目录下。
注意：sdk1.5之后此android:updateperiodmillis就失效了，要自己创建service更新
 -->
<appwidget-provider
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:minwidth="75dip"
  android:minheight="45dip"
  android:updateperiodmillis="1000"
  android:initiallayout="@layout/my_layout"/>

testactivity类：

package com.ljq.activity;
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;
/**
 * 为手机添加桌面控件，当点击桌面控件时则进入主程序
 * 
 * appwidgetprovider：继承自broadcastrecevier，在appwidget应用update、enable、disable和delete时接收通知。
 * 其中，onupdate、onreceive是最常用到的方法，它们接收更新通知
 * 
 * @author jiqinlin
 *
 */
public class testactivity extends appwidgetprovider {
  /**
   * 用来间隔的更新app widget，间隔时间用appwidgetproviderinfo里的updateperiodmillis属性定义(单位为毫秒)。
   * 注意：sdk1.5之后此android:updateperiodmillis就失效了，要自己创建service更新。
   * 这个方法也会在用户添加app widget时被调用，因此它应该执行基础的设置，比如为视图定义事件处理器并启动一个临时的服务service，如果需要的话。
   * 但是，如果你已经声明了一个配置活动，这个方法在用户添加app widget时将不会被调用，
   * 而只在后续更新时被调用。配置活动应该在配置完成时负责执行第一次更新。
   */
  @override
  public void onupdate(context context, appwidgetmanager appwidgetmanager, int[] appwidgetids) {
    system.out.println("onupdate");
    //点击桌面组件时进入主程序入口
    intent intent=new intent(context, mainactivity.class);
    pendingintent pendingintent=pendingintent.getactivity(context, 0, intent, 0);
    //remoteviews类描述了一个view对象能够显示在其他进程中，可以融合layout资源文件实现布局。
    //虽然该类在android.widget.remoteviews而不是appwidget下面,但在android widgets开发中会经常用到它，
    //主要是可以跨进程调用(appwidget由一个服务宿主来统一运行的)。
    remoteviews myremoteviews = new remoteviews(context.getpackagename(), r.layout.my_layout);
    //myremoteviews.setimageviewresource(r.id.imageview, r.drawable.png1);//设置布局控件的属性（要特别注意）
    myremoteviews.setonclickpendingintent(r.id.btn, pendingintent);
    componentname mycomponentname = new componentname(context, testactivity.class);
    //负责管理appwidget，向appwidgetprovider发送通知。提供了更新appwidget状态，获取已经安装的appwidget提供信息和其他的相关状态
    appwidgetmanager myappwidgetmanager = appwidgetmanager.getinstance(context);
    myappwidgetmanager.updateappwidget(mycomponentname, myremoteviews);
  }
  /**
   * 当app widget从宿主中删除时被调用。
   */
  @override
  public void ondeleted(context context, int[] appwidgetids) {
    system.out.println("ondeleted");
    super.ondeleted(context, appwidgetids);
  }
  /**
   * 当一个app widget实例第一次创建时被调用。
   * 比如，如果用户添加两个app widget实例，只在第一次被调用。
   * 如果你需要打开一个新的数据库或者执行其他对于所有的app widget实例只需要发生一次的设置，
   * 那么这里是完成这个工作的好地方。
   */
  @override
  public void onenabled(context context) {
    system.out.println("onenabled");
    super.onenabled(context);
  }
  /**
   * 当你的app widget的最后一个实例被从宿主中删除时被调用。你应该在onenabled(context)中做一些清理工作，比如删除一个临时的数据库
   */
  @override
  public void ondisabled(context context) {
    system.out.println("ondisabled");
    super.ondisabled(context);
  }
  /**
   * 接收到每个广播时都会被调用，而且在上面的回调函数之前。
   * 你通常不需要实现这个方法，因为缺省的appwidgetprovider实现过滤所有app widget广播并恰当的调用上述方法。
   * 注意: 在android 1.5中，有一个已知问题，ondeleted()方法在调用时不被调用。
   * 为了规避这个问题，你可以像group post中描述的那样实现onreceive()来接收这个ondeleted()回调。
   */
  @override
  public void onreceive(context context, intent intent) {
    system.out.println("onreceive");
    super.onreceive(context, intent);
  }
}

清单文件：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.ljq.activity" android:versioncode="1"
  android:versionname="1.0">
  <application android:icon="@drawable/icon" android:label="@string/app_name">
    <activity android:name=".mainactivity" android:label="主程序">
      <intent-filter>
        <action android:name="android.intent.action.main" />
        <category android:name="android.intent.category.launcher" />
      </intent-filter>
    </activity>
    <!-- testactivity类为一个广播接收器，因为testactivity继承自appwidgetprovider -->
    <receiver android:name=".testactivity"  android:label="添加桌面控件">
      <intent-filter>
        <action android:name="android.appwidget.action.appwidget_update" />
      </intent-filter>
      <meta-data android:name="android.appwidget.provider"
        android:resource="@xml/my_appwidget"/>
    </receiver>
  </application>
  <uses-sdk android:minsdkversion="7" />
</manifest>

希望本文所述对大家的android程序设计有所帮助。