文档章节

Android --- App Widget 开发

J
 Jumper_Woo
发布于 2013/04/06 14:07
字数 1129
阅读 756
收藏 14

概要: 

App Widget应用小控件,用户可以通过长按屏幕,然后添加小控件倒桌面,这些小控件一般都是为了显示一些信息在桌面上,同时方便用户通过点击桌面上的小控件来访问你的程序。

基础知识:

开发一个小控件,我们需要:

AppWidgetProvider

继承AppWidgetProvider类,并重载一些方法(onUpdate方法尤为重要,后面描述Why),AppWidgetProvider其实也是一个BroadcastReceiver,因此我们也可以象扑通的BroadcastReceiver一样监听广播事件。

AppWidgetProviderInfo

在XML文件中,描述AppWidgetProvider的Metadata信息,如声明AppWidgetProvider类,Layout,更新间隔,配置AppWidget的Activity等。。。

Layout

定义一个App Widget,我们也需要定义它的Layout文件。在App Widget中,不是所有的Android控件都能放入App Widget的Layout中去的,现阶段只有下面一些Layout和控件才能放入App Widget中。

还有在程序中要控制App Widget的控件都通过RemoteViews来控制。

Layout类:LinearLayout, FrameLayout,RelativeLayout

控件类:

AnalogClock,Button,Chronometer,ImageButton,ImageView,ProgressBar

TextView,ViewFlipper,ListView,GridView,StackView,AdapterViewFlipper

如果上述以外的控件或者Layout类被放入App Widget的Layout文件中的话,App Widget将不能在桌面显示。

开发流程:

Step1.继承AppWidgetProvider类,并重载下列方法(如有必要的话)

*应为用户可以在桌面添加多个相同的App Widget,因此系统调用我们重载的方法时,很多时候都是传给我们一个id数组。

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

onUpdate是非常重要的一个方法。当用户在桌面添加一个App Widget时,或者用户定义的时钟updatePeriodMillis响应时,此方法都会被调用。

*但是如果用户定义了configuration Activity时,在用户添加小控件时,onUpdate不会被调用。

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

每一个App Widget从桌面删除时,onDeleted都会被调用。

public void onEnabled(Context context)

用户初次添加App Widget时,onEnabled会被调用。

public void onDisabled(Context context)

当用户删除了所有的App Widget时,onDisabled会被调用

Step2.定义AppWidgetProviderInfo

在res文件夹下创建名为xml的文件夹,然后添加一xml,Tag为appwidget-provider,

屏幕一般被分为,4x4单元,因此我们定义的miniHeight和miniWidth不要超过4x4单元的大小,每一单元大小为72x72dp

initialLayout用来声明Layout文件,updatePeriodMills来定义更新App Widget的时钟,当不需要更新时设置为0

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

    android:initialLayout="@layout/example_app_widget_provider"

    android:minHeight="72dp"

    android:minWidth="200dp"

    android:updatePeriodMillis="60000" >

</appwidget-provider>

Step3.定义Manifest

前面已经讲过,所有的AppWidgetProvider实际上都是BroadcastReceiver,因此在Manifest里面申明时使用receiver标签。meta-data标签的名字固定为"android.appwidget.provider",resource用来声明AppWidgetProviderInfo xml,intent-filter里面添加“android.appwidget.action.APPWIDGET_UPDATE”,当我们定义的时钟android:updatePeriodMillis响应时,会广播APPWIDGET_UPDATE,此时我们的onUpdate会被调用。

        <receiver android:name="...ExampleAppWidgetProvider" >

            <meta-data

                android:name="android.appwidget.provider"

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

            <intent-filter>

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

            </intent-filter>

        </receiver>

源代码:

<Java>

ExampleAppWidgetProvider.java

package com.jumper.android.demos.appwidget;

import com.jumper.android.demos.R;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;


public class ExampleAppWidgetProvider extends AppWidgetProvider {


private final static String lOG_TAG = ExampleAppWidgetProvider.class.getName();
public final static String SUBMIT_ACTION = "com.jumper.android.demos.appwidget.SUBMIT";
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
}


@Override
public void onDisabled(Context context) {
super.onDisabled(context);
}


@Override
public void onEnabled(Context context) {
super.onEnabled(context);
}


@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
Log.v(lOG_TAG, "onUpdate=" + appWidgetIds.length);
int length = appWidgetIds.length;
for(int i=0; i<length; i++) {
updateWidget(context, appWidgetManager, appWidgetIds[i]);
}
}

private void updateWidget(Context context, AppWidgetManager appwidgetmanager, int appwidgetid) {
Log.v(lOG_TAG, "updateWidget ID=" + appwidgetid);
Intent intent = new Intent();
intent.setAction(SUBMIT_ACTION);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appwidgetid);

PendingIntent pendingintent = PendingIntent.getBroadcast(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
RemoteViews removteviews = new RemoteViews(context.getPackageName(), R.layout.example_app_widget_provider);
removteviews.setOnClickPendingIntent(R.id.app_widget_submit, pendingintent);

appwidgetmanager.updateAppWidget(appwidgetid, removteviews);
}


}


ExampleAppWidgetReceiver.java

package com.jumper.android.demos.appwidget;

import com.jumper.android.demos.R;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;


public class ExampleAppWidgetReceiver extends BroadcastReceiver {
private final String lOG_TAG = this.getClass().getName();
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
Log.v(lOG_TAG, "onReceive=" + action);
if(action.equals(ExampleAppWidgetProvider.SUBMIT_ACTION)) {
int appwidgetid = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, 0);
Log.v(lOG_TAG, "ID=" + appwidgetid);
updateWidget(context, AppWidgetManager.getInstance(context), appwidgetid);

}
}
private void updateWidget(Context context, AppWidgetManager appwidgetmanager, int appwidgetid) {
Log.v(lOG_TAG, "updateWidget ID=" + appwidgetid);
RemoteViews removteviews = new RemoteViews(context.getPackageName(), R.layout.example_app_widget_provider);
removteviews.setTextViewText(R.id.app_widget_output, "WidgetID:" + appwidgetid + " " + System.currentTimeMillis());
appwidgetmanager.updateAppWidget(appwidgetid, removteviews);
}
}


<AppWidgetProviderInfo>Xml


app_widget_provider_info.xml

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

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"

    android:initialLayout="@layout/example_app_widget_provider"

    android:minHeight="72dp"

    android:minWidth="286dp"

    android:updatePeriodMillis="60000" >

</appwidget-provider>


<Layout>

example_app_widget_provider.xml

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

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

    android:layout_width="160dp"

    android:layout_height="80dp"

    android:orientation="vertical" >

    <LinearLayout

        android:layout_width="match_parent"

        android:layout_height="wrap_content"

        android:gravity="center"

        >

    <TextView

        android:id="@+id/app_widget_output"

        android:layout_width="wrap_content"

        android:layout_height="wrap_content"

        android:layout_marginLeft="10.0dip"

        android:text="Medium Text"

        android:textAppearance="?android:attr/textAppearanceMedium" />

        <ImageView

            android:id="@+id/app_widget_submit"

            android:layout_width="wrap_content"

            android:layout_height="wrap_content"

            android:layout_marginLeft="5.0dip"

            android:src="@drawable/ic_menu_market_search" />

    </LinearLayout>

</LinearLayout>

<Manifest>

        <receiver android:name="com.jumper.android.demos.appwidget.ExampleAppWidgetProvider" >

            <meta-data

                android:name="android.appwidget.provider"

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

            <intent-filter>

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

            </intent-filter>

        </receiver>

        <receiver android:name="com.jumper.android.demos.appwidget.ExampleAppWidgetReceiver" >

            <intent-filter>

                <action android:name="com.jumper.android.demos.appwidget.SUBMIT" />

                <action android:name="android.intent.ACTION_TIMEZONE_CHANGED" />

                <action android:name="android.intent.ACTION_TIME" />

            </intent-filter>

        </receiver>



© 著作权归作者所有

J
粉丝 0
博文 3
码字总数 2996
作品 0
成都
程序员
私信 提问
Android开发指南-窗口小部件(App Widgets)

http://blog.csdn.net/iefreer/article/details/4626274# 应用程序窗口小部件App Widgets 应用程序窗口小部件(Widget)是微小的应用程序视图,可以被嵌入到其它应用程序中(比如桌面)并接收...

鲜鲜
2014/09/16
432
0
Android开发之App Widget的学习及使用

(以下为本人对于官方文档的理解,能力有限,有错还望指出) 1、首先,我们先阅读下官方文档,后面活给出Demo程序 App Widgets(应用程序 小工具,窗口小部件) App Widgets are miniature ...

Angels_安杰
2015/11/16
596
0
Android Launcher开发之AppWidget(桌面小部件)全面解析

导读:先简单说说Widget的原理。Widget是在桌面上的一块显示信息的东西,也通过单击Widget跳转到一个程序里面。而系统自带的程序,典型的Widget是music,这个Android内置的音乐播放小程序。先...

长平狐
2012/09/03
2.2K
0
[Android] App Widgets-窗口小部件-partI

应用程序窗口小部件(Widget)是微型的应用程序视图,它可以被嵌入到其它应用程序中(比如桌面)并接收周期性的更新。你可以通过一个App Widget Provider来发布一个Widget。可以容纳其它App...

android技术开发
2013/07/30
439
0
Flutter尝鲜:跨平台移动应用开发

开始之前 本人使用Flutter开发的一个图文App《每日图文》,可以同时运行在Android和iOS上,欢迎体验,喜欢的话还不吝Star一下。 叮叮叮~ 传送门 Flutter为何物? 随着移动App开发成本越来越...

开发的猫
2018/06/06
0
0

没有更多内容

加载失败,请刷新页面

加载更多

可见性有序性,Happens-before来搞定

写在前面 上一篇文章并发 Bug 之源有三,请睁大眼睛看清它们 谈到了可见性/原子性/有序性三个问题,这些问题通常违背我们的直觉和思考模式,也就导致了很多并发 Bug 为了解决 CPU,内存,IO ...

tan日拱一兵
38分钟前
3
0
网络七层模型与TCP/UDP

为了使全球范围内不同的计算机厂家能够相互之间能够比较协调的进行通信,这个时候就有必要建立一种全球范围内的通用协议,以规范各个厂家之间的通信接口,这就是网络七层模型的由来。本文首先...

爱宝贝丶
42分钟前
4
0
Jenkins World 贡献者峰会及专家答疑展位

本文首发于:Jenkins 中文社区 原文链接 作者:Marky Jackson 译者:shunw Jenkins World 贡献者峰会及专家答疑展位 本文为 Jenkins World 贡献者峰会活动期间的记录 Jenkins 15周岁啦!Jen...

Jenkins中文社区
59分钟前
10
0
杂谈:面向微服务的体系结构评审中需要问的三个问题

面向微服务的体系结构如今风靡全球。这是因为更快的部署节奏和更低的成本是面向微服务的体系结构的基本承诺。 然而,对于大多数试水的公司来说,开发活动更多的是将现有的单块应用程序转换为...

liululee
今天
8
0
OSChina 周二乱弹 —— 我等饭呢,你是不是来错食堂了?

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @ 自行车丢了:给主编推荐首歌 《クリスマスの夜》- 岡村孝子 手机党少年们想听歌,请使劲儿戳(这里) @烽火燎原 :国庆快来,我需要长假! ...

小小编辑
今天
1K
14

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部