logo
搜索
我的图书馆

发文章

发文工具

其他工具

留言交流
搜索
分享

Wix 安装部署教程（四） 添加安装文件及快捷方式

 兰亭文艺 2023-04-20 发布于加拿大

      通过之前三篇的介绍，大家对wix的xml部署方式也应该有一些认识，今天天气不错，再来一发。主要介绍桌面，开始菜单，卸载等功能的如何添加。希望园友们支持！

一、如何添加文件

     Demo打包程序很简单，就一个exe，但实际过程中，往往还要引用一些dll，配置文件。我们如何安装到目标文件下呢。这个就比windows installer 麻烦些了，在windows installer中直接一个添加引用就可以了。 但wix也不麻烦，首先要明白各个元素的作用，Directory定义了安装目录，ComponentGroup和DirectoryRef包含的Component和File 定义文件的正真的路径。然后Feature 就是一个安装清单，告诉wix需要安装的文件是哪些。 我们试着在安装目录下增加一个文件，放入一个dll和一个xml文件。

    1.先在wix工程中新建一个文件夹，把我们需要打包的文件copy进来。

    2.再修改目标文件夹。在Setup07下面加入一个Id='Demo'的Directory

复制代码
  <Fragment>
    <Directory Id='TARGETDIR' Name='SourceDir'>
      <Directory Id='ProgramFilesFolder'>
        <Directory Id='INSTALLFOLDER' Name='Setup07' >
          <Directory Id='Demo' Name='Demo' />
        </Directory>
      </Directory>
    </Directory>
  </Fragment>
复制代码

   3.定义需要添加的文件的位置。在Framment 元素块。添加一个DriectoryRef 元素，id指向Demo，

复制代码
  <Fragment>
    <ComponentGroup Id='ProductComponents' Directory='INSTALLFOLDER'>
      <Component Id='ProductComponent'>
        <File Id='myapplication.exe'  Source='$(var.MyApplication.TargetPath)' />
      </Component>
    </ComponentGroup>
   <DirectoryRef Id='Demo'>
     <Component Id='Variable.xml' Guid='5E254682-DD5F-453D-8333-844457282026'>
      <File Id='Variable.xml'  Source='content/Variable.xml' />
      <File Id='mydll'  Source='content/CxIODrvWrapper.dll' />
      </Component>
   </DirectoryRef>
  </Fragment>
复制代码

   如果想保持文件，在卸载的时候不被删除，用Permanent

   <Component Id='keepfile'  Guid='{031FD8D4-CCD9-446B-B876-F20816DFAB39}' Permanent='yes' >  
<File Source='$(var.Dev)IOServer\msvcr110d.dll' Id='msvcr110d'  />
      </Component>

我们可以看见，对于ComponentGroup直接用的是Dirctory属性INSTALLFOLDER指向上个Fragment中的Directory。他其中的file都可以安装在Setup07文件夹下。而我们的DirectoryRef 的Id指向我们创建的Demo文件夹，这里要说明的是Component 安装组件的意思，是必须和feature元素对应起来的，且其中可以包含多个File。然后修改我们的Feature元素。添加一段。关于Guid，直接在VS -工具-创建GUID 再copy出来就行。 不用每次都那么生成，把生产的随便改几个数字也行。

  <ComponentRef Id='Variable.xml'/>

 这个ComponentRef就直接对应了id为Variable.xml的Component的元素，告诉wix 需要安装一个这样的组件。 这样在生成就可以安装了。在你的C:\Program Files (x86)\Setup07\Demo 目录下就可以看见dll和xml文件了。 

  上面的ComponentGroup也可以改掉。 效果一样。

复制代码
<Fragment>
    <!--<ComponentGroup Id='ProductComponents' Directory='INSTALLFOLDER'>
      <Component Id='ProductComponent'>
        <File Id='myapplication.exe'  Source='$(var.MyApplication.TargetPath)' />
      </Component>
    </ComponentGroup>-->
    <DirectoryRef Id='INSTALLFOLDER'>
      <Component Id='myapplication.exe' Guid='5E254682-DD5F-453D-8323-844457212026'>
        <File Id='myapplication.exe'  Source='$(var.MyApplication.TargetPath)' />
      </Component>
  </DirectoryRef>  
    <DirectoryRef Id='Demo'>
     <Component Id='Variable.xml' Guid='5E254682-DD5F-453D-8333-844457282026'>
      <File Id='Variable.xml'  Source='content/Variable.xml' />
      <File Id='mydll'  Source='content/CxIODrvWrapper.dll' />
      </Component>
   </DirectoryRef>
  </Fragment>
