
<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi"
    xmlns:util="http://schemas.microsoft.com/wix/UtilExtension" >

  <Product Id="*" Name="环境变量设置Sample"
          Language="2052" Codepage="936"
          Version="1.0.0.0" Manufacturer="Jess"
          UpgradeCode="{6C0C1D6D-80CF-4074-AC42-5ADBD7E4087F}">
    <Package InstallerVersion="300" Compressed="yes" InstallScope="perMachine" SummaryCodepage="936" />

    <MediaTemplate EmbedCab="yes" />

    <UIRef Id="WixUI_Minimal"/>
    <Property Id="WIXUI_INSTALLDIR" Value="INSTALLLOCATION" />

    <Feature Id="ProductFeature" Title="Wix环境变量设置" Level="1">
      <ComponentGroupRef Id="ProductComponents" />
    </Feature>
  </Product>

  <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFiles64Folder">
        <Directory Id="INSTALLLOCATION" Name="EnvSample">
        </Directory>
      </Directory>
    </Directory>
  </Fragment>

  <Fragment>
    <ComponentGroup Id="ProductComponents" >
      <Component Id="cmpEnvSample" Guid="{63B3AF3B-94BB-4D3D-8D24-A0772CA5CFAA}" Directory="INSTALLLOCATION">
        <CreateFolder />
        <!--系统环境变量Path中添加路径-->
        <Environment Id="EnvSamplePath" Action="set" Part="last" Name="Path" Permanent="no" System="yes" Value="[INSTALLLOCATION]" />
      </Component>
    </ComponentGroup>
  </Fragment>

</Wix>

其核心就一句话：<Environment Id="EnvSamplePath" Action="set" Part="last" Name="Path" Permanent="no" System="yes" Value="[INSTALLLOCATION]" />

控制环境变量设置时机

软件安装过程中，环境变量的设置，可能需要在某一步骤之后，即需要控制Wix安装的Action顺序。
例如环境变量的写入需要在卸载之后，配置如下：


<?define ProductVersion="1.0.0.0" ?>

<Product Id="*" Name="环境变量设置Sample"
        Language="2052" Codepage="936"
        Version="1.0.0.0" Manufacturer="Jess"
        UpgradeCode="{6C0C1D6D-80CF-4074-AC42-5ADBD7E4087F}">
    <Package InstallerVersion="300" Compressed="yes" InstallScope="perMachine" SummaryCodepage="936" />

    <MediaTemplate EmbedCab="yes" />

    <UIRef Id="WixUI_Minimal"/>
    <Property Id="WIXUI_INSTALLDIR" Value="INSTALLLOCATION" />

    <Feature Id="ProductFeature" Title="Wix环境变量设置" Level="1">
        <ComponentGroupRef Id="ProductComponents" />
    </Feature>

    <Upgrade Id="{6C0C1D6D-80CF-4074-AC42-5ADBD7E4087F}">
        <UpgradeVersion OnlyDetect='no' Property='SELFFOUND'
            Minimum='$(var.ProductVersion)' IncludeMinimum='yes'
            Maximum='$(var.ProductVersion)' IncludeMaximum='yes' />
        <UpgradeVersion OnlyDetect='no' Property='PREVIOUSFOUND'
            Minimum='0.0.0.1' IncludeMinimum='yes'
            Maximum='$(var.ProductVersion)' IncludeMaximum='yes' />
        <UpgradeVersion OnlyDetect='no' Property='NEWERFOUND'
            Minimum='$(var.ProductVersion)' IncludeMinimum='yes' />
    </Upgrade>

    <InstallExecuteSequence>
        <RemoveExistingProducts Before='InstallInitialize' />
        <WriteEnvironmentStrings />
    </InstallExecuteSequence>
</Product>

核心就是在InstallExecuteSequence中添加WriteEnvironmentStrings执行步骤，也可以直接设置Sequence属性：<WriteEnvironmentStrings Sequence="1" />

控制环境变量设置条件

在某些情况下，环境变量的设置需要添加条件判断，如通过Bootstrap安装时，外部传入的参数，标记不需要添加环境变量。

以下配置添加了EnableEnv属性控制是否设置环境变量：


<InstallExecuteSequence>
    <WriteEnvironmentStrings>EnableEnv=1</WriteEnvironmentStrings>     
</InstallExecuteSequence>

<Property Id="EnableEnv" Value="1"></Property>

另外，也可以直接设置Suppress属性禁用环境变量设置<WriteEnvironmentStrings Suppress="yes" />。

理：奇葩史

2020-07-18

官方教程

[译]：Wix Toolset基础 —— 环境变量设置

返回目录索引

参考链接：

Environmentally Friendly

Environment Element

示例参考：

Wix Toolset基础 —— 环境变量设置示例

Environment简易说明

安装过程中要添加环境变量，需要在组件中使用Environment标签：

1	<Environment Id='UpdatePath' Name='PATH' Action='set' Permanent='yes' System='yes' Part='last' Value='[INSTALLDIR]' />

Action属性指定组件安装时，所执行的操作 —— create、set、remove；
Part属性控制设置新值的方式：all替换之前的值，first在现有值之前添加，last添加到现有值之后；
Permanent属性控制产品卸载时，环境变量的处理方式：yes保留环境变量值，no在产品卸载时，同时删除环境变量值；
System属性指定环境变量值是系统变量还是用户变量；
~~所有名称使用大写。~~ —— 经测试，目前小写名称也支持。

Environment元素结构

父级需要是Component

属性列表：

属性	类型	说明	是否必需
Id	字符串	Environment条目的唯一标识	是
Action	枚举	在安装父级组件时，指定环境变量的操作：`created`、`set`、`removed`。此属性必须为以下的值： create 安装期间，若不存在此环境变量，则创建；若存在，则不影响已有的值。 set 安装期间，若不存在此环境变量，则创建；若存在，则修改为新设置的值。 remove 安装期间，移除环境变量。仅当环境变量的name和value均匹配时，才移除。若需要移除环境变量（无论它的值是什么），则不要设置Value属性。
Name	字符串	环境变量的名称	是
Part	枚举	此属性必须为以下的值： all 替换整个环境变量的值。此值为默认值。 first 在现有值之前插入 last 在现有值之后附加
Permanent	YesNoType	指定在卸载时是否保留环境变量。
Separator	字符串	环境变量Value值的分隔符，默认时分号分隔。
System	YesNoType	指定环境变量是否添加到系统环境变量。默认值为`no`，表示环境变量添加到用户变量中。
Value	字符串	待设置到环境变量中的值。若此属性为设置，则在安装过程中移除已存在的同名环境变量。