首页
/ 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组件的行为变更,建议在升级后运行完整的测试套件来验证所有静态内容的展示是否正确。

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

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
165
2.05 K
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
954
563
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
60
16
apintoapinto
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
0
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
17
0
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
408
387
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
77
71
rainbondrainbond
无需学习 Kubernetes 的容器平台,在 Kubernetes 上构建、部署、组装和管理应用,无需 K8s 专业知识,全流程图形化管理
Go
14
1