Informazioni sulle configurazioni della build

Sono necessarie configurazioni di compilazione quando è necessario compilare i progetti con impostazioni diverse. Ad esempio, Debug e Release sono configurazioni di compilazione e vengono usate di conseguenza diverse opzioni del compilatore durante la compilazione. Una configurazione è attiva ed è indicata nella barra dei comandi nella parte superiore dell'IDE.

Nota

Questo argomento si applica a Visual Studio in Windows. Per Visual Studio per Mac, vedere Build configurations in Visual Studio for Mac (Compilazione di configurazioni in Visual Studio for Mac).

La configurazione e il controllo della piattaforma in cui vengono archiviati i file di output compilati. In genere, quando Visual Studio compila il progetto, l'output viene inserito in una sottocartella di progetto denominata con la configurazione attiva , ad esempio bin/Debug/x86, ma è possibile modificarla.

È possibile creare configurazioni di compilazione personalizzate a livello di soluzione e progetto. La configurazione della soluzione determina i progetti inclusi nella compilazione quando tale configurazione è attiva. Verranno compilati solo i progetti specificati nella configurazione della soluzione attiva. Se in Configuration Manager sono selezionate più piattaforme di destinazione, vengono compilati tutti i progetti applicabili a tale piattaforma. La configurazione del progetto determina le impostazioni di compilazione e le opzioni del compilatore usate quando si compila il progetto.

Per creare, selezionare, modificare o eliminare una configurazione, è possibile usare Gestione configurazione. Per aprirlo, nella barra dei menu scegliere Compilazione>Gestione configurazione oppure digitare configurazione nella casella di ricerca. È inoltre possibile usare l'elenco Configurazioni soluzione sulla barra degli strumenti Standard per selezionare una configurazione o aprire Gestione configurazione.

Nota

Se non è possibile trovare le impostazioni di configurazione della soluzione sulla barra degli strumenti e non è possibile accedere a Configuration Manager, è possibile che si usino le impostazioni di sviluppo di Visual Basic. Per altre informazioni, vedere Procedura: Gestire configurazioni di compilazione applicando le impostazioni di Visual Basic Developer.

Per impostazione predefinita, le configurazioni di debug e rilascio sono incluse nei progetti creati usando i modelli di Visual Studio. Una configurazione di debug supporta il debug di un'app e una configurazione versione compila una versione dell'app che può essere distribuita. Per altre informazioni, vedere Procedura: Impostare le configurazioni di debug e rilascio. È inoltre possibile creare configurazioni personalizzate per progetti e soluzioni. Per altre informazioni, vedere Procedura: Creare e modificare le configurazioni.

Configurazioni di soluzioni

In una configurazione per la soluzione viene specificato il modo in cui i progetti di una soluzione devono essere compilati e distribuiti. Per modificare una configurazione per la soluzione o per definirne una nuova, in Gestione configurazione, sotto la voce Configurazione soluzione attiva scegliere Modifica o Nuovo.

Ogni voce nella casella Contesti progetto di una configurazione per la soluzione rappresenta un progetto nella soluzione. Per ogni combinazione di Configurazione soluzione attiva e Piattaforma soluzione attiva, è possibile definire il modo in cui ogni progetto viene usato.

Quando si definisce una nuova configurazione della soluzione e si seleziona la casella di controllo Crea nuove configurazioni di progetto, Visual Studio crea una nuova configurazione del progetto in tutti i progetti. Analogamente, quando si definisce una nuova piattaforma di soluzioni e si seleziona la casella di controllo Crea nuove piattaforme di progetto, Visual Studio crea la nuova opzione di piattaforma in tutti i progetti. Inoltre, se si aggiunge un progetto destinato a una nuova piattaforma, Visual Studio aggiunge tale piattaforma all'elenco delle piattaforme di soluzioni e rende la piattaforma disponibile come opzione in tutti i progetti. È possibile modificare le impostazioni per ogni progetto, nei casi in cui le piattaforme non sono necessarie o supportate da alcuni progetti.

La configurazione per la soluzione attiva fornisce anche il contesto all'IDE. Se, ad esempio, si sta lavorando a un progetto e nella configurazione per la soluzione attiva viene specificata la compilazione per un dispositivo mobile, nella Casella degli strumenti verranno visualizzati solo gli elementi del progetto che possono essere usati in un progetto per un dispositivo mobile.

Configurazioni di progetto

La configurazione e la piattaforma di destinazione di un progetto vengono usate insieme per specificare le impostazioni di compilazione e le opzioni del compilatore da usare al momento della compilazione. Un progetto può avere impostazioni diverse per ogni combinazione di configurazione e piattaforma. Per modificare le proprietà di un progetto, aprire il menu di scelta rapida per il progetto in Esplora soluzioni e quindi scegliere Proprietà. Nella parte superiore della scheda Compila della finestra di progettazione del progetto scegliere una configurazione attiva per modificare le impostazioni di compilazione.

Come Visual Studio associa le configurazioni del progetto alle configurazioni della soluzione

Quando si definisce una nuova configurazione della soluzione e non si copiano le impostazioni da una esistente, Visual Studio usa i criteri seguenti per associare le configurazioni di progetto esistenti alla nuova configurazione della soluzione. I criteri vengono valutati nell'ordine indicato.

1. Se un progetto ha un nome di configurazione (<nome piattaforma> nome><configurazione) che corrisponde al nome della nuova configurazione della soluzione, tale configurazione viene usata. I nomi delle configurazioni non rispettano la distinzione tra maiuscole e minuscole.

2. Se il progetto ha un nome di configurazione in cui la parte configuration-name corrisponde alla nuova configurazione della soluzione, tale configurazione viene usata, indipendentemente dal fatto che la parte della piattaforma corrisponda o meno.

3. Se non esiste ancora alcuna corrispondenza, viene usata la prima configurazione elencata nel progetto.

Modalità di associazione delle configurazioni della soluzione a nuove configurazioni di progetto in Visual Studio

Quando si crea una configurazione per il progetto (in Gestione configurazione scegliere Nuovo nel menu a discesa nella colonna Configurazione del progetto) e si seleziona la casella di controllo Crea nuove configurazioni soluzione, in Visual Studio viene cercata una configurazione con lo stesso nome per compilare il progetto per ogni piattaforma supportata. In alcuni casi, le configurazioni di soluzione esistenti vengono rinominate o ne vengono definite di nuove.

Visual Studio usa i criteri seguenti per associare le configurazioni della soluzione alle configurazioni del progetto:

• Se in una configurazione di progetto non è specificata una piattaforma oppure ne è specificata una sola, viene trovata o aggiunta una configurazione per la soluzione il cui nome corrisponde a quello della nuova configurazione di progetto. Il nome predefinito di questa configurazione della soluzione non include un nome della piattaforma; accetta il nome> di configurazione del progetto di modulo<.

• Se un progetto supporta più piattaforme, verrà trovata o aggiunta una configurazione per la soluzione per ogni piattaforma supportata. Il nome di ogni configurazione della soluzione include sia il nome della configurazione del progetto che il nome della piattaforma e il nome><> della piattaforma del <progetto modulo.

Impatto delle configurazioni sulla compilazione

Quando si compila una soluzione usando il comando Compila>soluzione, Visual Studio compila solo la configurazione attiva. Tutti i progetti specificati nella configurazione della soluzione vengono compilati e l'unica configurazione del progetto compilata è quella specificata nella configurazione della soluzione attiva e nella piattaforma della soluzione attiva, visualizzata nella barra degli strumenti di Visual Studio. Ad esempio, Debug e x86. Altre configurazioni e piattaforme definite non vengono compilate.

Se si vogliono compilare più configurazioni e piattaforme in un'unica azione, è possibile usare l'opzione Compila>batch in Visual Studio. Per accedere a questa funzionalità, premere CTRL+Q per aprire la casella di ricerca e immettere .Batch build La compilazione batch non è disponibile per tutti i tipi di progetto. Vedere Procedura: Creare più configurazioni contemporaneamente.

Contenuto correlato

• Walkthrough: Building an Application (Procedura dettagliata: Compilare un'applicazione)
• Compilare
• Soluzioni e progetti
• Riferimenti alla compilazione in C/C++
• Configurare i progetti per le piattaforme di destinazione
• Build configurations (Visual Studio per Mac) (Compilare configurazioni)