MyPake - MSI 安装包构建工具

为什么选择 MyPake?

MyPake 是一款基于 Rust 语言开发的 MSI 安装包构建工具,使用 GPUI 框架构建现代化图形界面。它解决了传统制作 MSI 安装包需要编写复杂 WiX XML 配置文件的痛点,让您通过直观的图形界面快速生成专业的 Windows 安装程序。

MyPake 能为您解决什么问题?

❌ 传统方式的困扰

制作 MSI 安装包需要编写复杂的 WiX XML 配置文件,学习成本高,容易出错,对于不熟悉 WiX 语法的开发者来说是一个巨大的挑战。

✓ MyPake 的解决方案

通过可视化界面操作,无需编写任何代码。拖拽文件、填写产品信息、点击构建,三步即可生成专业的 MSI 安装包。即使没有 WiX 经验,也能轻松上手。

核心功能

  • 可视化文件管理:支持拖拽添加文件和文件夹,操作简单直观
  • 自动生成 WiX 配置:根据用户设置自动生成完整的 WiX 源文件
  • 快捷方式配置:支持创建桌面快捷方式和开始菜单快捷方式
  • 图标定制:支持自定义安装包图标,打造专业品牌形象
  • 多语言支持:内置中文界面,支持 WiX UI 本地化
  • 实时日志输出:详细的构建过程日志,便于问题排查

系统要求

硬件要求
  • CPU:x64 架构处理器
  • 内存:至少 2GB RAM(推荐 4GB 或以上)
  • 硬盘:至少 500MB 可用空间
软件要求
  • 操作系统:Windows 10/11(64位)
  • WiX Toolset v3.14 或更高版本

快速上手

  1. 添加文件:拖拽或点击按钮添加要打包的文件和文件夹
  2. 设置主程序:在文件列表中选择 .exe 文件设为主程序(可选)
  3. 配置产品信息:在设置页面填写产品名称、版本号等信息
  4. 配置 WiX 路径:首次使用需要配置 WiX Toolset 安装路径
  5. 构建安装包:点击"构建 MSI 安装包"按钮,等待完成

下载工具

通过百度网盘下载 MyPake 工具:

操作手册

1. 软件简介

MyPake 是一款基于 Rust 语言开发的 MSI 安装包构建工具,使用 GPUI 框架构建现代化图形界面。该软件旨在简化 Windows MSI 安装包的制作流程,用户无需编写复杂的 WiX XML 配置文件,即可通过直观的图形界面快速生成专业的安装程序。

主要功能

  • 可视化文件管理:支持拖拽添加文件和文件夹
  • 自动生成 WiX 配置:根据用户设置自动生成完整的 WiX 源文件
  • 快捷方式配置:支持创建桌面快捷方式和开始菜单快捷方式
  • 图标定制:支持自定义安装包图标
  • 多语言支持:内置中文界面,支持 WiX UI 本地化
  • 实时日志输出:详细的构建过程日志,便于问题排查

2. 系统要求

硬件要求

  • CPU:x64 架构处理器
  • 内存:至少 2GB RAM(推荐 4GB 或以上)
  • 硬盘:至少 500MB 可用空间

软件要求

  • 操作系统:Windows 10/11(64位)
  • WiX Toolset v3.14 或更高版本

3. 安装与启动

安装步骤

  1. 下载 MyPake 可执行文件(mypake.exe)
  2. 将文件放置在任意目录(建议放置在非系统盘)
  3. 确保 WiX Toolset 已正确安装

启动软件

双击运行 mypake.exe 即可启动软件。软件首次启动时会自动加载默认配置。

4. 界面介绍

主界面布局

软件主界面采用现代化深色主题设计,主要由以下几个部分组成:

1. 标题栏区域

标题栏位于窗口顶部,包含以下元素:

  • 软件图标和名称:左侧显示 MyPake 图标和名称
  • 功能标签页:包含"打包"、"设置"、"赞助"三个标签页
  • 窗口控制按钮:最小化和关闭按钮
2. 内容区域

根据当前选中的标签页显示不同的功能界面:

  • 打包标签页:文件列表、日志输出、操作按钮
  • 设置标签页:产品信息配置、快捷方式设置、WiX 工具路径
  • 赞助标签页:打赏二维码和联系方式
3. 状态栏

底部显示当前操作状态和提示信息

5. 打包功能操作

打包标签页界面

打包标签页是软件的核心功能区域,界面布局如下:

┌─────────────────────────────────────────────────────────────┐
│ 文件列表 (2 项)                      [📄 添加文件] [📁 添加文件夹] │
├─────────────────────────────────────────────────────────────┤
│ 📄 D:\app\main.exe                → main.exe     [×]        │
│ 📁 D:\app\resources               → resources    [×]        │
├─────────────────────────────────────────────────────────────┤
│ [10:30:15] 准备就绪                                            │
│ [10:30:20] 添加: D:\app\main.exe                              │
│ [10:30:25] 添加: D:\app\resources                            │
├─────────────────────────────────────────────────────────────┤
│ [清空列表]                    [🚀 构建 MSI 安装包]          │
└─────────────────────────────────────────────────────────────┘
                    

