代码改变世界

WIX 安装部署教程(六) 为你收集的七个知识点

2014-05-28 07:56  stoneniqiu  阅读(5441)  评论(7编辑  收藏

 前段时间整理5篇WIX(Windows Installer XML)的安装教程,但还不够完善,这里继续整理了七个知识点分享给大家。WIX最新版本3.8,点击下载

1.设置路径变量

  有的时候路径过长,文件又比较多,重复粘贴一个地址总是不舒服,而且要改起来也很麻烦,那这个时候就可以用统一的变量了。

  项目右键-->属性-->Build-->Define Preprocessor variables:  直接 vars=address; 分号隔开就可以了。

 

 使用的时候用$(var.yourvars)就可以了

   <!--自定义页面元素-->
    <WixVariable Id="WixUIDialogBmp" Value="$(var.Photoes)bk.jpg"/>
    <WixVariable Id="WixUIBannerBmp" Value="$(var.Photoes)top.jpg"/>

而上图中的Define variables是预先定义Property(在WIX中,Property就是代表变量),

其实元素Directory也是一种Property。也已经为我们定义了目录。可以直接用。

  比如讲你的数据文件安装在C:\ProgramData文件中(对应CommonAppDataFolder)

       <Directory Id="CommonAppDataFolder">
        <Directory Id="MyDATA" Name="DATA">
          <Directory Id="DemoProject" Name="DemoProject" />
        </Directory>
      </Directory>

 

而Culture to build是用于生成不同语言的安装包不同语言分号隔开。

 生成对应版本。

2.注册COM组件

  这个问题困扰我好久,一开始用Action触发bat文件注册,但有个cmd框,有网友提议用QtExecCmdLine静默注册,但没有实现。自己写注册表一个是工作量蛮大,二个是写不对(regedit中一大堆)。最后网友提示File标签支持自己注册。我就呵呵~

 <DirectoryRef Id="IORegedit">
      <Component Id="ForIOSERVER" Guid="{B5F03CF3-BBAE-4C03-BA06-4FE211FF41FD}">
        <File Id="CxDrvOPC.dll"  Source="$(var.Runtime)IORegedit\CxDrvOPC.dll"  SelfRegCost="1" />
        <File Id="CxDrvModbus.dll"  Source="$(var.Runtime)IORegedit\CxDrvModbus.dll"  SelfRegCost="1" />  
</Component>
</DirectoryRef>

SelfRegCost>0就可以自动注册,但文档里面描述的又比较晦涩,注册这个文件所需的Bytes?

 

 3.开机自启动

 安装之后,希望程序开机启动。同C#程序一样,需要将程序注册到SOFTWARE\Microsoft\Windows\CurrentVersion\Run 目录下即可。

     <Component Id="Register">
       <RegistryKey Action="create" Id="AutoStarKey" Root="HKLM" Key="SOFTWARE\Microsoft\Windows\CurrentVersion\Run">
         <RegistryValue Id="autoStarKeyValue" Name="!(loc.AppName)"  KeyPath="yes"  Type="string" Value="[INSTALLFOLDER]HMIRun.exe" /> 
       </RegistryKey> 
      </Component>

如果是C#程序

  private void AutoRun()
        {
            //获取程序执行路径..
            string starupPath = Application.ExecutablePath;
            //表示Window注册表中项级节点,读取 Windows 注册表基项HKEY_LOCAL_MACHINE           
            RegistryKey loca = Registry.LocalMachine;
            RegistryKey run = loca.CreateSubKey(@"SOFTWARE\Microsoft\Windows\CurrentVersion\Run");
            if (run != null) run.SetValue("YourApp", starupPath);//加入注册,参数一为注册节点名称(随意)
        }

这里要说明的是Root="HKLM" 

Type=“String”

4.删除日志文件

  打包程序不处理的话,程序卸载之后可能会留下日志文件和一些数据文件,默认只会卸载安装时的那些文件,新增的文件不会删除。

  这时要用RemoveFile和RemoveFolder两个元素

 <DirectoryRef  Id="History" >
      <Component Id="ForHistory" Guid="5628C681-0345-4BFC-2345-4C4D446401CE" KeyPath="yes">
        <File Source="$(var.DemoProject)History\HistoryDB201402.sdf" />
        <File Source="$(var.DemoProject)History\HistoryDB201403.sdf"/>
        <File Source="$(var.DemoProject)History\HistoryDB201404.sdf"/>
        <RemoveFile Id="removeDb" Name="*.sdf" On="uninstall" Directory="History"/>
        <RemoveFolder Id= "Rdb1"  Directory="History" On= "uninstall"/>
      </Component>
    </DirectoryRef>

 要注意的是,如果History目录上面还有父目录,也需要加入RemoveFolder将父目录清除。

 5.用Orca.exe 查看安装包

 生成的MSI文件,其实就是一个数据库。不同的元素就是不同的表格,我们可以借助Orca.exe来查看,可以用来纠错和直接修改。点击下载

 我们看到Property表,可以看到已经有很多自带的Property,而且数据是可以编辑的。 有的时候就可以直接修改不必再去生成。

 6.版本更新

 WIX定义了三个级别的更新,以版本信息和产品GUID号是否改变来判断。 

 

<Product Id="{092B357C-6028-42CF-BCE0-44B717628935}" Name="!(loc.ProjectName)" Language="1033" Version="1.1.1.0" Manufacturer="yourCompany" UpgradeCode="{BA90B701-DB4C-4FF2-9717-88EBA32060D7}">
....
</Product>

 产品ID改变表示这个版本这次是改动很大,Version的前两位可能都改变了(Windows只检查前三位),而UpgradeCode不能变,变了那真就是表示是另外一个产品了。UpgradeCode 在判断版本的时候的有用。比如直接更新版本和防止版本降级。Upgrade的Id就是上面的UpgradeCode

   <!--新旧版本检查-->
    <Upgrade Id="{BA90B701-DB4C-4FF2-9717-88EBA32060D7}">
      <UpgradeVersion Property="OLD_VERSION_FOUND"  OnlyDetect="no" IgnoreRemoveFailure="yes" MigrateFeatures="yes" Language="1033"
                      Minimum="1.0.0.0" Maximum="2.0.0.0" IncludeMinimum="yes" IncludeMaximum="no" />
      <UpgradeVersion Property="NEWER_VERSION_FOUND" Minimum="2.0.0.0" IncludeMinimum="no" OnlyDetect="yes" Language="1033" />
    </Upgrade>

其实比较麻烦的是Minor Upgrade 和 Small Upgrade。他们的做法一样,相当于给我们的程序打补丁。需要4步

 1.在你的WIX工程中先创建一个Patch.WXS文件。Media的Cabinet表示后面要用到的CBA文件的名称,Id越大越好,要高于你MSI文件中要更新的Media的Id,PatchBaseLine的Id会作为后面的一个引用(遗憾的是,我还没有找到为什么...) 而PatchFamily就比较直白了,更新的版本,对应的ProductCode(Product的Id),里面ComponentRef 表示那些组件发生了变化。其他就不用说明了

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Patch  AllowRemoval="yes" Classification="update" Comments="Patch for Your Software v. 1.1.0.0"
   Description="Updates Software to v. 1.1.0.0"  DisplayName="Your Software Patch 2014-05-22"
  Manufacturer="YourCompany" MoreInfoURL="http://www.xxx.com/" TargetProductName="YourProduct">
    <Media Id="1000" Cabinet="MyPatch.cab">
      <PatchBaseline Id="MyPatch" />
    </Media>
    <PatchFamily Id="MyPatch" Version="1.1.1.0" ProductCode="{092B357C-6028-42CF-BCE0-44B717628935}" Supersede="yes">
      <ComponentRef Id="ForHMIRT"/>
    </PatchFamily>
  </Patch>
</Wix>

不要包括在你的项目,右键从项目中解除。

2.用candle.exe 生成wixobj 文件。

  最好先把Wix目录,添加到你的环境变量。我的电脑右键--属性--高级系统设置--环境变量:编辑Path 分号隔开,加上%Wix%

  

 然后就可以直接调用candle.exe

再用light.exe 生成wixmsp

3.再把你更新版本的pdb文件和当前工程的pdb文件复制到Patch.wxs同一个目录。 调用命令生成wixmst文件,做这些主要是要比较两个版本的差异。当然前提是你现在的工程已经新增了组件或者组件里面已经新增了文件,并生成了一次。

 

 torch.exe -p -xi older.wixpdb newpdb.wixpdb -out Patch.wixmst

4.最后生成一个MSP文件

  同上,调用Pyro.exe. 

pyro.exe Patch.wixmsp -t MyPatch Patch.wixmst -out Patch.msp

 

  生成的MSP文件很小,但安装效果和MSI文件一样。和你更新组件的多少有关系。整个过程有点繁杂,而且不清晰。最简单的办法还是改变版本号和ProductCode 重新发布一个版本。上面用到了很多exe,这些都是wix自带的工具。各自有不同的功能

 

7.用Heat.exe自动生成wxs文件

 我们要打包一个工程,但文件项目非常多,要是一个一个敲xml标签确实有点苦逼,其实WIX已经提供了heat.exe这个神奇来解决这个问题了。在D盘新建一个Runtime文件,随便拖一些文件进去。打开Cmd调用命令

 

View Code

 

 dir表示目录,-out 表示输出  瞬间就生成了HeatFile.Wxs. 但一看,不是我们想要的,GuiD没有生成,Component的Id也不直观。 不急有更强大的命令

  

再看WXS文件,命令中的dr表示建立目录,cg 是建立ComponentGroup -var是创建变量,-gg表示自动生成GUID  -gl表示GUID不带括号,其他命令可以通过heat.exe -?来查看

<?xml version="1.0" encoding="utf-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Fragment>
        <DirectoryRef Id="RunTime">
            <Directory Id="dirD818D8F32371FA9E971748891D2F242F" Name="zh-CHS" />
        </DirectoryRef>
    </Fragment>
    <Fragment>
        <ComponentGroup Id="MyFileGroup">
            <Component Id="cmpFA55E9F45A78DE86628F8BCAF841C59C" Directory="RunTime" Guid="{14872EC8-B1A0-4DC9-84D5-E9F809D82230}">
                <File Id="filA7DF3B9FB3655FA11EA18E662641CEBA" KeyPath="yes" Source="$(var.Dir)\HMIRun.exe.config" />
            </Component>
            <Component Id="cmp3F203958186210FBCF0D3406F15BEA8A" Directory="RunTime" Guid="{0249740B-AF5F-498B-9F5E-E5780DA84412}">
                <File Id="fil55A2858BF646C17534199602D317C722" KeyPath="yes" Source="$(var.Dir)\NLog.config" />
            </Component>
            <Component Id="cmp6E035C559882EEC7EF1A85BECD96EC39" Directory="RunTime" Guid="{E2F60E84-02AB-41ED-A3BF-88C3CEB34DAD}">
                <File Id="fil407F115AC10BEC92A22BDC17267AEC7B" KeyPath="yes" Source="$(var.Dir)\TemplateProject.template" />
            </Component>
            <Component Id="cmp077331F5CBD00FD180CA24C8FFF612A0" Directory="dirD818D8F32371FA9E971748891D2F242F" Guid="{581B54CC-0E55-4374-9CC8-F5D8784A23B6}">
                <File Id="filD5FE549C3B37047CA548D43FDBBFD3A0" KeyPath="yes" Source="$(var.Dir)\zh-CHS\System.Data.SqlServerCe.Entity.resources.dll" />
            </Component>
            <Component Id="cmp857576E8B47F065DAA1F65C9021B5B23" Directory="dirD818D8F32371FA9E971748891D2F242F" Guid="{50B28B73-4648-4582-BF13-D517224C3617}">
                <File Id="filB140B4B368F3FC0584CDDCA845EDC878" KeyPath="yes" Source="$(var.Dir)\zh-CHS\System.Data.SqlServerCe.resources.dll" />
            </Component>
        </ComponentGroup>
    </Fragment>
</Wix>

 这样生成的文件就很漂亮了,可以复制你的工程中去。

今天先到这里,希望对你有帮助~ 

tks!:)