Aracılığıyla paylaş

GenerateApplicationManifest görev

  • Makale

Oluşturduğu bir ClickOnce uygulama bildirimi ya da yerel bir bildirim. Doğal bir bildirim bileşeni bileşen için benzersiz bir kimlik tanımlama ve tüm Derlemeler ve bileşen dosyaları tanımlamak açıklar. A ClickOnce uygulama bildirimi uygulamasının giriş noktasını gösteren ve uygulama güvenlik düzeyini belirten doğal bildirim genişletir.

Parametreler

Aşağıdaki tabloda parametrelerini açıklar GenerateApplicationManifest görevi.

Parametre

Description

AssemblyName

İsteğe bağlı String parametresi.

Belirtir Name üretilen bildirim için derleme Kimliği alanının. Bu parametre belirtilmezse, adı tarafından algılanır EntryPoint veya InputManifest parametreleri. İsimsiz oluşturulabilir, görevi bir hata atar.

AssemblyVersion

İsteğe bağlı String parametresi.

Belirtir Version üretilen bildirim için derleme Kimliği alanının. Bu parametre belirtilmezse, varsayılan değer "1.0.0.0" olarak kullanılır.

ClrVersion

İsteğe bağlı String parametresi.

En küçük sürüm, ortak dil çalışma zamanı (uygulama tarafından gerekli clr) belirtir. clr sürümü oluþturma sistemi tarafından kullanılan varsayılan değerdir. Görev yerel bildirim oluşturuyorsa, bu parametre yoksayılır.

ConfigFile

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

Uygulama yapılandırma dosyasına hangi madde içerdiğini belirtir. Görev yerel bildirim oluşturuyorsa, bu parametre yoksayılır.

Dependencies

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

Bağımlı derlemelerin için üretilen bildirim kümesini tanımlayan bir öğe listesi belirtir. Her madde daha fazla ek dağıtım durumu ve yükleme türünü belirtmek için öğe meta tarafından açıklanan. Daha fazla bilgi için aşağıdaki "Öğe meta" bölümüne bakın.

Description

İsteğe bağlı String parametresi.

Uygulamanın veya bileşenin açıklamasını belirtir.

EntryPoint

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

Giriş noktası için üretilen bildirim derlemesi gösteren tek bir öğeyi belirtir.

İçin bir ClickOnce uygulama bildirimi, bu parametre, uygulamayı çalıştırdığınızda başlatan derleme belirtir.

ErrorReportUrl

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

Hata raporlarına ClickOnce yüklemeler sırasında iletişim kutularında görüntülenen Web sayfası URL'sini belirtir.

FileAssociations

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

ClickOnce dağıtım listesi ile ilişkili bir veya daha fazla dosya türü listesini belirtir.

Dosya ilişkilendirmelerini tek tek geçerli olduğunda.net Framework 3.5 veya sonraki hedeflemektedir.

Files

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

Bildirimde İçerilecek dosyalar. Her dosyanın tam yolunu belirtin.

HostInBrowser

İsteğe bağlı [Boolean] parametresi.

true, (wpf Web tarayıcısı uygulamaları gibi) uygulama tarayıcı içinde barındırılan.

IconFile

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

Uygulama simge dosyasını gösterir. Uygulama simgesi oluşturulan uygulama bildiriminde ifade ve Başlat menüsü ve Program Ekle/Kaldır iletişim için kullanılır. Bu giriş belirtilmemişse, varsayılan simge kullanılır. Görev yerel bildirim oluşturuyorsa, bu parametre yoksayılır.

InputManifest

İsteğe bağlı ITaskItem parametresi.

Liste Oluşturucu için temel olarak hizmet verecek bir giriş xml belgesini gösterir. Bu uygulama güvenliği veya çıktı bildiriminde yansıtılması için özel liste tanımları gibi yapılandırılmış veri sağlar. xml belgesinin kök öğesinde asmv1 ad alanında bir derleme düğümü olmalıdır.

IsolatedComReferences

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

