Aggiungere file al server

L'aggiunta di un file al controllo della versione viene spesso eseguita automaticamente quando si usa Esplora soluzioni e il progetto è sottoposto al controllo della versione. Tuttavia, in alcuni casi è necessario effettuare ulteriori passaggi per aggiungere il progetto al controllo della versione.

Suggerimento

Prima di aggiungere i file al controllo della versione, è necessario innanzitutto configurare l'area di lavoro nel computer di sviluppo.

Per saperne di più

• Creare un nuovo progetto di codice e una soluzione nel controllo della versione

• Inserire una soluzione esistente e i progetti di codice nel controllo della versione

• Aggiungere uno o più file al controllo della versione

• Usare i binari di terze parti non compilati dal codice

• Personalizzare i file ignorati dal controllo della versione

• Lavorare dal prompt dei comandi

Creare un nuovo progetto di codice e una soluzione nel controllo della versione

È possibile creare contemporaneamente un nuovo progetto team e aggiungerlo al controllo della versione. In questo modo l'utente e il team potranno sfruttare immediatamente tutti i vantaggi del controllo della versione dalla prima riga di codice scritta.

1. In Visual Studio connettersi al progetto team, se non si è già connessi.

2. Scegliere File, Nuovo, Progetto (tastiera: CTRL + MAIUSC + N).

   Verrà visualizzata la finestra di dialogo Nuovo progetto.

3. Selezionare il tipo di progetto di codice che si desidera creare.

4. Nella casella Nome specificare il nome del progetto di codice.

5. Se viene visualizzato l'elenco Soluzione, verificare che Crea nuova soluzione sia selezionato.

6. Nell'elenco Percorso specificare il percorso di una cartella di lavoro locale appropriata, ad esempio c:\code\SiteApp\Main\, nell'area di lavoro creata durante la configurazione del computer di sviluppo.

   Verificare che le caselle di controllo Aggiungi al controllo del codice sorgente e Crea directory per soluzione siano selezionate.

7. Scegliere OK per creare il progetto di codice che quindi può essere visualizzato in Esplora soluzioni (tastiera: CTRL + ALT + L).

   

8. In Esplora soluzioni aprire il menu di scelta rapida della soluzione creata o modificata e quindi scegliere Archivia per inviare le modifiche in sospeso.

Inserire una soluzione esistente e i progetti di codice nel controllo della versione

Per aggiungere una soluzione esistente al controllo della versione, spostare tutti i file della soluzione nell'area di lavoro e quindi aggiungerli.

Nota

Evitare di usare la finestra di dialogo Aggiungi soluzione al controllo del codice sorgente per caricare la soluzione nel controllo della versione.È invece opportuno usare la procedura seguente:

1. In Visual Studio connettersi al progetto team, se non si è già connessi.

2. Scegliere Visualizza, Altre finestre, Esplora controllo codice sorgente.

3. In Esplora controllo codice sorgente passare a una cartella padre logica per la soluzione, ad esempio $/SiteApp/Main, dove SiteApp è il nome del progetto team. Perché si tratta di una cartella padre appropriata?

4. Scegliere il collegamento accanto a Percorso locale per aprire la cartella padre in Esplora risorse (Esplora file in Windows 8).

   Cosa fare se il testo del collegamento è "Non mappato"?

5. Spostare la cartella contenente la soluzione nella cartella padre.

6. In Visual Studio scegliere File, Apri, Progetto/Soluzione, quindi usare la finestra di dialogo Apri progetto per aprire la soluzione.

7. In Esplora soluzioni (tastiera: CTRL + ALT + L) selezionare la soluzione, aprire il menu di scelta rapida, quindi scegliere Aggiungi soluzione al controllo del codice sorgente.

8. In Esplora soluzioni selezionare la soluzione, aprire il menu di scelta rapida, quindi scegliere Archivia.

9. In Team Explorer viene visualizzata la pagina Modifiche in sospeso.

10. Sono presenti Modifiche rilevate visualizzate nella sezione Modifiche escluse?

    • No: continuare con il passaggio successivo.

    • Sì: selezionare il collegamento Modifiche rilevate. Verrà visualizzata la finestra di dialogo Promuovi modifiche candidato. Nei progetti di codice nella soluzione non viene fatto alcun riferimento ai file elencati in questa finestra di dialogo. Se il team avrà bisogno di questi file, assicurarsi che siano selezionati e quindi scegliere Alza di livello per spostarli nella sezione Modifiche incluse della pagina Modifiche in sospeso. Per altre informazioni, vedere Archiviare il proprio lavoro nel codebase del team.