.......
 <Feature Id='ProductFeature' Title='Setup07' Level='1'>
      <!--<ComponentGroupRef Id='ProductComponents' />-->
      <ComponentRef Id='Variable.xml'/>
      <ComponentRef Id='myapplication.exe'/>
    </Feature>
View Code
复制代码

二、增加菜单栏快捷方式

   我们先在菜单栏中加入快捷方式

   1.在安装目录Fragment元素中，添加一个Directory。记住这个要插入在<Directory Id='TARGETDIR' Name='SourceDir'> 下面。

<Directory Id='ProgramMenuFolder'>
        <Directory Id='ApplicationProgramsFolder' Name='WixSetUp'/>
 </Directory>

  这里的ProgramMenuFolder就是只的windows的开始菜单，第二级的directory就是要在菜单中显示的文件，名称为wixsetup。

   2.接下我们再这个目录下加入快捷方式，需要用DirectoryRef元素了。Shortcut 就是生成快捷方式的元素。

复制代码
 <DirectoryRef Id='ApplicationProgramsFolder'>
      <Component Id='ApplicationShortcut' Guid='5A254682-DD5F-453D-8333-144457282026'>
        <Shortcut Id='ApplicationStartMenuShortcut'
                  Name='Mysetup'
                  Description='my first application installed by wix'
                  Target='[INSTALLFOLDER]MyApplication.exe'
                  WorkingDirectory='INSTALLFOLDER'/>
        <RemoveFolder Id='ApplicationProgramsFolder' On='uninstall'/>
        <RegistryValue Root='HKCU' Key='Software\Microsoft\MyApplicationName' Name='installed' Type='integer' Value='1' KeyPath='yes'/>
      </Component>
    </DirectoryRef>
复制代码

  需要说明的是，Target的写法，指向我们安装目录下的exe，中括号中加入directory的Id，再紧跟应用程序的名字。 这里的RemoveFolder和Registry元素，官方文档说是为了避免出现ICE 验证错误才结合Shortcut一起出现，我也有点晕，只能先加上了。感兴趣的可以看下这里的http://msdn.microsoft.com/en-us/library/aa368942.aspx 对这种验证的解释。vs生成出错，都是ice开头的。

最后我们在feature中加入Component的列表。

 <ComponentRef Id='ApplicationShortcut' />

  在编译生成，安装完成后，我们的菜单栏中就会出现WixSetup/Mysetup的目录。打开可以运行，但这个时候快捷方式的图标还没有改变，先记住这个问题，再继续往下走。

 最近发现一个奇怪的问题，需要做成快捷方式的exe，他们的id必须和文件一直，否则这个快捷方式在安装之后找不到这个exe。

复制代码
   <Shortcut Id='DesktopShortcut' Directory='DesktopFolder'   Name='Runtime ' Target='[dirE77F08C3A4BE230B19F4D6C90A249E4F]HMIRun.exe' 
                  WorkingDirectory='dirE77F08C3A4BE230B19F4D6C90A249E4F' Icon='Startshorcut' />
  <Shortcut Id='DesktopShortcut2' Directory='DesktopFolder'   Name='SACADDev' Target='[INSTALLFOLDER]SCADAFramework.exe'
              WorkingDirectory='INSTALLFOLDER' Icon='devshorcut' />
复制代码
....
<File Source='$(var.Dev)HMIRun\HMIRun.exe' Id='HMIRun.exe' />

 而如果换成加密的那种id，却找不到。

 此时的全代码如下

