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

标签: WiX Toolset

博客分类: 官方教程

返回目录索引

参考链接:

示例参考:

Environment简易说明

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

<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 枚举 在安装父级组件时,指定环境变量的操作:`created`、`set`、`removed`。此属性必须为以下的值: * *create* * 安装期间,若不存在此环境变量,则创建;若存在,则不影响已有的值。 * *set* * 安装期间,若不存在此环境变量,则创建;若存在,则修改为新设置的值。 * *remove* * 安装期间,移除环境变量。仅当环境变量的name和value均匹配时,才移除。若需要移除环境变量(无论它的值是什么),则不要设置Value属性。
Name 字符串 环境变量的名称
Part 枚举 此属性必须为以下的值: * *all* * 替换整个环境变量的值。此值为默认值。 * *first* * 在现有值之前插入 * *last* * 在现有值之后附加
Permanent YesNoType 指定在卸载时是否保留环境变量。
Separator 字符串 环境变量Value值的分隔符,默认时分号分隔。
System YesNoType 指定环境变量是否添加到系统环境变量。默认值为`no`,表示环境变量添加到用户变量中。
Value 字符串 待设置到环境变量中的值。若此属性为设置,则在安装过程中移除已存在的同名环境变量。

译:奇葩史