场景很具体:要在用户的 Android 源码里插一行 super.onCreate() 之后、找最后一个 import、找方法结尾的 }。这些都是文本搜索,不认语法树。
三类真实会踩的坑
第一类,Log.d("t", "}")。你在找方法结尾的 },字符串里那个先被找到了。
第二类,注释里的 import。// import androidx.activity.enableEdgeToEdge 会把插入点劫持到注释里。
第三类,Kotlin 字符串模板。嵌套引号这种写法,字符串扫描器会在内层引号处提前结束,后面的代码被当成字符串,或者反过来。
做法分两步
判断和写回走两条路径。判断在掩码文本上做——把注释、字符串内容替换成等长空格,偏移量不变,这样搜索锚点不会命中假的;但真正写回必须用原文,否则用户代码里的注释和字符串会被二次破坏。
关键的一步:闸门不复用掩码
这是上一版踩过的坑。如果闸门和掩码共用一套实现,掩码错的时候闸门也错,检查结果是通过,代码其实已经坏了——错得很自洽,等于没检查。
现在闸门是一套单独写的极简词法器,自己不认任何业务逻辑,只做三件事:
- 纯插入点必须落在代码区,不能落进字符串、注释、字符字面量;
- 插入点所在括号层级必须和锚点文字一致——这条专治补丁掉到类体外层;
- 改动前后花括号和圆括号必须在代码区里绝对配平。
第 2 条值得多说一句。第 3 条其实拦不住掉到类外这种错误:补丁从方法里掉到类里,括号总数可能刚好守恒,配平检查就过了。层级检查是另一条独立的路,它比的是插入点的深度和锚点文字的深度——不一致就拒。
收尾
闸门不过就不写,直接提示人工。加上 apply 之后会复扫一次、把新增 finding 当 warning 抛出来,再加一层字节级 undo 兜底。
拒绝自动修比强行修更贵,但更对。一个静态工具最贵的错误不是漏报,是把人家能跑的代码改坏了。
顺带一句
这套东西跑起来之后我把它做成了一个 Windows 上的桌面工具,叫 EdgeFit。扫一遍工程就能把 Android 15/16 的 edge-to-edge 问题按文件行号列出来。
检测版免费,需要自动改的才走买断制。