Android学习笔记之AppWidget

什么是AppWidget?AppWidget就是我们平常在桌面上见到的那种一个个的小窗口,利用这个小窗口可以给用户提供一些方便快捷的操作。
今天的目标就是怎么创建一个简单的AppWidget。



首先我先把目录结构展示一下,方便大家理解。



第一步:我们需要在res目录下创建一个folder,可以命名为xml(但这并不是必须的,你也可以换成你喜欢的名字)。然后在这么目录下创建一个xml文件。我的appwidget.xml文件代码如下:

<appwidget-provider
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:minHeight="72dp"
    android:minWidth="294dp"
    android:updatePeriodMillis="86400000"
    android:initialLayout="@layout/example_widget"
    >
</appwidget-provider>

小注解:



在android的命名空间下声明了appwidget 的最小的高度、宽度、以及更新的时间(注意是以毫秒为单位的)和最重要的绑定的布局文件(所谓布局文件就是展示到桌面上的界面的外观)。



第二步:下面的这个文件是在上面的appwidget.xml中的initialLayout属性中绑定的xml布局文件,即example_widget.xml,代码如下:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView
        android:id="@+id/textview1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="MyFirst Widget Example!"
        >
    </TextView>
    <!--由于只是实现简单的效果,所以就只用一个TextView吧-->
</LinearLayout>


第三步:实现了布局展示界面,下面自然而然的,我们就会想到要怎么让这个布局界面展示出来,所以就必须有一个provider,因此,下面就需要创建一个继承了AppWidgetProvider的实例,来完成这一个功能。我的文件名称命名为Widget.java.

package com.summer.widgettest;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
/**
*在这四个必须的方法中,只是打印出一句话,来观察其“生命周期”即可
*/
public class Widget extends AppWidgetProvider {

   @Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
        int[] appWidgetIds) {
    // TODO Auto-generated method stub
       System.out.println("onUpdate");
    super.onUpdate(context, appWidgetManager, appWidgetIds);
}

   @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        // TODO Auto-generated method stub
       System.out.println("onDeleted");
        super.onDeleted(context, appWidgetIds);
    }

   @Override
    public void onDisabled(Context context) {
        // TODO Auto-generated method stub
       System.out.println("onDisabled");
        super.onDisabled(context);
    }

   @Override
    public void onEnabled(Context context) {
        // TODO Auto-generated method stub
       System.out.println("onEnabled");
        super.onEnabled(context);
    }

}


第四步:这也是最为关键的一步,因为前面的工作都是为这一步来打基础的。那么要怎么做捏?答案就是清单文件,在清单文件中进行声明就可以了。我的代码如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.summer.widgettest"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="18" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.summer.widgettest.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <receiver android:name="com.summer.widgettest.Widget">
            <intent-filter >
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
            </intent-filter>
            <meta-data android:name="android.appwidget.provider"
                android:resource="@xml/appwidget_info"/>
        </receiver>
    </application>

</manifest>

小注解:
在这里我么也不难看出,原来widget也就是个广播事件啊,所以需要使用receiver ,然后接下来是一个inent-filter过滤器,功能就是过滤出符合要求的action,在这里当然是widget动作了。
接下来有一个meta-data元数据解释,作用就是对这个widget进行解释的作用,也是为了让android系统知道这到底是个什么东西。(偷偷告诉你,一般这两个要点是固定的表达)



好了,万事具备,只欠”运行“了,接下来就是程序运行之后的界面。。上面的那一行文字就是程序运行之后就可以看到的结果,也就是我们”自制“的一个AppWidget了。(说实话,真的是不太好看)。



回顾与总结:
1、怎么实现的这个AppWidget?先是在res文件夹下创建一个xml 文件夹,并在里面添加一个appwidget-provider文件,再就是写一个用于呈现内容的布局文件。接下来就是一个继承自AppWidgetProvider的类的创建,然后再清单文件中进行相关项的声明就可以了。
2、逻辑思路很重要,每一步的衔接是思路的引导点。
3、这里仅仅是一个简单的小例子,接下来要做的就是如何让这个widget和我们的系统进行交互。
4、好了,大致就是这样,欢迎广大博友留言评论,我一定会虚心的接受,希望能和你们一起进步!



—————————–这里是华丽的分界线——————



上面的是创建一个简单的appWidget的示例,下面是关于如何实现这些Widget如何实现相关的动作侦听的。
知识点准备:
我们应该知道的是,android的widget的进程与程序运行的进程并不是同一个进程,这就意味着我们不能像往常一样简单的使用一个setOnClickListener方法了,因为这样做是完不成相关的动作的侦听的功能的。那么问题来了,我们要怎么实现这些动作的交互呢?
别着急,答案是采用RemoteViews,顾名思义就是采用”远程的“方式来实现相关的处理操作。接下来让我们一起来看一下具体的实现流程吧。



第一步,在之前的appWidget的布局文件中添加一个按钮,用来实现布局。

    <Button
        android:id="@+id/button1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Click To Renew!"
        >
    </Button>


第二步:然后再Widget.java这个AppWidgetProvider的实现类的onUpdate方法中实现相关的代码。为了更好地展示效果,我们可以新建一个Activity,用来呈现点击按钮之后跳转的界面的展示。我命名为RenewActivity.java.相关源码如下所示

  @Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
        int[] appWidgetIds) {
    // TODO Auto-generated method stub
       System.out.println("onUpdate");

       for(int i=0;i<appWidgetIds.length;i++){
           //check which appwidget is enabled!
           System.out.println(appWidgetIds[i]);
           Intent intent=new Intent(context,RenewActivity.class);
           PendingIntent pendingIntent=PendingIntent.getActivity(context, 0, intent, 0);

           RemoteViews remoteViews=new RemoteViews(context.getPackageName(), R.layout.example_widget);
           remoteViews.setOnClickPendingIntent(R.id.button1, pendingIntent);
           appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
       }

    super.onUpdate(context, appWidgetManager, appWidgetIds);
}

RenewActivity.java

package com.summer.widgettest;

import android.app.Activity;
import android.os.Bundle;

public class RenewActivity extends Activity{

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        setContentView(R.layout.renew);
    }
    //由于renew布局是一个非常简单的界面(一个TextView而已),所以不再贴出代码
}


第三步:不要忘记在清单文件中进行Activity的声明,否则你是看不到界面的效果的。

<activity
            android:name="com.summer.widgettest.RenewActivity"
            android:label="Renew Activity!"
            >
</activity>


效果图如下所示:



小总结:
在Widget的onUpdate方法中,我们使用到了RemoteViews类的实例,起作用就不再详细的阐述,这里就直接解释代码的功能吧。如上,创建其实例的时候需要两个参数分别为上下文对象的包名和widget的”布局“,然后在进行对按钮的时间侦听的时候使用到了一个叫pendingIntent的实例,其作用就是将远程的消息信息传达给相应的处理逻辑中,进而实现对widget上按钮的动作的侦听处理。然后使用appWidgetManager进行更新操作就可以了!如此便可以完成我们的代码的逻辑。

时间: 2024-09-26 16:46:57

Android学习笔记之AppWidget的相关文章

Android学习笔记45之gson解析json_Android

JSON即JavaScript Object Natation, 是一种轻量级的数据交换格式,采用完全独立于语言的文本格式,为Web应用开发提供了一种理想的数据交换格式. JSON对象: JSON中对象(Object)以"{"开始, 以"}"结束. 对象中的每一个item都是一个key-value对, 表现为"key:value"的形式, key-value对之间使用逗号分隔. 如:{"name":"coolxing

Android学习笔记(二)App工程文件分析_Android

App工程文件分析 关于如何创建一个最简单的Android App请参照链接: < Android学习笔记(一)环境安装及第一个hello world > http://www.jb51.net/article/52593.htm 创建完的工程文件如下图所示,本文对一些主要的文件进行分析. src文件分析 App源文件如图: 打开源文件 MainActivity.java 可看到如下代码: 源码主要功能如下: App源文件目录 package com.example.firstapp; 导入A

Android学习笔记之应用单元测试实例分析_Android

本文实例讲述了Android学习笔记之应用单元测试.分享给大家供大家参考,具体如下: 第一步:在AndroidManifest.xml中加入如下两段代码: <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.pccw" android:versionCode="1" android:versionName="1.0&qu

Android学习笔记之应用单元测试实例分析

本文实例讲述了Android学习笔记之应用单元测试.分享给大家供大家参考,具体如下: 第一步:在AndroidManifest.xml中加入如下两段代码: <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.pccw" android:versionCode="1" android:versionName="1.0&qu

Android学习笔记45之gson解析json

JSON即JavaScript Object Natation, 是一种轻量级的数据交换格式,采用完全独立于语言的文本格式,为Web应用开发提供了一种理想的数据交换格式. JSON对象: JSON中对象(Object)以"{"开始, 以"}"结束. 对象中的每一个item都是一个key-value对, 表现为"key:value"的形式, key-value对之间使用逗号分隔. 如:{"name":"coolxing

Android学习笔记(5):配置文件AndroidManifest.xml和Android权限

AndroidManifest.xml配置文件包含下面这些信息: 1. 应用程序的包名:包名是应用的唯一标识 2. 应用程序所包含的组件:如Activity.Service.BroadcastReceiver和ContentProvider等 3. 应用程序兼容的最低版本 4. 应用程序使用系统所需的权限声明 5. 其他程序访问该程序所需的权限声明   看下面一个简单的AndroidManifest.xml配置文件 <?xml version="1.0" encoding=&qu

Android学习笔记——文件路径、内容Uri学习笔记[转]

一.URI 通用资源标志符(Universal Resource Identifier, 简称"URI"). Uri代表要操作的数据,Android上可用的每种资源 - 图像.视频片段等都可以用Uri来表示. URI一般由三部分组成: 访问资源的命名机制.  存放资源的主机名.  资源自身的名称,由路径表示.  Android的Uri由以下三部分组成: "content://".数据的路径.标示ID(可选) 举些例子,如:  所有联系人的Uri: content:/

Android学习笔记——保存数据到SQL数据库中(Saving Data in SQL Databases)

知识点: 1.使用SQL Helper创建数据库            2.数据的增删查改(PRDU:Put.Read.Delete.Update) 背景知识:                  上篇文章学习了保存文件,今天学习的是保存数据到SQL数据库中.相信大家对数据库都不陌生.对于                             大量重复的,有特定结构的             数据的保存,用 SQL数据库 来保存是最理想不过了.             下面将用一个关于联系人的数

Android学习笔记——Intents 和 Intent Filters(二)

 本人邮箱:JohnTsai.Work@gmail.com,欢迎交流讨论.       欢迎转载,转载请注明网址:http://www.cnblogs.com/JohnTsai/p/3993488.html 知识点:            继续昨天的Intents 和 Intent Filters的学习        组成一个Intent(Building an Intent):           Intent 对象携带信息(例如明确的组件名或应该接收intent的组件种类(intent ca