一、背景
之前写过的几个WPF小工具,每次发布都需要给它打安装包和升级包,涉及到一些系列繁琐的手工操作,有了Power Automate Desktop,于是便寻思着能不能做成一个自动化的流来使用。

二、创建流任务
创建名为创建WPF程序安装包及升级包的流任务。
三、添加主流程
因为整个步骤比较长,为了更好的设计整个流,我们将这次流拆成几个子流程,然后通过主流程串起来。
3.1 设置WPF项目目录位置SettingProjectDir
1. 显示选择文件夹对话框,弹窗交互选择当前WPF项目所在的文件夹,我们用名为CurrentProjectDir变量来存储它,如果是常用位置,我们还可以设置默认值。

3.2 设置WPF项目存档位置SettingArchiveDir
1. 显示选择文件夹对话框,弹窗交互选择安装包和升级包的存档位置,我们用名为CurrentArchiveDir变量来存储它,如果是常用位置,我们还可以设置默认值。

3.3 设置变量,设置WPF项目起始子项目名称ProjectStartDir
1. 设置变量,变量名ProjectStartDir,用来存储WPF项目的起始子项目名称,方便我们后续找到正确的起始入口。

大家都知道,一般来说我们在一个解决方案中会构建多个子项目,所以我们这里需要知道在CurrentProjectDir中入口子项目是哪个,也就是包括App.xaml的那个项目。
3.4 获取当前程序版本号GetAppVersion
0. 概览

1. 设置变量,变量名StartAssemblyFilePath,拼接出ProjectStartDir的AssemblyInfo.cs文件位置。
%CurrentProjectDir%\%ProjectStartDir%\Properties\AssemblyInfo.cs

这个信息中,存储了程序版本号等基础信息。
2. 从文件读取文本,从StartAssemblyFilePath中读取文本到变量StartAssemblyContents中。

3. 分析文本,从StartAssemblyContents中正则匹配出版本号信息,将结果存储到MatchAssemblyContents变量。

"[0-9.]+"
但是遗憾的是,这里得到的结果是带了双引号的数据,比如: "1.0.0.0"
4. 拆分文本,从MatchAssemblyContents中我们通过拆分文本来提取最终我们要的版本号,通过自定义分隔符的模式,用分隔符"来进行分割,分割结果放在变量SplitAssemblyContents中。

5. 设置变量,从SplitAssemblyContents结果中,提取第二个位置的数据,就是我们要的版本号,将版本号存在变量CurrentAppVersion中。
%SplitAssemblyContents[1]%

这样我们就可以得到我们要的最终数据1.0.0.0
3.5 获取当前环境模式GetEnvMode
0. 概览

1. 设置变量,变量名AppSettingsFilePath,拼接出ProjectStartDir的AppSettings.json文件位置。
%CurrentProjectDir%\%ProjectStartDir%\appsettings.json

这个信息中,存储了程序本地应用配置信息。
2. 从文件读取文本,从AppSettingsFilePath中读取文本到变量AppSettingsContents中。

这里留意AppSettingsContents的内容通常是JSON格式的。
{
"ThirdHostConfig": {
"HostAddress": "http://gateway.xxxxxxx.com",
"CallModel": "GateWay"
}
}
3. 将JSON转换为自定义对象,将AppSettingsContents内容以JSON对象的形式提取出来,存储到变量AppSettingsJsonObj。

4. 设置变量,从AppSettingsJsonObj中提取网关地址,存储为变量CurrentGatewayUrl。
%AppSettingsJsonObj.ThirdHostConfig.HostAddress%

JSON对象的数据,在Power Automate中可以直接用.来逐层获取值,非常方便。
5. 设置变量,变量名为CurrentEnvMode来存储,当前环境模式。
设置一个初始值为UnKnown。
UnKnown

6. Switch-Case,根据CurrentGatewayUrl的特征,来识别对应的CurrentEnvMode值。
以其中一个Case为例,我们选择运算符为包含,把特征值写在要比较的值中,并且可以设置忽略大小写。

