LoadingAndRetryManager 使用避坑指南5 个常见问题与终极解决方案【免费下载链接】LoadingAndRetryManager无缝为Activity、Fragment、任何View设置加载loading、重试(retry)和无数据empty页面。项目地址: https://gitcode.com/gh_mirrors/lo/LoadingAndRetryManagerLoadingAndRetryManager 是一款轻量级的 Android 加载状态管理库核心功能是无缝为 Activity、Fragment 以及任意 View 一键设置 loading加载中、retry重试和 empty无数据页面。只需一行LoadingAndRetryManager.generate(this, listener)就能告别手工编写各种状态布局的重复代码。本文结合源码整理了 5 个新手最容易踩的坑并给出可直接照抄的终极解决方案帮你快速上手、少走弯路。先花 1 分钟认识核心 API整个库的核心逻辑集中在两个类中LoadingAndRetryManager.java对外入口负责生成管理器和状态切换LoadingAndRetryLayout.java内部容器管理四种子视图的显示与隐藏核心状态切换只有 4 个方法showLoading()显示加载中页面showRetry()显示重试页面showEmpty()显示无数据页面showContent()显示正常内容页面✨ 贴心的是这 4 个方法内部自动处理了主线程切换非主线程调用会自动post到主线程所以即使在子线程里调用也不会崩溃。避坑 1没有全局配置基础页面页面只剩一片空白常见症状调用generate后loading / retry / empty 布局完全没有出现界面毫无反应。踩坑原因库默认三个全局布局 ID 都是NO_LAYOUT_ID即 0。如果你不在 Application 中预先配置且 listener 也没有返回自定义布局库就会无页面可用效果约等于什么都没做。终极解决方案在MyApplication的onCreate中一次性配置好全局布局参考 MyApplication.javaLoadingAndRetryManager.BASE_RETRY_LAYOUT_ID R.layout.base_retry; LoadingAndRetryManager.BASE_LOADING_LAYOUT_ID R.layout.base_loading; LoadingAndRetryManager.BASE_EMPTY_LAYOUT_ID R.layout.base_empty;这样所有页面默认共享一套基础样式大大减少重复劳动。对应布局文件可查看 base_loading.xml 和 base_retry.xml。避坑 2generate 调用时机不对Fragment 直接空指针崩溃常见症状在 Fragment 中调用generate后 App 闪退报NullPointerException。踩坑原因generate在处理 Fragment 时会执行fragment.getView().getParent()。如果你在onCreate甚至onCreateView之前就调用generate此时getView()返回 null必然崩溃。终极解决方案记住黄金时机——必须在 View 创建完成之后调用。正确做法是在onViewCreated中调用参考 NormalFragment.javaOverride public void onViewCreated(View view, Bundle savedInstanceState) { super.onViewCreated(view, savedInstanceState); mLoadingAndRetryManager LoadingAndRetryManager.generate(this, listener); mLoadingAndRetryManager.showLoading(); }⚠️ 另外注意不要在onCreate里启动的线程中立即访问mLoadingAndRetryManager此时它可能还没初始化同样会空指针。避坑 3给任意 View 添加时未挂载直接抛出异常常见症状对某个 View 调用generate时崩溃异常信息是类型不匹配或空指针。踩坑原因库的构造函数里有这样一段逻辑——如果参数是 View会执行view.getParent()来找到父容器。如果这个 View还没有被添加到任何布局中比如刚从inflate出来还没 addgetParent()返回 null随即崩溃。终极解决方案确保目标 View 已经通过setContentView或addView挂载到界面上后再调用generate。参考官方示例 AnyViewTestActivity.java先用findViewById拿到已挂载的TextView再执行mLoadingAndRetryManager LoadingAndRetryManager.generate(mTextView, listener);避坑 4重试按钮点了没反应页面纹丝不动常见症状成功显示出了重试页面但点击重试按钮毫无反应。踩坑原因按钮的点击事件不是自动绑定的库只负责展示重试页面具体点击后的逻辑需要你在setRetryEvent回调中自己实现。如果 listener 里没写或者写成了空实现按钮自然没反应。终极解决方案在OnLoadingAndRetryListener的setRetryEvent中绑定点击事件并重新触发数据加载参考 MainActivity.javamLoadingAndRetryManager LoadingAndRetryManager.generate(this, new OnLoadingAndRetryListener() { Override public void setRetryEvent(View retryView) { retryView.findViewById(R.id.id_btn_retry).setOnClickListener(v - { loadData(); // 重新加载数据 }); } });避坑 5重复调用 generate状态页面层层嵌套常见症状页面出现了两层甚至多层 loading / retry 布局或者显示异常错乱。踩坑原因generate的机制是移除原内容 View替换成新的LoadingAndRetryLayout。如果同一个 Activity / View重复调用generate第二次会把第一次生成的LoadingAndRetryLayout当成内容 View再包一层导致布局嵌套叠加。终极解决方案严格遵守一个目标只 generate 一次的原则建议把mLoadingAndRetryManager声明为成员变量避免重复创建只在onCreate/onViewCreated中调用一次后续切换状态统一使用showXxx()方法而不是重新generate// 成员变量全生命周期只生成一次 private LoadingAndRetryManager mLoadingAndRetryManager;结语记住 3 条黄金法则从此告别踩坑先全局配置在 Application 中设置好三个 BASE 布局 ID时机要对Activity 在setContentView之后、Fragment 在onViewCreated中调用generate只生成一次状态切换全部交给showContent / showRetry / showLoading / showEmptyLoadingAndRetryManager 的核心思想非常简洁一次生成、四处切换、任意 View 通用。只要避开上面 5 个坑你就能用极少的代码为整个 App 统一加载、重试、空数据三种状态把精力专注在真正的业务逻辑上。如果你正在开发多页面 Android 应用强烈建议在项目中引入这个库配合全局配置开发效率立竿见影【免费下载链接】LoadingAndRetryManager无缝为Activity、Fragment、任何View设置加载loading、重试(retry)和无数据empty页面。项目地址: https://gitcode.com/gh_mirrors/lo/LoadingAndRetryManager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考