博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Android --- App Widget 开发
阅读量:6035 次
发布时间:2019-06-20

本文共 7472 字,大约阅读时间需要 24 分钟。

hot3.png

概要: 

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>

转载于:https://my.oschina.net/u/1021301/blog/120350

你可能感兴趣的文章
01配置管理过程指南
查看>>
jstl格式化时间
查看>>
一则关于运算符的小例
查看>>
centos7 ambari2.6.1.5+hdp2.6.4.0 大数据集群安装部署
查看>>
cronexpression 详解
查看>>
一周小程序学习 第1天
查看>>
小孩的linux
查看>>
SpringMVC、MyBatis声明式事务管理
查看>>
开发者详解:端游及手游服务端的常用架构
查看>>
JavaScript History对象
查看>>
在 Windows 下安装 Oracle 11g XE (Express Edition)
查看>>
ListView优化
查看>>
【原创】 PostgreSQL 实现MySQL 的auto_increment 字段
查看>>
vs2015添加vc助手
查看>>
检测点1.1
查看>>
android--------阿里 AndFix 热修复
查看>>
java springcloud版b2b2c社交电商spring cloud分布式微服务 (七)高可用的分布式配置中心(Spring Cloud Config)...
查看>>
Oozie与Coordinator调度讲解及系统时区配置与定时触发两种配置方式
查看>>
RGB_YUV_YCbCr
查看>>
tesseract 安装及使用
查看>>