复制代码
<?xml version='1.0' encoding='UTF-8'?>
<Wix xmlns='http://schemas.microsoft.com/wix/2006/wi'>
  <Product Id='*' Name='!(loc.ApplicationName)'
 Language='1033' Version='1.0.0.0' Manufacturer='RJStone' UpgradeCode='3486eddf-0957-45cf-8c26-3de8bceca2b4'>
    <Package InstallerVersion='200' Compressed='yes' InstallScope='perMachine' />

    <MajorUpgrade DowngradeErrorMessage='A newer version of [ProductName] is already installed.' />
    <MediaTemplate />

    <!--安装列表-->
    <Feature Id='ProductFeature' Title='Setup07' Level='1'>
      <!--<ComponentGroupRef Id='ProductComponents' />-->
      <ComponentRef Id='Variable.xml'/>
      <ComponentRef Id='myapplication.exe'/>
      <ComponentRef Id='ApplicationShortcut' />

    </Feature>

    <!--自定义安装界面-->
    <WixVariable Id='WixUILicenseRtf' Value='lisences.rtf' />
    <WixVariable Id='WixUIDialogBmp' Value='bb.jpg'/>
    <WixVariable Id='WixUIBannerBmp' Value='top.jpg'/>

    <!--安装完成后启动程序-->
    <Property Id='WIXUI_EXITDIALOGOPTIONALTEXT' Value='Thank you for installing this product.' />
    <Property Id='WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT' Value='Launch this Application ' />
    <Property Id='WixShellExecTarget' Value='[#myapplication.exe]' />
    <CustomAction Id='LaunchApplication' BinaryKey='WixCA' DllEntry='WixShellExec' Impersonate='yes' />

    <!--UI风格-->
    <UI Id='WixUI_Mondo'>
      <TextStyle Id='WixUI_Font_Normal' FaceName='Tahoma' Size='8' />
      <TextStyle Id='WixUI_Font_Bigger' FaceName='Tahoma' Size='12' />
      <TextStyle Id='WixUI_Font_Title' FaceName='Tahoma' Size='9' Bold='yes' />

      <Property Id='DefaultUIFont' Value='WixUI_Font_Normal' />
      <Property Id='WixUI_Mode' Value='Mondo' />
      <DialogRef Id='ErrorDlg' />
      <DialogRef Id='FatalError' />
      <DialogRef Id='FilesInUse' />
      <DialogRef Id='MsiRMFilesInUse' />
      <DialogRef Id='PrepareDlg' />
      <DialogRef Id='ProgressDlg' />
      <DialogRef Id='ResumeDlg' />
      <DialogRef Id='UserExit' />

      <Publish Dialog='ExitDialog' Control='Finish' Event='EndDialog' Value='Return' Order='999'>1</Publish>

      <Publish Dialog='WelcomeDlg' Control='Next' Event='NewDialog' Value='SpecialDlg'>NOT Installed AND NOT PATCH</Publish>
      <Publish Dialog='WelcomeDlg' Control='Next' Event='NewDialog' Value='VerifyReadyDlg'>Installed AND PATCH</Publish>

      <Publish Dialog='SpecialDlg' Control='Back' Event='NewDialog' Value='WelcomeDlg'>1</Publish>
      <Publish Dialog='SpecialDlg' Control='Next' Event='NewDialog' Value='LicenseAgreementDlg'>1</Publish>


      <Publish Dialog='LicenseAgreementDlg' Control='Back' Event='NewDialog' Value='SpecialDlg'>1</Publish>
      <Publish Dialog='LicenseAgreementDlg' Control='Next' Event='NewDialog' Value='SetupTypeDlg' Order='2'>LicenseAccepted = '1'</Publish>

      <Publish Dialog='SetupTypeDlg' Control='Back' Event='NewDialog' Value='LicenseAgreementDlg'>1</Publish>
      <Publish Dialog='SetupTypeDlg' Control='TypicalButton' Event='NewDialog' Value='VerifyReadyDlg'>1</Publish>
      <Publish Dialog='SetupTypeDlg' Control='CustomButton' Event='NewDialog' Value='CustomizeDlg'>1</Publish>
      <Publish Dialog='SetupTypeDlg' Control='CompleteButton' Event='NewDialog' Value='VerifyReadyDlg'>1</Publish>

      <Publish Dialog='CustomizeDlg' Control='Back' Event='NewDialog' Value='MaintenanceTypeDlg' Order='1'>WixUI_InstallMode = 'Change'</Publish>
      <Publish Dialog='CustomizeDlg' Control='Back' Event='NewDialog' Value='SetupTypeDlg' Order='2'>WixUI_InstallMode = 'InstallCustom'</Publish>
      <Publish Dialog='CustomizeDlg' Control='Next' Event='NewDialog' Value='VerifyReadyDlg'>1</Publish>

      <Publish Dialog='VerifyReadyDlg' Control='Back' Event='NewDialog' Value='CustomizeDlg' Order='1'>WixUI_InstallMode = 'InstallCustom'</Publish>
      <Publish Dialog='VerifyReadyDlg' Control='Back' Event='NewDialog' Value='SetupTypeDlg' Order='2'>WixUI_InstallMode = 'InstallTypical' OR WixUI_InstallMode = 'InstallComplete'</Publish>
      <Publish Dialog='VerifyReadyDlg' Control='Back' Event='NewDialog' Value='CustomizeDlg' Order='3'>WixUI_InstallMode = 'Change'</Publish>
      <Publish Dialog='VerifyReadyDlg' Control='Back' Event='NewDialog' Value='MaintenanceTypeDlg' Order='4'>WixUI_InstallMode = 'Repair' OR WixUI_InstallMode = 'Remove'</Publish>
      <Publish Dialog='VerifyReadyDlg' Control='Back' Event='NewDialog' Value='WelcomeDlg' Order='2'>WixUI_InstallMode = 'Update'</Publish>

      <Publish Dialog='MaintenanceWelcomeDlg' Control='Next' Event='NewDialog' Value='MaintenanceTypeDlg'>1</Publish>

      <Publish Dialog='MaintenanceTypeDlg' Control='ChangeButton' Event='NewDialog' Value='CustomizeDlg'>1</Publish>
      <Publish Dialog='MaintenanceTypeDlg' Control='RepairButton' Event='NewDialog' Value='VerifyReadyDlg'>1</Publish>
      <Publish Dialog='MaintenanceTypeDlg' Control='RemoveButton' Event='NewDialog' Value='VerifyReadyDlg'>1</Publish>
      <Publish Dialog='MaintenanceTypeDlg' Control='Back' Event='NewDialog' Value='MaintenanceWelcomeDlg'>1</Publish>

      <Publish Dialog='ExitDialog'
       Control='Finish'
       Event='DoAction'
       Value='LaunchApplication'>WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 and NOT Installed</Publish>
    </UI>
    <UIRef Id='WixUI_Common' />

  </Product>


  <!--目标安装目录-->
  <Fragment>
    <Directory Id='TARGETDIR' Name='SourceDir'>
      <Directory Id='ProgramFilesFolder'>
        <Directory Id='INSTALLFOLDER' Name='Setup07' >
          <Directory Id='Demo' Name='Demo' />
        </Directory>
      </Directory>

      <Directory Id='ProgramMenuFolder'>
        <Directory Id='ApplicationProgramsFolder' Name='WixSetUp'/>
      </Directory>
    </Directory>
  </Fragment>

  <!--安装文件目录-->
  <Fragment>
    <!--<ComponentGroup Id='ProductComponents' Directory='INSTALLFOLDER'>
      <Component Id='ProductComponent'>
        <File Id='myapplication.exe'  Source='$(var.MyApplication.TargetPath)' />
      </Component>
    </ComponentGroup>-->
    <DirectoryRef Id='INSTALLFOLDER'>
      <Component Id='myapplication.exe' Guid='5E254682-DD5F-453D-8323-844457212026'>
        <File Id='myapplication.exe'  Source='$(var.MyApplication.TargetPath)' />
      </Component>
    </DirectoryRef>
    <DirectoryRef Id='Demo'>
      <Component Id='Variable.xml' Guid='5E254682-DD5F-453D-8333-844457282026'>
        <File Id='Variable.xml'  Source='content/Variable.xml' />
        <File Id='mydll'  Source='content/CxIODrvWrapper.dll' />
      </Component>
    </DirectoryRef>

    <DirectoryRef Id='ApplicationProgramsFolder'>
      <Component Id='ApplicationShortcut' Guid='5A254682-DD5F-453D-8333-144457282026'>
        <Shortcut Id='ApplicationStartMenuShortcut'
                  Name='Mysetup'
                  Description='my first application installed by wix'
                  Target='[INSTALLFOLDER]MyApplication.exe'
                  WorkingDirectory='INSTALLFOLDER'/>
        <RemoveFolder Id='ApplicationProgramsFolder' On='uninstall'/>
        <RegistryValue Root='HKCU' Key='Software\Microsoft\MyApplicationName' Name='installed' Type='integer' Value='1' KeyPath='yes'/>
      </Component>
    </DirectoryRef>

  </Fragment>
