electron-forge-maker-innosetup 0.2.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Electron Forge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,360 @@
+# @electron-forge/maker-innosetup
+
+一个用于 [Electron Forge](https://www.electronforge.io/) 的 Innosetup Maker，支持使用 Innosetup 为 Windows 平台创建安装程序。继承自 `@electron-forge/maker-base`。
+
+## 安装
+
+```bash
+npm install --save-dev @electron-forge/maker-innosetup
+```
+
+## 前置要求
+
+### 选项一：使用内置便携版（推荐）
+
+将 Innosetup 便携版放置在 `vendor/innosetup/` 目录：
+
+```
+vendor/
+└── innosetup/
+    ├── ISCC.exe
+    ├── ISCmplr.dll
+    ├── Default.isl
+    └── Languages/
+```
+
+### 选项二：系统安装
+
+需要在 Windows 系统上安装 [Innosetup](https://jrsoftware.org/isinfo.php)。
+
+## 使用方法
+
+### 导入方式
+
+```typescript
+// 命名导入（推荐）
+import { MakerInnosetup } from "@electron-forge/maker-innosetup";
+
+// 默认导入
+import MakerInnosetup from "@electron-forge/maker-innosetup";
+
+// 导入解析器
+import {
+  MakerInnosetup,
+  InnoScriptParser,
+} from "@electron-forge/maker-innosetup";
+```
+
+### 方式一：在配置文件中使用（推荐）
+
+在 `forge.config.ts` 中：
+
+```typescript
+import type { ForgeConfig } from "@electron-forge/shared-types";
+import MakerInnosetup from "@electron-forge/maker-innosetup";
+
+const config: ForgeConfig = {
+  makers: [
+    new MakerInnosetup(
+      {
+        appName: "MyApp",
+        appPublisher: "My Company",
+        setupIconFile: "./assets/icon.ico",
+        createDesktopIcon: true,
+      },
+      ["win32"]
+    ),
+  ],
+};
+
+export default config;
+```
+
+### 方式二：使用配置对象
+
+在 `forge.config.js` 中：
+
+```javascript
+module.exports = {
+  makers: [
+    {
+      name: "@electron-forge/maker-innosetup",
+      config: {
+        appName: "MyApp",
+        appPublisher: "My Company",
+        setupIconFile: "./assets/icon.ico",
+      },
+    },
+  ],
+};
+```
+
+### 完整配置示例
+
+```typescript
+import type { MakerInnosetupConfig } from "@electron-forge/maker-innosetup";
+
+const config: MakerInnosetupConfig = {
+  // 应用信息
+  appName: "MyApp",
+  appVersion: "1.0.0",
+  appPublisher: "My Company",
+  appId: "{{MyUniqueAppId}}",
+
+  // 文件路径
+  setupIconFile: "./assets/icon.ico",
+  licenseFile: "./LICENSE",
+
+  // 输出配置
+  outputDir: "./out/installers",
+
+  // 快捷方式
+  createDesktopIcon: true,
+  createQuickLaunchIcon: false,
+
+  // Innosetup 编译器路径（可选，会自动查找）
+  innosetupPath: "C:\\Program Files (x86)\\Inno Setup 6\\ISCC.exe",
+
+  // 完整的 Innosetup 配置
+  config: {
+    Setup: {
+      AppName: "MyApp",
+      AppVersion: "1.0.0",
+      AppPublisher: "My Company",
+      AppPublisherURL: "https://mycompany.com",
+      DefaultDirName: "{autopf}\\MyApp",
+      DefaultGroupName: "MyApp",
+      Compression: "lzma2",
+      SolidCompression: true,
+      ArchitecturesAllowed: "x64",
+      ArchitecturesInstallIn64BitMode: "x64",
+      PrivilegesRequired: "admin",
+      WizardStyle: "modern",
+    },
+    Languages: [
+      {
+        Name: "english",
+        MessagesFile: "compiler:Default.isl",
+      },
+      {
+        Name: "chinesesimplified",
+        MessagesFile: "compiler:Languages\\ChineseSimplified.isl",
+      },
+    ],
+    Tasks: [
+      {
+        Name: "desktopicon",
+        Description: "Create a desktop icon",
+        GroupDescription: "Additional icons:",
+      },
+    ],
+    Files: [
+      {
+        Source: "{src}\\*",
+        DestDir: "{app}",
+        Flags: "ignoreversion recursesubdirs createallsubdirs",
+      },
+    ],
+    Icons: [
+      {
+        Name: "{group}\\MyApp",
+        Filename: "{app}\\MyApp.exe",
+      },
+      {
+        Name: "{autodesktop}\\MyApp",
+        Filename: "{app}\\MyApp.exe",
+        Tasks: "desktopicon",
+      },
+    ],
+    Run: [
+      {
+        Filename: "{app}\\MyApp.exe",
+        Description: "Launch MyApp",
+        Flags: "nowait postinstall skipifsilent",
+      },
+    ],
+  },
+};
+```
+
+### 使用自定义 Innosetup 脚本
+
+如果您已有现成的 `.iss` 脚本文件：
+
+#### 方法 1: 直接使用 ISS 文件
+
+```javascript
+{
+  name: '@electron-forge/maker-innosetup',
+  config: {
+    scriptPath: './installer.iss'
+  }
+}
+
+```
+
+#### 方法 2: 解析 ISS 文件为配置
+
+```typescript
+import { MakerInnosetup } from "@electron-forge/maker-innosetup";
+
+// 从 ISS 文件解析配置
+const config = MakerInnosetup.fromIssFile("./installer.iss");
+
+// 或者从 ISS 内容解析
+const issContent = fs.readFileSync("./installer.iss", "utf-8");
+const config2 = MakerInnosetup.fromIssContent(issContent);
+
+// 使用在 forge 配置中
+const forgeConfig: ForgeConfig = {
+  makers: [
+    {
+      name: "@electron-forge/maker-innosetup",
+      config: config, // 使用解析后的配置
+      platforms: ["win32"],
+    },
+  ],
+};
+```
+
+> 📝 **详细文档**: 查看 [iss-parser.md](./docs/iss-parser.md) 了解 ISS 解析器的完整使用方法
+
+> ⚠️ **重要**: 如果你的 ISS 脚本中定义了 `OutputDir`，Maker 会自动解析并在正确的目录中查找安装包。详见 [custom-script-output.md](./docs/custom-script-output.md)
+
+## 配置选项
+
+### MakerInnosetupConfig
+
+| 选项                    | 类型              | 默认值             | 说明                                    |
+| ----------------------- | ----------------- | ------------------ | --------------------------------------- |
+| `config`                | `InnoSetupConfig` | -                  | 完整的 Innosetup 配置对象               |
+| `scriptPath`            | `string`          | -                  | 自定义脚本路径（如果提供则忽略 config） |
+| `innosetupPath`         | `string`          | 自动查找           | Innosetup 编译器路径                    |
+| `outputDir`             | `string`          | `./out/installers` | 输出目录                                |
+| `appName`               | `string`          | -                  | 应用程序名称                            |
+| `appVersion`            | `string`          | -                  | 应用程序版本                            |
+| `appPublisher`          | `string`          | -                  | 应用程序发布者                          |
+| `appId`                 | `string`          | -                  | 应用程序唯一 ID                         |
+| `licenseFile`           | `string`          | -                  | 许可证文件路径                          |
+| `setupIconFile`         | `string`          | -                  | 安装图标文件路径                        |
+| `createDesktopIcon`     | `boolean`         | `false`            | 是否创建桌面图标                        |
+| `createQuickLaunchIcon` | `boolean`         | `false`            | 是否创建快速启动图标                    |
+| `gui`                   | `boolean`         | `false`            | 是否使用 GUI 模式编译                   |
+| `isccOptions`           | `string[]`        | -                  | 额外的 ISCC 命令行参数                  |
+
+### InnoSetupConfig
+
+完整的 Innosetup 配置类型支持，包括以下部分：
+
+- `Setup` - 安装配置
+- `Languages` - 语言支持
+- `Types` - 安装类型
+- `Components` - 组件选项
+- `Tasks` - 任务选项
+- `Files` - 文件安装
+- `Dirs` - 目录创建
+- `Icons` - 快捷方式
+- `Registry` - 注册表项
+- `Run` - 安装后运行
+- `UninstallRun` - 卸载时运行
+- `InstallDelete` - 安装时删除
+- `UninstallDelete` - 卸载时删除
+- `INI` - INI 文件操作
+- `Messages` - 自定义消息
+- `CustomMessages` - 自定义消息
+- `Code` - Pascal Script 代码
+
+所有配置项都有完整的 TypeScript 类型提示和文档。
+
+## 高级用法
+
+### 添加自定义 Pascal 代码
+
+```typescript
+config: {
+  config: {
+    Code: `
+    function InitializeSetup(): Boolean;
+      begin
+        Result := True;
+        // 自定义初始化逻辑
+      end;
+
+      procedure CurStepChanged(CurStep: TSetupStep);
+      begin
+        if CurStep = ssPostInstall then
+      begin
+      // 安装后的自定义操作
+      end;
+    end;
+`;
+  }
+}
+```
+
+### 注册表操作
+
+```typescript
+config: {
+  config: {
+    Registry: [
+      {
+        Root: "HKLM",
+        Subkey: "Software\\MyApp",
+        ValueType: "string",
+        ValueName: "InstallPath",
+        ValueData: "{app}",
+        Flags: "uninsdeletekey",
+      },
+    ];
+  }
+}
+```
+
+### 多语言支持
+
+```typescript
+config: {
+  config: {
+    Languages: [
+      {
+        Name: "english",
+        MessagesFile: "compiler:Default.isl",
+      },
+      {
+        Name: "chinesesimplified",
+        MessagesFile: "compiler:Languages\\ChineseSimplified.isl",
+      },
+      {
+        Name: "japanese",
+        MessagesFile: "compiler:Languages\\Japanese.isl",
+      },
+    ];
+  }
+}
+```
+
+## 环境变量
+
+- `INNOSETUP_PATH` - 指定 Innosetup 编译器路径
+
+## 编译器查找顺序
+
+1. 配置中指定的路径 (`config.innosetupPath`)
+2. 内置便携版 (`vendor/innosetup/ISCC.exe`)
+3. 环境变量 (`INNOSETUP_PATH`)
+4. 系统安装路径：
+   - `C:\Program Files (x86)\Inno Setup 6\ISCC.exe`
+   - `C:\Program Files\Inno Setup 6\ISCC.exe`
+   - `C:\Program Files (x86)\Inno Setup 5\ISCC.exe`
+   - `C:\Program Files\Inno Setup 5\ISCC.exe`
+
+## 许可证
+
+MIT
+
+## 相关链接
+
+- [Electron Forge](https://www.electronforge.io/)
+- [Innosetup 官方文档](https://jrsoftware.org/ishelp/)
+- [Innosetup 下载](https://jrsoftware.org/isdl.php)

package/dist/MakerInnosetup.d.ts

@@ -0,0 +1,63 @@
+import MakerBase, { MakerOptions } from "@electron-forge/maker-base";
+import { ForgePlatform } from "@electron-forge/shared-types";
+import { MakerInnosetupConfig } from "./types";
+/**
+ * Electron Forge Maker for Innosetup
+ */
+export default class MakerInnosetup extends MakerBase<MakerInnosetupConfig> {
+    name: string;
+    defaultPlatforms: ForgePlatform[];
+    private scriptGenerator;
+    constructor(config?: MakerInnosetupConfig, platforms?: ForgePlatform[]);
+    /**
+     * 从 ISS 文件解析配置
+     * @param issFilePath ISS 文件路径
+     * @returns MakerInnosetupConfig 配置对象
+     */
+    static fromIssFile(issFilePath: string): MakerInnosetupConfig;
+    /**
+     * 从 ISS 脚本内容解析配置
+     * @param issContent ISS 脚本内容
+     * @returns MakerInnosetupConfig 配置对象
+     */
+    static fromIssContent(issContent: string): MakerInnosetupConfig;
+    /**
+     * 检查是否支持当前平台
+     */
+    isSupportedOnCurrentPlatform(): boolean;
+    /**
+     * 查找 Innosetup 编译器路径
+     */
+    private findInnosetupCompiler;
+    /**
+     * 根据架构获取架构标识符
+     */
+    private getArchIdentifier;
+    /**
+     * 根据架构获取 ArchitecturesAllowed 配置
+     */
+    private getArchitecturesAllowed;
+    /**
+     * 生成默认配置
+     */
+    private generateDefaultConfig;
+    /**
+     * 合并用户配置和默认配置
+     */
+    private mergeConfig;
+    /**
+     * 添加任务（桌面图标、快速启动等）
+     */
+    private addTasks;
+    /**
+     * 执行 Innosetup 编译
+     */
+    private compileScript;
+    /**
+     * 制作安装包
+     */
+    make(options: MakerOptions): Promise<string[]>;
+}
+export * from "./types";
+export { InnoScriptGenerator } from "./generator";
+export { InnoScriptParser } from "./parser";