Condividi tramite

Attività AL (Assembly Linker)

  • Articolo

Aggiornamento: novembre 2007

L'attività AL esegue il wrapping di AL.exe, uno strumento distribuito con .NET Framework SDK. Lo strumento Assembly Linker consente di creare un assembly con un manifesto a partire da uno o più moduli o file di risorse. Poiché è possibile che negli ambienti di compilazione e sviluppo queste funzionalità siano già disponibili, spesso non è necessario utilizzare direttamente questa attività. Assembly Linker è particolarmente utile per gli sviluppatori che hanno la necessità di creare un unico assembly da più file di componenti, ad esempio quelli che possono essere prodotti dallo sviluppo in linguaggi misti. Questa attività non combina i moduli in un unico file assembly. Affinché l'assembly ottenuto venga caricato correttamente, è comunque necessario che i singoli moduli vengano distribuiti e che siano disponibili. Per ulteriori informazioni su AL.exe, vedere Assembly Linker (Al.exe).

Parametri

Nella tabella riportata di seguito sono descritti i parametri dell'attività AL.

Parametro

Descrizione

AlgorithmID

Parametro String facoltativo.

Specifica un algoritmo per generare un hash per tutti i file di un assembly su più file ad eccezione del file contenente il manifesto dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /algid di Assembly Linker (Al.exe).

BaseAddress

Parametro String facoltativo.

Specifica l'indirizzo da utilizzare in fase di esecuzione per il caricamento di una DLL sul computer dell'utente. Il caricamento delle applicazioni risulta più veloce se si specifica l'indirizzo di base delle DLL, poiché non viene affidato al sistema operativo il compito di rilocare le DLL nello spazio di processo. Questo parametro corrisponde all'opzione /base[address] di Assembly Linker (Al.exe).

CompanyName

Parametro String facoltativo.

Specifica una stringa per il campo Company dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /comp[any] di Assembly Linker (Al.exe).

Configuration

Parametro String facoltativo.

Specifica una stringa per il campo Configuration dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /config[uration] di Assembly Linker (Al.exe).

Copyright

Parametro String facoltativo.

Specifica una stringa per il campo Copyright dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /copy[right] di Assembly Linker (Al.exe).

Culture

Parametro String facoltativo.

Specifica la stringa della lingua da associare all'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /c[ulture] di Assembly Linker (Al.exe).

DelaySign

Parametro Boolean facoltativo.

Se il parametro è impostato su true, nell'assembly viene inserita solo la chiave pubblica. Se è impostato su false, l'assembly viene firmato completamente. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /delay[sign] di Assembly Linker (Al.exe).

Description

Parametro String facoltativo.

Specifica una stringa per il campo Description dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /descr[iption] di Assembly Linker (Al.exe).

EmbedResources

Parametro ITaskItem[] facoltativo.

Incorpora le risorse specificate nell'immagine contenente il manifesto dell'assembly. Questa attività copia nell'immagine il contenuto del file di risorse. È possibile che agli elementi passati a questo parametro siano associati metadati facoltativi denominati LogicalName e Access. Il metadato LogicalName viene utilizzato per specificare l'identificatore interno per la risorsa, mentre il metadato Access può essere impostato su private per rendere la risorsa invisibile ad altri assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /embed[resource] di Assembly Linker (Al.exe).

EvidenceFile

Parametro String facoltativo.

Incorpora il file specificato nell'assembly con il nome di risorsa Security.Evidence.

Non è possibile utilizzare il nome Security.Evidence per risorse regolari. Questo parametro corrisponde all'opzione /e[vidence] di Assembly Linker (Al.exe).

ExitCode

Parametro di output di sola lettura Int32 facoltativo.

Specifica il codice di uscita fornito dal comando eseguito.

FileVersion

Parametro String facoltativo.

Specifica una stringa per il campo File Version dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /fileversion di Assembly Linker (Al.exe).

Flags

Parametro String facoltativo.

Specifica un valore per il campo Flags dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /flags di Assembly Linker (Al.exe).

GenerateFullPaths

Parametro Boolean facoltativo.

Determina l'utilizzo del percorso assoluto per tutti i file segnalati in un messaggio di errore. Questo parametro corrisponde all'opzione /fullpaths di Assembly Linker (Al.exe).

KeyContainer

Parametro String facoltativo.

Specifica un contenitore che contiene una coppia di chiavi. Tale parametro firmerà l'assembly, ossia assegnerà a quest'ultimo un nome sicuro, inserendo una chiave pubblica nel manifesto dell'assembly. L'assembly finale verrà quindi firmato con la chiave privata. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /keyn[ame] di Assembly Linker (Al.exe).

KeyFile

Parametro String facoltativo.

Specifica un file contenente una coppia di chiavi o solo una chiave pubblica da utilizzare per la firma di un assembly. Durante la compilazione la chiave pubblica verrà inserita nel manifesto dell'assembly, mentre l'assembly finale verrà firmato con la chiave privata. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /keyf[ile] di Assembly Linker (Al.exe).

LinkResources

Parametro ITaskItem[] facoltativo.

