GenerateApplicationManifest (attività)

Articolo
08/25/2023

Genera un manifesto dell'applicazione ClickOnce o un manifesto nativo. Un manifesto nativo descrive un componente definendo un'identità univoca per il componente e identificando tutti gli assembly e i file che costituiscono il componente. Un manifesto dell'applicazione ClickOnce estende un manifesto nativo indicando il punto di ingresso dell'applicazione e specificando il livello di sicurezza dell'applicazione.

Parametri

La tabella seguente descrive i parametri dell'attività GenerateApplicationManifest.

Parametro	Descrizione
`AssemblyName`	Parametro `String` facoltativo. Specifica il campo `Name` relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non è specificato, il nome viene dedotto dal parametro `EntryPoint` o `InputManifest`. Se non è possibile creare alcun nome, l'attività genera un errore.
`AssemblyVersion`	Parametro `String` facoltativo. Specifica il campo `Version` relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non è specificato, viene usato il valore predefinito "1.0.0.0".
`ClrVersion`	Parametro `String` facoltativo. Specifica la versione minima di Common Language Runtime (CLR) richiesta dall'applicazione. Il valore predefinito è la versione di CLR usata dal sistema di compilazione. Se l'attività genera un manifesto nativo, questo parametro viene ignorato.
`ConfigFile`	Parametro ITaskItem`[]` facoltativo. Specifica l'elemento che contiene il file di configurazione dell'applicazione. Se l'attività genera un manifesto nativo, questo parametro viene ignorato.
`Dependencies`	Parametro ITaskItem`[]` facoltativo. Specifica un elenco di elementi che definisce il set di assembly dipendenti per il manifesto generato. Ogni elemento può essere ulteriormente descritto dai metadati dell'elemento per indicare informazioni aggiuntive sullo stato della distribuzione e il tipo di dipendenza. Per altre informazioni, vedere Metadati degli elementi.
`Description`	Parametro `String` facoltativo. Specifica la descrizione per l'applicazione o il componente.
`EntryPoint`	Parametro ITaskItem`[]` facoltativo. Specifica un singolo elemento che indica il punto di ingresso per l'assembly del manifesto generato. Per un manifesto dell'applicazione ClickOnce, questo parametro specifica l'assembly che viene avviato quando viene eseguita l'applicazione.
`ErrorReportUrl`	Parametro System.String facoltativo. Specifica l'URL della pagina Web visualizzata nelle finestre di dialogo durante le segnalazioni di errori nelle installazioni ClickOnce.
`FileAssociations`	Parametro ITaskItem`[]` facoltativo. Specifica un elenco di uno o più tipi di file associati al manifesto della distribuzione ClickOnce. Le associazioni di file sono valide solo quando la destinazione è .NET Framework 3.5 o versione successiva.
`Files`	Parametro ITaskItem`[]` facoltativo. I file da includere nel manifesto. Specificare il percorso completo per ogni file.
`HostInBrowser`	Parametro Boolean facoltativo. Se `true`, l'applicazione è ospitata in un browser (come le applicazioni Web Browser WPF).
`IconFile`	Parametro ITaskItem`[]` facoltativo. Indica il file dell'icona dell'applicazione. L'icona dell'applicazione è espressa nel manifesto dell'applicazione generato e viene usata per il menu Start e la finestra di dialogo Installazione applicazioni. Se questo input non viene specificato, viene usata un'icona predefinita. Se l'attività genera un manifesto nativo, questo parametro viene ignorato.
`InputManifest`	Parametro ITaskItem facoltativo. Indica un documento XML di input da usare come base per il generatore del manifesto. In questo modo è possibile applicare nel manifesto di output dati strutturati, ad esempio definizioni della protezione dell'applicazione o definizioni del manifesto personalizzate. L'elemento radice del documento XML deve essere un nodo assembly nello spazio dei nomi asmv1.
`IsolatedComReferences`	Parametro ITaskItem`[]` facoltativo. Specifica i componenti COM da isolare nel manifesto generato. Questo parametro supporta la possibilità di isolare i componenti COM per la distribuzione di "COM senza registrazione". Funziona generando automaticamente un manifesto con definizioni di registrazione COM standard. Tuttavia, i componenti COM devono essere registrati nel computer di compilazione per garantire il funzionamento corretto.
`LauncherBasedDeployment`	Parametro booleano facoltativo. Impostare questa opzione su `True` durante la compilazione per .NET Core 3.1, .NET 5 e versioni successive per assicurarsi che l'eseguibile dell'applicazione venga rinominato nel nome eseguibile previsto dopo la compilazione dell'eseguibile dell'host dell'applicazione apphost.exe.
`ManifestType`	Parametro `String` facoltativo. Specifica il tipo di manifesto da generare. Per il parametro è possibile specificare i valori seguenti: - `Native` - `ClickOnce` Se questo parametro non è specificato, l'attività usa il valore predefinito `ClickOnce`.
`MaxTargetPath`	Parametro `String` facoltativo. Specifica la lunghezza massima consentita di un percorso di file in una distribuzione dell'applicazione ClickOnce. Se questo valore è specificato, viene verificata la lunghezza di ogni percorso di file nell'applicazione rispetto a questo limite. Per tutti gli elementi che superano il limite verrà generato un avviso di compilazione. Se questo input non è specificato o è uguale a zero, non viene eseguita alcuna verifica. Se l'attività genera un manifesto nativo, questo parametro viene ignorato.
`OSVersion`	Parametro `String` facoltativo. Specifica la versione minima del sistema operativo richiesta dall'applicazione. Se questo parametro non viene specificato, viene usato il valore "4.10.0.0", il sistema operativo minimo supportato di .NET Framework. Se l'attività genera un manifesto nativo, questo input viene ignorato.
`OutputManifest`	Parametro di output ITaskItem facoltativo. Specifica il nome del file del manifesto di output generato. Se questo parametro non è specificato, il nome del file di output viene dedotto dall'identità del manifesto generato.
`Platform`	Parametro `String` facoltativo. Specifica la piattaforma di destinazione dell'applicazione. Per il parametro è possibile specificare i valori seguenti: - `AnyCPU` - `x86` - `x64` - `Itanium` Se questo parametro non è specificato, l'attività usa il valore predefinito `AnyCPU`.
`Product`	Parametro `String` facoltativo. Specifica il nome dell'applicazione. Se questo parametro non è specificato, il nome viene dedotto dall'identità del manifesto generato. Questo nome viene usato per il collegamento nel menu Start e fa parte del nome visualizzato nella finestra di dialogo Installazione applicazioni.
`Publisher`	Parametro `String` facoltativo. Specifica l'editore dell'applicazione. Se questo parametro non è specificato, il nome viene dedotto dall'utente registrato o dall'identità del manifesto generato. Questo nome viene usato per la cartella nel menu Start e fa parte del nome visualizzato nella finestra di dialogo Installazione applicazioni.
`RequiresMinimumFramework35SP1`	Parametro `Boolean` facoltativo. Se true, l'applicazione richiede .NET Framework 3.5 SP1 o una versione più recente.
`TargetCulture`	Parametro `String` facoltativo. Identifica le impostazioni cultura dell'applicazione e specifica il campo `Language` relativo all'identità dell'assembly per il manifesto generato. Se questo parametro non viene specificato, si presuppone che l'applicazione sia indipendente dalle impostazioni cultura.
`TargetFrameworkMoniker`	Parametro `String` facoltativo. Specifica il moniker del framework di destinazione.
`TargetFrameworkProfile`	Parametro `String` facoltativo. Specifica il profilo del framework di destinazione.
`TargetFrameworkSubset`	Parametro `String` facoltativo. Specifica il nome del subset di .NET Framework da usare come destinazione.
`TargetFrameworkVersion`	Parametro `String` facoltativo. Specifica la versione di .NET Framework di destinazione del progetto.
`TrustInfoFile`	Parametro ITaskItem facoltativo. Indica un documento XML che specifica la sicurezza dell'applicazione. L'elemento radice del documento XML deve essere un nodo trustInfo nello spazio dei nomi asmv2. Se l'attività genera un manifesto nativo, questo parametro viene ignorato.
`UseApplicationTrust`	Parametro `Boolean` facoltativo. Se true, le proprietà `Product`, `Publisher` e `SupportUrl` vengono scritte nel manifesto dell'applicazione.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe GenerateManifestBase, che a sua volta eredita dalla classe Task. Per un elenco dei parametri della classe Task, vedere Classe di base Task.

