Android中实现Launcher功能之二 ----- 添加窗口小部件以及AppWidget的创建详解-低调大师

Android中实现Launcher功能之二 ----- 添加窗口小部件以及AppWidget的创建详解

2017-12-30 506

今天给大家展现的如何创建一个窗口小部件(AppWidget)以及如何在自己的应用程序中添加窗口小部件(AppWidget)。

本文组织如下：

第一部分：创建一个窗口小部件；

第二部分：在自己的应用程序中添加窗口小部件(AppWidget)。

整个功能其实实现起来也是很简单的，只望大家能耐着性子点看。

第一部分、创建一个窗口小部件

网上资料已经许多了，在此先给大家推荐几个不错的Blog ，大家可以先去看看：

1、SDK对AppWidget的介绍

2、Android 桌面组件【widget】初探

从中我们知道：

1、每个AppWidget都有一个AppWidgetProviderInfo对象，该对象描述了每个AppWidget的基本数据(meta-data)信息，

其定义在<appwidget-provider>节点信息。

2、每个AppWidget都对应一个RemoteViews视图对象，该RemoteViews提供了特定AppWidget的展示(View视图)和操作

(例如，点击该RemoteViews会跨进程处理一些事情)。

关于RemoteViews类请参考：Android中文API（138） —— RemoteViews

3、AppWidgetManager类维护了应用程序中所有的AppWidget，并且为给每个AppWidget特定的Id去标识他们(一般我们

用 appWidgetId去标识)。通过给定的appWidgetId，AppWidgetManager可以管理对应的AppWidget，例如：更新该

AppWidgetId的RemoteViews视图，删除该AppWidget对象等。

4、AppWidgetProvider广播类从来说是一个监听器，系统把对AppWidget的操作(例如，创建和更新等)分发给

AppWidgetProvider类去处理。

对每个AppWidget，我们可以创建多个其多个实例，当然这些实例对应于不同的appWidgetId。假设存在这么个

MyAppWidgetProvider广播类，以及对应的MyAppWidgetProviderInfo对象。那么，则存在如下关系：

MyAppWidgetProvider.class : 代表了由该MyAppWidgetProvider创建的窗口小部件(AppWidget)的类型，一般用

CompontentName对象形式表示。那么存在如下关系：

从上图可是，每个appWidget都对应于一个MyAppWidgetProvider类，于是当任何一个appWidgetId发生变化时，我们需要

同步其他实例，保持同步性。

AppWidgetProviderInfo类补充说明：

publicComponentNameconfigure：一般为一个Activity，表明该Activity复杂需要管理AppWidget的创建操作。

public int updatePeriodMillis：用来更新AppWidget，但该属性在SDK1.5已废除

AppWidgetProvider类介绍：

常用方法：

onDeleted() ：当该类型的AppWidget每次被删除时，调用此方法

onDisabled() ：当该类型的窗口小部件(AppWidget)全被删除时，调用此方法

onEnabled() ：当第一次创建该类型的AppWidget时，调用此方法

onReceive() ：广播接受者方法，用来接受广播消息

onUpdate() ：每次创建该类型的AppWidget都会调用此方法，通常来说我们需要在该方法里为该AppWidget指定

RemoteViews对象。

AppWidgetManager类介绍：

常用常量：

ACTION_APPWIDGET_PICK= "android.appwidget.action.APPWIDGET_PICK“

说明：列出所有能够创建AppWidget的对象，该对象一般为自定义的AppWidgetProvider广播接受者。

注意：发送该Intent必须添加附加值：EXTRA_APPWIDGET_ID 。

该EXTRA_APPWIDGET_ID含义：该appWidgetId与我们发送Action为ACTION_APPWIDGET_PICK 后

所选择的AppWidget绑定。因此，我们可以通过这个appWidgetId获取该AppWidget的信息了。

ACTION_APPWIDGET_CONFIGURE= "android.appwidget.action.APPWIDGET_CONFIGURE”

说明：如果选择的AppWidget配置了android:configure 属性，需要再次启动性对应的Activity，继而进一步去选择

AppWidget。同时发送该Intent必须添加附加值：EXTRA_APPWIDGET_ID，含义同上。

常用方法：

public int[] getAppWidgetIds(ComponentName provider)

功能：获取对应ComponentName类型的所有appWidgetId

参数说明： provider 通常为 XXXAppProvider.class类型

publicAppWidgetProviderInfo getAppWidgetInfo(int appWidgetId)

功能：获取特定appWidgetId对应的AppWidgetProviderInfo对象

