SpannedGridLayoutManager 1.x到3.x升级完全指南:10分钟完成API迁移
SpannedGridLayoutManager 1.x到3.x升级完全指南10分钟完成API迁移【免费下载链接】SpannedGridLayoutManagerAndroid RecyclerView.LayoutManager that resizes and reorders views based on SpanSize项目地址: https://gitcode.com/gh_mirrors/sp/SpannedGridLayoutManagerSpannedGridLayoutManager是一个 Android RecyclerView 布局管理器能根据每个视图的 SpanSize宽高跨数自动调整大小并重新排序智能填满所有空隙打造瀑布流式混排网格。它的 1.x → 2.x → 3.x 三次大版本各有一处破坏性 API 变更。别担心整篇指南带你 10 分钟完成全部迁移改动量不到 10 行代码。一、三个版本的变更总览版本关键变更迁移成本1.x → 2.x用SpanLayoutParams替代RecyclerView.LayoutParams设置 SpanSize改 1 行2.x → 3.x删除SpanLayoutParams改用SpanSizeLookup提供 SpanSize改几行3.0.1 / 3.0.2修复 overscroll、视图回收等滚动问题直接升级核心原理该库用空闲矩形算法寻找空隙并决定视图落点详细推导见项目自带的论文 free_space_algorithm.pdf。二、第 1 步升级依赖1 分钟只需把版本号改成 3.0.2dependencies { implementation com.arasthel:spannedgridlayoutmanager:3.0.2 }三、第 2 步1.x → 2.x 的变更——SpanLayoutParams 登场2.x 之前SpanSize 直接借用RecyclerView.LayoutParams的宽高两个值来传递引发了严重的布局问题因此 2.0 引入了专用的参数类。1.x 旧写法onBindViewHolder中holder.itemView.layoutParams RecyclerView.LayoutParams(width, height)2.x 新写法holder.itemView.layoutParams SpanLayoutParams(SpanSize(width, height))SpanSize(width, height)表示该视图横向跨 width 格、纵向跨 height 格。定义见 SpannedGridLayoutManager.kt。四、第 3 步2.x → 3.x 的变更——SpanLayoutParams 退场 ⚡这是迁移中唯一真正的破坏性变更。3.x 为了修复回收与性能问题重写了整个布局与回收流程SpanLayoutParams不再需要你可以安全地把它从 Adapter 中全部删掉。取而代之的是在 LayoutManager 上设置SpanSizeLookup用法和原生GridLayoutManager的 spanSizeLookup 几乎一致val layoutManager SpannedGridLayoutManager( orientation SpannedGridLayoutManager.Orientation.VERTICAL, spans 4) layoutManager.spanSizeLookup SpannedGridLayoutManager.SpanSizeLookup { position - SpanSize(1, 1) // 每个视图默认占 1x1 } recyclerView.layoutManager layoutManager一个实用技巧如果你的 SpanSize 计算逻辑很复杂可以开启缓存spanSizeLookup.usesCache true数据变化后调用invalidateCache()使缓存失效即可。这两个 API 同样定义在 SpannedGridLayoutManager.kt 的SpanSizeLookup类中。五、理解布局原理空闲矩形如何填缝3.x 的精髓在于空隙填充每当一个视图需要落位算法先找到与它相邻或相交的空闲矩形把它切成上下左右四个子矩形再放回空闲列表。于是后面序号的视图如果恰好能填进更靠前的空隙会被提前摆放——这正是重排序的来源。需要注意的性能特性3.0 为保证布局正确会在每次整体重排时预计算并缓存全部视图的矩形。官方实测 1 万条数据约 55~135ms、5 万条约 200~530ms常规列表毫无压力若是无限滚动场景建议关注数据量增长带来的重排耗时。六、迁移后必查清单 ✅依赖已改为3.0.2Adapter 中所有SpanLayoutParams相关代码已删除已设置spanSizeLookup未设置时所有视图按 1x1 处理滚动位置恢复该管理器会改变屏幕上视图顺序默认禁用了滚动位置恢复。如果你确信 item 位置变化不大可开启spannedGridLayoutManager.itemOrderIsStable true需要 Item 变化动画时Adapter 中调用setHasStableIds(true)、覆写getItemId返回稳定 id并用notifyDatasetChanged()触发重排完整用法可参考示例工程 MainActivity.kt 与 GridItemAdapter.kt。七、迁移耗时小结步骤内容耗时1更新依赖版本~1 分钟2删除SpanLayoutParams2.x 用户~2 分钟3添加SpanSizeLookup~3 分钟4验证滚动位置与动画~4 分钟至此你的项目已完成 SpannedGridLayoutManager 从 1.x 到 3.x 的完整升级 【免费下载链接】SpannedGridLayoutManagerAndroid RecyclerView.LayoutManager that resizes and reorders views based on SpanSize项目地址: https://gitcode.com/gh_mirrors/sp/SpannedGridLayoutManager创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

如何用remarkable_mouse的--region参数实现任意屏幕区域映射:完整指南

如何用remarkable_mouse的--region参数实现任意屏幕区域映射:完整指南

如何用remarkable_mouse的--region参数实现任意屏幕区域映射:完整指南 【免费下载链接】remarkable_mouse use your reMarkable as a graphics tablet 项目地址: https://gitcode.com/gh_mirrors/re/remarkable_mouse remarkable_mouse 是一款能把 reMarkabl…

2026/11/21 5:58:13 阅读更多 →
Wine  Ubuntu 调用 Windows 应用

Wine Ubuntu 调用 Windows 应用

Wine介绍 Wine 是一个允许在 Unix 上运行 Microsoft Windows 程序 (包括 DOS、Windows 3.x、Win32 和 Win64 可执行文件) 的程序。它包含一个程序加载程序,用于加载和执行 Microsoft Windows 二进制文件,以及一个名为 Winelib 的库,该库使用…

2026/11/19 5:42:34 阅读更多 →
解密prompt系列35. 标准化Prompt进行时! DSPy论文串烧和代码示例

解密prompt系列35. 标准化Prompt进行时! DSPy论文串烧和代码示例

前言 来重新看下大模型应用中最脆弱的一环Prompt Engineering有了哪些新的解决方案。这一章我们先看看大火的DSPy框架,会先梳理DSPy相关的几篇核心论文了解下框架背后的设计思想和原理,然后以FinEval的单选题作为任务,从简单指令,COT指令&am…

2026/11/9 13:40:31 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