杰理打包工具
JL打包工具 V1.0.0 使用说明
JL打包工具是一款用于杰理固件交付文件整理的桌面工具。它可以根据客户代码、项目名称、芯片型号、软件版本、蓝牙名称、校验码等信息自动生成规范文件名，并支持输出 FW、UFW、ZIP 升级包和 LOG 日志。
适用场景：
- 固件版本交付前的统一命名
- 自动生成
update.ufw升级包 - 生成带校验码、版本号、项目名的交付文件
- 输出累计或单次 LOG 记录
- 按 KEY 文件生成授权后的固件文件
1. 软件启动
双击运行JL打包工具_V1.0.0.exe。
图1说明：主界面左侧用于填写打包字段、选择输出目录、设置固件授权模式和输出选项，右侧用于填写打包日志。顶部包含路径层级、文件名顺序、主题和著作信息。
2. 填写打包信息
常用字段包括：
自定义备注客户代码项目名称芯片型号ROM容量硬件版本软件版本蓝牙名称校验码生成日期
字段左侧的勾选框决定该字段是否参与最终文件名。未勾选的字段不会出现在输出文件名中。
图2说明：根据项目实际情况填写字段。软件会尽量自动识别部分信息，例如蓝牙名称、芯片型号、校验码和日期；用户手动修改后的内容优先生效。如果手动填写后又调整路径层级，则以最新路径层级识别结果为准。
3. 选择输出目录
在输出路径下方点击选择输出目录，选择本次打包文件保存的位置。
软件会在输出目录下自动创建日期编号文件夹，例如：
20260724-001 20260724-002每次打包会自动递增编号，方便区分不同批次。
图3说明：建议为每个客户或项目单独建立输出目录，后续查找历史版本会更清晰。
4. 选择固件授权模式
固件授权模式有三种：
无授权：直接复制原始固件输出无限制授权：生成无限制授权后的固件文件机器码授权：根据机器码和授权数量生成授权后的固件文件
选择无授权时，KEY 文件、机器码和数量输入项会自动收起。
选择无限制授权时，需要选择 KEY 文件。
选择机器码授权时，需要选择 KEY 文件，并填写机器码和授权数量。
图4说明：如果选择了固件授权模式，工具会同时输出授权前文件和授权后文件。授权后文件名会自动带有授权标识；授权文件本身不会额外生成压缩包。
授权文件名示例：
JL0001_[已授权_无限制].fw JL0001_[已授权7-机器码CRC[D471]].fw5. 选择输出内容
输出选项包括：
输出 FW输出 UFW生成 ZIP(update.ufw)生成 LOG.txtLOG方式：累加 / 不累加打包后打开目录
图5说明：如果没有勾选生成 LOG.txt，ZIP 内不会包含 LOG 文件；如果勾选了生成 LOG.txt，ZIP 内会同时打包LOG.txt。固件授权输出不会影响原有 FW、UFW、ZIP 和 LOG 的生成规则。
6. 填写打包日志
右侧打包日志区域用于记录本次修改内容和备注。
默认格式如下：
/***************20260724-001***************/ [V]0.0.1 校验码: [ 6DA1-F7A9FA50 ] 蓝牙名: [ BT_NAME ] 日期 : [ 20260724 ] 型号 : [ AC6323A4 ] 项目 : [ Mayn->JL0001 ] ============== 修改内容: 1. 2. 3. ============== 备注: @[NULL]->FIXLOG方式支持两种模式：
累加：新记录在上，历史记录在下不累加：只输出本次日志
图6说明：累加模式适合长期维护同一个项目，可以在一个 LOG 文件中保留多个版本的修改记录。
7. 开始打包
确认字段、输出目录、固件授权模式、输出选项和日志内容无误后，点击底部开始打包。
打包完成后，输出目录中会生成对应文件。
常见输出示例：
图7说明：ZIP 内部的升级文件名保持为update.ufw。
8. 文件名顺序调整
顶部点击文件名顺序旁边的显示，可以展开字段排序列表。
拖动字段即可调整最终文件名中各字段的顺序。
图8说明：如果客户有固定命名规范，可以通过拖动排序快速适配。
9. 路径层级设置
顶部点击路径与层级旁边的显示，可以设置从路径中自动识别客户代码和项目名称的层级。
图9说明：如果项目目录结构固定，可以通过路径层级减少手动填写工作。
10. 主题
工具支持主题切换
11. 常见问题
11.1 提示 KEY 文件不匹配
说明当前选择的 KEY 文件与固件不匹配。请重新选择正确的 KEY 文件。
11.2 ZIP 里没有 LOG.txt
只有勾选生成 LOG.txt时，ZIP 内才会包含LOG.txt。
11.3 授权后为什么还有原始文件
选择固件授权模式后，工具会同时输出授权前的原始文件和授权后的新文件。这样既方便内部存档，也便于交付时进行核对。
11.4 LOG 累加顺序是什么
累加模式下，新版本记录在最上方，旧版本记录在下方。