Condividere o riutilizzare le impostazioni di progetto di Visual Studio

Per creare un gruppo personalizzato di impostazioni che è possibile condividere con altri utenti o riutilizzare in più progetti, usare Gestione proprietà per creare una finestra delle proprietà (un .props file) per archiviare le impostazioni per ogni tipo di progetto che si vuole riutilizzare o condividere con altri utenti. L'uso delle finestre delle proprietà è molto meno soggetto a errori rispetto ad altri modi per creare impostazioni "globali".

Importante

Il problema con i *.user file

Le versioni precedenti di Visual Studio usavano fogli di proprietà globali con estensione di file .user e si trovavano nella cartella \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\.

Microsoft non consiglia più di usare questo approccio. Questi file impostano le proprietà per le configurazioni di progetto per ogni utente, per computer. Tali impostazioni globali possono interferire con le compilazioni, soprattutto quando si ha come destinazione più di una piattaforma nel computer di compilazione. Ad esempio, se si dispone sia di un progetto MFC sia di un progetto Windows Phone, le proprietà .user non sono valide per uno dei due. Le schede delle proprietà riutilizzabili sono più flessibili e più robuste.

Anche se Visual Studio ancora installa i .user file e partecipano all'ereditarietà delle proprietà, sono vuoti per impostazione predefinita. La procedura consigliata consiste nell'eliminare qualsiasi riferimento in Gestione proprietà per assicurarsi che i progetti funzionino indipendentemente da qualsiasi impostazione per utente, per computer. Questa procedura è importante per garantire un comportamento corretto in un ambiente di controllo del codice sorgente.

Per visualizzare Property Manager, nella barra dei menu, scegliere Visualizza>Property Manager oppure Visualizza>Altre finestre>Property Manager, a seconda delle impostazioni.

Se si desidera applicare un set di proprietà comune e usato di frequente a più progetti, usare Gestione proprietà per acquisirli in un file della finestra delle proprietà riutilizzabile, che per convenzione ha un'estensione .props del nome file. È possibile applicare il foglio (o i fogli) ai nuovi progetti in modo da non dover impostare tali proprietà da zero.

Schermata del menu contestuale di Property Manager.

Sotto ciascun nodo di configurazione, vengono visualizzati i nodi per ogni scheda delle proprietà applicabile a tale configurazione. Il sistema aggiunge le finestre delle proprietà che impostano valori comuni in base alle opzioni scelte nella procedura guidata dell'app quando si crea il progetto. Fare clic con il pulsante destro del mouse su qualsiasi nodo e scegliere Proprietà per visualizzare le proprietà applicabili a tale nodo.

Tutte le finestre delle proprietà vengono importate automaticamente nella finestra delle proprietà primarie del progetto (ms.cpp.props) e vengono valutate nell'ordine in cui vengono visualizzate in Gestione proprietà. È possibile spostarle per modificare l'ordine di valutazione. I fogli delle proprietà valutati successivamente sovrascrivono i valori nei fogli valutati in precedenza.

Per altre informazioni sull'ordine di valutazione nel file .vcxproj, nei file .props e .targets, nelle variabili di ambiente e nella riga di comando, vedere Ereditarietà delle proprietà del progetto.

Se si sceglie Aggiungi nuova finestra delle proprietà del progetto e successivamente si seleziona ad esempio la finestra delle proprietà MyProps.props, viene visualizzata una finestra di dialogo della pagina delle proprietà. Questa condizione è valida per la finestra delle proprietà MyProps. Le modifiche apportate vengono scritte nella finestra, non nel file di progetto (con estensione vcxproj).

Le proprietà in un foglio proprietà vengono sovrascritte se la stessa proprietà è impostata direttamente nel file .vcxproj.

È possibile importare un foglio proprietà tutte le volte che è necessario. Più progetti in una soluzione possono ereditare le impostazioni dalla stessa finestra delle proprietà e in un progetto possono essere presenti più finestre. La stessa finestra delle proprietà può ereditare le impostazioni da un'altra finestra delle proprietà.

È anche possibile creare una finestra delle proprietà comune per più configurazioni. Per creare una finestra delle proprietà per ogni configurazione, aprire il menu di scelta rapida per uno di essi, scegliere Aggiungi finestra delle proprietà esistente e quindi aggiungere gli altri fogli. Tuttavia, se si utilizza una finestra delle proprietà comune, le proprietà impostate si applicano a tutte le configurazioni a cui si applica il foglio. L'IDE non mostra quali progetti o altri fogli delle proprietà ereditano da un determinato foglio delle proprietà.

In soluzioni di grandi dimensioni con molti progetti, può essere utile creare una finestra delle proprietà comune per tutti i progetti nella soluzione. Creare il foglio proprietà come di consueto. Utilizzare Property Manager per aggiungere quel foglio delle proprietà a ogni progetto nella soluzione. Se necessario a livello di progetto, è possibile aggiungere un'altra finestra delle proprietà per impostare valori specifici del progetto.

Importante

Un .props file per impostazione predefinita non partecipa al controllo del codice sorgente perché non viene creato come elemento di progetto. È possibile aggiungere manualmente il file come elemento di soluzione se si desidera includerlo nel controllo del codice sorgente.

Per creare una scheda proprietà

  1. Sulla barra dei menu, scegliere Visualizza>Gestore proprietà o Visualizza>Altre finestre>Gestore proprietà. Si apre Gestione proprietà.

  2. Selezionare l'elemento a cui applicare la scheda delle proprietà. Questo elemento può essere una particolare configurazione o un'altra scheda delle proprietà.

  3. Fare clic con il pulsante destro sull'elemento e quindi scegliere Aggiungi nuovo foglio proprietà del progetto.

  4. Nella finestra di dialogo Aggiungi nuovo elemento specificare un nome e un percorso per la finestra delle proprietà. Visual Studio salva il .props file nel percorso specificato.

    Espandi gli elementi sotto il progetto per visualizzare la finestra delle proprietà.

  5. In Gestione proprietà aprire la nuova finestra delle proprietà e successivamente impostare le proprietà da includere.

  • Last updated on