繁体   English   中英

是否可以使用 .wxl 文件在 WiX 中本地化 EULA?

[英]Is it possible to localize EULA in WiX using .wxl file?

我使用 WiX 创建的安装程序通过 .wxl 文件进行了本地化。 在 WiX 中可以指定多种文化,并且 light.exe 将被多次调用,为每种语言创建一个安装程序(这在从 Visual Studio 构建安装程序时可用)。

除 EULA 外的所有作品文件。 它通过 .wxs 文件定义

<WixVariable Id='WixUILicenseRtf' Value='en.rtf' />

而且我不知道从 .wxl 本地化文件更改此值的好方法。 使用

<WixVariable Id='WixUILicenseRtf' Value='!(loc.EulaFile)' />
<String Id='EulaFile'>en.rtf</String>

不工作, sice .wxl 文件在链接时使用, .wxs 在它们之前编译,所以编译器找不到!(loc.EulaFile) 搜索论坛我发现了两种解决方法。 首先是为每种语言创建一个自定义的许可证对话框——它似乎有效,但这是一种非常困难的方法,并且会大量膨胀源代码。 第二种方法是删除 Visual Studio / Votive 构建并多次调用 light.exe,每次通过 -d 命令行键指定不同的许可证文件。

有什么方法可以解决这个问题并使用本地化的 EULA 文件,以便可以在 VisualStudio + Voltive 中构建项目而无需复制粘贴大量对话框? 本地化安装程序是一个非常普遍的问题,所以也许存在一些我不知道的解决方案?

最简单的解决方案是最简单的,只需在命令行上使用WixUILicenseRtf变量来指定.wxl文件。

light -loc setup_fr-FR.wxl -dWixUILicenseRtf=EULA_fr-FR.rtf ...

有关更多信息,请参阅WiX Wiki上的用户界面基础知识

还有另外一种方法可以做到这一点,虽然它有点乱,但它比OP提到的两个解决方法更简洁。 在信用到期的情况下,这个答案几乎100%基于这篇文章http://weblogs.sqlteam.com/mladenp/archive/2010/04/15/WiX-3-Tutorial-Custom-EULA-License-and MladenPrajdić的-MSI-localization.aspx

以下是基于WiX 3.5。

您可以创建一个稍微修改过的LicenseAgreementDlg对话框副本,并将其包含在项目中。

<?xml version="1.0" encoding="UTF-8"?>
<!--
    Copyright (c) Microsoft Corporation.  All rights reserved.

    The use and distribution terms for this software are covered by the
    Common Public License 1.0 (http://opensource.org/licenses/cpl1.0.php)
    which can be found in the file CPL.TXT at the root of this distribution.
    By using this software in any fashion, you are agreeing to be bound by
    the terms of this license.

    You must not remove this notice, or any other, from this software.
-->

<!-- This is a modified version of LicenseAgreementDlg to support selection of localized versions of 
     the license file. It is very much based on this article: 
     http://sqlserverpedia.com/blog/sql-server-bloggers/wix-3-tutorial-custom-eula-license-and-msi-localization/  -->

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Fragment>
        <UI>
            <Dialog Id="LicenseAgreementKludge" Width="370" Height="270" Title="!(loc.LicenseAgreementDlg_Title)">
                <Control Id="BannerBitmap" Type="Bitmap" X="0" Y="0" Width="370" Height="44" TabSkip="no" Text="!(loc.LicenseAgreementDlgBannerBitmap)" />
                <Control Id="BannerLine" Type="Line" X="0" Y="44" Width="370" Height="0" />
                <Control Id="BottomLine" Type="Line" X="0" Y="234" Width="370" Height="0" />
                <Control Id="Description" Type="Text" X="25" Y="23" Width="340" Height="15" Transparent="yes" NoPrefix="yes" Text="!(loc.LicenseAgreementDlgDescription)" />
                <Control Id="Title" Type="Text" X="15" Y="6" Width="200" Height="15" Transparent="yes" NoPrefix="yes" Text="!(loc.LicenseAgreementDlgTitle)" />
                <Control Id="LicenseAcceptedCheckBox" Type="CheckBox" X="20" Y="207" Width="330" Height="18" CheckBoxValue="1" Property="LicenseAcceptedKludge" Text="!(loc.LicenseAgreementDlgLicenseAcceptedCheckBox)" />
                <Control Id="Print" Type="PushButton" X="112" Y="243" Width="56" Height="17" Text="!(loc.WixUIPrint)">
                    <Publish Event="DoAction" Value="WixUIPrintEula">1</Publish>
                </Control>
                <Control Id="Back" Type="PushButton" X="180" Y="243" Width="56" Height="17" Text="!(loc.WixUIBack)" />
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)">
                    <Publish Event="SpawnWaitDialog" Value="WaitForCostingDlg">!(wix.WixUICostingPopupOptOut) OR CostingComplete = 1</Publish>
                    <Condition Action="disable"><![CDATA[LicenseAcceptedKludge <> "1"]]></Condition>
                    <Condition Action="enable">LicenseAcceptedKludge = "1"</Condition>
                </Control>
                <Control Id="Cancel" Type="PushButton" X="304" Y="243" Width="56" Height="17" Cancel="yes" Text="!(loc.WixUICancel)">
                    <Publish Event="SpawnDialog" Value="CancelDlg">1</Publish>
                </Control>
                <Control Id="LicenseText" Type="ScrollableText" X="20" Y="60" Width="330" Height="140" Sunken="yes" TabSkip="no">
                    <Text SourceFile="$(var.ProjectDir)\!(loc.LicenseRtf)" />  <!-- this value has been modified -->
                </Control>
            </Dialog>
        </UI>
    </Fragment>
