移动开发UI组件【免费下载链接】BaseRecyclerViewAdapterHelperBRVAH:Powerful and flexible RecyclerAdapter项目地址https://gitcode.com/gh_mirrors/ba/BaseRecyclerViewAdapterHelper点击查看免费下载BaseRecyclerViewAdapterHelper简称 BRVAH是 Android 生态中广为人知的 RecyclerView Adapter 增强方案其定位是强大而灵活的 RecyclerView Adapter。本文以仓库根目录的 README.md 为骨架围绕 4.x 版本的核心革新——ConcatAdapter 兼容、功能模块拆分、多类型布局强化与双向加载能力——展开并结合 library/src/main/java/com/chad/library/adapter4 下的真实源码逐层剖析。读完本文你将掌握 v4 依赖的正确引入方式、五大 Adapter 基类的选型与用法、QuickAdapterHelper 的组合式加载方案以及 ProGuard 混淆规则的自动导入机制。一、项目定位一个强大而灵活的 RecyclerView Adapter 库README 开篇即给出 BRVAH 的定位——Powerful and flexible RecyclerView Adapter强大而灵活的 RecyclerView Adapter并鼓励开发者自由使用、参与 Star 与 Fork。针对 4.x 版本README 明确列出了本次大版本升级的四个核心变化这也是理解整个 v4 架构的钥匙完美兼容ConcatAdapter可以与其他 Adapter 无缝组合突破了传统单 Adapter 单数据源的限制解决了许多遗留问题拆分了功能模块v3 及以前版本中堆叠在单一 BaseQuickAdapter 上的功能被重新组织BaseAdapter 更加简洁干净数据集合、Diff 逻辑、状态视图等职责划分更清晰多类型布局更加灵活向上、向下加载得到极大加强多类型布局不再局限于通过继承重写实现向上加载leading load成为与向下加载trailing load并列的一等公民。同时README 强调v4 版本已经上传 Maven 中央仓库不需要再引入三方仓库配置——这是 v4 相比旧版本在分发方式上的关键改进旧版往往需要额外配置 JitPack 等三方仓库。二、快速开始从 Maven Central 引入 v4 依赖README 给出的 v4 依赖方式极为简洁仅需一行 Gradle 配置implementation(io.github.cymchad:BaseRecyclerViewAdapterHelper4:4.4.1)关键点说明该坐标中的BaseRecyclerViewAdapterHelper4后缀即表示这是 4.x 系列产物与 2.x/3.x 的坐标相互独立避免版本冲突由于产物已发布到 Maven CentralREADME 明确说明不需要再引入三方仓库配置项目中只需声明常规的mavenCentral()仓库即可解析工程本身基于 Kotlin 编写gradle/libs.versions.toml 中 Kotlin 版本为 2.3.21但通过JvmOverloads、fun interface等设计对 Java 调用方保持友好示例工程中同时存在 Kotlin 与 Java 的用例见 app/src/main/java/com/chad/baserecyclerviewadapterhelper。引入依赖后即可在代码中使用com.chad.library.adapter4包下的全部组件。三、核心架构adapter4 包下的五大 Adapter 基类README 所述拆分了功能模块、BaseAdapter 更加简洁干净在源码层面体现为 library/src/main/java/com/chad/library/adapter4 目录下的一组职责单一、可互相组合的基类。从源码结构看v4 提供以下五类 Adapter基类源码路径适用场景BaseQuickAdapterT, VHBaseQuickAdapter.kt通用列表单类型 item功能最全的基类BaseSingleItemAdapterT, VHBaseSingleItemAdapter.kt仅承载单个 item 的场景如空态、占位BaseMultiItemAdapterTBaseMultiItemAdapter.kt多类型布局一个数据源映射多种 item 布局BaseNodeAdapterBaseNodeAdapter.kt树形/可展开节点列表BaseDifferAdapterT, VHBaseDifferAdapter.kt已标记Deprecated官方建议直接使用 BaseQuickAdapter3.1 BaseQuickAdapter一切列表能力的汇聚点BaseQuickAdapter.kt 是 v4 的核心它继承自RecyclerView.Adapter并围绕一个可选的AsyncListDiffer构建。其构造函数家族清晰地展示了 v4 的设计哲学——Diff 能力可选、数据初始值可选abstract class BaseQuickAdapterT : Any, VH : RecyclerView.ViewHolder( private var _items: ListT, config: AsyncDifferConfigT? ) : RecyclerView.AdapterRecyclerView.ViewHolder() { constructor(diffCallback: DiffUtil.ItemCallbackT) : this(emptyList(), diffCallback) constructor(items: ListT, diffCallback: DiffUtil.ItemCallbackT) : this( items, AsyncDifferConfig.Builder(diffCallback).build(), ) constructor(config: AsyncDifferConfigT?) : this(emptyList(), config) constructor(items: ListT) : this(items, null) constructor() : this(emptyList(), null) ... }从源码可以看到传入DiffUtil.ItemCallback时库内部会自动包装为AsyncDifferConfig并构建AsyncListDiffer不传则退化为普通的_items列表 手动notify*通知路径。两种路径在submitList()中分别处理BaseQuickAdapter.kt有 Differ 路径调用mDiffer.submitList(list, commitCallback)Diff 计算在后台线程异步执行由AsyncListDiffer负责精准的增删改移动画无 Differ 路径直接替换_items并调用notifyDataSetChanged()此时commitCallback同步执行。子类需要实现两个抽象方法BaseQuickAdapter.ktprotected abstract fun onCreateViewHolder(context: Context, parent: ViewGroup, viewType: Int): VH protected abstract fun onBindViewHolder(holder: VH, position: Int, item: T?)示例工程中的 RecyclerViewAdapter.kt 展示了标准用法自定义VH承载 ViewBinding重写onCreateViewHolder与onBindViewHolder即可完成一个列表 Adapter。3.2 BaseMultiItemAdapter更灵活的多类型布局README 强调 v4 的多类型布局更加灵活。相比旧版需要在子类中重写getItemViewType和convert的写法v4 的 BaseMultiItemAdapter.kt 采用注册式设计用addItemType(viewType, listener)为每种布局注册独立的创建/绑定逻辑数据到类型的映射通过onItemViewType(listener)回调完成fun V : RecyclerView.ViewHolder addItemType( itemViewType: Int, listener: OnMultiItemAdapterListenerT, V ) apply { ... } fun onItemViewType(listener: OnItemViewTypeListenerT?) apply { ... }其内部用SparseArray按 viewType 存储各类型的OnMultiItemAdapterListener并在onCreateViewHolder中按 type 查找对应监听器创建 ViewHolderBaseMultiItemAdapter.kt若未注册对应类型会抛出明确的IllegalArgumentException提示please use addItemType() first!避免运行时静默崩溃。此外OnMultiItemAdapterListener接口完整暴露了 ViewHolder 生命周期回调onViewAttachedToWindow、onViewRecycled、onFailedToRecycleView等均带默认空实现并支持isFullSpanItem实现 StaggeredGrid 全宽 item。示例参考 GroupAdapter.kt。3.3 BaseSingleItemAdapter 与 BaseNodeAdapterBaseSingleItemAdapter.kt 固定getItemCount返回 1数据更新只允许通过setItem(t, payload)或item属性进行其余add/remove/submitList等列表操作一律抛出RuntimeException(Please use setItem())从 API 层面杜绝了误用BaseNodeAdapter.kt 面向树形节点抽象方法getChildNodeList(position, parent)返回子节点、isInitialOpen(position, item)决定默认展开。它内部维护openedSet/closedSet两套节点集合并用自定义的isSameNode语义默认引用比较子类可重写为唯一 ID 匹配来保持展开/收起状态在数据刷新后不丢失。示例见 NodeAdapter.kt 与 NodeActivity.kt。四、完美兼容 ConcatAdapterQuickAdapterHelper 的组合式加载方案README 将完美兼容 ConcatAdapter列为 v4 的首要特性。这一承诺的落地载体是 QuickAdapterHelper.kt。从源码注释给出的结构图可见其组装模型ConcatAdapter ----------------------------------------------------------------- leadingLoadStateAdapter 或者 BeforeAdapter ----------------------------------------------------------------- contentAdapter内容 ----------------------------------------------------------------- trailingLoadStateAdapter 或者 AfterAdapter -----------------------------------------------------------------即一个内容 AdaptercontentAdapter 可选的头部加载 AdapterleadingLoadStateAdapter 可选的尾部加载 AdaptertrailingLoadStateAdapter通过ConcatAdapter拼装成一个对外只暴露一个helper.adapter的整体。典型用法来自源码注释val helper QuickAdapterHelper.Builder(...).build() recyclerView.adapter helper.adapter或使用 Builder 的便捷方法直接挂载QuickAdapterHelper.Builder(contentAdapter) .setTrailingLoadStateAdapter(loadMoreListener) // 尾部加载更多监听 .setTrailPreloadSize(size) // 尾部预加载阈值item 数 .isTrailAutoLoadMore(true) // 是否自动加载更多 .setLeadingLoadStateAdapter(loadListener) // 首部向上加载监听 .setLeadPreloadSize(size) // 首部预加载阈值 .setConfig(ConcatAdapter.Config.DEFAULT) // ConcatAdapter 配置 .attachTo(recyclerView) // 直接附加到 RecyclerViewQuickAdapterHelper还提供了addBeforeAdapter/addAfterAdapter/removeAdapter/clearBeforeAdapters等方法可在运行时动态调整内容 Adapter 前后的附加 Adapter如插入 Header/Footer并在插入时自动把预加载监听挂到最外层 Adapter 上QuickAdapterHelper.kt。示例工程中的 HeaderDragAndSwipe.kt、HeaderAndFooterUseActivity.kt 均有实际组合用法。五、向上/向下加载LoadState 状态机与预加载README 称 v4 向上、向下加载得到极大加强。加载状态的核心抽象是 LoadState.kt分为四种状态NotLoading含endOfPaginationReached标记是否到底、Loading、Error、None。默认尾部加载 Adapter DefaultTrailingLoadStateAdapter.kt 内置了四视图切换逻辑NotLoading(endOfPaginationReached true)显示加载完成/没有更多视图NotLoading(endOfPaginationReached false)显示可点击的加载更多视图点击触发invokeLoadMore()Loading显示加载中动画视图Error显示失败视图点击触发invokeFailRetry()重试。布局见 brvah_trailing_load_more.xml头部对应 DefaultLeadingLoadStateAdapter.kt 与 brvah_leading_load_more.xml。开发者也可继承TrailingLoadStateAdapter/LeadingLoadStateAdapter自定义加载视图示例见 CustomLoadMoreAdapter.kt。预加载的触发机制在 QuickAdapterHelper.kthelper 通过给内容 Adapter 注册OnViewAttachStateChangeListener当尾部或首部item 滑入窗口时调用checkPreload()判断是否达到预加载阈值从而实现滚动接近末尾时自动加载更多。完整示例见 AutoLoadMoreRefreshUseActivity.kt。六、数据更新、动画与状态视图6.1 丰富的数据操作 APIBaseQuickAdapter内置一整套带JvmOverloads的数据操作方法均支持可选的commitCallbackBaseQuickAdapter.ktsubmitList(list)整体替换数据推荐add(position, data)/add(data)/addAll(...)单条/批量插入removeAt(position)/remove(data)/removeAtRange(range)删除set(position, data, payload)定点修改支持 payload 局部刷新swap(from, to)/move(from, to)交换与移动两者结果顺序语义不同源码注释已特别提醒itemIndexOfFirst(item)按相等语义查找索引。在有 Differ 的路径下这些操作统一转化为mDiffer.currentList.toMutableList()修改后重新submitList从而复用 Diff 动画无 Differ 路径则直接notifyItem*精准通知。删除到空列表时还会自动补发notifyItemInserted(0)以便切换到空视图BaseQuickAdapter.kt。6.2 内置五种入场动画v4 将动画抽象为 ItemAnimator.kt内置五种实现BaseQuickAdapter.ktenum class AnimationType { AlphaIn, ScaleIn, SlideInBottom, SlideInLeft, SlideInRight }对应实现位于 animation 目录AlphaInAnimation.kt、ScaleInAnimation.kt、SlideInBottomAnimation.kt、SlideInLeftAnimation.kt、SlideInRightAnimation.kt。通过adapter.animationEnable true开启isAnimationFirstOnly控制是否仅首次滚动播放也可实现自定义ItemAnimator赋给itemAnimation。示例见 AnimationUseActivity.kt。6.3 空视图/状态视图与点击事件v4 引入统一的状态视图概念isStateViewEnable开关 stateView可 View 可布局 idisUseStateViewSize尺寸控制空数据时由StateLayoutVH渲染BaseQuickAdapter.kt。旧 APIisEmptyViewEnable、emptyView、setEmptyViewLayout()均已标记Deprecated并自动委托到新 API兼容迁移路径清晰。示例见 EmptyViewUseActivity.kt。点击事件方面提供setOnItemClickListener、setOnItemLongClickListener、addOnItemChildClickListener(id, listener)子 View 点击支持 SparseArray 按 id 注册以及对应的 View 附加状态监听addOnViewAttachStateChangeListener绑定逻辑集中在bindViewClickListenerBaseQuickAdapter.kt示例见 ItemClickActivity.kt。七、ProGuard 混淆规则无需手动配置README 专门说明此资源库自带混淆规则并且会自动导入正常情况下无需手动导入。仓库内的 library/proguard-rules.pro 即随库发布并被 AAR 机制自动合并进使用方工程的混淆配置因此开发者无需在自身proguard-rules.pro中额外添加 keep 规则。需要核对规则内容时可直接查看该文件。八、Demo 与示例代码README 单独列出 demo 入口。本仓库中demo 目录提供可直接安装体验的app-release.apk完整示例源码位于 app/src/main/java/com/chad/baserecyclerviewadapterhelper/activity 下按功能模块组织包括animation入场动画、databindingDataBinding 集成、differDiffUtil 异步差异、dragswipe拖拽与滑动删除、emptyview空视图、headerfooter头尾布局、itemclick点击事件、loadmore加载更多与自动加载、node树节点、scene多类型分组、upfetch向上加载等每个模块都配有独立 Adapter 与 Activity是学习 v4 各功能的最佳配套材料。九、版本演进与文档生态README 提示旧版本用户可继续使用 2.x 与 3.x 分支v4 的详细中文文档由官方 Wiki 维护README 中标注Document章节。从源码结构可以推断v4 通过独立坐标BaseRecyclerViewAdapterHelper4与旧版共存同一工程内可平滑迁移、逐步替换这降低了升级成本。总结BRVAH v4 以拆分工模块、兼容 ConcatAdapter、强化双向加载与多类型布局为核心交付了一套更简洁、更现代的组合式 Adapter 方案。快速接入只需一行 Maven Central 依赖深入使用则围绕BaseQuickAdapter五大基类与QuickAdapterHelper展开所有核心能力均可在 library/src/main/java/com/chad/library/adapter4 的源码中找到实现依据配合 app 示例工程即可快速落地到业务项目。赞分享移动开发UI组件【免费下载链接】BaseRecyclerViewAdapterHelperBRVAH:Powerful and flexible RecyclerAdapter项目地址https://gitcode.com/gh_mirrors/ba/BaseRecyclerViewAdapterHelper点击查看免费下载相关推荐PermissionsDispatcher 迁移指南从 2.x 到 4.x 与 Maven Central 的完整升级路径PermissionsDispatcher 迁移指南从 2.x 到 4.x 与 Maven Central 的完整升级路径 本文是面向 Permissions移动开发zotero-style通过模块化架构解决科研文献可视化管理难题的技术方案zotero style通过模块化架构解决科研文献可视化管理难题的技术方案 在科研工作流程中文献管理工具往往面临信息过载和可视化不足的双重挑战。传统文献管理桌面应用知识管理科研PyTorch Android 构建与集成指南从 Maven 依赖到源码编译 libpytorch.so 的完整实践PyTorch Android 构建与集成指南从 Maven 依赖到源码编译 libpytorch.so 的完整实践 PyTorch 的 Android 集成人工智能机器学习深度学习分布式训练模型编译上一篇GPT Researcher 网页抓取配置完全指南从 BeautifulSoup 静态解析到 Tavily Extract / FireCrawl 生产级抓取下一篇在 AIRI 中配置 AIHubMix 聊天模型从 API Key 获取到验证与排障创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考