PatchAssistant2J 1.3.x 说明文档

主界面

程序主界面

分区导航

选项栏

左侧提供补丁信息选中联动文件详情等常用选项的快捷操作,右侧提供搜索配置关于等功能的打开按钮。

补丁信息

控制主界面下方的补丁信息窗体的显示。

  • 勾选:显示补丁信息窗体
  • 未勾选:隐藏补丁信息窗体。

选中联动

在应用文件和补丁文件已经匹配(新增、修改)的情况,控制选中应用文件或者补丁文件时,已经关联的匹配文件自动选中。

  • 勾选:自动选中已经关联匹配的文件
  • 未勾选:禁用自动选中已经关联匹配的文件

文件详情

控制应用树和补丁树是否显示文件的详情信息(修改时间、文件大小、文件Hash值等)。

  • 勾选:在应用树和补丁树中显示文件详情
  • 未勾选:在应用树和补丁树中不显示文件详情

仅看变动

在应用文件和补丁文件已经匹配(新增、修改)的情况,应用树仅显示已经关联匹配的文件。在没有文件匹配的情况下,应用树显示无叶子节点的空树。

  • 勾选:应用树仅显示已经关联匹配的文件
  • 未勾选:应用树显示所有的文件

Docker镜像

控制是否应用Docker镜像模式,应用Docker镜像模式的情况下,程序自动将生成的应用包上传到Docker服务器,按照Dockerfile模板生成Docker镜像、导出Docker镜像,并自动把导出的.tar文件下载至指定目录(生成速度受Docker配置、计算机状态、网络等因素的影响)。

  • 勾选:保存Docker镜像(*.tar)
  • 未勾选:保存应用包(*.jar)

应用树

按层级展示应用包中的内容,支持多层展开,即Jar包无限嵌套的情况。

选择应用包

点击“选择”按钮或者通过快捷键Ctrl + O可以打开资源管理器选择应用包,仅支持*.jar格式的Java应用包。也可以通过拖拽的方式将*.jar包拖入应用树区域。

应用包选择界面

右键菜单

当焦点在应用树时,通过单击鼠标右键打开操作菜单。

创建目录

选中目录时显示“创建目录”菜单项,可以在当前选中的目录下面创建子目录,创建时可以直接对新增的目录名称进行编辑,按回车键确认。

新增目录示例

重新加载

选中根节点时显示“重新加载”菜单项,该操作可以重新读取应用文件并刷新应用树。当焦点在应用树时,也可以通过F5快捷键或者Ctrl + R快捷键重新加载应用树。

重命名

选中目录或者文件时显示“重命名”菜单项,该操作可以直接修改文件名称。当选中目录或者文件时,可以通过F2快捷键进行重命名。

文件重命名

删除

选中未关联的文件或者目录时显示“删除”菜单项,该操作会直接将文件或者目录从应用树中移出。

删除文件确认框

标记删除

选中未关联的文件或者目录时显示“标记删除”菜单项,该操作不会立即删除文件,而是将文件类型标记为删除状态,并且显示颜色置灰,在保存应用时才会排除该文件。对于通过补丁说明匹配删除的文件状态为标记删除状态。

标记删除的文件被置灰

保存文件

选中文件时显示“保存文件”菜单项,该操作可以将选中的文件保存到指定的位置,或者通过拖拽的将文件拖到指定位置。

保存源文件

选中*.class文件时显示“保存源文件”菜单项,该操作将直接反编译字节码文件并将反编译的结果保存到指定位置。

资源管理器中查看

当选中的目录或者文件在磁盘中存在时显示“资源管理器中查看”菜单项,该操作将直接打开资源管理器并定位到选中的文件。应用树只有根节点在磁盘中有文件对应,其余节点均为压缩包中的文件,因此只有根节点会显示该菜单项。

聚焦应用

“聚焦应用”菜单项会把补丁树区域隐藏,仅显示应用树区域。

聚焦应用

补丁树

按层级展示补丁包或者补丁目录中的内容,支持无限嵌套补丁包(目前支持*.zip*.rar两种压缩格式)。

选择补丁包

点击“选择”按钮或者通过快捷键Ctrl + O可以打开资源管理器选择补丁包,仅支持*.zip*.rar格式的补丁包。也可以通过拖拽的方式将*.zip或者*.rar包拖入补丁树区域。

补丁包选择界面

选择补丁目录

点击“目录”可以打开资源管理器选择补丁目录,也可以通过拖拽的方式将补丁文件所在目录拖入补丁树区域。

右键菜单

当焦点在补丁树时,通过单击鼠标右键打开操作菜单。

重新加载

选中根节点时显示“重新加载”菜单项,可以重新读取补丁文件、补丁目录内容刷新补丁树。当焦点在补丁树时,也可以通过F5快捷键或者Ctrl + R快捷键重新加载补丁树。

当选中标记根节点时显示“刷新信息”菜单项,支持重新读取标记根节点的补丁说明文件,刷新当前标记根节点的绑定信息。也可以通过F5快捷键或者Ctrl + R快捷键完成刷新。

刷新信息

注意:“重新加载”和“刷新信息”会根据当前节点所在根的类型(根、标记根)显示其中一个菜单项,快捷键亦然。

保存文件

参考:应用树-保存文件

保存源文件

参考:应用树-保存源文件

查看签名

查看签名可以查看根节点标记根节点的详细文件信息,包括补丁编码、补丁名称、完整Hash值等信息,可用于校验补丁文件完整性。

查看签名

查看绑定信息

查看绑定信息

资源管理器中查看

聚焦补丁

“聚焦补丁”菜单项会把应用树区域隐藏,仅显示补丁树区划。

聚焦补丁

补丁信息

补丁说明文件(README.txt)

状态栏

状态栏左边显示操作统计信息,右侧显示保存按钮。

统计信息

  • 新增-显示应用树新增的文件数量
  • 修改-显示应用树更新的文件数量
  • 删除-显示应用树手动删除的文件数量
  • 标记删除-显示应用树根据说明文件匹配删除的文件数量和手动标记删除的文件数量之和

保存按钮

替换完补丁后需要点击右下角的保存按钮保存操作结果,未保存操作结果不会同步到应用文件。

保存没有进行任何操作的应用包时,将会提示: 未更改提示

如果应用包已经替换过相同的补丁包时,将会提示: 补丁包执行重复提示

注意:补丁包执行重复提示需要开启“写入补丁签名”功能,参考 补丁配置

文件查看

普通文本

文本查看

代码高亮

代码高亮

反编译

文本字符集

内容查看时,通过右键菜单要的字符编码,支持GBKUTF-8字符集,满足绝大部分的情况。

字符编码

差异(对比)模式

差异(对比)模式的前提是应用文件和补丁文件已经匹配,可以通过右键菜单切换模式。 切换对比模式

对比模式:呈左右两侧内容,左边是应用树文件内容,右边是补丁树文件内容 对比模式

差异模式:应用树文件内容和补丁树文件内容通过文本对比工具对比后合并显示 差异模式

@@ -1,2 +1,1 @@

代表:从第一行开始删除两行内容,从第1行开始新增一行内容

其他文件

对于非文本文件或者程序未支持的文件类型,会调用系统默认程序打开。

搜索

快速搜索

高级搜索(弹窗)

配置(界面)

配置界面

常规配置

配置项默认值配置说明生效时间
主题明亮主题明亮主题暗夜主题保存
语言English简体中文、英文重启

搜索配置

配置项默认值配置说明生效时间
保存历史条数30高级搜索保存搜索记录的条数保存

补丁配置

配置项默认值配置说明生效时间
用户名计算机登录用户名写入补丁签名时优先使用该值保存
开启路径匹配自动按全路径匹配补丁文件保存
开启文件名匹配自动按文件名匹配补丁文件保存
说明文件README.txt补丁说明文件名称保存
写入补丁签名保存应用包时将补丁签名写入META-INF/patch-up.sign文件保存
UnRar路径C:\Program Files\WinRARUnrar程序的路径,用于解压rar5压缩包保存

Docker配置

配置项默认值配置说明生效时间
本机调用本地docker命令生成tar镜像包保存
远程调用远程docker命令生成tar镜像包,需要配置远程信息保存
命令dockerdocker命令(可填写全路径)保存
目录/opt/PatchAssistant2J上传、导出文件的工作目录保存
地址-远程docker服务器的地址和端口保存
用户-远程docker服务器登录的用户名保存
密码-远程docker服务器登录的密码保存

快捷键

位置快捷键说明
应用树F5/Ctrl + R重新加载应用包
应用树Ctrl + O选择应用包
应用树F2重命名文件

特别鸣谢

开发计划

PatchAssistant2J 开发计划

使用 Hugo 构建
主题 StackJimmy 设计