四份日志的分工：dock、error、pack、apktool 各记什么，先翻哪一份

安卓修改大师智改工坊 · 技术拆解

出错不可怕，找不到现场才可怕

dock.log · error.log · pack.log · apktool.log

主标语放在最显眼的位置：只需说话，就能让应用变成你想要的样子。这是安卓修改大师智改工坊要做的事——一款 Windows 桌面工具，拖入安装包、用中文写需求，AI 改 smali 与资源，改完自动回编 / 对齐 / 签名 / 校验，一键装到手机或模拟器看效果。介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网 www.apkeditor.cn。

改包这件事，链路长、环节多：解包、改 smali 与资源、回编、对齐、签名、校验、装机、拉起。任何一环出问题，症状看起来都差不多——"没成功"。要把它变成"能定位的问题"，靠的不是运气，而是把每一步的现场都写进文件。这篇就把四份日志的分工、位置和用法讲透。

一、为什么要写四份，而不是一份大日志

四类问题的现场根本不在同一个地方。反编译失败，现场是 apktool 那一长串输出；打包失败，现场是四条命令与它们的返回；界面吸附异常、AI 等待不结束、主题没生效，现场是程序自己的运行轨迹；而崩溃，现场只有异常堆栈。把它们混在一个文件里，只会让每次排查都从头读到尾。

所以这套工具按"谁产生、谁负责、活多久"把日志分成四份：两份跟着程序走（放在系统用户目录下，跨项目共用），两份跟着项目走（放在项目工作目录里，删项目就一起走）。

一句话分工：dock.log 是程序的运行现场，error.log 是崩溃现场，pack.log 与 apktool.log 是"这个包"的产物过程。

二、四份日志各记什么

dock.log 默认是关的：用 --verbose 启动，或把 settings.ini 里的 VerboseLog 改成 true，它才开始写。它记的东西很杂，但可以归成四类。

• 吸附几何：两个窗口的矩形、磁吸动画轨迹、每次写入被吸附窗口的矩形与原因、主窗口跟随缩放的前后尺寸，以及"对方变了但主窗口没变就跳过（避免死循环）"这类判断。
• 窗口生命周期：找到窗口的句柄、进程号与标题；托盘里没窗口时的处理；启动清理、重启、退出清理各结束了多少进程、优雅关闭是否超时。
• 发送与停止：粘贴进对方输入框的字符数、唤醒窗口用到的办法；"取消修改"时点到了哪个停止按钮。
• 界面自检：主题应用、页面切换完成、各浮层显示与隐藏、绑定错误（带"绑定: "前缀），以及一行"布局自检"。

它的写入方式有几个讲究：第一行是抬头（程序名 + 吸附日志 + 时间），之后每行都带"时:分:秒.毫秒"前缀；写入加锁，多线程同时写不会错乱；而写日志失败会被直接忽略——日志是来帮忙的，不能反过来拖垮程序。

error.log 记的是崩溃现场。程序挂了两种线程的未处理异常都会落到这里：界面线程抛的异常会被标记为"已处理"，让程序继续跑，同时弹一个应用内提示窗口告诉你出了什么事；后台线程的异常同样记录并提示。每条的格式是"[时间] 上下文 + 异常全文"，追加写入，目录不存在会自动创建。还有一种特殊情况：如果主窗口还没建起来就崩了（启动期），提示会退回系统弹窗——因为那时候应用内的提示窗口还没地方挂。

pack.log 记的是"这一个包"的打包全程。头部先写清时间、项目工作目录、工具链描述、签名私钥与证书路径，然后是打包标记那一行；接着四条命令依次执行，每条都先写下"> 可执行文件 参数"，再把它吐出来的每一行原样收进来。最后一步是很多人会忽略的校验：前面三步只看退出码，而"到底签没签上"要 apksigner verify 说了算——密钥格式不对这类问题，只有这一步会明确报出来。

apktool.log 记的是反编译的完整输出。头部写明源文件与输出目录，正文是 apktool 的逐行输出。它最大的价值是"失败也能用"：反编译失败不会让项目创建失败——配置、图标、原始包副本都已经落地，照样能进详情页，只是多一条说明失败原因的提示；想把原因看全，就翻这个文件。

三、--verbose 到底多做了哪三件事

很多人以为 --verbose 就是"打开日志"，其实它同时打开了三样东西，第二样和第三样才是排查界面问题的关键。

1. 打开 dock.log 的写入。没有它，这个文件根本不会被创建。
2. 打开数据绑定错误跟踪。界面绑定一旦出问题，错误会以"绑定: "开头写进同一份日志；平时这类错误是静默的。
3. 启动后补一次布局自检。界面排完版后，把主窗口、顶栏、内容区、Tab 条、提示条的实测尺寸与当前页写进日志；切回新建项目页时还会再自检一次，并记下首页广告条在屏幕上的坐标。

