# Electron 桌面应用手动打包与重命名指南
## 摘要
本文介绍在不使用 Electron Forge 等专用工具的情况下，如何通过预构建二进制文件或 asar 归档手动打包 Electron 应用，并在 macOS、Windows 和 Linux 上完成应用的重命名及 Info.plist 配置修改。
## 通过预构建二进制文件打包
若选择手动方式分发 Electron 应用，首先需要下载 Electron 的预构建二进制文件。将包含应用的文件夹命名为 `app`，并放置在 Electron 资源的对应目录下。
- **macOS**: 将 `app` 文件夹放入 `electron/Electron.app/Contents/Resources/app/`。
- **Windows 和 Linux**: 将 `app` 文件夹放入 `electron/resources/app/`。
放置完成后，在 macOS 上执行 `Electron.app`，Linux 上执行 `electron`，Windows 上执行 `electron.exe`，Electron 便会作为您的应用启动。此时，`electron` 目录即为您分发给用户的安装包。
## 使用 asar 归档打包
为了避免复制所有源文件，您可以将应用打包成 asar 归档，这能提升在 Windows 等平台上读取文件的性能（前提是您未使用 Parcel 或 Webpack 等 bundler）。
使用方法是将归档重命名为 `app.asar`，并放入 Electron 的资源目录中：
- **macOS**: 放入 `electron/Electron.app/Contents/Resources/`
- **Windows**: 放入 `electron/resources/`
Electron 会自动读取该归档并从中启动应用。如需了解更多 asar 用法，可参考 `electron/asar` 仓库。
## 应用重命名与配置修改
打包完成后，通常需要对 Electron 进行重命名（Rebranding）以便分发给用户。
### Windows
- 将 `electron.exe` 重命名为任意名称。
- 使用工具（如 rcedit）修改图标及其他信息。
- 将 `electron_wer.dll` 重命名为与主程序一致（例如 `myapp.exe` 对应 `myapp_wer.dll`），以确保崩溃报告器仍能捕获失败崩溃。
### Linux
- 可直接将 Electron 可执行文件重命名为任意名称。
### macOS
- 将 `Electron.app` 重命名为所需名称。
- 修改以下文件中的配置字段：
- `Electron.app/Contents/Info.plist`
- `Electron.app/Contents/Frameworks/Electron Helper.app/Contents/Info.plist`
- 可重命名 helper 应用以避免在活动监视器中显示 "Electron Helper"，但务必同步修改 helper 应用的执行文件名。
### 重命名后的目录结构示例（macOS）
```
MyApp.app/Contents
├── Info.plist
├── MacOS/
│ └── MyApp
└── Frameworks/
└── MyApp Helper.app
├── Info.plist
└── MacOS/
└── MyApp Helper
```
> 注：也可通过修改产品名并从源码构建来重命名 Electron，需在 `args.gn` 文件中设置 `electron_product_name = "YourProductName"` 并重新编译。但此方法不推荐，因环境配置复杂且耗时。