Translation Example
翻译示例
Using translations to localize installer pages and licenses.
使用翻译来本地化安装程序页面和许可证。
Translations illustrates how to use translations to localize the output of component scripts and component UI files into another language. It also shows how to select the license according to the system language.
翻译说明了如何使用翻译将组件脚本和组件UI文件的输出本地化为另一种语言。它还显示了如何根据系统语言选择许可证。
To add a new language, you first need to create a translation source (TS) file for the package that contains all the translatable strings. Run the following command in the package's meta directory:
要添加新语言,首先需要为包含所有可翻译字符串的包创建一个翻译源(TS)文件。在包的元目录中运行以下命令:
lupdate installscript.qs page.ui -ts <language>.ts
Replace <language> with the two letter lowercase code for the language you want to translate to. After finishing translating you need to use lrelease on that TS file to generate the binary Qt messages (QM) file. Do not forget to include that in the package.xml as shown below. Run the following command in the package's meta directory:
将<language>替换为要翻译的语言的两个字母的小写代码。翻译完成后,需要在该TS文件上使用lrelease来生成二进制Qt消息(QM)文件。不要忘记将其包含在package.xml中,如下所示。在包的meta 目录中运行以下命令:
lrelase <language>.ts
Configuring the Example Installer
配置示例安装程序
The installer configuration file, config.xml, in the config
directory specifies the text and default values used in the installer:
config目录中的安装程序配置文件config.xml指定了安装程序中使用的文本和默认值:
- The
<Name>
element sets the application name and adds it to the page name and introduction text. - <Name>元素设置应用程序名称并将其添加到页面名称和介绍文本中。
- The
<Version>
element sets the application version number. - <Version>元素设置应用程序版本号。
- The
<Title>
element sets the installer name and displays it on the title bar. - <Title>元素设置安装程序名称并将其显示在标题栏上。
- The
<Publisher>
element sets the publisher of the software (as shown in the Windows Control Panel, for example). - <Publisher>元素设置软件的发布者(例如,如Windows控制面板所示)。
- The
<StartMenuDir>
element sets the name of the default program group for the product in the Windows Start menu. - <StartMenuDir>元素在Windows“开始”菜单中设置产品的默认程序组的名称。
- The
<TargetDir>
element sets the default target directory location to be within theIfwExamples
directory in the home directory of the current user (because it uses the pre-existing variable,
@HomeDir@, as part of the value). For more information, see Predefined Variables. - <TargetDir>元素将默认目标目录位置设置为当前用户主目录中的IfwExamples目录内(因为它使用预先存在的变量@HomeDir@作为值的一部分)。有关详细信息,请参见预定义变量。
<?xml version="1.0" encoding="UTF-8"?>
<Installer>
<Name>Translations Example</Name>
<Version>1.0.0</Version>
<Title>Package Translations Example</Title>
<Publisher>Qt Project</Publisher>
<StartMenuDir>Qt Installer Framework Examples</StartMenuDir>
<TargetDir>@HomeDir@/IfwExamples/translations</TargetDir>
</Installer>
Creating the Example Package Information File
创建示例包信息文件
The installer package information file, package.xml, in the meta
directory specifies the components that are available for installation:
meta
目录中的安装程序包信息文件package.xml指定了可用于安装的组件:
- The
<DisplayName>
element sets the human-readable name of the component. - <DisplayName>元素设置组件的人类可读名称。
- The
<Description>
element sets the human-readable description of the component. - <Description>元素设置组件的人类可读描述。
- The
<Version>
element sets the version number of the component. - <Version>元素设置组件的版本号。
- The
<ReleaseDate>
element sets the date of release for this component version. - <ReleaseDate>元素设置此组件版本的发布日期。
- The
<Default>
element is set totrue
to preselect the component in the installer. - 将<Default>元素设置为true,以在安装程序中预选组件。
- The
<Script>
element specifies the file name of the JavaScript file that is loaded to perform operations. - <Script>元素指定加载以执行操作的JavaScript文件的文件名。
- The
<License>
element specifies the file name of the license file that is shown when this component is selected for installation. - <License>元素指定选择此组件进行安装时显示的许可证文件的文件名。
- The
<Translations>
element specifies the file name of the QM file containing translations for this compontent's UI and script files. - <Translations>元素指定QM文件的文件名,该文件包含此组件的UI和脚本文件的翻译。
<?xml version="1.0" encoding="UTF-8"?>
<Package>
<DisplayName>The root component</DisplayName>
<Description>This component contains a license and translations to German.</Description>
<Version>0.5.0-1</Version>
<ReleaseDate>2015-01-29</ReleaseDate>
<Licenses>
<License name="Beer Public License Agreement" file="license.txt" />
</Licenses>
<Default>true</Default>
<Script>installscript.qs</Script>
<UserInterfaces>
<UserInterface>page.ui</UserInterface>
</UserInterfaces>
<Translations>
<Translation>de.qm</Translation>
<Translation>pl.qm</Translation>
</Translations>
</Package>
Generating the Example Installer
生成示例安装程序
To create the example installer, switch to the example source directory on the command line and enter the following command:
要创建示例安装程序,请在命令行上切换到示例源代码目录,然后输入以下命令:
- On Windows:
..\..\bin\binarycreator.exe -c config\config.xml -p packages installer.exe
- On Linux or macOS:
../../bin/binarycreator -c config/config.xml -p packages installer
This creates the installer to the current directory.
这将创建当前目录的安装程序。
Files:
- translations/config/config.xml
- translations/packages/com.vendor.product/data/installcontent.txt
- translations/packages/com.vendor.product/meta/de.ts
- translations/packages/com.vendor.product/meta/installscript.qs
- translations/packages/com.vendor.product/meta/license.txt
- translations/packages/com.vendor.product/meta/license_de.txt
- translations/packages/com.vendor.product/meta/license_pl.txt
- translations/packages/com.vendor.product/meta/package.xml
- translations/packages/com.vendor.product/meta/page.ui
- translations/packages/com.vendor.product/meta/pl.ts
- translations/translations.pro
© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. The Qt Company, Qt and their respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.