</Wix>

在主要的WiX源文件中,添加以下代码以将新对话框“修补”到对话框排序中而不是原始对话框中:

  <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="LicenseAgreementKludge">1</Publish>
  <Publish Dialog="LicenseAgreementKludge" Control="Back" Event="NewDialog" Value="WelcomeDlg">1</Publish>
  <Publish Dialog="LicenseAgreementKludge" Control="Next" Event="NewDialog" Value="InstallDirDlg">LicenseAcceptedKludge = "1"</Publish>
  <Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementKludge">1</Publish>

请注意,这是基于使用WixUI_InstallDir对话框集合 - 对于其他集合,例如WixUI_Mondo,您可能需要通过查看源代码来修改上述内容。

最后,在每个本地化文件中,您放置一行,如下所示:

<String Id="LicenseRtf">en-us\MerliniaSMSGatewayLicense.en-us.rtf</String>

<String Id="LicenseRtf">da-dk\MerliniaSMSGatewayLicense.da-dk.rtf</String>

当然,您可以按照指示放置本地化的许可证文件。 我将许可文件(和本地化文件)放在子文件夹中,但这不是必需的。

就像我说的那样,它有点乱,但确实有效。

本地化EULA非常简单。 ScrollableText控件添加到您的一个对话框中。 在ScrollableText控件的text元素中引用本地化String。

<Control Id="LicenseText" Type="ScrollableText" X="20" Y="60" Width="330" Height="140" Sunken="yes" TabSkip="no">
  <Text>!(loc.License)</Text>
</Control>

接下来创建一个本地化文件,比如美国英语。 将文件命名为en-US.wxl。 在本地化文件中创建一个本地化String元素,该元素使用ScrollableText控件的Text元素中引用的标识符,在本例中它称为License。 EULA的原始rtf字符串添加为本地化字符串的CDATA元素。

例如,要获取原始数据,请使用wordpad创建rtf文件。 用记事本打开该rtf文件并复制其内容。 将该内容粘贴到本地化String元素的CDATA元素中。 请务必省略 String和CDATA标记之间的所有空格

示例本地化的String元素如下:

<String Id="License"><![CDATA[{\rtf1\ansi\ansicpg1252\deff0\deflang1031{\fonttbl{\f0\fnil\fcharset0 Calibri;}}
{\*\generator Msftedit 5.41.21.2510;}\viewkind4\uc1\pard\sa200\sl276\slmult1\lang7\f0\fs22 American EULA.}]]></String>

因此,包含多个EULA的关键是在各自的本地化文件中使用原始rtf数据。

转到解决方案的配置管理器,在安装程序项目行上为您要使用的每个本地化创建一个新配置,例如如下所示:

解决方案配置管理器的项目配置选择器

现在,在安装程序项目属性页面/构建上,对于每个创建的配置,在“要构建的文化”上设置一个文化,并在每个文化的“定义变量”框中设置不同的值:

例如,对于 es-ES:

WixUILicenseRtf=.\\Assets\\license-es-ES.rtf

对于美国:

WixUILicenseRtf=.\\Assets\\license-en-US.rtf

... 等等

项目属性参数

要构建您的安装程序:

对于每种文化:

  • 转到配置管理器,
  • 选择安装程序的配置文化,接受
  • 建造

优点:

  • 无需处理自定义操作、自定义对话框或控制台命令
  • 只需要配置一次。 让它运行是一项机械任务

缺点:

  • 每次构建都需要一些额外的点击
  • 超过三种文化的混乱

暂无
暂无

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM