LC (attività)
Esegue il wrapping di LC.exe, uno strumento che genera un file con estensione license da un file con estensione licx. Per altre informazioni su LC.exe, vedere Lc.exe (License Compiler).
Parametri
La tabella seguente descrive i parametri dell'attività LC
.
Parametro | Descrizione |
---|---|
LicenseTarget |
Parametro ITaskItem obbligatorio. Specifica l'eseguibile per cui vengono generati i file con estensione licenses. |
NoLogo |
Parametro Boolean facoltativo.Evita la visualizzazione del messaggio di avvio Microsoft. |
OutputDirectory |
Parametro String facoltativo.Specifica la directory in cui inserire i file di output con estensione licenses. |
OutputLicense |
Parametro di output ITaskItem facoltativo. Specifica il nome del file con estensione licenses. Se non si specifica un nome, viene usato il nome del file con estensione licx e il file con estensione licenses viene inserito nella directory contenente il file con estensione licx. |
ReferencedAssemblies |
Parametro ITaskItem[] facoltativo.Specifica i componenti a cui si fa riferimento da caricare durante la generazione del file con estensione license. |
SdkToolsPath |
Parametro String facoltativo.Specifica il percorso degli strumenti SDK, ad esempio resgen.exe. |
Sources |
Parametro ITaskItem[] obbligatorio.Specifica gli elementi che contengono componenti concessi in licenza da includere nel file con estensione licenses. Per altre informazioni, vedere la documentazione relativa all'opzione /complist in Lc.exe (License Compiler). |
Parametri ToolTaskExtension
Questa attività eredita dalla ToolTaskExtension classe , che eredita dalla ToolTask classe , che a sua volta eredita dalla Task classe . Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano.
Nella tabella seguente vengono descritti i parametri delle classi di base:
Parametro | Descrizione |
---|---|
EchoOff | Parametro bool facoltativo.Se impostata su true , questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout. |
EnvironmentVariables | Parametro di matrice String facoltativo.Matrice di definizioni di variabili di ambiente, separate da punti e virgola. Ogni definizione deve specificare un nome di variabile di ambiente e un valore separati da un segno di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard. Ad esempio, Variable1=Value1;Variable2=Value2 . |
ExitCode | Parametro di sola lettura di output Int32 facoltativo.Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1. |
LogStandardErrorAsError | Parametro bool facoltativo.Se true , tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori. |
StandardErrorImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di errore standard. |
StandardOutputImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di output standard. |
Timeout | Parametro Int32 facoltativo.Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue , con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi. |
ToolExe | Parametro string facoltativo.I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName. |
ToolPath | Parametro string facoltativo.Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild. |
UseCommandProcessor | Parametro bool facoltativo.Se true , questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando. |
YieldDuringToolExecution | Parametro bool facoltativo.Se true , questa attività restituisce il nodo quando l'attività è in esecuzione. |
Esempio
Nell'esempio seguente l'attività LC
viene usata per compilare le licenze.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Item declarations, etc -->
<Target Name="CompileLicenses">
<LC
Sources="@(LicxFile)"
LicenseTarget="$(TargetFileName)"
OutputDirectory="$(IntermediateOutputPath)"
OutputLicenses="$(IntermediateOutputPath)$(TargetFileName).licenses"
ReferencedAssemblies="@(ReferencePath);@(ReferenceDependencyPaths)">
<Output
TaskParameter="OutputLicenses"
ItemName="CompiledLicenseFile"/>
</LC>
</Target>
</Project>