Per informazioni sull'uso dell'attività GenerateDeploymentManifest, vedere Attività GenerateApplicationManifest.

Gli input per i file e le dipendenze possono essere ulteriormente decorati con i metadati dell'elemento per specificare informazioni aggiuntive sullo stato di ogni elemento.

Metadati degli elementi

Nome dei metadati	Descrizione
`DependencyType`	Indica se la dipendenza è pubblicata e installata con l'applicazione o un prerequisito. Questi metadati sono validi per tutte le dipendenze, ma non vengono usati per i file. I valori disponibili per questi metadati sono: - `Install` - `Prerequisite` Install è il valore predefinito.
`AssemblyType`	Indica se la dipendenza è un assembly gestito o nativo. Questi metadati sono validi per tutte le dipendenze, ma non vengono usati per i file. I valori disponibili per questi metadati sono: - `Managed` - `Native` - `Unspecified` `Unspecified` è il valore predefinito, che indica che il generatore del manifesto determina automaticamente il tipo di assembly.
`Group`	Indica il gruppo per il download dei file aggiuntivi su richiesta. Il nome del gruppo è definito dall'applicazione e può essere qualsiasi stringa. Una stringa vuota indica che il file non fa parte di un gruppo di download, che è l'impostazione predefinita. File non inseriti in un gruppo fanno parte del download iniziale dell'applicazione. I file di un gruppo vengono scaricati solo se richiesti in modo esplicito dall'applicazione con System.Deployment.Application. Questi metadati sono validi per tutti i file in cui `IsDataFile` è `false` e tutte le dipendenze in cui `DependencyType` è `Install`.
`TargetPath`	Specifica il modo in cui il percorso deve essere definito nel manifesto generato. Questo attributo è valido per tutti i file. Se questo attributo non viene specificato, viene usata la specifica dell'elemento, Questo attributo è valido per tutti i file e le dipendenze con un valore `DependencyType` pari a `Install`.
`IsDataFile`	Valore di metadati `Boolean` che indica se il file è o non è un file di dati. Un file di dati è speciale poiché viene migrato tra gli aggiornamenti dell'applicazione. Questi metadati sono validi solo per i file. `False` è il valore predefinito.

