Release v1.6.4.0

-----

v1.6.4.0
* Implemented localization of the Feature's description text (ManagedUI)
* AutoEllipsis enabled for long Feature's label text
* Issue #337: How to set ManagedAction execute before Appsearch
  Added `SetupEventArgs.ManagedUI.Shell.CustomErrorDescription`
* Add dual signing of binaries.
* Issue #333: FeaturesDialog drawing issues
* Added sample for "Issuae #324: Capture Msi error in bootraper"
* Added support for bootstrapper generic items (`Bundle.Items`): Triggered by #315
* Issue #270: Deduplication of files added with wildcards sample dedup
* Added additional resolution algorithm for FileShortcut location, which now can be both dir id and dir path. Triggered by #307
* Issue #307: Fileshortcuts starting with an integer; Removed '_' inserted by the 'start digit in the name' check for composite Dir Ids (e.g. ProgramMenuFolder.1My_Product);
* Issue #180: Multiple root level directories. Added `InstallDir` class
* Added `FileShortcut` constructor that does nor require 'location' parameter. It automatically creates the shortcut in the parent `Dir`.  Triggered by #307.
* Package WixSharp.bin: added copying nbsbuilder.exe to output folder
* NuGet package(s): Added <references> section to register only managed dlls.
  WixSharp.bin.targets file is added to copy unmanaged dll to the output folder.
* Implementation XmlFile Element
* Issue #304: Localization bootstrapper via theme file
* Added optional generation of the XML id attribute for `Bootstrapper.Payload.Id`
* Issue #303: ExternalTool method ConsoleRun(Action<string> onConsoleOut) pass invalid unicode strings to onConsoleOut
* Added `ExternalTool,Encoding`. The default value is `Encoding.UTF8`.

Source/src/WixSharp.Samples/WixSharp.xml

@@ -2061,6 +2061,21 @@
             </summary>
             <seealso cref="T:WixSharp.WixEntity" />
         </member>
+        <member name="P:WixSharp.Bootstrapper.Payload.Id">
+            <summary>
+            Gets or sets the <c>Id</c> value of the <see cref="T:WixSharp.WixEntity" />.
+            <para>This value is used as a <c>Id</c> for the corresponding WiX XML element.</para><para>If the <see cref="P:WixSharp.Bootstrapper.Payload.Id" /> value is not specified explicitly by the user the Wix# compiler
+            generates it automatically insuring its uniqueness.</para><remarks>
+            Note: The ID auto-generation is triggered on the first access (evaluation) and in order to make the id
+            allocation deterministic the compiler resets ID generator just before the build starts. However if you
+            accessing any auto-id before the Build*() is called you can it interferes with the ID auto generation and eventually
+            lead to the WiX ID duplications. To prevent this from happening either:"
+            <para> - Avoid evaluating the auto-generated IDs values before the call to Build*()</para><para> - Set the IDs (to be evaluated) explicitly</para><para> - Prevent resetting auto-ID generator by setting WixEntity.DoNotResetIdGenerator to true";</para></remarks>
+            </summary>
+            <value>
+            The id.
+            </value>
+        </member>
         <member name="M:WixSharp.Bootstrapper.Payload.#ctor">
             <summary>
             Initializes a new instance of the <see cref="T:WixSharp.Bootstrapper.Payload"/> class.
@@ -10263,6 +10278,15 @@
               <c>true</c> if error was detected; otherwise, <c>false</c>.
             </value>
         </member>
+        <member name="P:WixSharp.IManagedUIShell.CustomErrorDescription">
+            <summary>
+            Gets or sets the custom error description to be displayed in the ExitDialog
+            in case of <see cref="P:WixSharp.IManagedUIShell.ErrorDetected"/> being set to <c>true</c>.
+            </summary>
+            <value>
+            The custom error description.
+            </value>
+        </member>
         <member name="P:WixSharp.IManagedUIShell.Dialogs">
             <summary>
             Gets the sequence of the UI dialogs specific for the current setup type (e.g. install vs. modify).
@@ -11320,6 +11344,27 @@
             </summary>
             <param name="value">The value of the WiX condition expression.</param>
         </member>
