百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程网 > 正文

在 Android 12 中构建更现代的应用 Widget

yuyutoo 2024-10-12 01:28 4 浏览 0 评论

从 2008 年开始,Widget 就一直是 Android 系统的一个重要组成部分,也是自定义主屏幕的一个重要方面。您可以将 Widget 理解为一个 "一目了然" 的应用视图,让用户在无需从主屏幕打开应用的前提下,就能对应用数据和核心功能一览无余。但是从 Android 推出至今,AppWidget 的 API 基本就没有什么大的变化,从 2012 年到 2021 年更是只有一个 Android 版本包含了对 AppWidget API 的更新。而随着 Android 12 的推出,也带来了 Widget API 一些亟需改进的更新。

本文我们就来介绍一下 Android 12 中带来了哪些关于 Widget API 的更新,以及有哪些好用的工具可以让开发应用 Widget 变得更加出色。

Widget 工作原理

Widget 运行在一个名为 AppWidgetHost 的远端进程中,比如 Home Screen Launcher,也正因如此,它的运行受到了一些限制。我们来看看 Widget 的工作原理。

在前端,应用首先注册 AppWidgetProvider 来定义 Widget 行为,以及注册 AppWidgetProviderInfo 来定义元数据。然后 AndroidManifest 引用这些信息,让操作系统通过 AndroidManifest 读取元数据,例如 Widget 初始的布局和默认尺寸,并提供 Widget 的预览,紧接着,provider 会使用链接账户来更新布局并对 Widget 进行更新。这里需要注意的是,应用于 Widget 的构建次数有限,所以操作系统是通过接收方的广播事件 (包含了更新信息) 对 Widget 进行更新,这也意味着 Widget 是定期接收来自应用的信息进行更新的。

API

Android 12 的推出带来了很多关于 AppWidget API 的更新,本文不会对所有的 API 一一介绍,而是重点介绍几个对 Widget 构建非常有用的 API。

实现圆角

在 Android 12 中许多关键的界面元素都开始采用圆角设计,为了使 AppWidget 与其他系统组件样式之间看起来一致,Android 12 引入了 system_app_widget_background_radius 和 system_app_widget_inner_radius 两个新的系统参数实现圆角,前一个参数是用来设置 Widget 的圆角半径,后一个则是设置 Widget 内视图的圆角半径。要使用这些参数,只需要定义一个设置了系统参数 corner 的可绘制对象即可,如代码所示:

// res/drawable/app_widget_background.xml
<shape android:shape="rectangle">
    <corners android:radius="@android:dimen/system_app_widget_background_radius">
    …
</shape>

// res/drawable/app_widget_inner_view_background.xml
<shape android:shape="rectangle">
    <corners android:radius="@android:dimen/system_app_widget_inner_radius">
    …
</shape>

然后将可绘制对象应用于 Widget 的外部容器,这样做可将系统参数提供的圆角半径应用于 Widget 背景中。同样,将内部视图的可绘制对象应用于表示 Widget 内部容器的布局,如代码所示:

// res/layout/widget_layout.xml
<LinearLayout
    android:background=”@drawable/app_widget_background”
…>
    <LinearLayout
        android:background=”@drawable/app_widget_inner_view_background”
    …>
    </LinearLayout>
</LinearLayout>

从效果中我们可以看到 Widget 当前内部容器的圆角半径要小于外部容器,这就是新参数的使用方法。

动态颜色

正如我们之前在 Google I/O 大会上宣布的那样,从 Android 12 开始,Widget 可以为按钮、背景及其他组件使用设备主题颜色,包括浅色主题和深色主题。这样可使过渡更流畅,而且还能在不同的 Widget 之间保持一致。

我们添加了动态颜色 API,您可直接获取并使用 Pixel 设备系统上提供的主题背景、颜色等参数,从而让 Widget 同主屏幕的样式保持一致:

// res/layout/widget_layout.xml
<LinearLayout
    android:theme="@android:style/Theme.DeviceDefault.DayNight"
    android:background="?android:attr/colorBackground">
    <ImageView
        android:tint="?android:attr/colorAccent" />
    …
</LinearLayout>

您可以看到,当设置了主题属性之后,Widget 直接从系统壁纸中提取了主色,并将其应用于深色和浅色主题背景中。

响应式布局

Android 12 引入了新的 API 来实现响应式布局,可以随着 Widget 的尺寸调整,自动切换到不同的布局。如下图所示,用户可以通过拖动来任意更改 Widget 的尺寸,Widget 也会根据尺寸的不同而动态更新所要显示的内容。

那么如何做到让 Widget 随着尺寸的变化而动态更新显示内容呢,用如下代码举例,我们定义了三个不同的参数,分别包含最小支持宽度和高度,以及在此大小范围内对应的 RemoteView,系统会自动根据实际的尺寸而自动对 Widget 进行调整。