Oluşturulan bildiriminde yalıtmak için com bileşenleri belirtir. Bu parametre "Ücretsiz kayıt com" dağıtım için com bileşenleri izole yeteneğini destekler. Auto-standart com kayıt tanımları içeren bir liste oluşturarak çalışır. Ancak, com bileşenleri bunu düzgün çalışabilmesi yapı makinede kaydedilmesi gerekir.

ManifestType

İsteğe bağlı String parametresi.

Üretmek için bildirim türünü belirtir. Bu parametreyi aşağıdaki değerleri içerebilir:

  • Native

  • ClickOnce

Bu parametre belirtilmezse, görev için varsayılan olarak ClickOnce.

MaxTargetPath

İsteğe bağlı String parametresi.

Bir dosya yolu izin verilen en fazla uzunluğunu belirtir bir ClickOnce uygulama dağıtımı. Bu değer belirtilirse, uygulamadaki her dosya yolunun uzunluğu bu limitine karşı denetlenir. Sınırı aşan öğeleri içinde yapım uyarısı yükseltecektir. Bu giriş belirtilmemişse veya sıfır değilse, daha sonra hiçbir denetimi yapılmaz. Görev yerel bildirim oluşturuyorsa, bu parametre yoksayılır.

OSVersion

İsteğe bağlı String parametresi.

Uygulama için gereken minimum gerekli işletim sistemi (os) sürümünü belirtir. Örneğin, Windows xp işletim sistemi olan "5.1.2600.0" değerini gösterir. Bu parametre belirtilmezse, Windows 98 İkinci Sürüm gösterir "4.10.0.0" değeri kullanılır, işletim sistemi, en az desteklenen.net Framework. Görev yerel bildirim oluşturuyorsa, bu giriş dikkate alınmaz.

OutputManifest

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

Oluşturulan çıktı bildirim dosyası adını belirtir. Bu parametre belirtilmezse, çıktı dosyası adı üretilen bildirim kimlikten algılanır.

Platform

İsteğe bağlı String parametresi.

Hedef platform uygulamanın belirtir. Bu parametreyi aşağıdaki değerleri içerebilir:

  • AnyCPU

  • x86

  • x64

  • Itanium

Bu parametre belirtilmezse, görev için varsayılan olarak AnyCPU.

Product

İsteğe bağlı String parametresi.

Uygulamanın adını belirtir. Bu parametre belirtilmezse, adı üretilen bildirim kimlikten algılanır. Bu ad, Başlat menüsündeki kısayol adı kullanılır ve Program Ekle veya Kaldır iletişim kutusunda görünen adı bir parçasıdır.

Publisher

İsteğe bağlı String parametresi.

Publisher uygulamasının belirtir. Bu parametre belirtilmezse, adı kayıtlı kullanıcı veya üretilen bildirim kimliğini algılanır. Bu ad, Başlat menüsündeki klasör adı kullanılır ve Program Ekle veya Kaldır iletişim kutusunda görünen adı bir parçasıdır.

RequiresMinimumFramework35SP1

İsteğe bağlı Boolean parametresi.

TRUE, uygulamayı gerektiriyorsa.net Framework 3.5 SP1 veya daha yeni bir sürümü.

TargetCulture

İsteğe bağlı String parametresi.

Uygulamanın kültür tanımlar ve belirtir Language üretilen bildirim için derleme Kimliği alanının. Bu parametre belirtilmezse, uygulama kültür sabit olduğu varsayılır.

TargetFrameworkMoniker

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

Hedef çerçevesi takma adını belirtir.

TargetFrameworkProfile

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

Hedef çerçevesi profilini belirtir.

TargetFrameworkSubset

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

Adını belirtir.net Framework alt hedef.

TargetFrameworkVersion

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

Hedefi belirtir.net Framework proje.

TrustInfoFile

İsteğe bağlı ITaskItem parametresi.

Uygulama güvenliği belirtir bir xml belgesini gösterir. xml belgesinin kök öğesinde asmv2 ad alanında trustInfo düğümü olmalıdır. Görev yerel bildirim oluşturuyorsa, bu parametre yoksayılır.

UseApplicationTrust

İsteğe bağlı [Boolean] parametresi.