Collega i file di risorse specificati a un assembly. La risorsa diventa parte dell'assembly, ma il file non viene copiato. È possibile che agli elementi passati a questo parametro siano associati metadati facoltativi denominati LogicalName, Target e Access. Il metadato LogicalName viene utilizzato per specificare l'identificatore interno per la risorsa. Il metadato Target viene utilizzato per specificare il percorso e il nome di file in cui il file viene copiato e quindi compilato nell'assembly. Infine, il metadato Access può essere impostato su private per rendere la risorsa invisibile ad altri assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /link[resource] di Assembly Linker (Al.exe).

MainEntryPoint

Parametro String facoltativo.

Specifica il nome completo (class.method) del metodo da utilizzare come punto di ingresso durante la conversione di un modulo in un file eseguibile. Questo parametro corrisponde all'opzione /main di Assembly Linker (Al.exe).

OutputAssembly

Parametro di output ITaskItem obbligatorio.

Specifica il nome del file generato dall'attività. Questo parametro corrisponde all'opzione /out di Assembly Linker (Al.exe).

Platform

Parametro String facoltativo.

Limita le piattaforme su cui è possibile eseguire il codice. I valori possibili sono: x86, Itanium, x64 e anycpu. Il valore predefinito è anycpu. Questo parametro corrisponde all'opzione /platform di Assembly Linker (Al.exe).

ProductName

Parametro String facoltativo.

Specifica una stringa per il campo Product dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /prod[uct] di Assembly Linker (Al.exe).

ProductVersion

Parametro String facoltativo.

Specifica una stringa per il campo ProductVersion dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /productv[ersion] di Assembly Linker (Al.exe).

ResponseFiles

Parametro String[] facoltativo.

Specifica i file di risposta contenenti opzioni aggiuntive da passare ad Assembly Linker.

SourceModules

Parametro ITaskItem[] facoltativo.

Si tratta di uno o più moduli da compilare in un assembly. I moduli verranno elencati nel manifesto dell'assembly ottenuto. Affinché l'assembly venga caricato, è comunque necessario che i moduli vengano distribuiti e che siano disponibili. È possibile che agli elementi passati a questo parametro siano associati metadati aggiuntivi denominati Target, in cui sono specificati il percorso e il nome di file in cui il file viene copiato e quindi compilato nell'assembly. Per ulteriori informazioni, vedere la documentazione relativa ad Assembly Linker (Al.exe). Questo parametro corrisponde all'elenco di moduli passati ad Al.exe senza utilizzare un'opzione specifica.

TargetType

Parametro String facoltativo.

Specifica il formato del file di output. I valori possibili sono: library per le librerie di codici, exe per le applicazioni console e win per le applicazioni basate su Windows. Il valore predefinito è library. Questo parametro corrisponde all'opzione /t[arget] di Assembly Linker (Al.exe).

TemplateFile

Parametro String facoltativo.

Specifica l'assembly dal quale ereditare tutti i metadati dell'assembly, ad eccezione del campo relativo alla lingua. All'assembly specificato deve essere assegnato un nome sicuro.

Gli assembly creati con il parametro TemplateFile saranno assembly satellite. Questo parametro corrisponde all'opzione /template di Assembly Linker (Al.exe).

Timeout

Parametro Int32 facoltativo.

Specifica l'intervallo di tempo, in millisecondi, al termine del quale l'eseguibile dell'attività viene interrotto. Il valore predefinito è Int.MaxValue, con cui viene indicato che non è stato specificato alcun periodo di timeout.

Title

Parametro String facoltativo.

Specifica una stringa per il campo Title dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /title di Assembly Linker (Al.exe).

ToolPath

Parametro String facoltativo.

Specifica il percorso da cui l'attività carica il file eseguibile sottostante (Al.exe). Se questo parametro non è specificato, viene utilizzato il percorso di installazione SDK corrispondente alla versione del framework che esegue MSBuild.

Trademark

Parametro String facoltativo.

Specifica una stringa per il campo Trademark dell'assembly. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /trade[mark] di Assembly Linker (Al.exe).

Version

Parametro String facoltativo.

Specifica le informazioni sulla versione dell'assembly. La stringa ha il seguente formato: major.minor.build.revision. Il valore predefinito è 0. Per ulteriori informazioni, vedere la documentazione relativa all'opzione /v[ersion] di Assembly Linker (Al.exe).

Win32Icon

Parametro String facoltativo.

Inserisce nell'assembly un file ico che determina l'aspetto del file di output in Esplora risorse. Questo parametro corrisponde all'opzione /win32icon di Assembly Linker (Al.exe).

Win32Resource

Parametro String facoltativo.

Inserisce nel file di output una risorsa Win32 (file res). Per ulteriori informazioni, vedere la documentazione relativa all'opzione /win32res di Assembly Linker (Al.exe).

Esempio

Nell'esempio riportato di seguito viene creato un assembly con le opzioni specificate.

<AL
    EmbedResources="@(EmbeddedResource)"
    Culture="%(EmbeddedResource.Culture)"
    TemplateFile="@(IntermediateAssembly)"
    KeyContainer="$(KeyContainerName)"
    KeyFile="$(KeyOriginatorFile)"
    DelaySign="$(DelaySign)"

    OutputAssembly=
       "%(EmbeddedResource.Culture)\$(TargetName).resources.dll">

    <Output TaskParameter="OutputAssembly"
        ItemName="SatelliteAssemblies"/>
</AL>

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild