GAM项目Windows MSI安装包升级问题的分析与解决

问题背景

在GAM项目的Windows MSI安装包升级过程中，部分管理员报告了安装不完整的问题。具体表现为lib/目录下的部分文件在升级过程中被删除，导致GAM运行时因缺少依赖库而崩溃。

问题根源分析

经过技术团队深入调查，发现问题出在MSI安装包的构建过程中。当使用heat.exe工具生成文件列表时，每次构建都会为每个文件生成一个新的Guid标识符。这导致MSI安装程序将这些文件视为全新的文件，而非现有文件的更新版本。

在Windows Installer的升级机制中，文件的Guid标识符扮演着关键角色。如果前后版本的Guid不一致，安装程序无法正确识别这是同一个文件的新版本，从而导致文件替换失败。

临时解决方案

在找到永久解决方案前，技术团队建议采用以下临时方案：

1. 完全卸载当前GAM7 MSI版本（注意：此操作不会删除gam.cfg和项目文件）
2. 重新安装最新版本的MSI包

这种方法避免了升级过程，确保所有文件都能完整复制到目标位置。

永久解决方案

技术团队重写了构建工具脚本gen-wix-xml-filelist.py，在heat.exe运行后，该脚本会基于文件路径生成稳定的uuid5作为Guid。这种算法保证：

• 同一文件路径在所有构建中都会获得相同的Guid
• 不同文件路径获得不同的Guid
• 完全符合MSI升级机制的要求

注意事项

1. 使用GAM 7.00.19或更早版本的用户需要先执行卸载/重装操作
2. 卸载操作现在会删除空目录，但保留包含用户文件的目录
3. 建议用户不要在GAM安装目录中存放重要文件

版本建议

技术团队建议将修复后的版本号升级为7.01.00，以便用户更容易识别已修复的版本。

总结

通过为文件生成稳定的Guid标识符，GAM项目成功解决了Windows MSI安装包升级过程中的文件丢失问题。这一改进确保了升级过程的可靠性，提升了用户体验。技术团队将继续监控该问题的解决效果，并根据需要进一步优化安装包构建流程。