TRUE ise, Product, Publisher, ve SupportUrl özellikleri, uygulama bildirimi yazılır.

Notlar

Yukarıda listelenen parametrelere ek olarak, bu görevi parametrelerinden devralan GenerateManifest kendisinde sınıfı miras Task sınıfı. Görev sınıfı parametrelerinin bir listesi için bkz: Görev temel sınıfı.

Nasıl kullanılacağı hakkında bilgi için GenerateDeploymentManifest görev için bkz: GenerateApplicationManifest görev.

Her madde için ek dağıtım durumunu belirtmek için öğe meta verilerle bağımlılıkları ve dosyalar için girişleri daha donatılmış.

Öğe meta

Meta veri adı

Description

DependencyType

Bağımlılık yayımlanan ve uygulama ya da bir önkoşul yüklü olup olmadığını gösterir. Bu meta verileri tüm bağımlılıkları için geçerlidir, ancak dosyalar için kullanılmaz. Bu meta verileri için kullanılabilir değerler:

  • Install

  • Prerequisite

Yükleme varsayılan değerdir.

AssemblyType

Bağımlılık bir yönetilen olup olmadığını veya yerel bir derleme gösterir. Bu meta verileri tüm bağımlılıkları için geçerlidir, ancak dosyalar için kullanılmaz. Bu meta verileri için kullanılabilir değerler:

  • Managed

  • Native

  • Unspecified

UnspecifiedListe Oluşturucu derleme türü otomatik olarak belirleyecek belirten varsayılan değerdir.

Group

Grup istee ek dosyaları karşıdan yüklemek için gösterir. Grup adı uygulama tarafından tanımlanan ve herhangi bir dize olabilir. Boş bir dize dosya varsayılan yükleme grubunun bir parçası olduğunu gösterir. Dosyaları bir gruptaki ilk uygulama yükleme bir parçasıdır. Bir grup içindeki dosyaları açıkça uygulamasını kullanarak istendiğinde yalnızca yüklenir System.Deployment.Application.

Bu meta verileri tüm dosyalar için geçerli olan nerede IsDataFile olan false ve tüm bağımlılıkları nerede DependencyType olan Install.

TargetPath

Yol içinde üretilen bildirim nasıl tanımlanmalıdır belirtir. Bu öznitelik, tüm dosyalar için geçerlidir. Bu öznitelik belirtilmezse, öğe belirtimi kullanılır. Bu öznitelik tüm dosya ve bağımlılıklar içeren geçerli bir DependencyType değeri Install.

IsDataFile

A Boolean dosyası, bir veri dosyası olup olmadığını gösterir meta veri değeri. Uygulama güncelleştirmeleri arasında geçirilen bir veri dosyası özel olmamasıdır. Bu meta verileri, yalnızca dosyalar için geçerlidir. False varsayılan değerdir.

Örnek

Bu örnek GenerateApplicationManifest görev oluşturmak için bir ClickOnce uygulama bildirimi ve GenerateDeploymentManifest bir uygulamanın tek bir derleme ile dağıtım listesi oluşturmak için görev. Daha sonra kullanır SignFile bildirimlerin imzalamak için görev.

Bu basit olası bildirim oluşturma senaryosu gösterilmektedir nerede ClickOnce bildirimlerin, tek bir program için oluşturulur. Varsayılan adı ve kimlik bildirimi için derleme algılanır.

Not

Aşağıdaki örnekte, tüm uygulama ikili bildirim oluşturma yönleri üzerinde odaklanmak için önceden oluşturulmuş.Bu örnek bir çalışma tam olarak üreten ClickOnce dağıtım.

Not

Daha fazla bilgi için Thumbprint kullanılan özellik SignFile Bu örnekte görev, bkz: SignFile görev.

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

    <ItemGroup>
        <EntryPoint Include="SimpleWinApp.exe" />
    </ItemGroup>

    <PropertyGroup>
        <Thumbprint>
             <!-- Insert generated thumbprint here -->
        </Thumbprint>
    </PropertyGroup>

    <Target Name="Build">

        <GenerateApplicationManifest
            EntryPoint="@(EntryPoint)">
            <Output
                ItemName="ApplicationManifest"
                TaskParameter="OutputManifest"/>
        </GenerateApplicationManifest>

        <GenerateDeploymentManifest
            EntryPoint="@(ApplicationManifest)">
            <Output
                ItemName="DeployManifest"
                TaskParameter="OutputManifest"/>
        </GenerateDeploymentManifest>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(ApplicationManifest)"/>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(DeployManifest)"/>

    </Target>
