Procedura dettagliata: esplorazione del controllo della versione di Team Foundation

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa procedura dettagliata vengono illustrate le funzionalità di integrazione del controllo della versione in Visual Studio Team System Team Foundation Server.

In questa procedura dettagliata viene descritto come utilizzare il controllo della versione nell'IDE di Visual Studio Team System Team Foundation Server. In particolare, viene illustrato come completare le seguenti attività:

Impostare Controllo della versione di Team Foundation come plug-in predefinito del controllo della versione per Visual Studio Team System Team Foundation Server.
Creare un nuovo progetto in Visual Studio.
Aggiungere il progetto al controllo della versione, quindi creare un'area di lavoro locale in cui archiviare, modificare e testare i file con controllo della versione.
Archiviare la soluzione.
Aggiungere un file al progetto con controllo della versione e modificarne uno esistente.
Eseguire il commit di tutte le modifiche in sospeso nell'area di lavoro locale al server di controllo della versione.

Prerequisiti

Per completare questa procedura dettagliata, è necessario:

Specificare un Team Foundation Server. Per ulteriori informazioni su come connettersi a un Team Foundation Server, vedere Procedura: connettersi a Team Foundation Server.
Creare o aprire un progetto Team esistente. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un nuovo progetto Team o Procedura dettagliata: connessione a un progetto Team.

Autorizzazioni necessarie

Per completare questa procedura dettagliata, è necessario disporre delle autorizzazioni Read e Checkin.

Impostare il controllo della versione di Team Foundation come plug-in del controllo del codice sorgente

Prima di utilizzare Controllo della versione di Team Foundation, è necessario configurare Visual Studio in modo da utilizzare il plug-in Controllo della versione di Team Foundation, come illustrato nella procedura seguente. Per ulteriori informazioni, vedere la classe Procedura: configurare Visual Studio con il controllo delle versioni di Team Foundation.

Nota:
Visual Studio è configurato per utilizzare automaticamente il plug-in di Controllo della versione di Team Foundation, se Team Explorer viene installato dopo Visual Studio.

Per configurare Visual Studio per l'utilizzo del controllo della versione di Team Foundation

Scegliere Opzioni dal menu Strumenti.
Nella finestra di dialogo Opzioni individuare Controllo delcodice sorgente, espanderlo, quindi fare clic su Selezione plug-in.
Nell'elenco a discesa Plug-in del controllo del codice sorgente corrente, selezionare Visual Studio Team Foundation Server.
Scegliere OK.

Aggiungere un progetto al controllo della versione

I progetti creati possono essere aggiunti al controllo della versione per essere gestiti in Controllo della versione di Team Foundation. Al momento della prima aggiunta di un progetto al controllo della versione, in Controllo della versione di Team Foundation viene creata un'area di lavoro. Un'area di lavoro è una copia sul lato client dei file e delle cartelle presenti sul server Team Foundation. Quando si aggiunge, modifica, elimina, sposta, rinomina o gestisce in altro modo un elemento con controllo della versione, le modifiche vengono salvate in modo permanente sul client e contrassegnate come modifiche in sospeso nell'area di lavoro del computer locale.

Un'area di lavoro è un spazio isolato in cui è possibile scrivere e testare il codice. Le modifiche apportate dall'utente non influiscono sulla stabilità dei database di origine archiviati e non vengono influenzate dalle modifiche apportate dei colleghi del team. Le modifiche in sospeso rimangono isolate in un'area di lavoro finché non se ne esegue il commit nel server Team Foundation archiviandole.

È possibile creare sul computer più di un'area di lavoro per ogni server Team Foundation. Per ulteriori informazioni, vedere la classe Utilizzo delle aree di lavoro per il controllo della versione.

Per creare una nuova soluzione e un nuovo progetto

