Attività VCBuild
Aggiornamento: novembre 2007
Esegue il wrapping di vcbuild.exe, uno strumento in grado di compilare progetti e soluzioni Visual C++ contenenti progetti Visual C++. Per ulteriori informazioni, vedere Riferimenti a VCBUILD.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività VCBuild.
Parametro |
Descrizione |
|---|---|
AdditionalLibPaths |
Parametro ITaskItem[] facoltativo. Specifica eventuali percorsi da aggiungere alla variabile di ambiente LIBPATH prima dell'esecuzione di vcbuild.exe. |
AdditionalOptions |
Parametro String facoltativo. Specifica opzioni della riga di comando aggiuntive che non prevedono parametri dell'attività dedicati. |
Clean |
Parametro Boolean facoltativo. Se il parametro è impostato su true, indica che verranno restituiti solo output di compilazione sottoposti a pulizia. Se il parametro Rebuild è impostato su true, viene eseguito l'override di questo parametro. |
Configuration |
Parametro String facoltativo. Specifica il nome della configurazione e della piattaforma con cui eseguire la generazione. Ad esempio: Debug|Win32. Questo parametro può anche essere utilizzato per specificare soltanto il nome della configurazione. |
Override |
Parametro ITaskItem facoltativo. Specifica il percorso di un file della finestra delle proprietà VCBuild che eseguirà l'override delle impostazioni del file di progetto. |
Platform |
Parametro String facoltativo. Specifica il nome della piattaforma per la quale eseguire la generazione. |
Projects |
Parametro ITaskItem[] obbligatorio. Specifica i progetti da generare. |
Rebuild |
Parametro Boolean facoltativo. Se il parametro è impostato su true, indica che verrà effettuata la pulizia degli output di compilazione prima di eseguire un'operazione di compilazione. Questo parametro esegue l'override del parametro Clean. |
SolutionFile |
Parametro ITaskItem facoltativo. Specifica il percorso completo del file della soluzione durante la generazione delle soluzioni. Questo parametro viene utilizzato per risolvere le macro del progetto Visual C++ associate alla soluzione. |
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. |
ToolPath |
Parametro String facoltativo. Specifica il percorso da cui l'attività carica il file eseguibile sottostante (vcbuild.exe). Se questo parametro non è specificato, viene utilizzato il percorso di installazione SDK corrispondente alla versione del framework che esegue MSBuild. |
UseEnvironment |
Parametro Boolean facoltativo. true per utilizzare le variabili di ambiente per i percorsi INCLUDE e LIB; in caso contrario false. |
AdditionalLinkLibraryPaths |
Parametro String facoltativo. Specifica i percorsi di riferimento aggiuntivi da aggiungere alla variabile di ambiente LIB. Link.exe utilizza il percorso LIB quando cerca un file specificato sulla riga di comando di Link, ad esempio un oggetto o una libreria. Lib.exe non utilizza una variabile di ambiente. |
Esempio
Nell'esempio riportato di seguito l'attività VCBuild viene utilizzata per generare i progetti specificati dall'insieme di elementi vcprojects.
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>