最终,通过多个Case的组合我们得到一个完整的提取CurrentEnvMode值的流程。
| 运算符 | 要比较的值 | 结果值 |
|---|---|---|
| 包含 | xxxx-dev |
DevC1 |
| 包含 | gwkbs |
DevC1 |
| 包含 | gxxdev |
Dev |
| 包含 | gwdev |
Dev |
| 包含 | gxxfat |
Fat |
| 包含 | gwfat |
Fat |
| 包含 | gxxuat |
Uat |
| 包含 | gwfat |
Uat |
| 包含 | gatewayxx |
Pro |

3.5 创建WPF安装包CreatePackage
0. 概览

1. 设置变量,变量名VisualStudioEnvDir,设定当前系统安装的Visual Studio版本对应的IDE目录位置
C:\Program Files (x86)\Microsoft Visual Studio\2019\Preview\Common7\IDE

2. 设置变量,变量名InstallerProjectPath, 设定CurrentProjectDir中Visual Studio Installer Project的相对位置。
Setup1\Setup1.vdproj

3. 运行PowerShell脚本,来执行调用devenv.com命令,进行对Visual Studio Installer Project编译,得到安装包,这一步我们命名为BuildInstallProject。
cd '%VisualStudioEnvDir%'
.\devenv.com '%CurrentProjectDir%\%InstallerProjectPath%' /rebuild "Release|Any CPU"

- 我们先切换到
VisualStudioEnvDir这个目录,因为我们需要到当前系统安装的Visual Studio版本对应的IDE目录,去调用devenv.exe; - 这里使用
.\devenv.com,而不是.\devenv.exe; - 随后跟的是指定的
.vdproj文件的完整路径,也就是说指定是对这个Visual Studio Installer Project进行处理; /rebuild是devenv的一个参数,代表先清理后编译生成指定的项目或者解决方案,如果不需要清理,使用/build命令也是可以的;"Release|Any CPU"代表以Release模式进行生成,并且针对的设备平台是Any CPU;
如果顺利的话,最终根据这个命令可以得到.msi的安装包。

上述命令,建议先在终端中验证一下,单独在终端中执行效果如下图:


如果遇到下面这个错误,继续看下面的解决办法。
ERROR: An error occurred while validating. HRESULT = '8000000A'

官方给出了一个快捷的解决办法,只要是Visual Studio 2017+,都可以使用这个方法。

找到当前系统安装的Visual Studio版本对应的DisableOutOfProcBuild目录。
C:\Program Files (x86)\Microsoft Visual Studio\2019\Preview\Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild

在地址栏,输入cmd,以快速进入这个目录的当前终端上下文,然后执行如下命令即可。
DisableOutOfProcBuild.exe

这个执行之后,实际上是它为我们创建或者修改了已存在的一个注册表项,以便解决前面的那个报错。
4. 设置变量,变量名InstallerProductName, 设定安装包产品名称。

5. 设置变量,变量名InstallerPackagePath, 提取最终的.msi安装包路径。
%CurrentProjectDir%\Setup1\Release\%InstallerProductName%.msi

6. 设置变量,变量名InstallerVersionName,拼接出按版本号命名的文件名。
%CurrentEnvMode%-%InstallerProductName%-v%CurrentAppVersion%

最终得到的是比如是:Dev-xxxxx-v1.0.0.0
7. 重命名文件,将InstallerPackagePath文件重命名为InstallerVersionName,得到按版本号命名的新安装包,这个动作我们叫RenamePackageFile

8. 设置变量,变量名InstallerPackageFilePath, 拼接出按版本号命名的新文件名。
%CurrentProjectDir%\Setup1\Release\%InstallerVersionName%.msi

参考
- 使用devenv在命令行中编译项目
- How to build visual studio installer project (.vdproj) from jenkins to generate .exe and .msi files?
- An error occurred while validating. HRESULT = '8000000A'
- Visual Studio Installer 部署
- .Net5 WPF快速入门系列教程
Power Automate Desktop/RPA 爱好者交流群