val viewMapping: Map<SizeF, RemoteViews> = mapof(
    SizeF(180.0f, 110.0f) to RemoteViews(
        context. packageName,
        R.layout.widget_small
    ),
    SizeF (270.0f, 110.0f) to RemoteViews(
        context.packageName,
        R.layout.widget_medium
    ),
    SizeF(270.0f, 280.0f) to RemoteViews(
        context.packageName,
        R.layout.widget_large
    )
)
appWidgetManager.updateAppWidget(appWidgetId, RemoteViews(viewMapping))

Android 12 中还提供了新的 targetCellWidthtargetCellHeight 属性,这些属性指定了 Widget 置于主屏幕中时默认的较大单元格尺寸。在 Android 12 之前,可以使用 minWidgetminHeight 属性,它们指定了以 dp 为单位的默认 Widget 尺寸,我们建议同时指定这两个属性以保持向后兼容。如果您的 Widget 是可调整尺寸的,那么还可以使用 Android 12 提供的 minResizeWidget/Height 和 maxResizeWidget/Height 属性来限制 Widget 的可调整尺寸范围。

<appwidget-provider
    android:targetCellWidth="3"
    android: targetCellHeight="2"
    android:minWidth="140dp"
    android:minHeight="110dp"
    android:maxResizeWidth="570dp"
    android:maxResizeHeight="450dp"
    android:minResizeWidth="140dp"
    android:minResizeHeight="110dp"
    …>

Widget 选择器

Android 12 还改进了 Widget 选择器的使用体验,引入了两个新的属性,第一个属性是 description,它对 Widget 选择器的作用进行了描述说明,通过它可以了解 Widget 的作用;另一个是 previewLayout,它指定了 Widget 选择器中展示的 XML 布局。实际上在 Android 12 之前可以使用 previewImage 属性来指定静态资源达到类似效果,但是 previewLayout 相比较来说更加精确和方便。另外,由于这些预览都是在运行时构建的,因此也可以动态适配设备的主题。

<appwidget-provider
    android:description=
        "@string/app_widget_weather_description"
    android:previewLayout=
        "@layout/widget_weather_forecast_small"
…
/>

目前已经介绍了很多 Android 12 引入的新 API,相信不久之后就会看到越来越多的应用采用新 API 构建出更现代的 Widget 使用体验。

Glance

要构建出色的 Widget,除了需要用到目前更现代的 API 之外,我们还需要更现代、更出色的工具来帮助我们,Glance 就是这么一个出色的工具,它也加入到了 Jetpack 大家庭中。Glance 是由 Compose Runtime 提供支持的 API,通过它就可以使用 Compose 风格的语法来创建 AppWidget,这也意味着您可以通过 Glance 以 composable 构建界面,并将其转换为远端视图显示到 Widget 中,同时还能用到前文中提到的 Android 12 的新 API,并尽可能的让其向后兼容。另外,Glance 还会负责一些 Widget 生命周期以及其他一些常见的操作,听上去是不是觉得非常方便。

接下来我们介绍如何使用 Glance 构建 Widget,首先仍需要像之前一样声明 AppWidget,并在 AndroidManifest 中将其链接到接收器,当然,我们在这里使用了 Glance 提供的 GlanceAppWidgetReceiver 和 GlanceAppWidget,Glance 会为您处理大部分的工作,您只需要覆写 MyAppWidget 中的 Content 方法,提供 AppWidget 内容即可。在定义内容时,不再使用 XML 语法,而是使用 Compose 语法,要显示的内容将会被转换为远端视图展示在 AppWidget 中。

class MyAppWidget: GlanceAppWidget() {
    @Composable
    override fun Content() {
        // 在这里创建 AppWidget
        Column(
            modifier = Modifier.expandHeight().expandWidth(),
            verticalAlignment = Alignment.Top,
            horizontalAlignment = Alignment.CenterHorizontally
        ) {
            Text(text = “Where to”, modifier = Modifier.padding(12.dp))
            userDestinations()
        }
    }
}
 
class MyAppWidgetReceiver: GlanceAppWidgetReceiver() {
    // 告知 MyAppWidgetReceiver 该使用哪个 GlanceAppWidget
    override val glanceAppWidget: GlanceAppWidget = MyAppWidget()
}

有一点需要了解,虽然 Glance 使用 Compose Runtime 和 Compose 的语法,但它仍是一个独立的框架,由于受到在远端进行构建的限制,您不可能重用在 Jetpack Compose UI 中定义的组件。但如果您已对 Jetpack Compose 非常熟悉,那么 Glance 将非常易于理解。