要注意的是：命令行参数只对本次运行生效，不会写回配置文件。想长期开着，就改 settings.ini 里那一行；想临时抓一次现场，就用参数启动。

四、出问题先翻哪一份：四类症状的排查顺序

1. 包解不开、反编译失败 → apktool.log。看最后几行；注意项目本身没受影响，可以直接重试。
2. 打包失败、装上不去 → pack.log。找到失败那一步的命令与它的输出。
3. 界面不刷新、吸附不听话、等 AI 没反应 → dock.log（要 --verbose）。重点看绑定错误、自检数据与等待标志文件的那几行。
4. 程序崩了、启动就报错 → error.log。看时间点、上下文与异常堆栈的第一行。

顺序上还有一条经验：先看"最新一行"，再看"最后几行"。日志是按时间追加的，真正的原因通常就在出问题那一刻附近；从下往上看，比从上往下读快得多。四份日志里，pack.log 与 apktool.log 在失败时还会把最后几行直接附在错误提示里——界面上那一小段和文件里是同一批内容，不用另开文件就能先判断个大概。

五、怎么用才不踩坑：七个实操要点

1. dock.log 是"一次运行一份"。每次运行第一次写入时会重写文件并写下新抬头；想留现场，先复制走再重启程序。
2. 不开 --verbose 就没有这个文件。找不到它先确认这次是不是用参数启动的、配置里有没有打开。
3. 报问题时把 error.log 和 dock.log 一起发。前者说明"什么时候崩的"，后者说明"崩之前程序在做什么"。
4. pack.log 与 apktool.log 跟着项目走。一个项目一份，删项目会连它们一起删。
5. "没匹配到关键字，当时窗口里的按钮有 —— …"是给你改配置用的。把列出来的按钮名抄进 settings.ini 的停止按钮关键字里，不用等新版本。
6. "布局自检"那行是给窗口尺寸问题用的。主窗口高度超过屏幕会被系统截短（日志里看得出来），可以让高度自动收缩到可视区域。
7. 反编译失败不等于项目废了。配置、图标、原始包副本都已落地，项目照常可用；先看 apktool.log 再决定重试还是换包。

六、两个自家应用的改包实例：日志怎么真的帮上忙

实例一：自家内部工具包在旧机器上解不开。以前：同一个包在这台机器上解不开，就去换反编译工具、换参数、重装环境，一路试过去，最后也不确定到底卡在哪一步。现在一句话：拖入自家包建项目——反编译失败不会让项目失败，配置、图标、原始包副本都在；点开项目目录里的 apktool.log 看最后几行，就能判断是包本身的问题还是工具环境的问题。要用一句话完成修改时，把需求写清楚："把启动页背景换成附件里的图，应用名改成『XX 助手 内测版』"，附件写清用途后点「立刻修改」。怎么验证：打包时盯着四步逐个走完；失败就直接看项目目录里的 pack.log，找到失败那一步；成功就勾"打包后自动运行"装到设备上看效果。

实例二：改完好几版之后，要对上"手上这个包是哪一次出的"。以前：靠文件名和时间猜，发错版本给同事的坑谁都踩过。现在一句话：每次出包前程序会自动往资源里写一条打包标记（时间、账号、机器码、机器名、程序版本、应用名、包名等信息编码后写进一个名叫 info 的样式），同时这份记录也写进项目的 pack.log——打开文件看头部和标记那一行即可对上。怎么验证：出包后在打包窗口点「保存 APK」，默认文件名是"应用名_版本号_signed.apk"；拿不准就翻 pack.log 的时间与标记行，两者对上就没有争议。

七、把日志当成"过程的一部分"，而不是出事后的救火队

这套日志体系真正的价值，是把"改包"从一次性动作变成了可复现的过程。你随时能回答四个问题：这个包是什么时候、用什么工具链出的；反编译那一步有没有报过警告；签名到底有没有验过；程序在出问题那一刻正在做什么。

而这也是"只需说话就能改包"能成立的前提：一句话把需求交出去之后，中间那串命令不是你敲的、错误也不是你猜的。过程的每一步都被写下来了，出问题时你不用回忆，直接翻。安卓修改大师智改工坊的产品提示里也写着同一句建议：程序遇到未处理的错误会写进 error.log，报问题时把这个文件和 dock.log 一起发过来最有用。

回到主标语：只需说话，就能让应用变成你想要的样子。说得越轻松，背后的过程越要留下痕迹——四份日志就是这套工具留下的四组痕迹：dock.log 记程序在做什么，error.log 记它什么时候倒的，pack.log 与 apktool.log 记这个包经历了什么。产品是安卓修改大师智改工坊，介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网 www.apkeditor.cn。想验证这套东西，最好的办法是拿一个自家的包跑一遍完整流程，然后打开项目目录——那两份日志会告诉你，这句话背后到底做了多少事。