大家好啊。
我是个搞了 7 年多 Android 原生开发的老人了，平时常翻 Android Framework 源码，也懂点逆向 Hook 和 AOP 插桩，比如之前写过的 YukiHookAPI，偶尔还会写点后端（ PHP/SpringBoot ）折腾一下全栈。我一直有个习惯：在实际业务里踩了坑，就想办法通过开源工具库把能力沉淀下来，主打一个“开源反哺业务”。
写 Android 久了，人很容易进入一种奇怪的状态：有些需求不是不会写，而是每次碰到那些极度眼熟、又长又臭的 API ，往往会在敲键盘前忍不住长叹一口气：“怎么又是你？”
我算是个重度强迫症患者，对 Android 的很多不满，其实不是因为“它做不到”，而是“它明明能做到，但代码写起来怎么就这么别扭？”
比如一大坨的 Builder，比如不知道怎么就被吞掉的 padding，比如永远记不清参数顺序的 dp2px。
于是，就有了 BetterAndroid。
它不是什么想去颠覆什么架构的新框架，也不仅仅是塞一堆毫无灵魂的 xxxUtils。它更像是我对自己这 7 年编码体验的一次“重构”。我的初衷很简单：在不破坏原生能力、不强行改变项目架构的前提下，把那些重复、繁琐、兼容性像盲盒一样的部分，整理成更顺手的现代 Kotlin 写法。
这里面的很多功能，都是我在被实际业务狠狠按在地上摩擦后，抠出来的痛点。
1. 系统栏：Android 适配里最坑人的无底洞
如果只看文档，弄个状态栏、导航栏无非就是调个颜色、设几个 flag 。但只要你真正在项目中处理过沉浸式、Edge-to-Edge 或者在深浅色内容间跳跃，就知道这玩意有多恶心。不同系统版本表现不一样，不同国产 ROM 甚至还有私有实现。
在 BetterAndroid 里，我搞了个 SystemBarsController。它不是简单帮你改个颜色，而是把整个系统栏当成一个独立的“界面控制对象”。
很多老哥遇到的坑是，一开启 Edge-to-Edge ，内容就被刘海、水滴或者底部的短条给挡了。BetterAndroid 默认会用 safeDrawingIgnoringIme 给根布局垫一层安全的 padding ；如果你想自己掌控一切，直接置空 edgeToEdgeInsets 就行。总之，我不止给你提供方法，更想帮你提前把布局关系给想好。
2. Insets：把 Compose 的爽感偷回原生 View
Insets 是个好东西，但原生的写法实在让人没法夸：
WindowInsetsCompat.getInsets(WindowInsetsCompat.Type.systemBars())
页面稍微复杂点，这就是一坨又长又绕的代码。
在这里，我偷师了 Jetpack Compose 的思路，把 Insets 独立成了 ui-extension 的核心能力。现在你可以直接拿：
insetsWrapper.systemBars
insetsWrapper.ime
甚至它还支持 +、-、or、and 运算。应用到 View 上也不用手写繁琐的 setPadding，直接：
view.setInsetsPadding(systemBars)
view.updateInsetsPadding(insetsWrapper.ime, bottom = true)
而且小细节是：它会保存你本来的 padding 作为基线！ 再也不怕 Insets 一刷新，把你辛辛苦苦在 XML 里写的内边距全吃掉了。
3. 发个系统通知，为什么要像造火箭一样？
高低版本兼容、坑爹的通知渠道、Android 13 的运行时权限……写到最后，业务代码里混着一大段 Builder，看着就心烦。
我对通知做了一整套封装，我希望发通知的代码看起来是在描述“我要发一条通知”，而不是在拼装宇宙飞船：
context.createNotification(
channel = NotificationChannel("my_channel_id") {
name = "My Channel"
}
) {
smallIconResId = R.drawable.ic_my_notification
contentTitle = "My Notification"
contentText = "Hello World!"
}.post()
第一次 post 自动创建渠道，遇到同 ID 自动复用，权限优先级也成了友好的枚举，少掉一堆头发。
4. 都什么年代了，我真的不想再写 dp2px 了
相信我，每个接手屎山的项目，都能搜出 3 个以上的 DensityUtils。在 XML 里写 10dp 那么自然，一到代码里就得搞转换。
BetterAndroid 给 Kotlin 提供了一套很直觉的扩展：
val px = 10.toPx(context)
val dp = 36.toDp(context)
如果你在 Fragment / Activity 或者有 Context 的类里，只要实现一个 DisplayDensity 接口，甚至可以直接：
val px = 10.dp
val dp = 36.px
对嘛，写 Kotlin 就应该有写 Kotlin 的样子。 (注：如果你的项目重度依赖 Compose ，不建议混用避免命名冲突，这点我也在文档里标红了)
5. 国产 ROM 识别：一门玄学与野路子工程学
搞过国内适配的都知道，只判断 Android 版本那是图样图森破。 MIUI 、HyperOS 、ColorOS 、OriginOS 、MagicOS……它们都叫 Android ，但遇到 Bug 时个个都想让你怀疑人生。
得益于平时摸爬滚打做系统级问题定位的经验，BetterAndroid 里的 RomType 没有用市面上死板的设备型号匹配，而是通过综合判断底层系统属性、类存在性等核心特征去巧妙“闻”出来的。它不仅暴露出来给你用：
if (RomType.matches(RomType.MIUI)) {
// 专门针对 MIUI 写 workaround...
}
我在底层做系统栏适配和异形屏去坑时，也重度依赖了这套判断。这完全是在各种真实设备里滚钉板总结出来的填坑指南。
最后，聊句大实话：关于 Compose 与 View
现在大趋势是 Compose ，这毋庸置疑，我自己其实也是 Jetpack Compose 生态的重度使用者。我也做了 compose-extension 去支持跨平台，但现实是怎样的呢？
现实是大量的老项目、历史组件、复杂的屎山，依然在原生 View 体系里苟延残喘。大部分老哥根本没法（也没空）喊一句“全部重构为 Compose”。
所以 BetterAndroid 这个东西，本质上是给咱们这些还在维护/编写原生 View 的人，留一条更体面的路：不逃离原生，但也不被原生 API 的历史包袱恶心死。
其实顺带我还搞了一个极其头铁的项目叫 Hikage，一个 Android 响应式 UI 构建工具，让原生组件也能有更接近声明式布局的极致体验（有兴趣可以看看）。
总而言之，BetterAndroid 是我这 7 年踩坑、绕路、咒骂 API 之后的一次总账。如果你也曾对着某些弱智的源码发出过“卧槽这玩意是不是能写得稍微像个人一点”的感叹，希望这个库能帮你顺顺气。
🔗 GitHub 传送门：
欢迎体验、提 Issue 、扔砖，如果能骗个 Star 就更好了，嘿嘿。
2
Select Language