public staticAppWidgetManager getInstance(Contextcontext)

功能：获取 AppWidgetManager对象

public void updateAppWidget(int appWidgetId, RemoteViews views)

功能：以特定的views视图更新appWidgetId的窗口小部件(AppWidget) 。同时会发送ACTION_APPWIDGET_UPDATE广播

public void updateAppWidget(int[] appWidgetIds,RemoteViews views)

功能：以特定的views视图更新所有appWidgetIds的窗口小部件(AppWidget)，同时发送ACTION_APPWIDGET_UPDATE

广播

public void updateAppWidget(ComponentName provider, RemoteViews views)

功能：已特定的views更新组件类型为provider的所有窗口小部件(AppWidget)，同时发送ACTION_APPWIDGET_UPDATE

广播。

示例Demo ：

说明：创建一个简单的AppWidget实例，点击按钮后可以更该图片资源显示，具体代码在

截图为：

关于如何创建一个AppWidget的教材，我也不再多说了，大家可以参考上面我提到的两篇重量级博客去学习：

1、SDK对AppWidget的介绍

2、Android 桌面组件【widget】初探

PS：具体代码可在后面下载。

再次强调一点，每个AppWidget都对应与AppWidgetProvider ，我们需要同步更新这些AppWidget对象。

第二部分：在自己的应用程序中添加窗口小部件(AppWidget)

本部分的主要功能是像Launchcer那样添加AppWidget 。知识点介绍如下：

1、AppWidgetHost 类

功能：对每个应用程序App，该类提供了和AppWidgetService(该AppWidgetService用来管理所有AppWidget，类似于

NotificationManagerService系统服务管理所有Notifciation，不懂？其实我也不懂，知其大意即可)交互，用来更新、管理

AppWidget。打个比喻：AppWidgetHost是宿主对象，每个AppWidget都是寄生虫，可以附加在(显示)AppWidgetHost上。

每个能添加、显示AppWidget的Activity都是一个AppWidgetHost对象，比如Launcher.java(Activity对象)，以及我们后面自定

义的MainActivity.java(Activity对象)。

常用方法为：

public AppWidgetHost(Context context, int hostId)

功能：构造一个AppWidgetHost对象

参数: hostId 大意是该AppWidgetHost(宿主对象)对应的Id号，一般赋予一整数即可。

public int allocateAppWidgetId()

功能：申请一个新的appWidgetId ，该id会与新创建的AppWidget绑定。

public void startListening()

功能：监听所有AppWidget的变化，该方法必须在Activity的onCreate()/onStart()调用，否则 AppWidget是不会得到更新的

public void stopListening()

功能：对应于startListening()，即停止对AppWidget的更新监听。可以在Activity的onStop()方法里调用 ,

一般无需调用此方法去停止监听。

public final AppWidgetHostView createView(Context context, int appWidgetId, AppWidgetProviderInfo appWidget)

功能：根据指定的appWidgetId以及AppWidgetProviderInfo对象去构建一个AppWidgetHostView对象(具体该对象，

参见下文)。

AppWidgetHostView 与 RemoteViews的区别

对每个AppWidget内部而言，都有一个RemoteViews对象，用于视图显示；而对于外部而已，则以AppWidgetHostView

形式代言这个RemoteViews视图。换句话来说就是，AppWidgetHost对象而言，它并不知道RemoteViews存在，而只是知

RemoteViews 的代言人AppWidgetHostView。

好了，该说明的都说明了，下面最后给大家补充一下如何利用在自己的应用程序里添加窗口小部件(AppWidget) 。

也是两步走：

第一步：发送Action为ACTION_APPWIDGET_PICK的 Intent ，则所有能创建窗口小部件的AppWidgetProvider的广播

接收者都会显示，同时为该新创建的AppWidget分配一个appWidgetId ，该appWidgetId即可唯一标记我们选择的

AppWidget。

第二步：如果选择的AppWidget对应地AppWidgetProviderInfo对象配置了android:configure属性，则需要在此启动该配置

属性(一般为一个Activity类) ，然后在完成添加AppWidget的操作；否则，没有配置android:configure属性，就可以添加

AppWidget的操作。

示例Demo截图：

主工程流程如下：

[java]view plaincopyprint?
package com.qin.addappwidget;  
  
  
import android.app.Activity;  
import android.appwidget.AppWidgetHost;  
import android.appwidget.AppWidgetHostView;  
import android.appwidget.AppWidgetManager;  
import android.appwidget.AppWidgetProviderInfo;  
import android.content.Intent;  
import android.os.Bundle;  
import android.util.Log;  
import android.view.View;  
import android.widget.Button;  
import android.widget.ImageView;  
import android.widget.LinearLayout;  
import android.widget.TextView;  
import android.widget.Toast;  
  
public class MainActivity extends Activity  
{  
  
    private static String TAG = "AddAppWidget" ;  
      
    private Button btAddShortCut;  
    private LinearLayout linearLayout ;  // 装载Appwidget的父视图  
      
    private static final int MY_REQUEST_APPWIDGET = 1;  
    private static final int MY_CREATE_APPWIDGET = 2;  
      
    private static final int HOST_ID = 1024 ;  
      
    private AppWidgetHost  mAppWidgetHost = null ;  
    AppWidgetManager appWidgetManager = null;  
      
    /** Called when the activity is first created. */  
    @Override  
    public void onCreate(Bundle savedInstanceState)  
    {   
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.main);  
  
        btAddShortCut = (Button) findViewById(R.id.bt_addShortcut);  
  
        linearLayout = (LinearLayout)findViewById(R.id.linearLayout) ;  
        
        //其参数hostid大意是指定该AppWidgetHost 即本Activity的标记Id， 直接设置为一个整数值吧 。  
        mAppWidgetHost = new AppWidgetHost(MainActivity.this, HOST_ID) ;   
          
        //为了保证AppWidget的及时更新 ， 必须在Activity的onCreate/onStar方法调用该方法  
        // 当然可以在onStop方法中，调用mAppWidgetHost.stopListenering() 停止AppWidget更新  
        mAppWidgetHost.startListening() ;  
          
        //获得AppWidgetManager对象  
        appWidgetManager = AppWidgetManager.getInstance(MainActivity.this) ;  
          
          
        btAddShortCut.setOnClickListener(new View.OnClickListener()  
        {  
            @Override  
            public void onClick(View v)  
            {  
                 //显示所有能创建AppWidget的列表 发送此 ACTION_APPWIDGET_PICK 的Action  
                 Intent  pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK) ;  
                   
                 //向系统申请一个新的appWidgetId ，该appWidgetId与我们发送Action为ACTION_APPWIDGET_PICK  
                 //  后所选择的AppWidget绑定 。 因此，我们可以通过这个appWidgetId获取该AppWidget的信息了  
                   
                 //为当前所在进程申请一个新的appWidgetId   
                 int newAppWidgetId = mAppWidgetHost.allocateAppWidgetId() ;  
                 Log.i(TAG, "The new allocate appWidgetId is ----> " + newAppWidgetId) ;  
                   
                 //作为Intent附加值 ， 该appWidgetId将会与选定的AppWidget绑定                 
                 pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, newAppWidgetId) ;  
                   
                 //选择某项AppWidget后，立即返回，即回调onActivityResult()方法   
                 startActivityForResult(pickIntent , MY_REQUEST_APPWIDGET) ;  
                                    
            }  
        });  
    }  
  
    // 如果  
    protected void onActivityResult(int requestCode, int resultCode, Intent data)  
    {  
        //直接返回，没有选择任何一项 ，例如按Back键  
        if(resultCode == RESULT_CANCELED)  
           return ;  
          
        switch(requestCode){  
            case MY_REQUEST_APPWIDGET :  
                Log.i(TAG, "MY_REQUEST_APPWIDGET intent info is -----> "+data ) ;  
                int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID , AppWidgetManager.INVALID_APPWIDGET_ID) ;  
                  
                Log.i(TAG, "MY_REQUEST_APPWIDGET : appWidgetId is ----> " + appWidgetId) ;  
                  
                //得到的为有效的id  
                if(appWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID){  
                    //查询指定appWidgetId的 AppWidgetProviderInfo对象 ， 即在xml文件配置的<appwidget-provider />节点信息  
                    AppWidgetProviderInfo appWidgetProviderInfo = appWidgetManager.getAppWidgetInfo(appWidgetId) ;  
                      
                    //如果配置了configure属性 ， 即android:configure = "" ，需要再次启动该configure指定的类文件,通常为一个Activity  
                    if(appWidgetProviderInfo.configure != null){  
                          
                        Log.i(TAG, "The AppWidgetProviderInfo configure info -----> " + appWidgetProviderInfo.configure ) ;  
                          
                        //配置此Action  
                        Intent intent  = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE) ;  
                        intent.setComponent(appWidgetProviderInfo.configure) ;  
                        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);  
                          
                          
                        startActivityForResult(intent , MY_CREATE_APPWIDGET) ;                 
                    }  
                    else  //直接创建一个AppWidget  
                        onActivityResult(MY_CREATE_APPWIDGET , RESULT_OK , data) ;  //参数不同，简单回调而已                         
                }             
                break ;  
            case  MY_CREATE_APPWIDGET:  
                completeAddAppWidget(data) ;  
                break ;  
        }  
          
    }  
     
    //向当前视图添加一个用户选择的  
    private void completeAddAppWidget(Intent data){  
        Bundle extra = data.getExtras() ;  
        int appWidgetId = extra.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID , -1) ;  
        //等同于上面的获取方式  
        //int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID , AppWidgetManager.INVALID_APPWIDGET_ID) ;  
          
        Log.i(TAG, "completeAddAppWidget : appWidgetId is ----> " + appWidgetId) ;  
          
        if(appWidgetId == -1){  
            Toast.makeText(MainActivity.this, "添加窗口小部件有误", Toast.LENGTH_SHORT) ;  
            return ;  
        }  
          
        AppWidgetProviderInfo appWidgetProviderInfo = appWidgetManager.getAppWidgetInfo(appWidgetId) ;  
          
        AppWidgetHostView hostView = mAppWidgetHost.createView(MainActivity.this, appWidgetId, appWidgetProviderInfo);  
                  
        //linearLayout.addView(hostView) ;   
          
        int widget_minWidht = appWidgetProviderInfo.minWidth ;  
        int widget_minHeight = appWidgetProviderInfo.minHeight ;  
        //设置长宽  appWidgetProviderInfo 对象的 minWidth 和  minHeight 属性  
        LinearLayout.LayoutParams linearLayoutParams = new LinearLayout.LayoutParams(widget_minWidht, widget_minHeight);  
        //添加至LinearLayout父视图中  
        linearLayout.addView(hostView,linearLayoutParams) ;         
    }  
}  

最后，关于AppWidget点击后触发的相应事件，是通过设置该AppWidget的RemoteViews的某个控件点击事件而触发的。

本文转自wanqi博客园博客，原文链接：http://www.cnblogs.com/wanqieddy/archive/2012/05/05/2484533.html如需转载请自行联系原作者

微信关注我们

原文链接：https://yq.aliyun.com/articles/397773

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Android中滑屏实现----手把手教你如何实现触摸滑屏以及Scroller类详解

转载请注明出处：http://blog.csdn.net/qinjuning 前言：虽然本文标题的有点标题党的感觉，但无论如何，通过这篇文章的学习以及你自己的实践认知，写个简单的滑屏小 Demo还是justso so的。友情提示：在继续往下面读之前，希望您对以下知识点有一定程度掌握，否则，继续看下去对您意义也不大。 1、掌握View(视图)的"视图坐标"以及"布局坐标"，以及scrollTo()和scrollBy()方法的作用-----必须理解如果对这方面知识不太清楚的话，建议先看看我的这篇博客 <Android中滑屏初探 ---- scrollTo 以及 scrollBy方法使用说明>，不夸张地说，这篇博客理论上来说是我们这篇博文的基础。 2、知道onInterceptTouchEvent()以及onTouchEvent()对触摸事件的分发流程 ---- 不是必须 3、知道怎么绘制自定义ViewGroup即可 ---- 不是必须 OK。继续往下看，请一定有...

2017-12-31

575

张高兴的 Xamarin.Forms 开发笔记：Android 快捷方式 Shortcut 应用

一、Shortcut 简介 Shortcut 是 Android 7.1 (API Level 25) 的新特性，类似于苹果的 3D Touch ，但并不是压力感应，只是一种长按菜单。Shortcut 是受启动器限制的，也就是说国内大厂的定制系统大多数是不支持的，那些所谓的可以 pin 在桌面上的应用功能的快捷启动图标本质上就是 Shortcut 。二、Shortcut 在 Xamarin.Forms 中的实现分析本文讨论的是动态 Shortcut 实现。实现方式无非两种思路，一种 Native to Forms ，另一种 Forms to Native 。博主最开始考虑的是 Forms to Native ，但没成功。在设置 ShortcutInfo 时需要一个 Intent ，其中一个构造函数为 public Intent(Context packageContext, Type type); 看着很容易，只要传入一个 Content 以及把对应的页面 typeof 一下即可，但会抛出异常。原因是传入的 Forms Page 类并不是 Java 的原生类型。查阅 Xamar...

2017-12-31

516

发表评论

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。