另外,由于 Glance 使用用户事件 API 的方式处理交互,我们处理同用户的交互将变得更加轻松。如果您了解 Widget 的工作原理就会知道 Widget 在不同进程上工作,这使得处理简单的用户事件也变得困难,因为不在同一进程就代表您没有这个 Widget 的所有权,只能通过进程回调来处理各种事件。

Glance 将这些复杂性抽象了出来,您只需通过向需要的 composable 对象定义 clickable modifier 即可让其支持处理用户点击事件,Glance 会将其中的注入行为全部抽象出来,用户点击了 composanle,即可回调所定义的操作。我们还定义了一些常用的操作,例如,如何启动 Activity,只要调用 launchActivity 传递 Activity 目标类即可。

Button(
    text = “Home”,
    modifier = Modifier.clickable(launchActivity<NavigationActivity>)
)

此外,我们还可以提供自定义操作来执行一些自定义代码,例如,我们可能希望每当用户点击此按钮时就会更新地理位置并刷新 Widget,如下列代码所示,Glance 会在背后为您处理一些需要注入的工作,并通过广播接收器处理此次点击,最终调用您定义的操作代码。但请注意,如果该种操作为网络请求或数据库访问等较为耗时的操作,请使用 WorkManager API。

Button(
    text = “My Location”,
    modifier = Modifier.clickable(customAction<UpdateLocationAction>)
)

在前文中我们也提到,您可以使用可调整尺寸的 Widget,但是处理不同的响应式布局也并非易事,Glance 就试图通过定义三种不同的 SizeMode 选项从而让这种工作变得稍微轻松一些。

SizeMode.Single 是默认选项,该选项指定了我们在此处定义的 Widget 内容不会因为可用尺寸变化而改变,这意味着我们在 Widget 元数据上定义的最小支持尺寸只会通过 Content 方法被调用一次,如果 Widget 的可用尺寸发生更改,例如用户调整了 Widget 尺寸,则不会刷新内容。如下图所示,使用了 SizeMode.Single 选项的 Widget,无论其尺寸如何变化,其输出的尺寸大小永远不会得到变化,这是因为 Content 方法只被调用了一次,内容在尺寸发生变化时并没有得到刷新。

class MyAppWidget: GlanceAppWidget() {
    override val sizeMode = SizeMode.Single
 
    @Composable
    override fun Content() {
        val size = LocalSize.current
        //…
    }
}

若在每次尺寸发生变更都对内容进行刷新,则可使用 SizeMode.Exact 选项。此选项会在用户每次调整 Widget 尺寸时,重新创建 Widget 界面并再次调用 Content 方法,并同时提供最大可用尺寸以便让我们能够在空间足够的情况下更改界面,比如添加额外按钮等等。如下图中,Widget 尺寸发生变化时,其内部的输出也会随时发生变化,这是因为每次 Widget 界面都会被重新创建。

class MyAppWidget: GlanceAppWidget() {
    override val sizeMode = SizeMode.Exact
 
    @Composable
    override fun Content() {
        val size = LocalSize.current
        //…
    }
}

尽管 SizeMode.Exact 选项看似能够完全满足需求,但是每次都需要重新创建界面,可能会导致用户在调整尺寸时界面的转换因为一些性能问题有点不流畅,此时我们就可以通过 SizeMode.Responsive 选项。例如,此处我们将一些尺寸映射到某些特定形状,每当创建或更新 AppWidget 时 Glance 都会调用每个 Size 定义好的的 Content 方法,每次都将映射到特定尺寸并存储在内存中,系统能够在用户调整 Widget 尺寸时,根据可用尺寸选择最合适的尺寸,而无需重新创建界面从而提供更平稳的转换和更出色的性能。正如下图所展示的那样,当 Widget 尺寸发生变更时,只有当其尺寸能够匹配到所预先定义好的尺寸范围中,其内部输出才会发生变化,更应该注意的是,此时并没有重新创建界面。

同样,我们还可以在 Content() 方法中定义更加多元化的样式,让 Widget 在不同的尺寸下展示更独特的内容。

class MyAppWidget: GlanceAppWidget() {
    companion object {
        private val SMALL_SQUARE = DpSize (100.dp, 160. dp)
        private val HORIZONTAL_RECTANGLE = DpSize (250.dp, 100.dp)
        private val BIG_SQUARE = DpSize (250.dp, 250.dp)
    }
 
    override val sizeMode = SizeMode.Responsive(
        SMALL_SQUARE, HORIZONTAL_RECTANGLE, BIG_SQUARE
    )
 
    @Composable
    override fun Content() {
        val size = LocalSize.current
        //…
    }
}

除了以上提到的内容外,还有例如对 Widget 状态管理的支持,和即开即用的 Material You 主题背景等更多内容,等待着您的探索。

如需了解更多内容,欢迎您查阅 Android 开发者网站: 应用 Widget 概览,我们非常期待您尝试我们提供的新 API,并期待看到您构建出的 Widget 和您的反馈。

