/Build (devenv.exe)
Compila una soluzione o un progetto usando 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
Opzionale. Nome della configurazione della soluzione , ad esempio
Debug
oRelease
, da usare per compilare la soluzione denominata in SolutionName. Se sono disponibili più piattaforme di soluzioni, è necessario specificare anche la piattaforma ( ad esempio,Debug|Win32
). Se questo argomento non è specificato o una stringa vuota (""
), lo strumento usa la configurazione attiva della soluzione./Project
ProjNameOpzionale. Percorso e nome di un file di progetto all'interno della soluzione. È possibile immettere un percorso relativo dalla SolutionName cartella al file di progetto oppure dal nome visualizzato del progetto oppure dal percorso completo e dal nome del file di progetto.
/ProjectConfig
ProjConfigNameOpzionale. Nome di una configurazione di compilazione del progetto, ad esempio
Debug
oRelease
, da usare durante la compilazione del progetto denominato. Se sono disponibili più piattaforme di soluzioni, è necessario specificare anche la piattaforma ( ad esempio,Debug|Win32
). Se questa opzione viene specificata, esegue l'override dell'argomento SolnConfigName./Out
OutputFilenameOpzionale. Nome di un file a cui si desidera 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 all'interno dell'ambiente di sviluppo integrato (IDE).Racchiudere le stringhe che includono spazi tra virgolette doppie.
Le informazioni di riepilogo per le compilazioni, inclusi gli errori, possono essere visualizzate nella finestra di comando o in qualsiasi file di log specificato con l'opzione
/Out
.L'opzione
/Build
cambia solo i progetti che sono stati modificati dopo l'ultima compilazione. Per compilare tutti i progetti in una soluzione, usare /rebuild.Se viene visualizzato un messaggio di errore che indica Configurazione progetto non valida, assicurarsi di aver specificato una piattaforma di soluzione o una piattaforma di progetto , ad esempio
Debug|Win32
.
Esempi
Il comando seguente compila il progetto CSharpWinApp
, usando la configurazione della compilazione 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 ( file.msi
), è necessario un progetto di installazione , che include un file di progetto .vdproj
, 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 configurazione Release
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 configurazione Setup
definita, i comandi seguenti compilano un progetto WindowsFormsApp1
e il progetto di installazione associato per generare il file di .msi
:
devenv WindowsFormsApp1.sln /build Setup
Se la soluzione è già stata compilata con la configurazione release, questo comando compila solo il progetto di installazione.