搭配應用程式使用 Setup.exe 啟動載入器範例

發行項
08/21/2008

更新：2007 年 11 月

Setup.exe 啟動載入器範例 (英文) 執行的作業是自動的。但若要 Setup.exe 使用應用程式，就必須建立包含所需應用程式資訊的自訂 Settings.ini 檔。此外，建議您部署安裝程式時加上讀我檔案，檔案中提供使用者安裝應用程式和 Dotnetfx.exe 的最低組態需求。下列章節提供建立 Settings.ini 和讀我檔案的詳細資訊：

建立 Settings.ini 檔
建立安裝程式的讀我檔案

建立 Settings.ini 檔

Setup.exe 啟動載入器 (Bootstrapper) 範例使用外部檔案 Settings.ini 來決定下列事項：

Dotnetfx.exe 和主應用程式的位置
要檢查的 .NET Framework 的語言版本
etup.exe 對話方塊使用的自訂字串

Settings.ini 的預設位置位於與 Setup.exe 相同的資料夾。您必須負責建立 Settings.ini 檔，讓 Setup.exe 啟動載入器 (Bootstrapper) 範例能夠搭配您的應用程式使用。您可以複製 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 主應用程式和 Dotnetfx.exe 的 Windows Installer 套件 (mySetup.msi)。

在下列範例中，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 會預設檢查英文 (English) 語言版本。

下列資料表列出可用的語言版本和對應的文化特性名稱，以便在 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 之後對話方塊中出現的文字。例如，如果您將 ProductName 指定為 My Application，則對話方塊文字會顯示「若要啟動 My Application 安裝程式，請按一下 [確定]。若要結束不再安裝，請按一下 [取消]。」。

如果您不自訂 CaptionText 變數，還是可以使用 ProductName，自訂在啟動 Setup.exe 之後對話方塊中出現的標題列。例如，如果您將 ProductName 指定為 My Application，則標題列會顯示「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 (含) 以後版本。您還應該列出含資料存取的 .NET Framework 應用程式所需的 Microsoft Data Access Components (MDAC) 2.6 版 (含) 以後版本 (雖然安裝不需要)。如需安裝 Dotnetfx.exe 的最小組態需求的詳細資訊，請參閱最低組態需求。