</Wix>
View Code
复制代码

三、增加网页和卸载快捷方式

  在菜单栏的基础上，再增加一个Web快捷方式，可以跳转到你的门户网站。需要3步

   1.先引入WixUtilExtension.dll  这个就不多说了（之前引用过）。

   2.在工程的命名空间中加入这个扩展。这个就相当于c#的using了。

<Wix xmlns='http://schemas.microsoft.com/wix/2006/wi'  xmlns:util='http://schemas.microsoft.com/wix/UtilExtension' >

  3.在二中的Component中加入

    <util:InternetShortcut Id='OnlineDocumentationShortcut'
               Name='Online'
                      Target='http://yourWebsit/Home/index'/>

  和之前的Shortcut在同一级。 这样就ok了。再次安装多出一个online的快捷方式，点击跳转到指定网页。

  我们再增加个卸载的快捷方式，现在只需要再添加个Shortcut就行了，Id为UninstProduct

    <Shortcut Id='UninstallProduct'
                          Name='Uninstall'
                          Description='Uninstalls My Application'
                          Target='[SystemFolder]msiexec.exe'
                          Arguments='/x [ProductCode]'/>

Target指向msiexec.exe 这才是正真执行卸载的程序，[SystemFolder] 对应它的位置。Argument通过productcode告诉它哪个是要卸载的程序。/x 就是卸载命令到这里差不多就完成了。但是之前图标没有换过来。这里就给第一个Shortcut加上一个图标。 修改为

