/Build (devenv.exe)
Consente di compilare una soluzione o un progetto con un file di configurazione della soluzione specificato.
Sintassi
devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]
Argomenti
SolutionName
Obbligatorio. Percorso e nome del file della soluzione, relativo alla directory della soluzione.
SolnConfigName
Facoltativo. Nome della configurazione di soluzione (ad esempio
Debug
oRelease
) da usare per compilare la soluzione indicata in SolutionName. Se per la soluzione sono disponibili più piattaforme, è necessario specificare anche la piattaforma, ad esempioDebug|Win32
. Se questo argomento non viene specificato o viene specificata una stringa vuota (""
), lo strumento usa la configurazione attiva della soluzione./Project
ProjNameFacoltativo. Il percorso e il nome del file di progetto nella soluzione. È possibile immettere nel file di progetto il percorso relativo dalla cartella SolutionName, il nome visualizzato del progetto o il percorso completo e il nome del file di progetto.
/ProjectConfig
ProjConfigNameFacoltativo. Nome della configurazione della build del progetto (ad esempio,
Debug
oRelease
) da usare per la compilazione del progetto denominato. Se è disponibile più di una piattaforma di soluzione, è necessario specificare anche la piattaforma (ad esempio,Debug|Win32
). Se si specifica questa opzione, viene eseguito l'override dell'argomento SolnConfigName./Out
OutputFilenameFacoltativo. Nome di un file a cui si vuole inviare l'output dello strumento. Se il file esiste già, lo strumento aggiunge l'output alla fine del file.
Osservazioni:
L'opzione
/Build
esegue la stessa funzione del comando di menu Compila soluzione nell'ambiente di sviluppo integrato (IDE).Racchiudere le stringhe che includono spazi tra virgolette doppie.
Le informazioni di riepilogo sulle compilazioni, compresi gli errori, possono essere visualizzate nella finestra di comando o in qualsiasi file di log specificato con l'opzione
/Out
.L'opzione
/Build
esegue la compilazione dei soli progetti modificati dopo l'ultima compilazione. Per compilare tutti i progetti in una soluzione, usare /rebuild.Se viene visualizzato il messaggio di errore Configurazione progetto non valida, assicurarsi di aver specificato la piattaforma di una soluzione o di un progetto, ad esempio
Debug|Win32
.
Esempi
Il comando seguente compila il progetto CSharpWinApp
usando la configurazione della build del progetto Debug
all'interno di MySolution
.
devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug
E per pulire tutti i file di compilazione:
devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean
Compilare un progetto di installazione
Per compilare un programma di installazione (.msi
file), è necessario un progetto di installazione con un .vdproj
file di progetto, ma per compilarlo è necessario prima applicare una soluzione alternativa che imposta una determinata chiave del Registro di sistema. Dal prompt dei comandi per sviluppatori di Visual Studio eseguire il DisableOutOfProcBuild.exe eseguibile dalla cartella Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Senza questa soluzione alternativa, è possibile che venga visualizzato l'errore : ERROR: An error occurred while validating. HRESULT = '8000000A'
. Il comando influisce sull'utente corrente, quindi per gli scenari dell'agente di compilazione, assicurarsi di eseguirlo dallo stesso account che esegue la compilazione. Per altre informazioni, vedere il file README.txt nella stessa cartella.
In Visual Studio è anche possibile creare una nuova configurazione, ad esempio Setup
, in base alla Release
configurazione e selezionare il progetto di installazione come progetto da compilare. Per impostazione predefinita, i progetti di installazione non sono inclusi nelle configurazioni predefinite Debug
e Release
. Con la Setup
configurazione definita, i comandi seguenti compilano un progetto e il progetto WindowsFormsApp1
di installazione associato per generare il .msi
file:
devenv WindowsFormsApp1.sln /build Setup
Se la soluzione è già stata compilata con la configurazione release , questo comando compila solo il progetto di installazione.