Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Sono necessarie configurazioni di progetto quando è necessario compilare i progetti con impostazioni diverse e le configurazioni della soluzione organizzano le configurazioni del progetto a livello di soluzione. Le configurazioni di debug e di rilascio sono entrambe configurazioni della soluzione e configurazioni di progetto corrispondenti.
La configurazione della soluzione è simile a un contenitore di configurazioni di progetto. In realtà non contiene alcuna impostazione da sola. La configurazione del progetto e la piattaforma di destinazione (architettura del computer) sono direttamente associate alle impostazioni effettive, ad esempio le opzioni del compilatore.
Una configurazione della soluzione è attiva ed è indicata nella barra dei comandi nella parte superiore dell'IDE.
La configurazione del progetto 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 se si vuole modificarlo, vedere Modificare la directory di output della compilazione.
È possibile creare configurazioni 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 Configuration Manager. Per aprirlo, nella barra dei menu scegliere Compila>Configuration Manageroppure digitare semplicemente Configurazione nella casella di ricerca. È anche possibile usare l'elenco configurazioni della soluzione sulla barra degli strumenti Standard per selezionare una configurazione o aprire Configuration Manager.
Nota
Se non è possibile trovare le impostazioni di configurazione della soluzione sulla barra degli strumenti e non è possibile accedere alla Configuration Manager, potrebbe essere perché si usano le impostazioni di sviluppo di Visual Basic. Per altre informazioni, vedere Gestire le configurazioni con le impostazioni di sviluppo di Visual Basic applicate.
Nei progetti creati usando i modelli di Visual Studio, per impostazione predefinita, vengono incluse le configurazioni di Debug e Release. Una configurazione debug supporta il debug di un'app e una configurazione Release compila una versione dell'app che può essere distribuita. Per altre informazioni, vedere Impostare configurazioni di debug e rilascio. È anche possibile creare configurazioni di soluzioni personalizzate e configurazioni di progetto. Per altre informazioni, vedere Creare e modificare le configurazioni.
Perché esistono entrambe le configurazioni della soluzione e le configurazioni del progetto
Per qualsiasi soluzione, i progetti in tale soluzione non devono avere la stessa configurazione della soluzione. Ad esempio, una configurazione della soluzione di debug non richiede che tutti i progetti usino la configurazione debug .
Si supponga di essere uno sviluppatore che fa parte di una soluzione condivisa di grandi dimensioni, ma si è proprietari di uno o più progetti strettamente correlati in tale soluzione. È possibile usare una configurazione di debug per i progetti, ma una configurazione di rilascio per tutti gli altri progetti in tale soluzione. Per supportare questo scenario, è necessario configurare la configurazione della soluzione di debug per usare la configurazione del progetto di debug solo per alcuni progetti e usare la configurazione del progetto release per tutto il resto. Ciò potrebbe significare meno sovraccarico in termini di prestazioni e dimensioni dei file per tali progetti e, eseguendo in modalità Release su progetti di cui non si esegue attivamente il debug, si potrebbe eseguire in un modo più vicino all'esperienza del cliente, mantenendo comunque la possibilità di passare tra build Debug e Release in modo utile per il tuo lavoro.
Configurazioni della soluzione
Una configurazione della soluzione specifica il modo in cui i progetti nella soluzione devono essere compilati e distribuiti. Per modificare una configurazione della soluzione o definirne una nuova, in Configuration Manager, in configurazione della soluzione attivascegliere Modifica o Nuovo.
Ogni voce nella casella contesti del progetto in una configurazione della soluzione rappresenta un progetto nella soluzione. Per ogni combinazione di configurazione attiva della soluzione e piattaforma attiva della soluzione, è possibile impostare come utilizzare ogni progetto.
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 della soluzione attiva fornisce anche il contesto all'IDE. Ad esempio, se si sta lavorando a un progetto e la configurazione specifica che verrà compilata per un dispositivo mobile, la casella degli strumenti visualizza solo gli elementi che possono essere usati in un progetto di dispositivo mobile.
Configurazioni del 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 soluzionie quindi scegliere proprietà . Nella parte superiore della scheda Compila della finestra di progettazione del progetto scegliere una configurazione attiva per modificarne le impostazioni di compilazione.
Le costanti predefinite per ogni configurazione vengono visualizzate sotto la casella di testo in cui è possibile immettere le proprie. Queste costanti predefinite sono definite dall'SDK usato dal progetto. Per vedere dove vengono definite queste proprietà, è possibile cercare come viene definita e modificata la proprietà DefineConstants MSBuild nella cartella di installazione di .NET SDK in cui .props si trovano i file e .targets . Gli SDK forniscono proprietà MSBuild che è possibile impostare nel file di progetto per disabilitare le definizioni predefinite; ad esempio, vedere DisableImplicitFrameworkDefines.
È possibile personalizzare alcune impostazioni del progetto in base alla configurazione, alcune devono avere lo stesso valore nella configurazione e alcune offrono la possibilità di scegliere. Fare clic sull'icona a forma di ingranaggio per visualizzare le opzioni disponibili e, se supportato, è possibile impostare se usare lo stesso valore tra le configurazioni o variare in base alla configurazione. È anche possibile reimpostare il valore predefinito.
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.
Se un progetto ha un nome di configurazione (<nome di configurazione><nome della piattaforma>) che corrisponde al nome della nuova configurazione della soluzione, viene usata tale configurazione. I nomi di configurazione non fanno distinzione tra maiuscole e minuscole.
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.
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 del progetto (nel Configuration Manager, scegliendo Nuovo nel menu a discesa nella colonna Configurazione per tale progetto) e selezionare la casella di controllo Crea nuove configurazioni di soluzione, Visual Studio cerca una configurazione di soluzione simile per compilare il progetto in ogni piattaforma supportata. In alcuni casi, Visual Studio rinomina le configurazioni della soluzione esistenti o ne definisce di nuove.
Visual Studio usa i criteri seguenti per associare le configurazioni della soluzione alle configurazioni del progetto:
Se una configurazione del progetto non specifica una piattaforma o specifica una sola piattaforma, viene trovata o aggiunta una configurazione della soluzione il cui nome corrisponde a quello della nuova configurazione del progetto. Il nome predefinito di questa configurazione della soluzione non include un nome della piattaforma; accetta il formato <nome di configurazione del progetto>.
Se un progetto supporta più piattaforme, viene trovata o aggiunta una configurazione della 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 ha la forma <il nome della configurazione del progetto><il nome della piattaforma>.
Impatto delle configurazioni sulla compilazione
Quando si costruisce una soluzione utilizzando il comando Compila>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 desidera costruire più configurazioni e piattaforme in un'unica azione, è possibile utilizzare l'opzione Compilazione batch di > 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. Vedi Creare più configurazioni contemporaneamente.