复制代码
  <Shortcut Id='ApplicationStartMenuShortcut'
                  Name='Mysetup'
                     Icon='MyApplicationIcon.exe'
                  Description='my first application installed by wix'
                  Target='[INSTALLFOLDER]MyApplication.exe'
                  WorkingDirectory='INSTALLFOLDER'>
          <Icon Id='MyApplicationIcon.exe' SourceFile='content/MyApplicationIcon.exe.ico'/>
        </Shortcut>
复制代码

 就在这个内部加入了一个Icon属性和元素。Id命名的时候建议加上一个Icon，然后ico的图标制作，可以找在线的。这一块的代码如下

复制代码
<DirectoryRef Id='ApplicationProgramsFolder'>
      <Component Id='ApplicationShortcut' Guid='5A254682-DD5F-453D-8333-144457282026'>
        <Shortcut Id='ApplicationStartMenuShortcut'
                  Name='Mysetup'
                     Icon='MyApplicationIcon.exe'
                  Description='my first application installed by wix'
                  Target='[INSTALLFOLDER]MyApplication.exe'
                  WorkingDirectory='INSTALLFOLDER'>
          <Icon Id='MyApplicationIcon.exe' SourceFile='content/MyApplicationIcon.exe.ico'/>
        </Shortcut>
        <util:InternetShortcut Id='OnlineDocumentationShortcut'
              Name='ScadaOnline'
                     Target='http://yourwebsit/Home/index'/>
        <Shortcut Id='UninstallProduct'
                          Name='Uninstall'
                          Description='Uninstalls My Application'
                          Target='[SystemFolder]msiexec.exe'
                          Arguments='/x [ProductCode]' />
        <RemoveFolder Id='ApplicationProgramsFolder' On='uninstall'/>
        <RegistryValue Root='HKCU' Key='Software\Microsoft\MyApplicationName' Name='installed' Type='integer' Value='1' KeyPath='yes'/>
      </Component>
    </DirectoryRef>
View Code
复制代码

效果图如下：开始菜单栏中有三个图标，第一个是我们的应用程序，这个ico 看起有点模糊了。在线和卸载的图标是默认的，没有修改

四、增加桌面快捷方式

   现在我们还差一个桌面的快捷方式。经过几番摸索，还是整出来了。

  1.需要先增加一个文件目录 ，这就代表了再桌面。

    <Directory Id='DesktopFolder' Name='Desktop' />

 2.再加入Shortcut，这个shortcut就不能在之前的那个地方写了，因为那是菜单栏的。 必须用DirectoryRef ，但icon还是可以用同样一个

复制代码
<DirectoryRef Id='DesktopFolder'>
      <Component Id='DesktopFolderShortcut' Guid='5A254682-DD1F-453D-8333-144457282026'>
        <Shortcut Id='DesktopShortcut' Directory='DesktopFolder'   Name='myApplication' Target='[INSTALLFOLDER]MyApplication.exe'  WorkingDirectory='INSTALLFOLDER' Icon='MyIcon.exe'>
        </Shortcut>
      <RegistryValue Root='HKCU' Key='Software\Microsoft\MyApplicationName' Name='installed' Type='integer' Value='1' KeyPath='yes'/>
      </Component>
    </DirectoryRef>
复制代码

 注意，下面那个RegistryValue不加不行,果然ICEXX.... 报错。需要注册一下。 这样，再编译安装，桌面出现了快捷方式，程序运行时，在windows窗口下方的图标也变了，不再是默认的windo程序的图标了。

  这一节就到这了，明天继续努力。还是那句老话：周六加班不容易，看过路过，有帮助的就顶一个。 :）

    本站是提供个人知识管理的网络存储空间，所有内容均由用户发布，不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息，谨防诈骗。如发现有害或侵权内容，请点击一键举报。
    转藏 分享 献花（0）

    来自： 兰亭文艺 > 《WiX》

    举报/认领

    0条评论

    发表

    请遵守用户 评论公约

    类似文章