¿Por qué mi instalador de WiX necesita un CreateFolder vacío para actualizar condicionalmente un archivo Xml?

Question

TL; DR: ¿Por qué necesito un elemento vacío<CreateFolder/> en este componente condicional para que funcione?

Estoy armando un sencillo instalador basado en WiX para una aplicación interna. Este instalador necesita desplegar un archivo de configuración estándar (un archivo .NET .config normal) y luego personalizarlo usando propiedades pasadas al msiexec en la línea de comando.

Una de las personalizaciones consiste en crear una configuración de aplicación específica solo si se ha definido la propiedad RUNTIME. Aquí está el componente de WiX para ello:

<Component Id="C.Rbnz.Fsis.CollectionPeriodService.exe.config.runtime" 
      Guid="*"> 
    <Condition> 
     <![CDATA[RUNTIME]]> 
    </Condition> 

    <CreateFolder/> 

    <util:XmlFile Id="X.Runtime.1" 
        Action="createElement" 
        ElementPath="/configuration/appSettings" 
        File="[#F.Rbnz.Fsis.CollectionPeriodService.exe.config]" 
        Name="add" 
        Sequence="2"/> 

    <util:XmlFile Id="X.Runtime.2" 
        File="[#F.Rbnz.Fsis.CollectionPeriodService.exe.config]" 
        ElementPath="/configuration/appSettings/add[\[]not(@key)[\]]" 
        Action="setValue" 
        Name="key" 
        Value="RunTime" 
        Sequence="3"/> 

    <util:XmlFile Id="X.Runtime.3" 
        File="[#F.Rbnz.Fsis.CollectionPeriodService.exe.config]" 
        ElementPath="/configuration/appSettings/add[\[]@key='RunTime'[\]]" 
        Action="setValue" 
        Name="value" 
        Value="[RUNTIME]" 
        Sequence="4"/> 

    </Component> 

Esto funciona igual que yo quiero - si se especifica tiempo de ejecución en la línea de comandos para msiexec, el nuevo elemento se crea; si no, no pasa nada.

¿Por qué tengo que tener el <CreateFolder/> vacío dentro de este componente?

Mientras intentaba hacer que funcionara, encontré "Wix Condition Statement", que mostraba un componente en funcionamiento, pero no explica por qué es necesario <CreateFolder/>.

Extracción <CreateFolder/> me da este error:

ICE18: KeyPath for Component: 'C.Rbnz.Fsis.CollectionPeriodService.exe.config.runtime' is Directory: 'INSTALLDIR'. The Directory/Component pair must be listed in the CreateFolders table.

que es, estoy seguro, muy informativos una vez que sabes lo que significa.

Answer 1

Cada componente tiene una ruta clave; el más común es un archivo. Su componente no tiene un archivo u otra ruta clave, por lo que WiX le da el valor predeterminado de un directorio. A continuación aparece Windows Installer y dice que los componentes con rutas de clave de directorio deben garantizar que se cree el directorio, incluso si algo más lo hace. Es una regla tonta con una solución fácil.

Answer 2

En su lugar, puede usar el parámetro KeyPath = "yes" en su etiqueta de componente. Solo si el 'INSTALLDIR' es la ruta correcta para este componente.