操作步骤详解

步骤 1:添加文件

方法一:使用按钮添加

  1. 点击"📄 添加文件"按钮
  2. 在弹出的文件选择对话框中选择一个或多个文件
  3. 点击"打开"按钮完成添加

方法二:使用按钮添加文件夹

  1. 点击"📁 添加文件夹"按钮
  2. 在弹出的文件夹选择对话框中选择目标文件夹
  3. 点击"选择文件夹"按钮完成添加

方法三:拖拽添加

  1. 从文件资源管理器中选择文件或文件夹
  2. 直接拖拽到软件界面的文件列表区域
  3. 松开鼠标完成添加
步骤 2:设置主程序

主程序是安装包的核心可执行文件,用于创建快捷方式。

设置主程序的方法:

  1. 在文件列表中找到 .exe 文件
  2. 点击该文件右侧的"设为主程序"按钮
  3. 成功设置后,该文件会显示绿色背景和"★ 主程序"标记

注意事项:

  • 只有 .exe 文件可以被设置为主程序
  • 同一时间只能有一个主程序
  • 如果未设置主程序,构建时将不会创建快捷方式
步骤 3:配置产品信息

切换到"设置"标签页,配置以下信息:

产品基本信息

  • 产品名称:输入软件的显示名称(如:My Application)
  • 版本号:输入版本号(如:1.0.0)
  • 制造商:输入公司或开发者名称(如:My Company)
  • 安装目录:输入安装时的目标目录名(如:MyApp)
  • 升级代码:自动生成,用于识别同一产品的不同版本

图标设置

  1. 点击"图标文件"右侧的"浏览"按钮
  2. 选择 .ico 格式的图标文件
  3. 点击"打开"完成设置

快捷方式设置

勾选以下选项:

  • ☑ 创建桌面快捷方式:在用户桌面创建快捷方式
  • ☑ 创建开始菜单快捷方式:在开始菜单创建快捷方式
步骤 4:配置 WiX 工具路径

首次使用需要配置 WiX Toolset 路径:

配置步骤:

  1. 点击"WiX 安装路径"右侧的"浏览"按钮
  2. 选择 WiX Toolset 的安装根目录
    • 默认路径:C:\Program Files (x86)\WiX Toolset v3.14\
  3. 点击"选择文件夹"完成配置

验证配置:

软件会自动验证所选目录是否包含以下文件:

  • bin\candle.exe:WiX 编译器
  • bin\light.exe:WiX 链接器

如果验证失败,会提示错误信息。

语言文件配置(可选):

  1. 点击"语言文件"右侧的"浏览"按钮
  2. 选择 WiX UI 语言文件(.wxl 格式)
  3. 默认中文语言文件路径:WiX Toolset v3.14\SDK\wixui\WixUI_zh-CN.wxl
步骤 5:构建 MSI 安装包

构建前的准备工作:

  • 确保已添加至少一个文件
  • 确保已设置产品名称
  • 建议设置主程序以创建快捷方式
  • 确保 WiX Toolset 路径配置正确

开始构建:

  1. 点击"🚀 构建 MSI 安装包"按钮
  2. 按钮变为"⏳ 构建中..."状态
  3. 观察日志区域的实时输出

构建过程日志:

[10:35:00] ========== 开始构建 MSI 安装包 ==========
[10:35:01] ✓ 生成 WiX 源文件完成
[10:35:05] ✓ 编译 WiX 源文件完成
[10:35:12] ✓ 链接 MSI 安装包完成
[10:35:12] ========== ✓ MSI 安装包构建成功 ==========
[10:35:12] 输出路径: C:\Users\用户名\Desktop\My_Application_1.0.0.msi
                    

输出位置:

  • 默认输出位置:用户桌面
  • 文件命名规则:{产品名称}_{版本号}.msi
  • 示例:My_Application_1.0.0.msi
步骤 6:测试安装包
  1. 找到生成的 .msi 文件
  2. 双击运行安装程序
  3. 按照安装向导完成安装
  4. 验证快捷方式是否正确创建
  5. 验证程序是否正常运行

文件管理操作

移除单个文件
  1. 在文件列表中找到要移除的文件
  2. 点击该文件右侧的红色"×"按钮
  3. 文件从列表中移除
清空文件列表
  1. 点击底部的"清空列表"按钮
  2. 所有文件从列表中移除
  3. 日志区域显示"清空文件列表"

注意:清空操作不可撤销,请谨慎操作。

6. 设置功能操作

设置标签页界面

设置标签页分为三个主要区域:

┌─────────────────────────────────────────────────────────────┐
│ ┌─ 产品基本信息 ──────────────────────────────────────────┐ │
│ │ 产品名称: [My Application        ] 版本号: [1.0.0       ] │ │
│ │ 制造商:   [My Company           ] 安装目录: [MyApp      ] │ │
│ │ 升级代码: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}         │ │
│ │ 图标文件: [C:\icons\app.ico         ] [浏览]             │ │
│ └──────────────────────────────────────────────────────────┘ │
│ ┌─ 快捷方式 ───────────────────────────────────────────────┐ │
│ │ ☑ 创建桌面快捷方式    ☑ 创建开始菜单快捷方式              │ │
│ └──────────────────────────────────────────────────────────┘ │
│ ┌─ WiX Toolset 路径 ──────────────────────────────────────┐ │
│ │ WiX 安装路径: [C:\Program Files\WiX Toolset v3.14] [浏览] │ │
│ │ Candle 路径:   [C:\Program Files\...\bin\candle.exe]     │ │
│ │ Light 路径:    [C:\Program Files\...\bin\light.exe]      │ │
│ │ 语言文件:      [C:\Program Files\...\WixUI_zh-CN.wxl][浏览]│ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                    

产品基本信息配置

产品名称
  • 作用:显示在安装程序标题和已安装程序列表中
  • 格式:支持中文、英文和特殊字符
  • 示例:My Application、我的软件
  • 自动保存:输入后自动保存到配置文件
版本号
  • 作用:标识软件版本,用于升级检测
  • 格式:推荐使用语义化版本号(Major.Minor.Patch)
  • 示例:1.0.0、2.3.1、1.0.0-beta
  • 重要性:版本号影响 Product ID 的生成
制造商
  • 作用:显示在安装程序和已安装程序信息中
  • 格式:支持中文、英文和特殊字符
  • 示例:My Company、我的公司
安装目录
  • 作用:指定安装时的目标文件夹名称
  • 格式:不包含路径,仅文件夹名
  • 示例:MyApp、MySoftware
  • 默认路径C:\Program Files\{安装目录}
升级代码
  • 作用:用于识别同一产品的不同版本
  • 格式:自动生成的 GUID
  • 重要性:升级代码必须保持不变,否则会被识别为不同产品
  • 建议:首次设置后不要修改
图标文件
  • 作用:设置安装包的图标
  • 格式:必须是 .ico 格式
  • 建议:使用 256x256 或更高分辨率的图标

快捷方式设置

创建桌面快捷方式
  • 作用:在用户桌面创建主程序的快捷方式
  • 前提:必须先设置主程序
  • 效果:安装完成后桌面会出现快捷方式图标
创建开始菜单快捷方式
  • 作用:在开始菜单创建程序文件夹和快捷方式
  • 前提:必须先设置主程序
  • 效果:安装完成后开始菜单会出现程序入口

WiX Toolset 路径配置

WiX 安装路径
  • 作用:指定 WiX Toolset 的安装根目录
  • 默认路径C:\Program Files (x86)\WiX Toolset v3.14\
  • 验证:软件会自动验证路径是否正确
Candle 路径
  • 作用:WiX 编译器的完整路径
  • 默认{WiX 安装路径}\bin\candle.exe
  • 说明:通常自动检测,无需手动修改
Light 路径
  • 作用:WiX 链接器的完整路径
  • 默认{WiX 安装路径}\bin\light.exe
  • 说明:通常自动检测,无需手动修改
语言文件
  • 作用:指定 WiX UI 的本地化语言文件
  • 格式:.wxl 格式文件
  • 默认中文WixUI_zh-CN.wxl
  • 可选:不设置则使用默认英文界面

7. 常见问题

Q1: 构建失败,提示找不到 WiX 工具怎么办?

A: 请检查 WiX Toolset 是否正确安装,并在设置页面配置正确的 WiX 安装路径。确保路径指向 WiX Toolset 的根目录,而不是 bin 目录。

Q2: 构建的 MSI 安装包无法安装怎么办?

A: 请检查以下项目:

  • 产品名称是否设置
  • 文件列表是否为空
  • WiX 版本是否兼容(推荐 v3.14)
  • 查看日志输出,定位具体错误信息

Q3: 如何修改已生成的安装包?

A: MyPake 生成的 MSI 安装包是最终产品,无法直接修改。如需修改,请重新在 MyPake 中配置并构建新的安装包。

Q4: 安装包安装后没有快捷方式怎么办?

A: 请确保在构建前已正确设置主程序。只有设置了主程序,才会创建桌面和开始菜单快捷方式。

Q5: 如何升级已安装的软件?

A: 保持相同的升级代码(UpgradeCode),并增加版本号。新版本的安装包会自动识别并升级旧版本。

Q6: 支持哪些文件类型?

A: MyPake 支持打包任意类型的文件和文件夹,包括但不限于 .exe、.dll、.config、.json、图片、资源文件等。

Q7: 构建速度很慢怎么办?

A: 构建速度主要取决于文件数量和大小。如果构建速度过慢,可以:

  • 减少不必要的文件
  • 使用 SSD 硬盘
  • 关闭其他占用 CPU 的程序

8. 技术支持

如果您在使用 MyPake 过程中遇到问题,可以通过以下方式获取帮助:

  • 查看日志:软件界面下方的日志区域会显示详细的操作信息
  • 检查配置:确保 WiX Toolset 路径配置正确
  • 参考文档:阅读本操作手册的相应章节
  • 联系开发者:通过软件内的"赞助"标签页获取联系方式

感谢您使用 MyPake!