Scegliere Nuovo dal menu File e quindi Progetto.
Nella finestra di dialogo Nuovo progetto selezionare Visual C# nel riquadro Tipi progetto.
Nel riquadro destro, fare clic su Applicazione Windows Form.
Nella casella Nome, digitare MyWindowsApp, quindi immettere un percorso nella casella Percorso.
Selezionare la casella Aggiungi al controllo del codice sorgente, quindi fare clic su OK.
Nella casella Aggiungi soluzione a controllo del codice sorgente, selezionare il progetto team che si desidera utilizzare per questa procedura dettagliata.
Scegliere OK.

È possibile aggiungere soluzioni e progetti anche dalla riga di comando o dal menu di Visual Studio. Tuttavia, in questo modo, i progetti e le soluzioni non vengono associati. L'associazione rende disponibile la funzionalità di controllo della versione che include diverse icone di controllo della versione indicanti lo stato in Esplora soluzioni. Per ulteriori informazioni, vedere Procedura: associare e separare progetti e soluzioni, Comando Add e Procedura: aggiungere al controllo della versione file e cartelle non appartenenti al progetto o alla soluzione.

Finestra Modifiche in sospeso

Nella finestra Modifiche in sospeso sono presenti informazioni sullo stato delle modifiche in sospeso nell'area di lavoro. Questa finestra è utile per tenere traccia delle informazioni associate alle modifiche, ad esempio gli elementi di lavoro attinenti e le note di archiviazione. Per accedere alla finestra Modifiche in sospeso, è possibile utilizzare il menu Visualizza . Per ulteriori informazioni, vedere la classe Utilizzo delle finestre Archivia e Modifiche in sospeso.

Nota:
È necessario acquisire dal server la versione più recente di tutti i database di origine attinenti e compilare il codice per assicurarsi che venga generato senza errori prima di archiviare le modifiche in sospeso.

Successivamente, è necessario utilizzare la finestra Modifiche in sospeso per archiviare i nuovi file della soluzione nel controllo della versione.

Per archiviare le modifiche in sospeso della soluzione nel controllo della versione

Scegliere Compila soluzione dal menu Compila per confermare che l'applicazione viene compilata senza errori.
Se la finestra Modifiche in sospeso non è aperta, nel menu Visualizza, fare clic su Altre finestre, quindi selezionare Modifiche in sospeso.

Nella finestra Modifiche in sospeso, i file della soluzione verranno elencati in Aggiungi. Ciò significa che i file sono stati creati nell'area di lavoro, ma non sono ancora stati aggiunti al server.
Nella casella Commento della finestra di dialogo Modifiche in sospeso, immettere il commento "Aggiunta di un progetto nuovo al controllo della versione".
Fare clic su Archivia per archiviare sul server le modifiche in sospeso.

Per ulteriori informazioni, vedere°Modifiche in sospeso e Procedura: archiviare le modifiche in sospeso. Per ulteriori informazioni, vedere la classe Invio delle modifiche al server del controllo della versione.

Modificare il progetto del controllo della versione

Il controllo della versione è una parte completamente integrata nello sviluppo di Visual Studio. Ad esempio, quando si aggiunge un file a un progetto con controllo della versione, il file del progetto viene automaticamente estratto e aggiornato da Visual Studio.

Quando si aggiunge un file a un progetto con controllo della versione, in Visual Studio si presume che saranno apportate delle modifiche al file prima di renderlo disponibile per i colleghi del team. Pertanto, i file appena aggiunti non vengono archiviati automaticamente, ma considerati come aggiunte al controllo della versione in sospeso. Quando si archiviano in modo esplicito le modifiche di cui non è stato eseguito il commit, viene creato un nuovo insieme di modifiche nel server

Per aggiungere un file a un progetto con controllo della versione

In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi, quindi Classe.
Nella finestra di dialogo Aggiungi nuovo elemento fare clic su Aggiungi per aggiungere Class1.cs al progetto.

Class1.cs viene visualizzato insieme agli altri file di progetto nella finestra Modifiche in sospeso e il tipo di Modifica è aggiungi. In Esplora soluzioni è possibile verificare che l'icona di segnalazione del progetto è passata da un lucchetto blu a un segno di spunta rosso. Questa icona indica che il file di progetto è estratto. Notare che Class1.cs viene visualizzato con il segno più (+) per indicare un'aggiunta in sospeso.

Quando si decide di modificare un file del progetto archiviato, i file vengono estratti automaticamente.

Per modificare un file di un progetto con controllo della versione

In Esplora soluzioni fare doppio clic sul file AssemblyInfo.cs nella cartella Proprietà.
Aggiungere una nuova direttiva using, ad esempio using System.IO.Ports;, al file nell'editor di codice.

Notare che in Team Foundation, il file AssemblyInfo.cs viene estratto automaticamente non appena si inizia ad apportarvi modifiche. In Esplora soluzioni, l'icona di segnalazione viene sostituita da un segno di spunta. Il sistema consente di aggiungere il file all'elenco dei file di origine nella finestra Modifiche in sospeso.

Sincronizzare l'area di lavoro con la versione più recente del server

Per mantenere i file dell'area di lavoro sincronizzati con l'ultima versione del server, utilizzare l'operazione Leggi ultima versione. Se prima dell'archiviazione vengono sempre eseguite la sincronizzazione e la compilazione, è possibile evitare l'interruzione della compilazione di integrazione. È possibile interrompere una compilazione quando più utenti archiviano modifiche non in conflitto ma reciprocamente incompatibili che insieme impediscono la compilazione dell'applicazione.

Per ottenere la versione più recente dal server per l'area di lavoro e la compilazione

Fare clic con il pulsante destro del mouse sulla soluzione in Esplora soluzioni, quindi selezionare Leggi ultima versione (ricorsivo).
Scegliere Compila soluzione dal menu Compila per confermare che l'applicazione viene compilata senza errori.

Archiviare le modifiche in sospeso sul server

Dopo avere verificato che l'applicazione viene compilata con la versione più recente, è possibile archiviare le modifiche in Controllo della versione di Team Foundation e rendere il progetto disponibile per i colleghi del team.

Nota:
Se l'applicazione non è stata compilata poiché non si disponeva del tempo necessario per testarla oppure se si desidera che il codice venga rivisto da un altro sviluppatore, è possibile sospendere le modifiche invece di archiviarle. Per ulteriori informazioni, vedere Utilizzo delle aree di sospensione per il controllo della versione.

È possibile archiviare le modifiche in sospeso nei seguenti modi:

Utilizzando il sottomenu Controllo del codice sorgente del menu File.
Fare clic con il pulsante destro del mouse su un file estratto in Esplora soluzioni o in Esplora controllo del codice sorgente.
Fare clic su Archivia nella finestra Modifiche in sospeso.

Per archiviare tutte le modifiche in sospeso nel server

Nel menu Visualizza, fare clic su Altre finestre, quindi selezionare Modifiche in sospeso.
Digitare un commento nella casella Commento della finestra Modifiche in sospeso per spiegare la natura delle modifiche.

Ad esempio, è possibile digitare "aggiunta direttiva using" e, per indicare il motivo, "per attivare le chiamate alla classe Directory".
Aprire il canale Elementi di lavoro e selezionare gli elementi di lavoro pertinenti alle modifiche in sospeso.

Per ulteriori informazioni, vedere Procedura: associare gli elementi di lavoro agli insiemi di modifiche.

Aprire il canale Note di archiviazione e aggiungere i commenti relativi alle note di archiviazione per Revisore codice, Revisore sicurezza e Revisore prestazioni.

Nota:
Le note di archiviazione possono essere configurate come campi obbligatori da un amministratore e devono essere completate durante il processo di archiviazione. I campi obbligatori sono indicati dal colore ombreggiato nello sfondo della casella di testo.

Per ulteriori informazioni su come creare note di archiviazione e transizioni degli elementi di lavoro personalizzate, vedere Procedura dettagliata: personalizzazione dei criteri e delle note di archiviazione.

Scegliere Archivia.

