File MSSCCPRJ.SCC
Quando una soluzione o un progetto di Visual Studio viene inserita nel controllo del codice sorgente tramite l'ide, l'ide riceve due informazioni di base dal plug-in controllo del codice sorgente sotto forma di stringhe. Queste stringhe, “AuxPath„ e “ProjName„, sono opachi IDE, ma vengono utilizzate dal plug-in per individuare la soluzione o il progetto nel controllo della versione. L'ide ottiene in genere la prima volta queste stringhe chiamando Funzione SccGetProjPathe viene salvato nella soluzione o nel file di progetto per le chiamate future di a Funzione SccOpenProject. Una volta incorporate nella soluzione e file di progetto, le stringhe di ProjName “e„ di AuxPath non vengono automaticamente aggiornate quando branche utilizzarici, forcelle, o copiare la soluzione e i file di progetto nel controllo della versione. Per assicurarsi che la soluzione e il punto dei file di progetto nella posizione corretta nel controllo della versione, gli utenti devono aggiornare manualmente le stringhe. Poiché le stringhe sono progettate per essere opache, non può essere sempre chiaro come devono essere aggiornate.
Il plug-in controllo del codice sorgente possibile evitare questo problema archiviando le stringhe di ProjName “e„ di AuxPath in un file speciale denominato il file di MSSCCPRJ.SCC. È un locale, file sul lato client di proprietà e gestiti dal plug-in. Questo file non viene mai inclusi nel controllo del codice sorgente ma non viene generato dal plug-in per ogni directory contenente i file inclusi nel controllo del codice sorgente. Per determinare quali file sono soluzione e file di progetto di Visual Studio, un plug-in controllo del codice sorgente possibile confrontare le estensioni di file a uno standard o a un elenco fornito dall'utente. Una volta che l'ide rileva che un plug-in supporta il file di MSSCCPRJ.SCC, viene interrotta di includere le stringhe di ProjName “e„ di AuxPath di soluzione e file di progetto e legge le stringhe dal file di MSSCCPRJ.SCC anziché.
Un plug-in controllo del codice sorgente che supporta il file di MSSCCPRJ.SCC deve rispettare le seguenti linee guida:
Può esistere un file di MSSCCPRJ.SCC per directory.
Un file di MSSCCPRJ.SCC può contenere “il AuxPath„ e “ProjName„ per più file inclusi nel controllo del codice sorgente in una directory specificata.
La stringa “AuxPath„ non deve contenere virgolette. Può avere tra virgolette come delimitatori, ad esempio una coppia di virgolette può essere utilizzata per indicare una stringa vuota. L'ide tutte le virgolette dalla stringa “di AuxPath„ quando viene letto dal file di MSSCCPRJ.SCC.
La stringa “ProjName„ nel file di MSSCCPRJ.SCC deve corrispondere esattamente la stringa restituita dalla funzione di SccGetProjPath . Se la stringa restituita dalla funzione ha tra virgolette, la stringa nel file di MSSCCPRJ.SCC necessario racchiudere e viceversa.
Un file di MSSCCPRJ.SCC viene creato o aggiornato ogni qualvolta un file viene inserito nel controllo del codice sorgente.
Se un file di MSSCCPRJ.SCC ottiene eliminato, un provider deve rigenerarlo la volta successiva che esegue un'operazione di controllo del codice sorgente rispetto a quella directory.
An MSSCCPRJ.SCC file must strictly follow the defined format.
Questo concetto di formato di file di MSSCCPRJ.SCC
Di seguito è riportato un esempio di formato di file di MSSCCPRJ.SCC (i numeri di riga vengono forniti solo come guida e non devono essere inclusi nel corpo di file):
[Riga 1] SCC = This is a Source Code Control file
[Riga 2]
[Riga 3] [TestApp.sln]
[Riga 4] SCC_Aux_Path = "\\server\vss\"
[Riga 5] SCC_Project_Name = "$/TestApp"
[Riga 6]
[Riga 7] [TestApp.csproj]
[Riga 8] SCC_Aux_Path = "\\server\vss\"
[Riga 9] SCC_Project_Name = "$/TestApp"
La prima riga indica lo scopo del file e funge da firma per tutti i file di questo tipo. Questa riga deve essere contenuto esattamente come in tutti i file di MSSCCPRJ.SCC:
SCC = This is a Source Code Control file
Che segue è una sezione delle impostazioni per ogni file, contrassegnate dal nome file tra parentesi quadre. In questa sezione viene ripetuta per ogni file che è tracciato. Questa riga è un esempio di un nome file, cioé, [TestApp.csproj]. L'ide prevede le due righe. , Tuttavia, non definisce lo stile dei valori definiti. le variabili sono SCC_Aux_Path e SCC_Project_Name.
SCC_Aux_Path = "\\server\vss\"
SCC_Project_Name = "$/TestApp"
Non esiste un delimitatore finale di questa sezione. Il nome del file nonché di tutti i valori letterali visualizzate nel file, definito nel file di intestazione di scc.h. Per ulteriori informazioni, vedere Stringhe utilizzate come chiavi per la ricerca di un plug-in del controllo codice sorgente.
Vedere anche
Concetti
Stringhe utilizzate come chiavi per la ricerca di un plug-in del controllo codice sorgente