Esempio 1

Questo esempio usa l'attività GenerateApplicationManifest per generare un manifesto dell'applicazione ClickOnce e l'attività GenerateDeploymentManifest per generare un manifesto di distribuzione per un'applicazione con un singolo assembly. Viene quindi usata l'attività SignFile per firmare i manifesti.

Questo illustra lo scenario di generazione del manifesto più semplice possibile in cui vengono generati manifesti ClickOnce per un singolo programma. Un nome e un'identità predefiniti vengono dedotti dall'assembly per il manifesto.

Nota

Nell'esempio seguente tutti i file binari dell'applicazione sono precompilati in modo che sia possibile concentrarsi sugli aspetti della generazione del manifesto. Questo esempio produce una distribuzione ClickOnce completamente funzionante.

Nota

Per altre informazioni sulla proprietà Thumbprint usata nell'attività SignFile in questo esempio, vedere l'attività SignFile.

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

Esempio 2

Questo esempio usa le GenerateApplicationManifest attività e GenerateDeploymentManifest per generare manifesti dell'applicazione e della distribuzione ClickOnce per un'applicazione con un singolo assembly, specificando il nome e l'identità dei manifesti.

Questo esempio è simile all'esempio precedente, ma il nome e l'identità dei manifesti vengono specificati in modo esplicito. Inoltre, questo esempio è configurato come applicazione online, anziché come applicazione installata.

Nota

Per altre informazioni sulla proprietà Thumbprint usata nell'attività SignFile in questo esempio, vedere l'attività SignFile.

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

Esempio 3

Nota

Per altre informazioni sulla proprietà Thumbprint usata nell'attività SignFile in questo esempio, vedere l'attività SignFile.

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

Esempio 4

In questo esempio viene usata l'attività GenerateApplicationManifest per generare un manifesto nativo per l'applicazione Test.exe, facendo riferimento al componente nativo Alpha.dll e al componente COM isolato Bravo.dll.

L'esempio produce l'oggetto Test.exe.manifest, che rende l'applicazione XCOPY distribuibile sfruttando COM senza registrazione.

Nota

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

GenerateApplicationManifest (attività)

Parametri

Osservazioni:

Metadati degli elementi

Esempio 1

Esempio 2

Esempio 3

Esempio 4

Vedi anche

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive