ch014 Android AppWidget

--------------------------------------------AndroidManifest.xml------------------------------

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    package="com.ch14"

    android:versionCode="1"

    android:versionName="1.0" >

    <uses-sdk

        android:minSdkVersion="10"

        android:targetSdkVersion="15" />

    <application

        android:icon="@drawable/ic_launcher"

        android:label="@string/app_name"

        android:theme="@style/AppTheme" >

        <activity

            android:name=".MainActivity"

            android:label="@string/title_activity_main" >

            <intent-filter>

                <action android:name="com.ch14" />

                <category android:name="android.intent.category.DEFAULT" />

            </intent-filter>

        </activity>

        <receiver android:name=".MyAppWidgetProvider" >

            <meta-data

                android:name="android.appwidget.provider"

                android:resource="@xml/appwidget_my" />

            <intent-filter>

                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" >

                </action>

            </intent-filter>

        </receiver>

    </application>

</manifest>

--------------------------------------------XML appwidget_my.xml--------------------------

<?xml version="1.0" encoding="utf-8"?>

<appwidget-provider

  xmlns:android="http://schemas.android.com/apk/res/android"

  android:minWidth = "294dp"

  android:minHeight = "72dp"

  android:updatePeriodMillis = "0"

  android:initialLayout = "@layout/myappwidgetlayout"

  >

</appwidget-provider>

<!-- updatePeriodMillis = 0 为手动更新 -->

--------------------------------------------Layout activity_main.xml------------------------

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:tools="http://schemas.android.com/tools"

    android:layout_width="match_parent"

    android:layout_height="match_parent" >

    <TextView

        android:layout_width="wrap_content"

        android:layout_height="wrap_content"

        android:layout_centerHorizontal="true"

        android:layout_centerVertical="true"

        android:text="@string/hello_world"/>

</RelativeLayout>

--------------------------------------------Layout myappwidgetlayout.xml-----------------

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:layout_width="fill_parent"

    android:layout_height="fill_parent"

    android:orientation="vertical" >

    <Button

        android:id="@+id/txtapp"

        android:layout_width="fill_parent"

        android:layout_height="wrap_content"

        android:gravity="center"

        android:text="send........" >

    </Button>

</LinearLayout>

--------------------------------------------MainActivity.java---------------------------------

package com.ch14;

import android.app.Activity;

import android.os.Bundle;

public class MainActivity extends Activity {

    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

    }

}

--------------------------------------------MyAppWidgetProvider.java-----------------------

package com.ch14;

import com.ch14.util.LogOut;

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;

/**

 * 

 * 项目名称：com.ch14    

 * 类名称：MyAppWidgetProvider    

 * 类描述：  自定义窗口小部件

 * 创建人：方勇   

 * 创建时间：2012-11-22 下午9:05:00   

 * Copyright (c) 方勇-版权所有

 */

public class MyAppWidgetProvider extends AppWidgetProvider {

/* 接受广播事件 */

@Override

public void onReceive(Context context, Intent intent) {

LogOut.out(this, "onReceive()");

/* 只能通过远程对象来设置MyAppWidgetProvider中的控件状态 */

RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.myappwidgetlayout);

/* 管理AppWidgetProvider,以便进行更新操作 */

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);

/* 获得本程序创建的appwidget */

ComponentName componentName = new ComponentName(context, MyAppWidgetProvider.class);

/* 更新appwidget */

appWidgetManager.updateAppWidget(componentName, remoteViews);

super.onReceive(context, intent);

}

/* 组件被放置到桌面上时，或者刷新时间到达时调用 */

@Override

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {

LogOut.out(this, "onUpdate()");

RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.myappwidgetlayout);

Intent intent = new Intent();

intent.setAction("com.ch14");

/* 

 * 延迟执行的INTENT

 * 

 * 1、常使用的是FLAG_UPDATE_CURRENT，因为描述的Intent有更新的时候需要用到这个flag去更新你的描述，

 * 否则组件在下次事件发生或时间到达的时候extras永远是第一次Intent的extras。

 * 

 * 2、使用FLAG_CANCEL_CURRENT也能做到更新extras，只不过是先把前面的extras清除

 * 

 * 3、FLAG_CANCEL_CURRENT和FLAG_UPDATE_CURRENT的区别在于能否new一个Intent，

 * FLAG_UPDATE_CURRENT能够new一个Intent，而

 * FLAG_CANCEL_CURRENT则不能，只能使用第一次的Intent。

 * 

 * 4、(比较少用)

 * FLAG_ONE_SHOT获取的PendingIntent只能使用一次，再使用PendingIntent也将失败

 * FLAG_NO_CREAT获取的PendingIntent描述的Intent不存在则返回NULL值.

 * 

 */

PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);

/* 通过PendingIntent和mRemoteViews.setOnClickPendingIntent为AppWidget中的Button设置监听器 */

remoteViews.setOnClickPendingIntent(R.id.txtapp, pendingIntent);

remoteViews.setTextViewText(R.id.txtapp, "A07");

appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);

super.onUpdate(context, appWidgetManager, appWidgetIds);

}

/* 删除一个AppWidget组件时被调用 */

@Override

public void onDeleted(Context context, int[] appWidgetIds) {

LogOut.out(this, "onDeleted()");

super.onDeleted(context, appWidgetIds);

}

/* AppWidget的实例第一次被创建时调用 */

@Override

public void onEnabled(Context context) {

LogOut.out(this, "onEnabled()");

super.onEnabled(context);

}

/* 最后一个AppWidget组件被删除时调用 */

@Override

public void onDisabled(Context context) {

LogOut.out(this, "onDisabled()");

super.onDisabled(context);

}

}

--------------------------------------------LogOut.java---------------------------------------

package com.ch14.util;

import android.util.Log;

/**

 * 

 * 项目名称：com.ch14    

 * 类名称：LogOut    

 * 类描述： 指定日志输出格式

 * 创建人：方勇   

 * 创建时间：2012-11-22 下午9:35:41   

 * Copyright (c) 方勇-版权所有

 */

public class LogOut {

public static final String TAG = "A07";

private static final boolean DEBUG = true;

public static void out(Object obj, String info) {

if (DEBUG) {

String tag = TAG;

if (info.startsWith("length")) {

tag = TAG + "_TMP";

}

if (obj instanceof String) {

Log.d(tag, ((String) obj) + "->" + info);

} else {

Log.d(tag, obj.getClass().toString().substring(6) + "->" + info);

}

}

}

public static void out(Object obj, String tag, String info) {

if (DEBUG) {

if (obj instanceof String) {

Log.d(TAG + "_" + tag, ((String) obj) + "->" + info);

} else {

Log.d(TAG + "_" + tag, obj.getClass().toString().substring(6)

+ "->" + info);

}

}

}

}

--------------------------------------------结果------------------------------------------------

1、长按桌面(或选中桌面的某个位置，长按鼠标左键)

2、弹出对话框

3、选中后，桌面多了个按钮部件

4、双击AppWidget

<!--EndFragment-->