首页
/ Mosaic项目0.16.0版本发布:优化静态组件与快照测试

Mosaic项目0.16.0版本发布:优化静态组件与快照测试

2025-06-20 06:03:02作者:冯爽妲Honey

Mosaic是一个由JakeWharton开发的现代化UI工具库,它基于Kotlin的Compose技术栈,为终端应用开发提供了声明式的UI构建方式。该项目特别适合需要构建命令行界面(CLI)或终端交互式应用的开发者,通过类似Jetpack Compose的API,开发者可以用更简洁、更声明式的方式构建终端用户界面。

核心变更解析

新增setContentAndSnapshot测试API

在0.16.0版本中,测试模块新增了一个关键API——setContentAndSnapshot。这个改进解决了测试中一个潜在的竞态条件问题。

在之前的版本中,测试流程通常是先调用setContent设置UI内容,然后调用awaitSnapshot等待并获取快照。这种两步操作存在一个问题:awaitSnapshot可能会触发额外的重组(recomposition),导致我们无法准确观察到初始渲染状态。

新API将这两个操作合并为一个原子操作,直接返回初始组合的快照,确保了测试能够捕获到最原始的UI状态。这对于验证初始渲染行为特别有价值,特别是在测试条件渲染或状态初始化逻辑时。

Static组件行为重构

本次版本对Static组件进行了重大行为调整。在之前版本中,Static接受一个列表参数,这种设计显得有些冗余且不符合直觉。

新版本中,Static组件的行为被简化为一个普通的可组合函数,但具有特殊的一次性渲染特性。这意味着:

  • 它现在表现得像常规的Composable函数
  • 但只会在首次组合时执行其内容函数
  • 后续重组不会重新执行内容函数

这种改变使API更加符合开发者对Composable函数的直觉预期,同时保留了静态内容的优化特性。对于展示不会改变的静态内容(如帮助文本、固定格式信息等)非常有用。

移除Jansi依赖

另一个值得注意的变更是移除了对Jansi库的依赖。Jansi是一个为Windows平台提供ANSI颜色支持的Java库。

这一变更意味着:

  • 项目减少了一个外部依赖
  • 简化了构建配置
  • 可能意味着Mosaic现在使用其他方式或原生支持来处理Windows上的ANSI颜色

对于开发者而言,这一变更通常是透明的,除非你特别依赖Jansi的某些特性。大多数情况下,终端颜色输出应该会继续正常工作。

升级建议

对于现有项目升级到0.16.0版本,开发者需要注意以下几点:

  1. 测试代码中可以考虑将setContent+awaitSnapshot模式迁移到新的setContentAndSnapshotAPI,特别是在需要验证初始渲染状态的测试用例中。

  2. 检查所有使用Static组件的地方,移除不必要的列表参数包装,直接传递内容函数即可。

  3. 如果项目中直接依赖了Jansi库,可能需要单独声明这个依赖,或者验证颜色输出在Windows平台上的表现是否符合预期。

这个版本的变更主要集中在API优化和简化上,没有引入破坏性的大改动,因此升级应该相对平滑。不过,由于Static组件的行为变更,建议在升级后运行完整的测试套件来验证所有静态内容的展示是否正确。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
47
253
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
347
381
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
871
516
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
179
263
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
131
184
kernelkernel
deepin linux kernel
C
22
5
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
7
0
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
335
1.09 K
harmony-utilsharmony-utils
harmony-utils 一款功能丰富且极易上手的HarmonyOS工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON等一系列的功能和操作,能够满足各种不同的开发需求。
ArkTS
31
0
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.08 K
0