ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何搭建File Converter开发环境并参与贡献:从Visual Studio构建到Wix安装器打包指南

如何搭建File Converter开发环境并参与贡献:从Visual Studio构建到Wix安装器打包指南 如何搭建File Converter开发环境并参与贡献从Visual Studio构建到Wix安装器打包指南【免费下载链接】FileConverterFile Converter is a very simple tool which allows you to convert and compress files using the context menu in windows explorer.项目地址: https://gitcode.com/gh_mirrors/fi/FileConverterFile Converter 是一款 Windows 平台的文件转换与压缩工具通过资源管理器右键菜单即可完成音视频、图像、Office 文档等格式转换。本文带你完整搭建 File Converter 开发环境从克隆代码、Visual Studio 2022 编译到用 Wix 5 打包出 MSI 安装器并给出新手参与贡献的入门路径全程约 30 分钟。1️⃣ 认识项目结构先看懂解决方案打开仓库根目录的 FileConverter.sln 可以看到整个解决方案由 3 个项目组成对应三种构建目标项目作用FileConverter主程序WPF 应用.NET Framework 4.8所有转换逻辑都在这里FileConverterExtension资源管理器右键菜单扩展基于 SharpShell需程序集签名InstallerWix 5 安装器工程负责打包 MSI主程序的依赖与构建行为都定义在 FileConverter.csproj 中它通过 NuGet 引用了 SharpShell、Magick.NET、NetOffice 等包并在构建后自动把ffmpeg.exe、Ghostscript 等中间件拷贝到输出目录见该项目文件末尾的 PostBuildEvent 节点。因此构建环境不需要你手动准备 ffmpeg仓库已内置。2️⃣ 开发环境快速清单Visual Studio 2022 一键配置按官方要求见 README.md 的 Setup development environment 一节你只需要准备Visual Studio 2022解决方案由 VS 17 生成建议安装.NET 桌面开发工作负载.NET Framework 4.8 开发工具包两个 C# 项目均面向 v4.8 框架Wix 5随 NuGet 自动还原无需手动安装建议再装一个 Wix 的 VS 扩展以便可视化编辑Windows SDK 签名工具仅 Release 打包安装器时需要用于签名 Installer.sign 引用的证书然后克隆代码git clone https://gitcode.com/gh_mirrors/fi/FileConverter用 Visual Studio 打开FileConverter.sln等待 NuGet 还原完成后把平台切换为x64安装器只定义在 Debug|x64 / Release|x64 两种配置上。3️⃣ Visual Studio 构建主程序与右键扩展直接按 F5 或选择生成解决方案即可产物输出到bin\x64\下。几个新手需要知道的点右键扩展必须签名FileConverterExtension.csproj 已内置FileConverterExtensionKey.snk签名密钥构建时自动签名无需额外配置。转换逻辑入口各类格式的转换作业都集中在 Application/FileConverter/ConversionJobs/ 目录例如 ConversionJob_FFMPEG.cs 负责音视频转换ConversionJob_ImageMagick.cs 负责图像处理改功能前建议从这里读起。界面与逻辑分离视图在 Views/ 目录如 MainWindow.xaml数据绑定在 ViewModels/ 目录遵循 MVVM 模式便于单独修改界面。4️⃣ Wix 安装器打包构建 MSI 安装包安装器工程的核心文件Installer/Installer.wixproj引用 WixToolset.Sdk 5.0.2声明了 Heat 采集任务并把主程序和扩展两个项目的产物都收进INSTALLFOLDERInstaller/Product.wxs定义产品属性版本 2.2.0、安装时注册/卸载右键扩展的自定义操作、以及 .NET Framework 4.8 的检测条件。打包步骤在解决方案配置中选择Release|x64并生成解决方案bin\x64\Release\下会生成FileConverter-setup.msi⚠️ Release 配置会导入 Installer.sign 进行安装器签名没有证书时可临时注释该行或改用Debug|x64生成免签名版本本地验证安装效果可以直接运行仓库自带的 Installer/DebugInstaller.batDebugInstaller.bat --debug --install它会自动执行 msiexec 安装/卸载支持--release、--uninstall、--quiet参数并在 VS Code 中打开安装日志方便排查问题。5️⃣ 新手贡献入口从哪下第一手本地化翻译最容易上手多语言文件位于 Application/FileConverter/Properties/例如 Resources.zh-CN.resx补充或修正词条即可转换预设示例预设见 PresetSamples/可参考 XML 结构新增预设跟随版本演进查看 CHANGELOG.md 了解每个版本的功能与修复也方便为自己的改动撰写变更说明诊断工具应用内置诊断窗口DiagnosticsWindow.xaml提交 issue 前可先导出诊断数据。完成构建、安装、修改、重新打包这一整套流程后你就已经掌握了 File Converter 从源码到安装包的全部链路可以开始向项目提交自己的第一个 PR 了 【免费下载链接】FileConverterFile Converter is a very simple tool which allows you to convert and compress files using the context menu in windows explorer.项目地址: https://gitcode.com/gh_mirrors/fi/FileConverter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表