GenerateBootstrapper 工作

提供偵測、下載及安裝應用程式及其必要條件的自動化方法。 它可以做為單一安裝程式，用來整合適用於所有組成應用程式之元件的個別安裝程式。

工作參數

下表列出 GenerateBootstrapper 工作的參數及其概略說明。

參數	描述
ApplicationFile	選擇性 String 參數。 指定在安裝所有必要條件之後，啟動載入器 (Bootstrapper) 將用來開始安裝應用程式的檔案。 如果未指定 BootstrapperItems 和 ApplicationFile 參數，將會產生建置錯誤。
ApplicationName	選擇性 String 參數。 指定啟動載入器將安裝的應用程式名稱。 這個名稱將會出現在啟動載入器於安裝期間使用的 UI 上。
ApplicationRequiresElevation	選擇性 Boolean 參數。 如果為 true，表示當元件安裝在目標電腦上時會以更高的使用權限執行。
ApplicationUrl	選擇性 String 參數。 指定存放應用程式之安裝程式的 Web 位置。
BootstrapperComponentFiles	選擇性的 String[] 輸出參數。 指定啟動載入器套件檔案的建置位置。
BootstrapperItems	選擇性 ITaskItem[] 參數。 指定要在啟動載入器中建置的產品。 傳遞至此參數的項目必須使用下列語法： <BootstrapperItem Include="ProductCode"> <ProductName> ProductName </ProductName> </BootstrapperItem> Include 屬性是用來表示應該安裝的必要條件的名稱。 ProductName 項目中繼資料是選擇性參數，建置引擎若找不到套件時，可以用來當做使用者易記的名稱。 除非未指定 ApplicationFile，這些項目並非必要的 MSBuild 輸入參數。 您應該為每個必須安裝的應用程式必要條件加上一個項目。 如果未指定 BootstrapperItems 和 ApplicationFile 參數，將會產生建置錯誤。
BootstrapperKeyFile	選擇性 String 輸出參數。 指定 setup.exe 的建置位置
ComponentsLocation	選擇性 String 參數。 為啟動載入器指定一個位置，以便於尋找要安裝的必要條件。 這個參數可能具有下列其中一個值： HomeSite：表示必要條件是由元件廠商控管。 Relative：表示必要條件位於與應用程式相同的位置。 Absolute：表示所有元件都可以在集中式 URL 中找到。 這個值可以和 ComponentsUrl 輸入參數搭配使用。 如果未指定 ComponentsLocation，預設會使用 HomeSite。
ComponentsUrl	選擇性 String 參數。 指定包含安裝必要條件的 URL。
CopyComponents	選擇性 Boolean 參數。 如果為 true，啟動載入器就會將所有的輸出檔複製到 OutputPath 參數指定的路徑。 BootstrapperComponentFiles 參數的值必須全部以這個路徑為基礎。 如果為 false，則不會複製檔案，而且 BootstrapperComponentFiles 值會以 Path 參數的值為基礎。 此參數的預設值為 true。
Culture	選擇性 String 參數。 指定用於啟動載入器 UI 和安裝必要條件的文化特性 (Culture)。 如果指定的文化特性無法使用，此工作就會採用 FallbackCulture 參數的值。
FallbackCulture	選擇性 String 參數。 指定用於啟動載入器 UI 和安裝必要條件的次要文化特性。
OutputPath	選擇性 String 參數。 指定要複製 setup.exe 和所有套件檔案的位置。
Path	選擇性 String 參數。 指定所有可用必要條件套件的位置。
SupportUrl	選擇性 String 參數。 指定萬一啟動載入器安裝失敗時要提供的 URL。
Validate	選擇性 Boolean 參數。 如果為 true，啟動載入器會在指定的輸入啟動載入器項目上執行 XSD 驗證。 此參數的預設值為 false。

備註

除了以上列出的參數之外，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些錯誤碼的清單及其說明，請參閱 TaskExtension 基底類別。

範例

下列範例使用 GenerateBootstrapper 工作來安裝應用程式，而此應用程式必須安裝 .NET Framework 2.0 當做必要條件。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <BootstrapperFile Include="Microsoft.Net.Framework.2.0">
            <ProductName>Microsoft .NET Framework 2.0</ProductName>
        </BootstrapperFile>
    </ItemGroup>

    <Target Name="BuildBootstrapper">
        <GenerateBootstrapper
            ApplicationFile="WindowsApplication1.application"
            ApplicationName="WindowsApplication1"
            ApplicationUrl="http://mycomputer"
            BootstrapperItems="@(BootstrapperFile)"
            OutputPath="C:\output" />
    </Target>

</Project>

請參閱

概念

MSBuild 工作

其他資源

MSBuild 工作參考