天天看点

App Widget的使用

App Widget(桌面小组件)是一种可以被放在其他应用中(如Launcher)并接收周期性更新的应用视图。这些视图在UI上就表现为Widget,并且你可以同App Widget Provider一起发布。

要创建一个App Widget,你需要完成以下步骤:

AppWidgetProviderInfo对象:它描述了App Widget的基本元素,比如说布局、更新频率、AppWidgetProvider类等。这些都是在xml文件中定义的。

AppWidgetProvider类(广播,继承BroadcastReceiver)的实现:它定义了一些基本的方法以支持通过广播事件与App Widget交互。通过它,当App Widget被更新、启用、禁用以及删除时,你将收到相应的广播信息。

View Layout:通过xml文件定义App Widget的初始视图。

在Android Studio我们可以直接新建一个AppWidget 实现步骤 单击右键 —>new —>Widget—>App Widget 出现如图界面

App Widget的使用

新建完成之后会帮我们新建一个广播类(NewAppWidge类t继承AppWidgetProvider) ,xml文件(new_app_widget_info)

小编实现了一个在桌面上实时显示时间的Widget 看代码吧

xml文件:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/widget"
    android:minHeight="80dp"
    android:minWidth="80dp"
    android:previewImage="@drawable/example_appwidget_preview"
    android:resizeMode="horizontal|vertical"
    android:updatePeriodMillis="1000"
    android:widgetCategory="home_screen">
</appwidget-provider>
<!--
initialLayout 初始化布局
minHeight,minHeight Widget最小的宽高
previewImage  Widget预览的图片
android:resizeMode="horizontal|vertical"  横纵可以更改Widget的大小
updatePeriodMillis属性定义了App Widget调用AppWidgetProvider的onUpdate方法的频率
widgetCategory="keyguard|home_screen"  widget可添加的位置 锁屏界面|桌面

-->
           

NewAppWidget.class

package com.example.zhiwenyan.widgetdemo;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
public class NewAppWidget extends AppWidgetProvider {

    //刷新执行
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        //刷新RemoteViews更新
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

    //从屏幕上删除执行
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        super.onDeleted(context, appWidgetIds);
    }
    //添加到屏幕上执行
    @Override
    public void onEnabled(Context context) {
   //启动服务
        context.startService(new Intent(context,WidgetService.class));

    }
    //从屏幕移除执行
    @Override
public void onDisabled(Context context) {
  //停止服务
  context.stopService(new Intent(context,WidgetService.class));

    }
}
           

WidgetService 服务 实时更新时间

package com.example.zhiwenyan.widgetdemo;

import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.content.ComponentName;
import android.content.Intent;
import android.os.IBinder;
import android.widget.RemoteViews;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Timer;
import java.util.TimerTask;

public class WidgetService extends Service {
    private Timer timer;

    private SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

    public WidgetService() {
    }

    @Override
    public void onCreate() {
        super.onCreate();
        timer = new Timer();
        timer.schedule(new TimerTask() {
            @Override
            public void run() {
                updateView();
            }
        }, );

    }

    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        timer = null;
    }

    private void updateView() {
        String time = simpleDateFormat.format(new Date());
        //RemoteViews(远程视图)  
        RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.widget);
        //设置TextViwe显示的文本
        remoteViews.setTextViewText(R.id.text_time, time);
        AppWidgetManager manager=AppWidgetManager.getInstance(this);
        ComponentName componentName=new ComponentName(getApplicationContext(), NewAppWidget.class);
        //更新Widget  
        manager.updateAppWidget(componentName,remoteViews);
    }
}
           

manifest 清单文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.zhiwenyan.widgetdemo">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
<!--<receiver>标签用于指明App Widget使用的AppWidgetProvider
<intent-filter>标签必须包括一个含有android:name属性的<action>标签。该属性用于指明AppWidgetProvider接收APPWIDGET_UPDATE广播。这是你唯一需要显示声明的广播。当有需要时,AppWidgetManager自动发送AppWidgetProder所需的各种广播。
<meta-data>标签标识了AppWidgetProviderInfo资源,它需要以下属性:
android:name:使用android.appwidget.provider来标识AppWidgetProviderInfo。
android:resource:标识AppWidgetProviderInfo的资源位置-->
        <receiver android:name=".NewAppWidget">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/new_app_widget_info" />
            <!-- android:resource="@xml/new_app_widget_info" Widget
            的WidgetProviderInfo  xml文件-->
        </receiver>
<!--服务-->
        <service
            android:name=".WidgetService"
            android:enabled="true"
            android:exported="true"></service>
    </application>

</manifest>
           

Widget上显示的布局文件 只有一个TextView 负责显示时间

<?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/text_time"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

</LinearLayout>
           

MainActivity

package com.example.zhiwenyan.widgetdemo;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
/**
 * Android Widget
 */
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}
           

MainActivity没有啥!!呵呵

App Widget的使用

图中有个时间!实现了桌面显示Widget(显示实时时间)。

如果有错误大家可以指点指点!