Il processo di archiviazione di Team Foundation Server è progettato per semplificare le operazioni dei singoli utenti ed essere facilmente esteso al team. Per ottimizzare la facilità di utilizzo, nella finestra Modifiche in sospeso si presume implicitamente che si desideri archiviare tutte le modifiche. È tuttavia possibile escludere facilmente dall'archiviazione singole modifiche in sospeso. L'archiviazione applica in genere insiemi di modifiche correlate invece che singole modifiche. Al contrario, quando si eseguono archiviazioni da Esplora soluzioni o dal menu File, in Visual Studio si presuppone che si desideri archiviare soltanto le modifiche apportate all'elemento selezionato. Se si seleziona un contenitore di file, ad esempio un progetto o una soluzione, si sceglie di archiviare quell'oggetto e gli elementi in esso contenuti.

Un amministratore di Team Foundation Server può associare un insieme di criteri di archiviazione personalizzati a un progetto team per assicurare che tutte le archiviazioni soddisfino linee guida o requisiti specifici.

I singoli membri del team possono creare elementi di lavoro per tenere traccia di eventuali difetti del prodotto o di richieste relative alle funzionalità. Possono inoltre associare un elemento di lavoro a un progetto specifico. Quando si completa un elemento di lavoro, è possibile associarlo alle modifiche di origine contrassegnandolo come tale nel canale Elementi di lavoro della finestra Modifiche in sospeso. L'associazione degli elementi di lavoro alle modifiche di origine garantisce l'affidabilità dello stato di lavoro e la possibilità di tenerne traccia in modo accurato.

Finally, you and your teammates can add meaningful and consistent notes to each check-in. The process template used to create the team project determines the form and content of your check-in notes. L'amministratore di Team Foundation Server può personalizzare il modello per il team. Tra le categorie di note di archiviazione sono incluse le seguenti: impatto sulle prestazioni, requisiti relativi alla documentazione, istruzioni per i test e istruzioni di compilazione.

Processo di archiviazione

Quando si fa clic su Archivia,, nel sistema vengono raggruppati i file di origine selezionati con tutte le note di archiviazione e gli elementi di lavoro specificati nella finestra Modifiche in sospeso. Successivamente, Controllo della versione di Team Foundation consente di caricare questo raggruppamento nel server di Team Foundation e di eseguirne il commit come un nuovo insieme di modifiche. Un insieme di modificheè un insieme di revisioni di file, di note di archiviazione, di elementi di lavoro associati e di metadati di controllo della versione che viene archiviato sul server come singola entità semplice da gestire. Per ulteriori informazioni, vedere la classe Utilizzo degli insiemi di modifiche per il controllo della versione.

In secondo luogo, gli elementi di lavoro inclusi nell'insieme di modifiche vengono aggiornati in modo da contenere i collegamenti nel nuovo insieme di modifiche creato.

Viene quindi eseguita la transizione degli elementi di lavoro attraverso un flusso di lavoro in base alle regole di elaborazione predefinite esistenti. Il team può ad esempio definire una regola che consente di modificare automaticamente lo stato di un bug da "Attivo" a "Risolto" se lo stato secondario è "Correzione disponibile" quando si archivia il bug. Le regole di elaborazione e il flusso di lavoro sono creati attraverso il modello di processo utilizzato per generare il progetto team. Tuttavia, possono essere personalizzati dall'amministratore di Team Foundation Server. Per ulteriori informazioni, vedere la classe Personalizzazione dei modelli di processo.

Infine, in Controllo della versione di Team Foundation viene generata una notifica tramite posta elettronica per tutti i membri del team che desiderano ricevere notifiche di archiviazione.

Passaggi successivi

Dopo avere completato i passaggi di questa procedura dettagliata, sarà possibile acquisire ulteriori informazioni relative alle funzionalità avanzate di Controllo della versione di Team Foundation. Per ulteriori informazioni, vedere la classe Procedura dettagliata: funzionalità avanzate di controllo della versione. In questa procedura dettagliata viene descritto come creare un ramo, unire e applicare etichette agli elementi del controllo della versione.

Vedere anche

Share via