结合应用程序使用 Setup.exe 安装引导程序示例
更新：2007 年 11 月
Setup.exe Bootstrapper sample（Setup.exe 引导程序示例）执行的操作是自动进行的。但是，要使 Setup.exe 可以使用应用程序，您必须创建一个自定义 Settings.ini 文件，其中提供应用程序相关的必要信息。此外，建议您为部署的安装程序附带一个自述文件，通过该文件向用户说明安装应用程序和 Dotnetfx.exe 的最低配置要求。以下各节提供有关创建 Settings.ini 和自述文件的详细信息：
创建 Settings.ini 文件
为安装程序创建自述文件
创建 Settings.ini 文件
Setup.exe 安装引导程序示例使用外部文件 Settings.ini 确定以下内容：
Dotnetfx.exe 和宿主应用程序的位置。
要检查的 .NET Framework 的语言版本。
要用于 Setup.exe 对话框的自定义字符串。
Settings.ini 的默认位置与 Setup.exe 在相同文件夹中。您负责创建 Settings.ini 文件，该文件使 Setup.exe 引导程序示例可与您的应用程序配合使用。您可以复制随 Setup.exe 安装引导程序示例提供的 Settings.ini 文件，然后根据需要编辑该文件，为应用程序指定正确值。
指定 Dotnetfx.exe 和宿主应用程序的位置
Setup.exe 引导程序示例要求 Dotnetfx.exe 和宿主 .NET Framework 应用程序位于相对于 Setup.exe 的已知位置。Setup.exe 引导程序示例使用外部文件 Settings.ini 确定 Dotnetfx.exe 和宿主应用程序的位置。您可以复制随示例提供的 Settings.ini 文件，然后编辑该文件，以指向 .NET Framework 宿主应用程序和 Dotnetfx.exe 的位置。
以下 Settings.ini 文件示例说明了如何指向各种不同位置（相对于 Setup.exe 的位置而言）的宿主 .NET Framework 应用程序的 Windows Installer 包 (mySetup.msi) 和 Dotnetfx.exe。
在下面的示例 Settings.ini 文件中，mySetup.msi 和 Dotnetfx.exe 与 Setup.exe 位于同一个文件夹中。撇号“'”用于注释掉没有进行自定义的行。
[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\
在下面的示例 Settings.ini 文件中，mySetup.msi 和 Dotnetfx.exe 位于网络共享上，与 Setup.exe 不在同一个位置。
[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\
在下面的示例 Settings.ini 文件中，mySetup.msi 和 Dotnetfx.exe 与 Setup.exe 位于同一台计算机上，但在不同的文件夹中。
[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\
在下面的示例 Settings.ini 文件中，mySetup.msi 和 Dotnetfx.exe 与 Setup.exe 位于同一张 CD 上，但在不同的文件夹中。
[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/
指定语言版本
如果您希望 Setup.exe 检查 .NET Framework 的内部版本号和语言版本，必须在 Settings.ini 文件中指定语言的区域性名称。如果没有指定区域性名称，默认情况下 Setup.exe 将检查是否有英语语言版本。
下表列出了可用的语言版本和要在 Settings.ini 文件中指定的相应区域性名称。区域性名称不区分大小写。
语言 |
区域性名称 |
|---|---|
中文（简体） |
chs |
中文（繁体） |
cht |
法语 |
fr |
德语 |
de |
意大利语 |
it |
日语 |
ja |
朝鲜语 |
ko |
西班牙语 |
es |
下面的示例 Settings.ini 文件指示 Setup.exe 检查 Dotnetfx.exe 的法语版本。
[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\
自定义用于 Setup.exe 对话框的字符串
您可以在 Settings.ini 文件中编辑以下变量，以自定义 Setup.exe 对话框中显示的字符串。
ProductName 指定 Setup.exe 将安装的 .NET Framework 应用程序的名称。指定的产品名称用于自定义在启动 Setup.exe 之后出现的对话框中的文本。例如，如果指定 My Application 作为 ProductName，则该对话框文本显示“若要启动 My Application 安装程序，请单击‘确定’。要退出而不进行安装，请单击‘取消’”。
如果未自定义 CaptionText 变量，则 ProductName 还用于自定义在启动 Setup.exe 之后出现的对话框的标题栏。例如，如果指定 My Application 作为 ProductName，则该标题栏显示“My Application 安装程序”。如果您同时自定义 ProductName 和 CaptionText，则 CaptionText 用于自定义此对话框中的标题栏文本。
ProductName 还用于自定义完成安装应用程序时显示的成功对话框中的标题栏文本。如果未自定义 ProductName，则显示默认文本“应用程序安装程序”。
DialogText 指定在启动 Setup.exe 之后出现的对话框中显示的自定义文本。如果未自定义 DialogText，则显示默认文本“若要启动应用程序安装程序，请单击‘确定’。要退出而不进行安装，请单击‘取消’”。
CaptionText 指定在启动 Setup.exe 之后出现的对话框的标题栏中显示的自定义文本。如果未自定义 CaptionText，则显示 ProductName。如果没有自定义 ProductName，则显示默认文本“应用程序安装程序”。
ErrorCaptionText 指定要在 Setup.exe 错误对话框的标题栏中显示的自定义文本。如果未自定义 ErrorCaptionText，则显示默认文本“应用程序安装程序错误”。
为安装程序创建自述文件
建议您为分发的安装程序附带一个自述文件，在该文件中列出对可成功运行安装程序的计算机的最低配置要求。根据安装前要求，至少列出装有 Internet Explorer 5.01 或更高版本的 Microsoft Windows 98 或更高版本。还应列出 Microsoft 数据访问组件 (MDAC) 2.6 版或更高版本，并注明它不是安装所需的，而是提供数据访问权的 .NET Framework 应用程序所需的。有关用于安装 Dotnetfx.exe 的最低配置要求的更多信息，请参见最低配置要求。
请参见
概念
创建单独的安装项目安装 .NET Framework 应用程序和 Dotnetfx.exe