欢迎您打开链接:https://go2.gdsub.com/androiddevfb 向我们提交反馈,或分享您喜欢的内容、发现的问题。您的反馈对我们非常重要,感谢您的支持!

相关推荐

野路子科技!2步教你把手机改造成一个FTP服务器,支持PC互传

哈喽,大家好,我是野路子科技,今天来给大家带来一个教程,希望大家喜欢。正如标题所言,就是教大家如何把售价改造成FTP服务器,而这个时候估计有朋友会问了,把手机改造成FTP服务器有什么用呢?现在有Q...

不得不看:别样于Server-U的群晖文件存储服务器的搭建与使用

我先前的作品中,有着关于Server-U的ftp文件存储服务器的搭建与访问的头条文章和西瓜视频,而且我们通过各种方式也给各位粉丝介绍了如何突破局域网实现真正意义上的公网访问机制技术。关于Server-...

Qt三种方式实现FTP上传功能_qt引入qftp库

FTP协议FTP的中文名称是“文件传输协议”,是FileTransferProtocol三个英文单词的缩写。FTP协议是TCP/IP协议组中的协议之一,其传输效率非常高,在网络上传输大的文件时,经...

Filezilla文件服务器搭建及客户端的使用

FileZilla是一个免费开源的FTP软件,分为客户端版本和服务器版本,具备所有的FTP软件功能。可控性、有条理的界面和管理多站点的简化方式使得Filezilla客户端版成为一个方便高效的FTP客户...

美能达柯美/震旦复印机FTP扫描怎么设置?

好多网友不知道怎么安装美能达/震旦复印机扫描,用得最多是SMB和FTP扫描,相对于SMB来说,FTP扫描安装步骤更为便捷,不容易出问题,不需要设置文件夹共享,所以小编推荐FTP来扫描以美能达机器为例详...

CCD(简易FTP服务器软件)_简单ftp服务器软件

CCD简易FTP服务器软件是一款很方便的FPT搭建工具,可以将我们的电脑快速变成一个FPT服务器。使用方法非常简单,只要运行软件就会自动生效,下载银行有该资源。该工具是不提供操作界面的,其他用户可以输...

Ubuntu系统搭建FTP服务器教程_ubuntu架设服务器

在Ubuntu系统上搭建FTP服务器是文件传输的一个非常实用方法,适合需要进行大量文件交换的场景。以下是一步步指导,帮助您在Ubuntu上成功搭建FTP服务器。1.安装vsftpd软件...

理光FTP扫描设置教程_理光ftp扫描设置方法

此教程主要用来解决WIN10系统下不能使用SMB文件夹扫描的问题,由于旧的SMB协议存在安全漏洞,所以微软在新的系统,WIN8/WIN10/SERVER201220162018里使用了新的SMB传...

纯小白如何利用wireshark学习网络技术

写在前面工欲善其事必先利其器!熟悉掌握一种神器对以后的工作必然是有帮助的,下面我将从简单的描述Wireshark的使用和自己思考去写,若有错误或不足还请批评指正。...

京东买13盘位32GB内存NAS:NAS系统安装设置教程

本内容来源于@什么值得买APP,观点仅代表作者本人|作者:yasden你没有看错,我在京东自营商城购买硬件,组装了一台13盘位,32GB内存的NAS,硬盘有13个盘位!CPU是AMD的5500!本文...

FileZilla搭建FTP服务器图解教程_filezilla server搭建ftp服务器

...

python教程之FTP相关操作_python ftps

ftplib类库常用相关操作importftplibftp=ftplib.FTP()ftp.set_debuglevel(2)#打开调试级别2,显示详细信息ftp.connect(“I...

xftp怎么用,xftp怎么用,具体使用方法

Xftp是一款界面化的ftp传输工具,用起来方便简单,这里为大家分享下Xftp怎么使用?希望能帮到有需要的朋友。IIS7服务器管理工具可以批量管理、定时上传下载、同步操作、数据备份、到期提醒、自动更新...

树莓派文件上传和下载,详细步骤设置FTP服务器

在本指南中,详细记录了如何在树莓Pi上设置FTP。设置FTP可以在网络上轻松地将文件传输到Pi上。FTP是文件传输协议的缩写,只是一种通过网络在两个设备之间传输文件的方法。还有一种额外的方法,你可以用...

win10电脑操作系统,怎么设置FTP?windows10系统设置FTP操作方法

打印,打印,扫描的日常操作是每一个办公工作人员的必需专业技能,要应用FTP作用扫描文件到电脑上,最先要必须一台可以接受文件的FTP服务器。许多软件都需要收费标准进行,但人们还可以应用Windows的系...

取消回复欢迎 发表评论: