electron-forge-maker-innosetup 0.2.9 → 0.3.0

package/README.md

@@ -1,11 +1,11 @@
-# @electron-forge/maker-innosetup
+# 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
+npm install --save-dev electron-forge-maker-innosetup
 ```
 
 ## 前置要求
@@ -33,16 +33,16 @@ vendor/
 
 ```typescript
 // 命名导入（推荐）
-import { MakerInnosetup } from "@electron-forge/maker-innosetup";
+import { MakerInnosetup } from "electron-forge-maker-innosetup";
 
 // 默认导入
-import MakerInnosetup from "@electron-forge/maker-innosetup";
+import MakerInnosetup from "electron-forge-maker-innosetup";
 
 // 导入解析器
 import {
   MakerInnosetup,
   InnoScriptParser,
-} from "@electron-forge/maker-innosetup";
+} from "electron-forge-maker-innosetup";
 ```
 
 ### 方式一：在配置文件中使用（推荐）
@@ -51,7 +51,7 @@ import {
 
 ```typescript
 import type { ForgeConfig } from "@electron-forge/shared-types";
-import MakerInnosetup from "@electron-forge/maker-innosetup";
+import MakerInnosetup from "electron-forge-maker-innosetup";
 
 const config: ForgeConfig = {
   makers: [
@@ -78,7 +78,7 @@ export default config;
 module.exports = {
   makers: [
     {
-      name: "@electron-forge/maker-innosetup",
+      name: "electron-forge-maker-innosetup",
       config: {
         appName: "MyApp",
         appPublisher: "My Company",
@@ -92,7 +92,7 @@ module.exports = {
 ### 完整配置示例
 
 ```typescript
-import type { MakerInnosetupConfig } from "@electron-forge/maker-innosetup";
+import type { MakerInnosetupConfig } from "electron-forge-maker-innosetup";
 
 const config: MakerInnosetupConfig = {
   // 应用信息
@@ -185,7 +185,7 @@ const config: MakerInnosetupConfig = {
 
 ```javascript
 {
-  name: '@electron-forge/maker-innosetup',
+  name: 'electron-forge-maker-innosetup',
   config: {
     scriptPath: './installer.iss'
   }
@@ -196,7 +196,7 @@ const config: MakerInnosetupConfig = {
 #### 方法 2: 解析 ISS 文件为配置
 
 ```typescript
-import { MakerInnosetup } from "@electron-forge/maker-innosetup";
+import { MakerInnosetup } from "electron-forge-maker-innosetup";
 
 // 从 ISS 文件解析配置
 const config = MakerInnosetup.fromIssFile("./installer.iss");
@@ -209,7 +209,7 @@ const config2 = MakerInnosetup.fromIssContent(issContent);
 const forgeConfig: ForgeConfig = {
   makers: [
     {
-      name: "@electron-forge/maker-innosetup",
+      name: "electron-forge-maker-innosetup",
       config: config, // 使用解析后的配置
       platforms: ["win32"],
     },
@@ -268,6 +268,74 @@ const forgeConfig: ForgeConfig = {
 
 ## 高级用法
 
+### 使用预处理器常量 (#define)
+
+使用 `Defines` 字段可以定义预处理器常量，在配置中使用 `{#ConstantName}` 引用：
+
+```typescript
+config: {
+  config: {
+    // 定义预处理器常量
+    Defines: {
+      MyAppName: "Police Self Report",
+      MyAppVersion: "1.0.0",
+      MyAppPublisher: "合肥视尔信息科技有限公司",
+      MyAppExeName: "Police Self Report.exe",
+      MyAppAssocName: "Police Self Report File",
+      MyAppAssocExt: ".myp",
+      MyAppShortcutName: "公安自助接报案系统",
+    },
+    Setup: {
+      // 使用 {#ConstantName} 引用预处理器常量
+      AppName: "{#MyAppName}",
+      AppVersion: "{#MyAppVersion}",
+      AppPublisher: "{#MyAppPublisher}",
+      DefaultDirName: "{autopf}\\{#MyAppName}",
+      OutputBaseFilename: "{#MyAppName}_{#MyAppVersion}",
+      ChangesAssociations: true,
+    },
+    Icons: [
+      {
+        Name: "{group}\\{#MyAppShortcutName}",
+        Filename: "{app}\\{#MyAppExeName}",
+      },
+    ],
+    Registry: [
+      {
+        Root: "HKCR",
+        Subkey: "{#MyAppAssocExt}",
+        ValueType: "string",
+        ValueName: "",
+        ValueData: "{#MyAppAssocName}",
+      },
+    ],
+  },
+}
+```
+
+生成的 ISS 脚本将包含：
+
+```iss
+; Script generated by the Inno Setup Script Wizard.
+; SEE THE DOCUMENTATION FOR DETAILS ON CREATING INNO SETUP SCRIPT FILES!
+
+#define MyAppName "Police Self Report"
+#define MyAppVersion "1.0.0"
+#define MyAppPublisher "合肥视尔信息科技有限公司"
+#define MyAppExeName "Police Self Report.exe"
+
+[Setup]
+AppName={#MyAppName}
+AppVersion={#MyAppVersion}
+AppPublisher={#MyAppPublisher}
+```
+
+**优势：**
+
+- 🔄 更易维护：集中管理常量，修改一处即可
+- 📖 更清晰：生成的 ISS 脚本更具可读性
+- 🔧 更灵活：支持 Inno Setup 原生的预处理器功能
+
 ### 添加自定义 Pascal 代码
 
 ```typescript

package/dist/MakerInnosetup.js

@@ -174,7 +174,7 @@ class MakerInnosetup extends maker_base_1.default {
                 AppName: this.config.appName || appName,
                 AppVersion: this.config.appVersion || appVersion,
                 AppPublisher: this.config.appPublisher || "",
-                AppId: this.config.appId || `{{${appName}}`,
+                AppId: this.config.appId || `{{${appName}}}`,
                 DefaultDirName: `{autopf}\\${appName}`,
                 DefaultGroupName: appName,
                 OutputDir: outputDir,
@@ -234,6 +234,7 @@ class MakerInnosetup extends maker_base_1.default {
             return defaultConfig;
         }
         return {
+            Defines: userConfig.Defines || defaultConfig.Defines,
             Setup: { ...defaultConfig.Setup, ...userConfig.Setup },
             Languages: userConfig.Languages || defaultConfig.Languages,
             Tasks: userConfig.Tasks || defaultConfig.Tasks,
@@ -260,7 +261,12 @@ class MakerInnosetup extends maker_base_1.default {
         if (!config.Tasks) {
             config.Tasks = [];
         }
-        if (this.config.createDesktopIcon !== false) {
+        // 检查用户是否已经自定义了桌面图标任务
+        const hasDesktopTask = config.Tasks.some((task) => task.Name === "desktopicon");
+        const hasDesktopIcon = config.Icons?.some((icon) => icon.Name?.includes("{autodesktop}") && icon.Tasks === "desktopicon");
+        if (this.config.createDesktopIcon !== false &&
+            !hasDesktopTask &&
+            !hasDesktopIcon) {
             config.Tasks.push({
                 Name: "desktopicon",
                 Description: "Create a &desktop icon",
@@ -275,7 +281,12 @@ class MakerInnosetup extends maker_base_1.default {
                 });
             }
         }
-        if (this.config.createQuickLaunchIcon) {
+        // 检查用户是否已经自定义了快速启动任务
+        const hasQuickLaunchTask = config.Tasks.some((task) => task.Name === "quicklaunchicon");
+        const hasQuickLaunchIcon = config.Icons?.some((icon) => icon.Name?.includes("Quick Launch") && icon.Tasks === "quicklaunchicon");
+        if (this.config.createQuickLaunchIcon &&
+            !hasQuickLaunchTask &&
+            !hasQuickLaunchIcon) {
             config.Tasks.push({
                 Name: "quicklaunchicon",
                 Description: "Create a &Quick Launch icon",
@@ -306,6 +317,30 @@ class MakerInnosetup extends maker_base_1.default {
             });
             let output = "";
             let errorOutput = "";
+            let isResolved = false;
+            const timeout = this.config.compileTimeout || 300000;
+            const timeoutHandle = setTimeout(() => {
+                if (!isResolved) {
+                    isResolved = false;
+                    console.error("Innosetup compilation timeout, killing process...");
+                    try {
+                        iscc.kill("SIGKILL");
+                    }
+                    catch (e) {
+                        console.error("Failed to kill process", e);
+                    }
+                    reject(new Error(`Innosetup compilation timeout after ${timeout} ms`));
+                }
+            }, timeout);
+            const cleanup = () => {
+                clearTimeout(timeoutHandle);
+                try {
+                    if (iscc && !iscc.killed) {
+                        iscc.kill("SIGKILL");
+                    }
+                }
+                catch (e) { }
+            };
             iscc.stdout.on("data", (data) => {
                 const text = data.toString();
                 output += text;
@@ -317,16 +352,29 @@ class MakerInnosetup extends maker_base_1.default {
                 console.error(text);
             });
             iscc.on("close", (code) => {
+                if (isResolved)
+                    return;
+                isResolved = true;
+                clearTimeout(timeoutHandle);
                 if (code === 0) {
                     resolve(output);
                 }
                 else {
+                    cleanup();
                     reject(new Error(`Innosetup compilation failed with code ${code}\n${errorOutput}`));
                 }
             });
             iscc.on("error", (err) => {
+                if (isResolved)
+                    return;
+                isResolved = true;
+                cleanup();
                 reject(new Error(`Failed to start Innosetup compiler: ${err.message}`));
             });
+            // 处理进程意外退出
+            process.on("exit", cleanup);
+            process.on("SIGINT", cleanup);
+            process.on("SIGTERM", cleanup);
         });
     }
     /**

package/dist/generator.d.ts

@@ -7,6 +7,10 @@ export declare class InnoScriptGenerator {
      * 生成脚本内容
      */
     generate(config: InnoSetupConfig): string;
+    /**
+     * 生成 #define 指令部分
+     */
+    private generateDefinesSection;
     /**
      * 生成 Setup 部分
      */
@@ -77,6 +81,7 @@ export declare class InnoScriptGenerator {
     private generateCodeSection;
     /**
      * 将脚本保存到文件
+     * 注意：使用 UTF-8 编码保存，并在文件开头添加 BOM 标记
      */
     saveToFile(scriptContent: string, filePath: string): void;
 }

package/dist/generator.js

@@ -45,6 +45,10 @@ class InnoScriptGenerator {
      */
     generate(config) {
         const sections = [];
+        // 生成 #define 指令
+        if (config.Defines && Object.keys(config.Defines).length > 0) {
+            sections.push(this.generateDefinesSection(config.Defines));
+        }
         // 生成 [Setup] 部分
         if (config.Setup) {
             sections.push(this.generateSetupSection(config.Setup));
@@ -114,7 +118,40 @@ class InnoScriptGenerator {
         if (config.Code) {
             sections.push(this.generateCodeSection(config.Code));
         }
-        return sections.join("\n\n");
+        // 添加 UTF-8 BOM 标记，确保 Inno Setup 正确识别中文
+        return "\uFEFF" + sections.join("\n\n");
+    }
+    /**
+     * 生成 #define 指令部分
+     */
+    generateDefinesSection(defines) {
+        const lines = [
+            "; Script generated by the Inno Setup Script Wizard.",
+            "; SEE THE DOCUMENTATION FOR DETAILS ON CREATING INNO SETUP SCRIPT FILES!",
+            "",
+        ];
+        for (const [key, value] of Object.entries(defines)) {
+            if (value !== undefined && value !== null) {
+                const strValue = String(value);
+                // 检查是否是表达式（包含函数调用、引用或拼接）
+                const isExpression = strValue.includes("(") ||
+                    strValue.includes("+") ||
+                    (strValue.match(/^\w+$/) && !strValue.match(/^\d+$/));
+                if (typeof value === "string" && !isExpression) {
+                    // 普通字符串，添加引号
+                    lines.push(`#define ${key} "${value}"`);
+                }
+                else if (typeof value === "string" && isExpression) {
+                    // 表达式，不添加引号
+                    lines.push(`#define ${key} ${value}`);
+                }
+                else {
+                    // 数字等其他类型
+                    lines.push(`#define ${key} ${value}`);
+                }
+            }
+        }
+        return lines.join("\n");
     }
     /**
      * 生成 Setup 部分
@@ -130,7 +167,15 @@ class InnoScriptGenerator {
                     lines.push(`${key}=${value}`);
                 }
                 else {
-                    lines.push(`${key}=${value}`);
+                    // 检查值是否包含 {#...} 引用
+                    const stringValue = String(value);
+                    if (stringValue.includes("{#")) {
+                        // 如果包含常量引用，不添加额外引号
+                        lines.push(`${key}=${stringValue}`);
+                    }
+                    else {
+                        lines.push(`${key}=${stringValue}`);
+                    }
                 }
             }
         }
@@ -366,14 +411,34 @@ class InnoScriptGenerator {
         const lines = ["[Registry]"];
         for (const item of items) {
             const parts = [`Root: ${item.Root}`];
-            parts.push(`Subkey: "${item.Subkey}"`);
+            // Subkey: 检查是否包含 {#...} 引用或函数调用
+            const subkey = String(item.Subkey);
+            if (subkey.includes("{#") || subkey.includes("StringChange(")) {
+                // 如果包含常量引用或函数，不添加引号
+                parts.push(`Subkey: "${subkey}"`);
+            }
+            else {
+                parts.push(`Subkey: "${subkey}"`);
+            }
             if (item.ValueType)
                 parts.push(`ValueType: ${item.ValueType}`);
-            if (item.ValueName !== undefined)
-                parts.push(`ValueName: "${item.ValueName}"`);
+            // ValueName: 检查是否包含引用或函数调用
+            if (item.ValueName !== undefined) {
+                const valueName = String(item.ValueName);
+                if (valueName.includes("{#") || valueName.includes("StringChange(")) {
+                    // 如果包含常量引用或函数，不添加引号
+                    parts.push(`ValueName: "${valueName}"`);
+                }
+                else {
+                    parts.push(`ValueName: "${valueName}"`);
+                }
+            }
             if (item.ValueData !== undefined) {
                 if (typeof item.ValueData === "string") {
-                    parts.push(`ValueData: "${item.ValueData}"`);
+                    const valueData = item.ValueData;
+                    // 直接使用原始值，不需要额外转义
+                    // Inno Setup 中的引号转义应该由用户自己处理
+                    parts.push(`ValueData: "${valueData}"`);
                 }
                 else {
                     parts.push(`ValueData: ${item.ValueData}`);
@@ -483,12 +548,14 @@ class InnoScriptGenerator {
     }
     /**
      * 将脚本保存到文件
+     * 注意：使用 UTF-8 编码保存，并在文件开头添加 BOM 标记
      */
     saveToFile(scriptContent, filePath) {
         const dir = path.dirname(filePath);
         if (!fs.existsSync(dir)) {
             fs.mkdirSync(dir, { recursive: true });
         }
+        // 使用 UTF-8 编码保存，scriptContent 已经包含 BOM
         fs.writeFileSync(filePath, scriptContent, "utf-8");
     }
 }

package/dist/parser.d.ts

@@ -10,8 +10,22 @@ export declare class InnoScriptParser {
     static parseFile(issFilePath: string): InnoSetupConfig;
     /**
      * 解析 ISS 脚本内容
+     * @param content ISS 脚本内容
+     * @param preserveDefineReferences 是否保留 {#...} 引用（不替换为实际值）
      */
-    static parse(content: string): InnoSetupConfig;
+    static parse(content: string, preserveDefineReferences?: boolean): InnoSetupConfig;
+    /**
+     * 保留 #define 的原始表达式
+     */
+    private static preserveDefineExpression;
+    /**
+     * 解析 #define 的值，支持字符串拼接和函数调用
+     */
+    private static parseDefineValue;
+    /**
+     * 替换字符串中的常量引用 {#ConstantName}
+     */
+    private static replaceDefines;
     /**
      * 解析 Setup 段落的一行
      */

package/dist/parser.js

@@ -49,19 +49,51 @@ class InnoScriptParser {
     }
     /**
      * 解析 ISS 脚本内容
+     * @param content ISS 脚本内容
+     * @param preserveDefineReferences 是否保留 {#...} 引用（不替换为实际值）
      */
-    static parse(content) {
+    static parse(content, preserveDefineReferences = true) {
         const config = {};
+        const defines = {};
         const lines = content.split(/\r?\n/);
         let currentSection = null;
         let codeSection = "";
         let inCodeSection = false;
+        // 第一次扫描：提取所有 #define 定义
         for (let i = 0; i < lines.length; i++) {
             let line = lines[i].trim();
             // 跳过空行和注释
             if (!line || line.startsWith(";") || line.startsWith("//")) {
                 continue;
             }
+            // 解析 #define 指令
+            const defineMatch = line.match(/^#define\s+(\w+)\s+(.+)$/);
+            if (defineMatch) {
+                const [, varName, varValue] = defineMatch;
+                // 如果保留引用，则保存原始表达式；否则计算值
+                defines[varName] = preserveDefineReferences
+                    ? this.preserveDefineExpression(varValue)
+                    : this.parseDefineValue(varValue, defines);
+            }
+        }
+        // 如果有 defines，添加到配置中
+        if (Object.keys(defines).length > 0) {
+            config.Defines = defines;
+        }
+        // 第二次扫描：解析配置段落
+        for (let i = 0; i < lines.length; i++) {
+            let line = lines[i].trim();
+            // 跳过空行、注释和 #define 指令
+            if (!line ||
+                line.startsWith(";") ||
+                line.startsWith("//") ||
+                line.startsWith("#define")) {
+                continue;
+            }
+            // 如果不保留引用，则替换常量引用 {#ConstantName}
+            if (!preserveDefineReferences) {
+                line = this.replaceDefines(line, defines);
+            }
             // 检测段落
             const sectionMatch = line.match(/^\[(\w+)\]$/);
             if (sectionMatch) {
@@ -78,7 +110,11 @@ class InnoScriptParser {
             }
             // 如果在 Code 段落中，收集所有代码
             if (inCodeSection) {
-                codeSection += lines[i] + "\n";
+                // 对于 Code 段落，使用原始行（带缩进）
+                const processedLine = preserveDefineReferences
+                    ? lines[i]
+                    : this.replaceDefines(lines[i], defines);
+                codeSection += processedLine + "\n";
                 continue;
             }
             // 解析不同段落
@@ -137,6 +173,83 @@ class InnoScriptParser {
         }
         return config;
     }
+    /**
+     * 保留 #define 的原始表达式
+     */
+    static preserveDefineExpression(value) {
+        value = value.trim();
+        // 移除外层引号（如果有）
+        if (value.startsWith('"') && value.endsWith('"')) {
+            return value.slice(1, -1);
+        }
+        return value;
+    }
+    /**
+     * 解析 #define 的值，支持字符串拼接和函数调用
+     */
+    static parseDefineValue(value, defines) {
+        value = value.trim();
+        // 处理字符串拼接 (e.g., MyAppName + " File")
+        if (value.includes("+")) {
+            const parts = value.split("+").map((p) => p.trim());
+            let result = "";
+            for (const part of parts) {
+                if (part.startsWith('"') && part.endsWith('"')) {
+                    // 直接的字符串字面量
+                    result += part.slice(1, -1);
+                }
+                else if (defines[part]) {
+                    // 引用已定义的常量
+                    result += defines[part];
+                }
+                else {
+                    // 未知引用，保持原样
+                    result += part;
+                }
+            }
+            return result;
+        }
+        // 处理 StringChange 函数 (e.g., StringChange(MyAppAssocName, " ", ""))
+        const stringChangeMatch = value.match(/StringChange\(([^,]+),\s*"([^"]*)",\s*"([^"]*)"\)/);
+        if (stringChangeMatch) {
+            const [, varRef, searchStr, replaceStr] = stringChangeMatch;
+            const varName = varRef.trim();
+            const sourceValue = defines[varName] ? String(defines[varName]) : varName;
+            let result = sourceValue.replace(new RegExp(searchStr, "g"), replaceStr);
+            // 处理后续的拼接，例如 StringChange(...) + ".myp"
+            const fullMatch = value.match(/StringChange\([^)]+\)(.*)$/);
+            if (fullMatch && fullMatch[1]) {
+                const suffix = fullMatch[1].trim();
+                if (suffix.startsWith("+")) {
+                    const suffixPart = suffix.substring(1).trim();
+                    if (suffixPart.startsWith('"') && suffixPart.endsWith('"')) {
+                        result += suffixPart.slice(1, -1);
+                    }
+                    else {
+                        result += suffixPart;
+                    }
+                }
+            }
+            return result;
+        }
+        // 处理常量引用 (e.g., MyAppName)
+        if (defines[value]) {
+            return String(defines[value]);
+        }
+        // 移除外层引号
+        if (value.startsWith('"') && value.endsWith('"')) {
+            return value.slice(1, -1);
+        }
+        return value;
+    }
+    /**
+     * 替换字符串中的常量引用 {#ConstantName}
+     */
+    static replaceDefines(text, defines) {
+        return text.replace(/\{#(\w+)\}/g, (match, varName) => {
+            return defines[varName] !== undefined ? String(defines[varName]) : match;
+        });
+    }
     /**
      * 解析 Setup 段落的一行
      */
@@ -171,7 +284,7 @@ class InnoScriptParser {
      */
     static parseParams(line) {
         const params = {};
-        const parts = line.split(";").map(p => p.trim());
+        const parts = line.split(";").map((p) => p.trim());
         for (const part of parts) {
             const match = part.match(/^(\w+):\s*(.+)$/);
             if (match) {
@@ -253,7 +366,9 @@ class InnoScriptParser {
                 Description: params.Description,
                 Types: params.Types,
                 Flags: params.Flags,
-                ExtraDiskSpaceRequired: params.ExtraDiskSpaceRequired ? parseInt(params.ExtraDiskSpaceRequired) : undefined,
+                ExtraDiskSpaceRequired: params.ExtraDiskSpaceRequired
+                    ? parseInt(params.ExtraDiskSpaceRequired)
+                    : undefined,
             });
         }
     }

package/dist/types.d.ts

@@ -1,10 +1,18 @@
 /**
  * Innosetup 完整的 TypeScript 类型定义
  */
+/**
+ * Defines 部分配置 - 预处理器常量定义
+ */
+export interface InnoSetupDefines {
+    [key: string]: string | number;
+}
 /**
  * Setup 部分配置
  */
 export interface InnoSetupConfig {
+    /** Defines 部分配置 - 预处理器常量定义 */
+    Defines?: InnoSetupDefines;
     /** Setup 部分配置 */
     Setup?: {
         /** 应用程序名称 */
@@ -604,4 +612,6 @@ export interface MakerInnosetupConfig {
     createDesktopIcon?: boolean;
     /** 是否创建快速启动图标 */
     createQuickLaunchIcon?: boolean;
+    /** 编译超时时间（毫秒），默认 5 分钟 */
+    compileTimeout?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-forge-maker-innosetup",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "An Electron Forge maker for creating Windows installers using Innosetup with full TypeScript support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",