11. Quando possibile, inviare le modifiche in sospeso.

Aggiungere uno o più file al controllo della versione

Quando si usa Esplora soluzioni per aggiungere un file al progetto di codice, il sistema lo aggiunge automaticamente al controllo della versione. Tuttavia, è anche possibile aggiungere i file a cui non viene fatto riferimento nei progetti di codice.

Suggerimento

Se si crea un processo automatizzato oppure si preferisce usare il prompt dei comandi, è possibile usare Comando Add anziché le procedure riportate di seguito.

Aggiungere automaticamente uno o più file al controllo della versione

Se si usa un'area di lavoro locale, i nuovi file vengono automaticamente rilevati nella pagina Modifiche in sospeso.

1. In Visual Studio connettersi al progetto team, se non si è già connessi.

2. Scegliere Visualizza, Altre finestre, Esplora controllo codice sorgente.

3. In Esplora controllo codice sorgente passare alla cartella in cui si desidera aggiungere i file o le cartelle.

4. Scegliere il collegamento accanto a Percorso locale per aprire la cartella di destinazione in Esplora risorse (Esplora file in Windows 8).

   Spostare file e cartelle in questa cartella.

   Cosa fare se il testo del collegamento è "Non mappato"?

5. In Visual Studio scegliere Modifiche in sospeso in Team Explorer.

6. Nella sezione Modifiche escluse della pagina Modifiche in sospeso scegliere Modifiche rilevate.

7. Nella finestra di dialogo Promuovi modifiche candidato assicurarsi che solo i file che si desidera archiviare siano selezionati, quindi scegliere Alza di livello.

8. Inviare le modifiche in sospeso.

Aggiungere manualmente file al controllo della versione

È anche possibile aggiungere manualmente i file al controllo della versione.

1. Scegliere Visualizza, Altre finestre, Esplora controllo codice sorgente.

2. In Esplora controllo codice sorgente passare alla cartella in cui si desidera aggiungere i file.

   Importante

   Assicurarsi che questa cartella sia archiviata prima di continuare.Se si sta creando una cartella, aprire il menu di scelta rapida e scegliere Archivia, quindi archiviare la nuova cartella prima di continuare.

3. Trascinare le cartelle o i file da Esplora risorse (o da Esplora file) nella cartella in Esplora controllo codice sorgente.

4. Quando viene visualizzata la finestra di dialogo Aggiungi al controllo del codice sorgente, assicurarsi che tutti i file che si desidera aggiungere siano selezionati e quindi scegliere Includi elementi.

5. Scegliere Fine.

6. In Team Explorer, quando viene visualizzata la pagina Modifiche in sospeso, verificare che i binari che si desidera aggiungere siano visualizzati nella sezione Modifiche incluse. Scegliere Archivia.

Usare i binari di terze parti non compilati dal codice

Molti team sviluppano codice che dipende da file binari non compilati dalla soluzione in cui gestiscono il codice. In genere questi binari fanno parte di una libreria che è stata concessa in licenza al team da terze parti.

Talvolta questi binari derivano da un altro team nella stessa società. Ad esempio, il team A dipende dai binari prodotti dal team B e ogni team deve per qualche motivo lavorare in insiemi di progetti team diversi. Di conseguenza, il team B consegna i binari al team A, che li archivia nel controllo della versione.

Suggerimento

Se i computer di sviluppo e i server di compilazione possono accedere a Internet, NuGet può semplificare al team la gestione delle dipendenze e mantenere i binari aggiornati.Anche se si decide di usare NuGet, è consigliabile aggiungere comunque i binari al controllo della versione in modo da poter riprodurre e compilare delle versioni cronologiche del codice.

La struttura dell'area di lavoro e della cartella da usare per archiviare i file binari di terze parti varia dalla modalità con cui la soluzione dipende da queste librerie.

Aggiungere i file binari all'interno della struttura di cartelle o di branch

Se si inseriscono i binari di terze parti nella stessa cartella padre che contiene le cartelle della soluzione, tutti i progetti di codice di tutte le soluzioni possono fare riferimento alle librerie con lo stesso percorso relativo.

Ad esempio, un team usa questa struttura di cartelle:

