Wix自定义操作 - 从XML文件读取参数

Question

如何编写Wix安装程序,该安装程序从XML文件导入参数值以便在安装期间使用？

Answer 1

这不是一个完美的解决方案,但我花了两天时间才开始工作并希望分享.毫无疑问会有一些错误,但我在可用的时间里做得尽可能好:

1. 添加新项目并选择Windows Installer Xml安装项目
2. 添加新项目并选择Windows Installer Xml C#自定义操作项目

3. 在您的安装项目中:

   • 添加要安装的东西,例如files\web site等(请参阅其他有关如何执行此操作的教程)

   • 在Product.wxs中设置一些属性,例如

     <Property Id="MyProperty1" />
     <Property Id="MyProperty2" />
     

   • 在Product.wxs中引用新创建的自定义操作(如下所示):

     <Product> .....
         <Binary Id='VantageInstallerCustomActions.CA.dll' src='..\VantageInstallerCustomActions\bin\$(var.Configuration)\VantageInstallerCustomActions.CA.dll' />
         <InstallExecuteSequence>
             <Custom Action="SetInstallerProperties" Before="CostFinalize"  />
         </InstallExecuteSequence>
     </Product>
     
     <Fragment>
         <CustomAction Id='SetInstallerProperties' BinaryKey='VantageInstallerCustomActions.CA.dll' DllEntry='SetInstallerProperties' Return='check' Execute='immediate' />
     </Fragment>
     

4. 将以下代码添加到自定义操作项目或类似的东西中:

添加CustomAction类:

    public class CustomActions
    {
     private static readonly InstallerPropertiesFileManager InstallerPropertiesFileManager = new InstallerPropertiesFileManager();

    [CustomAction]
    public static ActionResult SetInstallerProperties(Session session)
    {
        session.Log("Begin SetInstallerProperties");

        try
        {

            var doc = XDocument.Load(@"C:\temp\Parameters.xml");

            session.Log("Parameters Loaded:" + (doc.Root != null));
            session.Log("Parameter Count:" + doc.Descendants("Parameter").Count());
            var parameters = doc.Descendants("Parameter").ToDictionary(n => n.Attribute("Name").Value, v => v.Attribute("Value").Value);

            if (parameters.Any())
            {
                session.Log("Parameters loaded into Dictionary Count: " + parameters.Count());

                //Set the Wix Properties in the Session object from the XML file
                foreach (var parameter in parameters)
                {
                    session[parameter.Key] = parameter.Value;
                }
            }                
            else
            {
                session.Log("No Parameters loaded");
            }
        }
        catch (Exception ex)
        {
            session.Log("ERROR in custom action SetInstallerProperties {0}", ex.ToString());
            return ActionResult.Failure;
        }
        session.Log("End SetInstallerProperties");
        return ActionResult.Success;
    }
    }

创建要存储在磁盘上的C:\ temp\Parameters.xml文件

    <?xml version="1.0" encoding="utf-8"?>
    <Parameters>
        <Environment ComputerName="Mycomputer" Description="Installation Parameters for Mycomputer" />
        <Category Name="WebServices">
            <Parameter Name="MyProperty1" Value="http://myserver/webservice" />
            <Parameter Name="MyProperty2" Value="myconfigSetting" />
        </Category>
    </Parameters>

注意,您无需从安装项目中引用自定义操作项目.您也不应该在早期需要的安装周期中设置太晚的属性,例如那些是安装文件的文件路径.我倾向于避免这些.

使用Product.wxs中的属性执行某些操作!例如,我使用检索到的属性更新已安装的web.config中的Web服务端点

<Fragment>
    <DirectoryRef Id ="INSTALLFOLDER">
      <Component Id="WebConfig" Guid="36768416-7661-4805-8D8D-E7329F4F3AB7">
        <CreateFolder />
        <util:XmlFile Id="WebServiceEnpointUrl" Action="setValue" ElementPath="//configuration/system.serviceModel/client/endpoint[\[]@contract='UserService.V1_0.GetUser.ClientProxy.Raw.IGetUserService'[\]]/@address" Value="[MyProperty1]" File="[INSTALLFOLDER]web.config" SelectionLanguage="XPath" />
      </Component>
    </DirectoryRef>
  </Fragment>

与Wix安装程序一样,第一次没有任何作用.重新构建您的Wix SetupProject并使用以下命令行在本地运行msi以打开日志记录:

msiexec /i "myInstaller.msi" /l*v "log.log"

运行后,打开日志文件,您应该看到以下事件:

MSI (s) (C4:3C) [11:00:11:655]: Doing action: SetInstallerProperties
Action start 11:00:11: SetInstallerProperties.
MSI (s) (C4:A8) [11:00:11:702]: Invoking remote custom action. DLL: C:\WINDOWS\Installer\MSICD83.tmp, Entrypoint: SetInstallerProperties
MSI (s) (C4:A8) [11:00:11:702]: Generating random cookie.
MSI (s) (C4:A8) [11:00:11:702]: Created Custom Action Server with PID 496 (0x1F0).
MSI (s) (C4:CC) [11:00:11:733]: Running as a service.
MSI (s) (C4:CC) [11:00:11:733]: Hello, I'm your 32bit Impersonated custom action server.
SFXCA: Extracting custom action to temporary directory: C:\Users\ak9763\AppData\Local\Temp\MSICD83.tmp-\
SFXCA: Binding to CLR version v4.0.30319
Calling custom action VantageInstallerCustomActions!VantageInstallerCustomActions.CustomActions.SetInstallerProperties
Begin SetInstallerProperties
Parameters loaded into Dictionary: 2
MSI (s) (C4!C0) [11:00:11:858]: PROPERTY CHANGE: Adding MyProperty1 property. Its value is 'http://myserver/webservice'.
MSI (s) (C4!C0) [11:00:11:858]: PROPERTY CHANGE: Adding MyProperty2 property. Its value is 'myConfigSetting'.
End SetInstallerProperties
Action ended 11:00:11: SetInstallerProperties. Return value 1.

这篇文章的参考文献:

在C#中创建WiX自定义操作并传递参数

从MSI到WiX,第5部分 - 自定义操作:简介

创建MSI日志文件