</Project>

Bu örnek GenerateApplicationManifest ve GenerateDeploymentManifest görevler oluşturmak için ClickOnce uygulama ve dağıtım bildirimler uygulamanın adı ve bildirimlerin kimliğini belirleyen tek bir derleme ile.

Adını ve kimliğini bildirimlerin açıkça belirtilen dışında bu önceki örnektekine benzer bir örnektir. Ayrıca, bu örnek, yüklü bir uygulama yerine çevrimiçi bir uygulama olarak yapılandırılır.

Not

Aşağıdaki örnekte, tüm uygulama ikili bildirim oluşturma yönleri üzerinde odaklanmak için önceden oluşturulmuş.Bu örnek bir çalışma tam olarak üreten ClickOnce dağıtım.

Not

Daha fazla bilgi için Thumbprint kullanılan özellik SignFile Bu örnekte görev, bkz: SignFile görev.

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

    <ItemGroup>
        <EntryPoint Include="SimpleWinApp.exe" />
    </ItemGroup>

    <PropertyGroup>
        <Thumbprint>
             <!-- Insert generated thumbprint here -->
        </Thumbprint>
    </PropertyGroup>

    <Target Name="Build">

        <GenerateApplicationManifest
            AssemblyName="SimpleWinApp.exe"
            AssemblyVersion="1.0.0.0"
            EntryPoint="@(EntryPoint)"
            OutputManifest="SimpleWinApp.exe.manifest">
            <Output
                ItemName="ApplicationManifest"
                TaskParameter="OutputManifest"/>
        </GenerateApplicationManifest>

        <GenerateDeploymentManifest
                AssemblyName="SimpleWinApp.application"
                AssemblyVersion="1.0.0.0"
                EntryPoint="@(ApplicationManifest)"
                Install="false"
                OutputManifest="SimpleWinApp.application">
                <Output
                    ItemName="DeployManifest"
                    TaskParameter="OutputManifest"/>
        </GenerateDeploymentManifest>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(ApplicationManifest)"/>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(DeployManifest)"/>

    </Target>
</Project>

Bu örnek GenerateApplicationManifest ve GenerateDeploymentManifest görevler oluşturmak için ClickOnce uygulama ve dağıtım bildirimler için uygulama birden çok dosya ve derlemeler.

Not

Aşağıdaki örnekte, tüm uygulama ikili bildirim oluşturma yönleri üzerinde odaklanmak için önceden oluşturulmuş.Bu örnek bir çalışma tam olarak üreten ClickOnce dağıtım.

Not