Ogni progetto di codice può fare riferimento alla cartella della libreria con il seguente percorso relativo: ../../Lib

Se, successivamente nel progetto il team deve isolare attività separate che richiedono versioni diverse dei binari, è possibile creare un branch di una cartella di libreria insieme alla cartella della soluzione.

Ad esempio, la versione 1 di un'applicazione si basa sulla versione 1 di una libreria. Poiché alcuni sviluppatori del team di accesso ai dati lavorano alla versione successiva, si basano sulla versione 2. Ma gli altri team non sono ancora pronti per l'aggiornamento. È possibile usare i branch per gestire questo tipo di situazione.

Usare un'area di lavoro per eseguire il mapping dei binari

Alcune società devono gestire dipendenze più complesse dalle librerie di terze parti. Ad esempio, più progetti team che contengono soluzioni con dipendenze diverse da un set comune di librerie. In casi come questo, è possibile archiviare le librerie di terze parti in un progetto team dedicato. I collaboratori ai vari progetti team eseguono il mapping nelle cartelle che contengono le librerie necessarie.

Ad esempio, FabrikamFiber crea un progetto team con la seguente struttura di cartelle e branch:

Raisa configura il computer di sviluppo con due aree di lavoro per due attività diverse, in ognuna delle quali viene eseguito il mapping delle librerie necessarie:

Personalizzare i file ignorati dal controllo della versione

Per impostazione predefinita, determinati tipi di file, ad esempio i file con estensione dll, vengono ignorati dal controllo della versione. Di conseguenza, si verifica quanto segue:

• Quando si aggiungono file ignorati alle cartelle di cui è stato eseguito il mapping in un'area di lavoro locale, questi file non vengono visualizzati nella pagina Modifiche in sospeso in Team Explorer.

• Quando si tenta di aggiungere i file ignorati usando la finestra di dialogo Aggiungi al controllo del codice sorgente, ad esempio trascinandoli in Esplora controllo codice sorgente, essi vengono visualizzati automaticamente nella scheda Elementi esclusi.

È possibile configurare quali tipi di file vengono ignorati inserendo il file di testo con estensione tfignore nella cartella a cui si desidera applicare le regole. Gli effetti del file con estensione tfignore sono ricorsivi. Tuttavia, è possibile creare file con estensione tfignore in sottocartelle per eseguire l'override degli effetti di un file con estensione tfignore in una cartella padre.

Regole dei file con estensione tfignore

Le seguenti regole si applicano a un file con estensione tfignore:

• # inizia una riga di commento

• I caratteri jolly * e ? sono supportati.

• Un filespec è ricorsivo a meno che non sia preceduto dal carattere \.

• ! nega un filespec (i file che corrispondono al modello non vengono ignorati)

Esempio di file con estensione tfignore

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# Ignore .txt files in this folder 
\*.txt
# Ignore .xml files in this folder and all its sub-folders
*.xml
# Ignore all files in the Temp sub-folder
\Temp
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Creare e usare un file con estensione tfignore

Sebbene sia possibile creare manualmente un file di testo con estensione tfignore usando le regole sopra indicate, è possibile anche generarne uno automaticamente dopo che la pagina Modifiche in sospeso ha rilevato una modifica.

Per generare automaticamente un file con estensione tfignore

1. Nella sezione Modifiche escluse della pagina Modifiche in sospeso scegliere il collegamento Modifiche rilevate.

   Verrà visualizzata la finestra di dialogo Promuovi modifiche candidato.

2. Selezionare un file, aprire il menu di scelta rapida e scegliere Ignora questo elemento locale, Ignora per estensione, Ignora per nome file o Ignora per cartella.

3. Scegliere OK o Annulla per chiudere la finestra di dialogo Promuovi modifiche candidato.

4. Un file con estensione tfignore verrà visualizzato nella sezione Modifiche incluse della pagina Modifiche in sospeso. È possibile aprire questo file e modificarlo a seconda delle esigenze.

Il file con estensione tfignore viene automaticamente aggiunto come modifica in sospeso inclusa in modo che le regole create verranno applicate a ogni membro del team che ottiene il file.

Lavorare dal prompt dei comandi

• Comando Add Carica i file dall'area di lavoro del computer di sviluppo nel server.

Vedere anche

Altre risorse

Decidere se utilizzare un'area di lavoro locale o del server