3分钟集成NiceDialog：基于DialogFragment的Android弹窗库快速上手教程

3分钟集成NiceDialog：基于DialogFragment的Android弹窗库快速上手教程

【免费下载链接】NiceDialogA nice dialog, that is based on DialogFragment项目地址: https://gitcode.com/gh_mirrors/ni/NiceDialog

在 Android 开发中，弹窗（Dialog）几乎是每个应用都绕不开的功能，但传统AlertDialog写法繁琐、样式难调，还要处理屏幕旋转和生命周期问题。今天要介绍的NiceDialog，是一款基于DialogFragment的轻量级Android 弹窗库，主打"一行代码弹窗"，只需 3 分钟即可完成集成并跑出第一个弹窗，无论新手还是老手都能快速上手。

上图是 NiceDialog 示例工程中红包弹窗的效果，只需指定一张布局，就能做出这种高颜值弹窗。

NiceDialog 是什么？凭什么好用？

NiceDialog 在DialogFragment之上做了一层简洁封装，核心代码集中在 BaseNiceDialog.java 和 NiceDialog.java 两个文件里，设计非常轻巧。它解决了原生弹窗的三大痛点：

• ✅写法简单：链式调用，一行代码完成弹窗创建与展示
• ✅生命周期安全：基于 Fragment 实现，屏幕旋转自动保存、恢复弹窗状态
• ✅动画随心配：内置上下左右进出场动画，一行配置即可切换

3分钟快速集成 NiceDialog 的完整步骤

第一步：添加 JitPack 仓库与依赖

在项目根目录的build.gradle中配置 JitPack 仓库，然后添加依赖即可，整个过程无需 clone 源码：

allprojects { repositories { maven { url "https://jitpack.io" } } }

dependencies { implementation 'com.github.SheHuan:NiceDialog:1.2.0' }

如果你想阅读或修改源码，也可以直接 clone 仓库体验完整示例工程：git clone https://gitcode.com/gh_mirrors/ni/NiceDialog，弹窗库本体位于nicedialog/目录，演示代码位于app/目录。

第二步：用一行代码弹出第一个弹窗

依赖同步完成后，在 Activity 里写下这段代码即可看到弹窗效果：

NiceDialog.init() .setLayoutId(R.layout.dialog) // 指定弹窗布局 .setConvertListener((holder, dialog) -> { // 在这里给弹窗里的控件绑定事件 }) .show(getSupportFragmentManager()); // 显示弹窗

没错，核心就三步：指定布局 → 绑定控件 → show 展示。更多完整示例可以参考演示工程中的 MainActivity.java，里面内置了分享、好友设置、评论、红包、加载提示等 7 种弹窗。

第三步：常用配置速查表

NiceDialog 提供了丰富的链式配置方法，这张速查表帮你快速找到想要的配置：

💡 小提示：setMargin()和setWidth()二选一使用即可，避免配置冲突。

进阶玩法：如何打造底部弹窗与自定义动画

最快的底部弹窗配置方法

常见的"底部弹出分享面板"，只需两行配置：

NiceDialog.init() .setLayoutId(R.layout.share_layout) .setGravity(Gravity.BOTTOM) // 底部弹出 .show(getSupportFragmentManager());

设置Gravity.BOTTOM后，NiceDialog 会自动匹配底部进出场动画（动画资源位于nicedialog/src/main/res/anim/目录），无需手动指定。

继承 BaseNiceDialog 打造可复用弹窗

如果同一弹窗需要在多个页面复用，推荐继承BaseNiceDialog，并使用原生 Fragment 传参方式传递数据：

public class ConfirmDialog extends BaseNiceDialog { public static ConfirmDialog newInstance(String type) { Bundle bundle = new Bundle(); bundle.putString("type", type); ConfirmDialog dialog = new ConfirmDialog(); dialog.setArguments(bundle); return dialog; } // 实现 intLayoutId() 与 convertView() 两个抽象方法即可 }

展示时依旧一行搞定：ConfirmDialog.newInstance("1").setMargin(60).setOutCancel(false).show(...)。

自定义动画的小技巧

NiceDialog 默认主题继承自Theme.AppCompat.Light.Dialog，可在 styles.xml 中查看默认动画风格。想自定义进出场动画，只需写一个 Animation 风格再通过setAnimStyle()传入，例如"缩放 + 渐变"的组合动画：

<style name="MyAnim" parent="android:Animation"> <item name="android:windowEnterAnimation">@anim/enter</item> <item name="android:windowExitAnimation">@anim/exit</item> </style>

结语：为什么推荐用 NiceDialog 做 Android 弹窗？

总结下来，NiceDialog 作为一款基于 DialogFragment 的 Android 弹窗库，把"配置繁琐、样式难调"的弹窗开发压缩到了极致：3 分钟集成、一行代码弹窗、内置动画、生命周期安全。如果你正在寻找一款简单好用的 Android 弹窗解决方案，不妨现在就上手试试吧！🚀

【免费下载链接】NiceDialogA nice dialog, that is based on DialogFragment项目地址: https://gitcode.com/gh_mirrors/ni/NiceDialog