Share via


Configurazione soluzione

Le configurazioni della soluzione archiviano le proprietà a livello di soluzione. Indirizzano il comportamento dei comandi Start (F5) e Build . Per impostazione predefinita, questi comandi compilano e avviano la configurazione di debug. Entrambi i comandi vengono eseguiti nel contesto di una configurazione della soluzione. Ciò significa che l'utente può aspettarsi che F5 avvii e crei qualsiasi elemento configurato dalla soluzione attiva tramite le impostazioni. L'ambiente è progettato per ottimizzare le soluzioni anziché per i progetti in caso di compilazione ed esecuzione.

La barra degli strumenti standard di Visual Studio contiene un pulsante Start e un elenco a discesa della configurazione della soluzione a destra del pulsante Start. Questo elenco consente agli utenti di scegliere la configurazione da avviare quando viene premuto F5, creare configurazioni di soluzione personalizzate o modificare una configurazione esistente.

Nota

Non esistono interfacce di estendibilità per creare o modificare le configurazioni della soluzione. È necessario usare DTE.SolutionBuild. Esistono tuttavia API di estendibilità per la gestione della compilazione della soluzione. Per ulteriori informazioni, vedere IVsSolutionBuildManager2.

Ecco come implementare le configurazioni della soluzione supportate dal tipo di progetto:

  • Project

    Visualizza i nomi dei progetti trovati nella soluzione corrente.

  • Impostazione

    Per fornire l'elenco delle configurazioni supportate dal tipo di progetto e visualizzate nelle pagine delle proprietà, implementare IVsCfgProvider2.

    Nella colonna Configurazione viene visualizzato il nome della configurazione del progetto da compilare in questa configurazione della soluzione e vengono elencate tutte le configurazioni del progetto quando si fa clic sul pulsante freccia. L'ambiente chiama il GetCfgNames metodo per compilare questo elenco. Se il GetCfgProviderProperty metodo indica che il progetto supporta la modifica della configurazione, anche le selezioni New o Edit vengono visualizzate sotto l'intestazione Configurazione. Ognuna di queste selezioni avvia finestre di dialogo che chiamano i metodi dell'interfaccia IVsCfgProvider2 per modificare le configurazioni del progetto.

    Se un progetto non supporta le configurazioni, nella colonna Configurazione viene visualizzato Nessuno ed è disabilitato.

  • Piattaforma

    Visualizza la piattaforma per cui viene compilata la configurazione del progetto selezionata ed elenca tutte le piattaforme disponibili per il progetto quando si fa clic sul pulsante freccia. L'ambiente chiama il GetPlatformNames metodo per compilare questo elenco. Se il GetCfgProviderProperty metodo indica che il progetto supporta la modifica della piattaforma, anche le selezioni New o Edit vengono visualizzate sotto l'intestazione Piattaforma. Ognuna di queste selezioni avvia finestre di dialogo che chiamano IVsCfgProvider2 i metodi per modificare le piattaforme disponibili del progetto.

    Se un progetto non supporta le piattaforme, la colonna della piattaforma per il progetto visualizza Nessuno ed è disabilitata.

  • Compilazione

    Specifica se il progetto viene compilato dalla configurazione della soluzione corrente. I progetti non selezionati non vengono compilati quando i comandi di compilazione a livello di soluzione vengono richiamati nonostante le dipendenze del progetto che contengono. I progetti non selezionati per la compilazione sono ancora inclusi nel debug, nell'esecuzione, nella creazione di pacchetti e nella distribuzione della soluzione.

  • Distribuzione

    Specifica se il progetto verrà distribuito o meno quando i comandi Avvia o Distribuisci vengono usati con la configurazione di compilazione della soluzione selezionata. La casella di controllo per questo campo sarà disponibile se il progetto supporta la distribuzione implementando l'interfaccia nel IVsDeployableProjectCfg relativo IVsProjectCfg2 oggetto.

    Dopo aver aggiunto una nuova configurazione della soluzione, l'utente può selezionarlo dalla casella di riepilogo a discesa Configurazione soluzione sulla barra degli strumenti standard per compilare e/o avviare tale configurazione.