WiX4: added WixProject.WixBuildCommandGenerated even. Triggered by #…

…1557

Source/src/WixSharp/Compiler.cs

@@ -193,11 +193,17 @@ static public bool EmitAutoGenFiles
             }
         }
     }
+
     /// <summary>
     /// Delegate for  <see cref="Compiler"/> event <c>WixSourceGenerated</c>
     /// </summary>
     public delegate void XDocumentGeneratedDlgt(XDocument document);
 
+    /// <summary>
+    /// Delegate for  <see cref="WixProject.WixBuildCommandGenerated"/> event.
+    /// </summary>
+    public delegate string WixBuildCommandGeneratedDlgt(string command);
+
     /// <summary>
     /// Delegate for  <see cref="Compiler"/> event <c>WixSourceSaved</c>
     /// </summary>
@@ -708,7 +714,11 @@ static string GenerateWixCommand(WixProject project, string wxsFile)
             if (extraWxsFiles.IsNotEmpty())
                 candleCmdLineParams.Append(extraWxsFiles);
 
-            return candleCmdLineParams.ToString().ExpandEnvVars();
+            var buildCmd = candleCmdLineParams.ToString().ExpandEnvVars();
+
+            buildCmd = project.WixBuildCommandGenerated?.Invoke(buildCmd) ?? buildCmd;
+
+            return buildCmd;
         }
 
         static string Build(Project project, string path, OutputType type)

Source/src/WixSharp/WixProject.cs

@@ -191,6 +191,13 @@ public string Language
         /// </summary>
         public event XDocumentGeneratedDlgt WixSourceGenerated;
 
+        /// <summary>
+        /// Occurs when `wix.exe` build command generated.
+        /// Use this event if you want to modify the command before
+        /// it is executed by `wix.exe`.
+        /// </summary>
+        public WixBuildCommandGeneratedDlgt WixBuildCommandGenerated = x => x;
+
         internal string SetVersionFromIdValue = "";
 
         /// <summary>