Daha fazla bilgi için Thumbprint kullanılan özellik SignFile Bu örnekte görev, bkz: SignFile görev.

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

    <ItemGroup>
        <EntryPoint Include="SimpleWinApp.exe" />
    </ItemGroup>

    <PropertyGroup>
        <Thumbprint>
             <!-- Insert generated thumbprint here -->
        </Thumbprint>
        <DeployUrl>
            <!-- Insert the deployment URL here -->
        </DeployUrl>
        <SupportUrl>
            <!-- Insert the support URL here -->
        </SupportUrl>
    </PropertyGroup>

    <Target Name="Build">

    <ItemGroup>
        <EntryPoint Include="SimpleWinApp.exe"/>
        <Dependency Include="ClassLibrary1.dll">
            <AssemblyType>Managed</AssemblyType>
            <DependencyType>Install</DependencyType>
        </Dependency>
        <Dependency Include="ClassLibrary2.dll">
            <AssemblyType>Managed</AssemblyType>
            <DependencyType>Install</DependencyType>
            <Group>Secondary</Group>
        </Dependency>
        <Dependency Include="MyAddIn1.dll">
            <AssemblyType>Managed</AssemblyType>
            <DependencyType>Install</DependencyType>
            <TargetPath>Addins\MyAddIn1.dll</TargetPath>
        </Dependency>
        <Dependency Include="ClassLibrary3.dll">
            <AssemblyType>Managed</AssemblyType>
            <DependencyType>Prerequisite</DependencyType>
        </Dependency>

        <File Include="Text1.txt">
            <TargetPath>Text\Text1.txt</TargetPath>
            <Group>Text</Group>
        </File>
        <File Include="DataFile1.xml ">
            <TargetPath>Data\DataFile1.xml</TargetPath>
            <IsDataFile>true</IsDataFile>
        </File>

        <IconFile Include="Heart.ico"/>
        <ConfigFile Include="app.config">
            <TargetPath>SimpleWinApp.exe.config</TargetPath>
        </ConfigFile>
        <BaseManifest Include="app.manifest"/>
    </ItemGroup>

    <Target Name="Build">

        <GenerateApplicationManifest
            AssemblyName="SimpleWinApp.exe"
            AssemblyVersion="1.0.0.0"
            ConfigFile="@(ConfigFile)"
            Dependencies="@(Dependency)"
            Description="TestApp"
            EntryPoint="@(EntryPoint)"
            Files="@(File)"
            IconFile="@(IconFile)"
            InputManifest="@(BaseManifest)"
            OutputManifest="SimpleWinApp.exe.manifest">
            <Output
                ItemName="ApplicationManifest"
                TaskParameter="OutputManifest"/>
        </GenerateApplicationManifest>

        <GenerateDeploymentManifest
            AssemblyName="SimpleWinApp.application"
            AssemblyVersion="1.0.0.0"
            DeploymentUrl="$(DeployToUrl)"
            Description="TestDeploy"
            EntryPoint="@(ApplicationManifest)"
            Install="true"
            OutputManifest="SimpleWinApp.application"
            Product="SimpleWinApp"
            Publisher="Microsoft"
            SupportUrl="$(SupportUrl)"
            UpdateEnabled="true"
            UpdateInterval="3"
            UpdateMode="Background"
            UpdateUnit="weeks">
            <Output
                ItemName="DeployManifest"
                TaskParameter="OutputManifest"/>
        </GenerateDeploymentManifest>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(ApplicationManifest)"/>

        <SignFile
            CertificateThumbprint="$(Thumbprint)"
            SigningTarget="@(DeployManifest)"/>

    </Target>
</Project>

Bu örnek GenerateApplicationManifest uygulama Test.exe, doğal bileşeni Alpha.dll ve yalıtılmış bir com bileşeni Bravo.dll baþvurmak için doğal bir liste oluşturmak için görev.

Bu örnek uygulama xcopy dağıtılabilir yararlanarak boş COM kayıt yapma Test.exe.manifest üretir.

Not

Aşağıdaki örnekte, tüm uygulama ikili bildirim oluşturma yönleri üzerinde odaklanmak için önceden oluşturulmuş.Bu örnek bir çalışma tam olarak üreten ClickOnce dağıtım.

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

    <ItemGroup>
        <File Include="Test.exe" />
        <Dependency Include="Alpha.dll">
            <AssemblyType>Native</AssemblyType>
            <DependencyType>Install</DependencyType>
        </Dependency>
        <ComComponent Include="Bravo.dll" />
    </ItemGroup>

    <Target Name="Build">
        <GenerateApplicationManifest
            AssemblyName="Test.exe"
            AssemblyVersion="1.0.0.0"
            Dependencies="@(Dependency)"
            Files="@(File)"
            IsolatedComReferences="@(ComComponent)"
            ManifestType="Native">
            <Output
                ItemName="ApplicationManifest"
                TaskParameter="OutputManifest"/>
        </GenerateApplicationManifest>

    </Target>
</Project>

Ayrıca bkz.

Başvuru

GenerateDeploymentManifest görev

SignFile görev

Kavramlar

MSBuild görevleri

Diğer Kaynaklar

MSBuild görevi başvurusu