GenerateBootstrapper görevi

  • Makale

Bir uygulamayı ve önkoşullarını algılamak, indirmek ve yüklemek için otomatik bir yol sağlar. Bir uygulamayı oluşturan tüm bileşenler için ayrı yükleyicileri tümleştiren tek bir yükleyici işlevi görür.

Görev parametreleri

Aşağıda görevin parametreleri GenerateBootstrapper açıklanmaktadır.

  • ApplicationFile

    İsteğe bağlı String parametre.

    Önyükleyicinin tüm önkoşullar yüklendikten sonra uygulamanın yüklenmesine başlamak için kullanacağı dosyayı belirtir. Ne ne de BootstrapperItemsApplicationFile parametresi belirtilmezse bir derleme hatası oluşur.

  • ApplicationName

    İsteğe bağlı String parametre.

    Önyükleyicinin yükleyeceği uygulamanın adını belirtir. Bu ad, önyükleyicinin yükleme sırasında kullandığı kullanıcı arabiriminde görünür.

  • ApplicationRequiresElevation

    İsteğe bağlı Boolean parametre.

    ise true, bileşen hedef bilgisayara yüklendiğinde yükseltilmiş izinlerle çalışır.

  • ApplicationUrl

    İsteğe bağlı String parametre.

    Uygulamanın yükleyicisini barındıran Web konumunu belirtir.

  • BootstrapperComponentFiles

    İsteğe bağlı String[] çıkış parametresi.

    Önyükleyici paket dosyalarının yerleşik konumunu belirtir.

  • BootstrapperItems

    İsteğe bağlı ITaskItem[] parametre.

    Önyükleyiciye eklenecek ürünleri belirtir. Bu parametreye geçirilen öğeler aşağıdaki söz dizimine sahip olmalıdır:

    <BootstrapperItem
    Include="ProductCode">
    <ProductName>
        ProductName
    </ProductName>
</BootstrapperItem>

    Include özniteliği, yüklenmesi gereken bir önkoşulun adını temsil eder. ProductName Öğe meta verileri isteğe bağlıdır ve paket bulunamazsa derleme altyapısı tarafından kullanıcı dostu bir ad olarak kullanılır. Bu öğeler, belirtilmediği sürece MSBuild giriş parametrelerine gerek yoktur ApplicationFile . Uygulamanız için yüklenmesi gereken her önkoşul için bir öğe eklemelisiniz.

    Ne ne de BootstrapperItemsApplicationFile parametresi belirtilmezse bir derleme hatası oluşur.

  • BootstrapperKeyFile

    İsteğe bağlı String çıkış parametresi.

    setup.exe dosyasının yerleşik konumunu belirtir

  • ComponentsLocation

    İsteğe bağlı String parametre.

    Önyükleyicinin yüklenecek yükleme önkoşullarını araması için bir konum belirtir. Bu parametre aşağıdaki değerlere sahip olabilir:

    • HomeSite: Önkoşulların bileşen satıcısı tarafından barındırıldığını gösterir.

    • Relative: Önkoşulun uygulamanın aynı konumunda olduğunu gösterir.

    • Absolute: Tüm bileşenlerin merkezi bir URL'de bulunup bulunmadığını gösterir. Bu değer giriş parametresiyle ComponentsUrl birlikte kullanılmalıdır.

      Belirtilmezse ComponentsLocation , HomeSite varsayılan olarak kullanılır.

  • ComponentsUrl

    İsteğe bağlı String parametre.

    Yükleme önkoşullarını içeren URL'yi belirtir.

  • CopyComponents

    İsteğe bağlı Boolean parametre.

    ise true, önyükleyici tüm çıkış dosyalarını parametresinde OutputPath belirtilen yola kopyalar. parametre değerlerinin BootstrapperComponentFiles tümü bu yola dayalı olmalıdır. ise false, dosyalar kopyalanmaz ve BootstrapperComponentFiles değerler parametresinin Path değerini temel alır. Bu parametrenin varsayılan değeridir true.

  • Culture

    İsteğe bağlı String parametre.

    Önyükleyici kullanıcı arabirimi ve yükleme önkoşulları için kullanılacak kültürü belirtir. Belirtilen kültür kullanılamıyorsa, görev parametresinin FallbackCulture değerini kullanır.

  • FallbackCulture

    İsteğe bağlı String parametre.

    Önyükleyici kullanıcı arabirimi ve yükleme önkoşulları için kullanılacak ikincil kültürü belirtir.

  • OutputPath

    İsteğe bağlı String parametre.

    setup.exe dosyasının ve tüm paket dosyalarının kopyalanacak konumu belirtir.

  • Path

    İsteğe bağlı String parametre.

    Kullanılabilir tüm önkoşul paketlerinin konumunu belirtir.

  • SupportUrl

    İsteğe bağlı String parametre.

    Önyükleyici yüklemesi başarısız olursa sağlayabilecek URL'yi belirtir.

  • Validate

    İsteğe bağlı Boolean parametre.

    ise true, önyükleyici belirtilen giriş önyükleyici öğelerinde XSD doğrulaması gerçekleştirir. Bu parametrenin varsayılan değeridir false.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki örnek, önkoşul olarak .NET Framework 2.0 yüklü olması gereken bir uygulamayı yüklemek için görevini kullanır GenerateBootstrapper .

<Project xmlns="http://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>

Ayrıca bkz.