+        <member name="M:WixSharp.Condition.#ctor(System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:WixSharp.Condition"/> class.
+            </summary>
+            <param name="name">The name.</param>
+            <param name="expectedValue">The expected value.</param>
+        </member>
+        <member name="M:WixSharp.Condition.#ctor(System.String,System.Boolean)">
+            <summary>
+            Initializes a new instance of the <see cref="T:WixSharp.Condition"/> class.
+            </summary>
+            <param name="name">The name.</param>
+            <param name="expectedValue">if set to <c>true</c> [expected value].</param>
+        </member>
+        <member name="M:WixSharp.Condition.#ctor(System.String,System.Int32)">
+            <summary>
+            Initializes a new instance of the <see cref="T:WixSharp.Condition"/> class.
+            </summary>
+            <param name="name">The name.</param>
+            <param name="expectedValue">The expected value.</param>
+        </member>
         <member name="M:WixSharp.Condition.ToString">
             <summary>
              Returns the WiX <c>Condition</c> as a string.

Source/src/WixSharp.UI/ManagedUI/UIShell.cs

@@ -101,6 +101,15 @@ public partial class UIShell : IUIContainer, IManagedUIShell
         /// </value>
         public bool ErrorDetected { get; set; }
 
+        /// <summary>
+        /// Gets or sets the custom error description to be displayed in the ExitDialog
+        /// in case of <see cref="P:WixSharp.IManagedUIShell.ErrorDetected" /> being set to <c>true</c>.
+        /// </summary>
+        /// <value>
+        /// The custom error description.
+        /// </value>
+        public string CustomErrorDescription { get; set; }
+
         /// <summary>
         /// Gets the MSI installation errors.
         /// </summary>

Source/src/WixSharp/Bootstrapper/BootstrapperApplication.cs

@@ -268,6 +268,19 @@ public virtual void AutoGenerateSources(string outDir)
     /// <seealso cref="WixSharp.WixEntity" />
     public class Payload : WixEntity
     {
+        /// <summary>
+        /// Gets or sets the <c>Id</c> value of the <see cref="WixEntity" />.
+        /// <para>This value is used as a <c>Id</c> for the corresponding WiX XML element.</para><para>If the <see cref="Id" /> value is not specified explicitly by the user the Wix# compiler
+        /// generates it automatically insuring its uniqueness.</para><remarks>
+        /// Note: The ID auto-generation is triggered on the first access (evaluation) and in order to make the id
+        /// allocation deterministic the compiler resets ID generator just before the build starts. However if you
+        /// accessing any auto-id before the Build*() is called you can it interferes with the ID auto generation and eventually
+        /// lead to the WiX ID duplications. To prevent this from happening either:"
+        /// <para> - Avoid evaluating the auto-generated IDs values before the call to Build*()</para><para> - Set the IDs (to be evaluated) explicitly</para><para> - Prevent resetting auto-ID generator by setting WixEntity.DoNotResetIdGenerator to true";</para></remarks>
+        /// </summary>
+        /// <value>
+        /// The id.
+        /// </value>
         [Xml]
         public new string Id
         {

Source/src/WixSharp/Condition.cs

@@ -75,16 +75,31 @@ public Condition(string value)
             Value = value;
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="Condition"/> class.
+        /// </summary>
+        /// <param name="name">The name.</param>
+        /// <param name="expectedValue">The expected value.</param>
         public Condition(string name, string expectedValue)
         {
             Value = $"{name}=\"{expectedValue}\"";
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="Condition"/> class.
+        /// </summary>
+        /// <param name="name">The name.</param>
+        /// <param name="expectedValue">if set to <c>true</c> [expected value].</param>
         public Condition(string name, bool expectedValue)
         {
             Value = $"{name}=\"{expectedValue.ToYesNo()}\"";
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="Condition"/> class.
+        /// </summary>
+        /// <param name="name">The name.</param>
+        /// <param name="expectedValue">The expected value.</param>
         public Condition(string name, int expectedValue)
         {
             Value = $"{name}=\"{expectedValue}\"";

Source/src/WixSharp/Properties/AssemblyInfo.version.cs

@@ -7,5 +7,5 @@
 //      Build Number
 //      Revision
 //
-[assembly: AssemblyVersion("1.6.3.2")]
-[assembly: AssemblyFileVersion("1.6.3.2")]
+[assembly: AssemblyVersion("1.6.4.0")]
+[assembly: AssemblyFileVersion("1.6.4.0")]