如何开发APP Widget?

发布时间:2020-06-05 15:12:17 作者:Leah
来源:亿速云 阅读:341

如何开发APP Widget?相信大部分人都还没学会这个技能,为了让大家学会,给大家总结了以下关于开发APP Widget的步骤内容,话不多说,一起往下看吧。

1、继承AppWidgetProvider类,

public class MyWidget extends AppWidgetProvider{
<!-- 每一个Widget放置到桌面上时调用,每一次updatePeriodMillis时间到了之后也会被调用-->    
public void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds)
<!-- 移除widget时调用-->
public void onDeleted(Context context, int[] appWidgetIds)
<!-- 不管添加多少个widget,都只会调用一次 -->
public void onEnabled(Context context)
<!-- 当最后一个widget从桌面删除的时候调用-->
public void onDisabled(Context context)

<!-- 可用做Widget上的按键响应处理-->
public void onReceive(Context context, Intent intent)
    
}

一般在onUpdate中进行widget中按键的事件处理,和初始化值。



2、AppWidgetProvider是一个Broadcast,需要在Mainfest.xml中注册。

 <receiver android:name="继承AppWidgetProvider的类">
           <intent-filter >
               <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
           </intent-filter>
           <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/widget_config"/>
 </receiver

   3、 <meta-data>中的android:resource引用的是Widget的配置文件,需要在res/xml下新建,如果xml目录不存在,也需要新建。

 widget_config文件

<?xml version="1.0" encoding="UTF-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"  <!-- 显示在桌面上最小的的宽,高,不能大于4*4的格子-->
    android:minHeight="20dp" 
    android:updatePeriodMillis="1000000"  <!-- widget的更新间隔时间-->
    android:previewImage="@drawable/l7"  <!-- 预览图-->
    android:initialLayout="@layout/my_widgets_layout" <!-- 在桌面的显示布局,在3.0版本之后可以使用,默认以应用图标显示。-->
    android:resizeMode="horizontal|vertical"  <!-- 在桌面可调整的方向-->
     android:configure="cn.fly.widgets.MyWidgetsConfigActivity"> <!-- 当widget在拖到桌面上时,显示的配置文件-->
     
    <!--加上以下配置,在4.2版本可以放到锁屏界面上,4.2以下的版本默认是放主屏幕
    android:widgetCategory ="home_screen|keyguard" 
    android:initialKeyguardLayout="" 在锁屏界面上显示的布局
     -->
</appwidget-provider>

设置了updatePeriodMillis后,就算手机处于待机状态,也会唤醒手机去执行更新操作,如果widget更新频繁,这会对手机电池寿命造成影响,所以针对这种情况,可以使用AlarmManager来执行定时更新操作,将AlarmManager的Type设置为 ELAPSED_REALTIME 或者 RTC,就可以保证手机在唤醒的状态下执行更新,updatePeriodMillis则需要设置为0。


在桌面显示的布局文件的跟节点必须是常用布局例如:Framelayout,linearLayout,viewStub等,不能使用自定义布局。


在4.0以后的版本,widget放置到桌面上是可以根据其他的widget或者快捷图标来扩充边距,使添加的widget能够在桌面视觉上达到协调,但是4.0以下的版本需要自己来设置Padding,使widget能和其他桌面图标达到视觉协调。


做完以上的操作,一个简单的widget的就完成了,根据应用需求我们会遇到以下的一些情况。

一、相应widget的按键事件

    因为widget不是运行在自身的应用的进程中,所以是通过以下方式来处理事件。

  RemoteView 进行布局引用。

   PendingIntent  进行事件分发。

//这段代码一般写在onUpdate中,所处理的事情是按button更改Textview的显示
final int N = appWidgetIds.length;
for(int i = 0;i< N;i++){
    Intent intent = new Intent("自定义action用来标示这个intent");
    intent.setClass(context, MyWidgets.class);
    //发送广播,在onReceive()中进行处理PendingIntent也可以启动Activity,也可以//启动Service
    PendingIntent mPendingIntent = PendingIntent.getBroadcast(context, 
					0, intent, 0);
    RemoteViews remoteViews = new RemoteViews(context.getPackageName(),
					"widget布局引用");
    //button按键处理
    remoteViews.setOnClickPendingIntent(R.id.btn_click, mPendingIntent);
    appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
}

  在onReceive()的处理

String action = intent.getAction();
if(action.equals("比较发送的action")){
    RemoteViews remoteViews  = new RemoteViews(context.getPackageName(),"widget布局引用");
    //更改文本显示
    remoteViews.setTextViewText(R.id.tv, "测试");
    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); 
    ComponentName componentName = new ComponentName(context,MyWidgets.class);
    appWidgetManager.updateAppWidget(componentName, remoteViews); 
		}

二、widget添加上桌面上时的配置页面

这个配置页面是一个activity,所以需要在mainfest.xml中进行配置

1、在启动这个配置页面的时候,需要在oncreate()方法里面写上setResult(RESULT_CANCELED);这样做是为了防止配置页面还没有显示出来,用户就按了返回键,

setResult(RESULT_CANCELED);
super.onCreate(savedInstanceState);

2、需要获取widgetId

Intent intent = getIntent();
Bundle extra = intent.getExtras();
if(extra !=null){
    mAppWidgetId  = extra.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
}

如果mAppWidgetId为INVALID_APPWIDGET_ID则退出页面显示。

3、当配置页面显示后,用户做完了配置退出页面时,需要将这些配置信息更新到桌面的widget,照着官方给出的文档上来操作的话,只能显示widget但是配置并没有生效,参考了appdemo中的例子和个人调试后总结如下。


在MyWidget中写一个静态方法

 //describe是一个在配置文件中自由输入文本,然后在widget的text上显示,widget是为了做到代码重用,这里只是一个简单的更改文本,如果涉及到图片更改,列表数据改动等,这些改动如果有配置界面的话基本上和onupdate所做的操作一样。
 public static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,int appWidgetId, String describe) {
   RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider);
   views.setTextViewText(R.id.tv, describe);
   appWidgetManager.updateAppWidget(appWidgetId, views);
}

在配置界面的退出方法中这样写

private void exits(){
    String describe = et.getText().toString();
    Context context = this;
    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
    //appWidgetId在进入配置界面的时候已经获取了
    MyWidget.updateAppWidget(context,appWidgetManager,appWidgetId , describe );
    
    //配置完成退出界面
    Intent intent = new Intent();
    resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
    setResult(RESULT_OK, intent );
    finish();
}

当时参考文档做时,文档中并没有提到调用updateAppWidget方法后,退出界面需要重新获取view,并改变view的显示数据。所以我只写了appWidgetManager.updateAppWidget(appWidgetId, views)方法。

看完这篇文章,你们学会开发APP Widget了吗?如果还想学到更多技能或想了解更多相关内容,欢迎关注亿速云行业资讯频道,感谢各位的阅读。

推荐阅读:
  1. app的特点是什么
  2. 微信如何实现通过H5页面直接打开本地app

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

app widget pp

上一篇:MongoDB性能测试与Python测试代码

下一篇:zabbix 添加端口监控(php的端口监控)

相关阅读

您好,登录后才能下订单哦!

密码登录
登录注册
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》