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

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

返回目录索引

参考链接:

示例参考:

Environment简易说明

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

1
<Environment Id='UpdatePath' Name='PATH' Action='set' Permanent='yes' System='yes' Part='last' Value='[INSTALLDIR]' />
  • Action属性指定组件安装时,所执行的操作 —— createsetremove
  • Part属性控制设置新值的方式:all替换之前的值,first在现有值之前添加,last添加到现有值之后;
  • Permanent属性控制产品卸载时,环境变量的处理方式:yes保留环境变量值,no在产品卸载时,同时删除环境变量值;
  • System属性指定环境变量值是系统变量还是用户变量
  • 所有名称使用大写。 —— 经测试,目前小写名称也支持。

Environment元素结构

父级需要是Component

属性列表:

属性 类型 说明 是否必需
Id 字符串 Environment条目的唯一标识
Action 枚举

在安装父级组件时,指定环境变量的操作:createdsetremoved。此属性必须为以下的值:

  • create
    • 安装期间,若不存在此环境变量,则创建;若存在,则不影响已有的值。
  • set
    • 安装期间,若不存在此环境变量,则创建;若存在,则修改为新设置的值。
  • remove
    • 安装期间,移除环境变量。仅当环境变量的name和value均匹配时,才移除。若需要移除环境变量(无论它的值是什么),则不要设置Value属性。
Name 字符串 环境变量的名称
Part 枚举

此属性必须为以下的值:

  • all
    • 替换整个环境变量的值。此值为默认值。
  • first
    • 在现有值之前插入
  • last
    • 在现有值之后附加
Permanent YesNoType 指定在卸载时是否保留环境变量。
Separator 字符串 环境变量Value值的分隔符,默认时分号分隔。
System YesNoType 指定环境变量是否添加到系统环境变量。默认值为`no`,表示环境变量添加到用户变量中。
Value 字符串 待设置到环境变量中的值。若此属性为设置,则在安装过程中移除已存在的同名环境变量。

译:奇葩史