共用方式為


建立啟動載入器套件

安裝程式 (Setup Program) 是一般安裝程式 (Installer),可設定來偵測及安裝可轉散發元件,例如 Windows Installer (.msi) 檔案和可執行程式。 安裝程式也稱為啟動載入器。 其程式設計方式是透過一組 XML 資訊清單,指定用於管理元件安裝的中繼資料。 ClickOnce 的 [必要條件] 對話方塊中出現的每個可轉散發元件或必要條件都是啟動載入器套件。 啟動載入器套件是一組目錄和檔案,內含描述必要條件安裝方式的資訊清單檔案。

啟動載入器會先偵測是否已安裝所有必要條件。 如果未安裝必要條件,啟動載入器會先顯示授權合約。 接著,在使用者接受授權合約之後,就會開始安裝必要條件。 不過,如果啟動載入器偵測到所有必要條件,就會直接啟動應用程式安裝程式。

建立自訂啟動載入器套件

您可以使用 Visual Studio 中的 XML 編輯器產生啟動載入器資訊清單。 若要查看建立啟動載入器套件的範例,請參閱逐步解說:建立具有隱私權提示的自訂啟動載入器

若要建立啟動載入器套件,您必須建立產品資訊清單,以及針對每個當地語系化版本的元件建立套件資訊清單。

  • 產品資訊清單 product.xml,包含套件的任何語言中性中繼資料。 此清單包含所有當地語系化版本之可轉散發元件通用的中繼資料。 若要建立此檔案,請參閱如何:建立產品資訊清單

  • 套件資訊清單 package.xml,包含特定語言中繼資料。此清單通常包含當地語系化的錯誤訊息。 元件的每個當地語系化版本至少必須各有一份套件資訊清單。 若要建立此檔案,請參閱如何:建立套件資訊清單

建立這些檔案之後,請將產品資訊清單檔案放入以自訂啟動載入器命名的資料夾中, 並將套件資訊清單檔案放入以地區設定命名的資料夾中。 例如,如果是英文版可轉散發套件的套件資訊清單檔案,請將檔案放入稱為 en 的資料夾中。 針對每個地區設定重複這個程序,例如以 ja 代表日文,以 de 代表德文。 最終的自訂啟動載入器套件可能會有下列資料夾結構。

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

接下來,將可轉散發檔案複製到啟動載入器資料夾位置中。 如需詳細資訊,請參閱 How to: Create a localized bootstrapper package (如何:建立當地語系化的啟動載入器套件)。

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

注意

上述 Visual Studio 安裝路徑下所列的路徑從 Visual Studio 2019 Update 7 版本開始運作。

您也可以從下列登錄機碼中的 [路徑] 值,找到啟動載入器資料夾位置:

*HKLM\Software\Microsoft\GenericBootstrapper*

在 64 位元系統上,使用下列登錄機碼:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

每個可轉散發元件會出現在套件目錄下各自的子資料夾中。 產品資訊清單和可轉散發檔案必須放入這個子資料夾中。 元件和套件資訊清單的當地語系化版本必須放入依文化特性名稱命名的子資料夾中。

當這些檔案複製到啟動載入器資料夾之後,啟動載入器套件就會自動出現在 Visual Studio 的 [必要條件] 對話方塊中。 如果您的自訂啟動載入器套件沒有出現在其中,請關閉再重新開啟 [必要條件] 對話方塊。 如需詳細資訊,請參閱必要條件對話方塊

下表顯示啟動載入器會自動填入的屬性。

屬性 說明
ApplicationName 應用程式的名稱。
ProcessorArchitecture 可執行檔之目標平台的處理器和每個字組的位元。 包括下列值:

- Intel
- IA64
- AMD64
VersionNT Windows 作業系統的版本號碼。 版本的語法是 Major.Minor.ServicePack。
VersionMSI 在安裝期間執行的 Windows Installer 組件 (msi.dll) 版本。
AdminUser 如果使用者具有系統管理員權限,則會設定這個屬性。 值為 true 或 false。
InstallMode 安裝模式指出需要從中安裝元件的位置。 包括下列值:

- HomeSite - 從廠商的網站安裝必要條件。
- SpecificSite - 從您選取的位置安裝必要條件。
- SameSite - 從應用程式的相同位置安裝必要條件。

將可轉散發套件與應用程式安裝分開放置

您可以防止可轉散發檔案部署在安裝專案中。 若要達成這項目的,請在 .NET Framework 目錄的 RedistList 資料夾中建立可轉散發清單:

%ProgramFiles%\Microsoft.NET\RedistList

可轉散發清單是 XML 檔案,應該使用下列格式命名:<公司名稱>.<元件名稱>.RedistList.xml。 例如,如果 Acme 建立稱為 Datawidgets 的元件,請使用 Acme.DataWidgets.RedistList.xml。 可轉散發清單的內容範例可能如下所示:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>