App Wiget(Android窗体挂件)

    xiaoxiao2021-03-25  143

    App Widget

    了解AppWidget前可以先看几个不错的Blog: 传送门: 1. Google App Widget介绍 2. App Widget初探


    每个AppWidget都有一个AppWidgetProviderInfo对象,该对象描述了每个AppWidget的基本数据(meta-data)信息 ,其定义在<appwidget-provider>节点信息。每个AppWidget都对应一个RemoteViews视图对象,该RemoteViews提供了特定AppWidget的展示(View视图)和操作 (例如,点击该RemoteViews会跨进程处理一些事情)。AppWidgetManager类维护了应用程序中所有的AppWidget,并且为给每个AppWidget特定的Id去标识他们(一般我们用 appWidgetId去标识)。通过给定的appWidgetId,AppWidgetManager可以管理对应的AppWidget,例如:更新该AppWidgetId的RemoteViews视图,删除该AppWidget对象等 。AppWidgetProvider广播类从来说是一个监听器,系统把对AppWidget的操作(例如,创建和更新等)分发给AppWidgetProvider类去处理。 对每个AppWidget,我们可以创建多个其多个实例,当然这些实例对应于不同的appWidgetId。 假设存在这么个MyAppWidgetProvider广播类,以及对应的MyAppWidgetProviderInfo对象。 那么,则存在如下关系:MyAppWidgetProvider.class: 代表了由该MyAppWidgetProvider创建的窗口小部件(AppWidget)的类型,一般用 CompontentName对象形式表示 。 那么存在如下关系:

    从上图可是,每个appWidget都对应于一个MyAppWidgetProvider类,于是当任何一个appWidgetId发生变化时,我们需要同步其他实例,保持同步性。


    简单介绍

    以下模拟一下App Widget的应用 通过两种方式启动应用程序

    App Widget启动

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

    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 eoe.demo; 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"/>

    清单文件

    <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="eoe.demo" 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>

    TestActivity类

    package eoe.demo; 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); } }

    常用方法

    AppWidgetProviderInfo类补充说明: publicComponentNameconfigure: 一般为一个Activity,表明该Activity复杂需要管理

    AppWidget的创建操作。 public int updatePeriodMillis:用来更新AppWidget,但该属性在SDK1.5已废除

    AppWidgetProvider类介绍: 常用方法:

    onDeleted() : 当该类型的AppWidget每次被删除时,调用此方法onDisabled() : 当该类型的窗口小部件(AppWidget)全被删除时,调用此方法onEnabled() : 当第一次创建该类型的AppWidget时,调用此方法onReceive() : 广播接受者方法 , 用来接受广播消息onUpdate() : 每次创建该类型的AppWidget都会调用此方法 , 通常来说我们需要在该方法里为该AppWidget指定 RemoteViews对象。
    转载请注明原文地址: https://ju.6miu.com/read-2764.html

    最新回复(0)