Registrazione e selezione (controllo del codice sorgente VSPackage)
Un controllo del codice sorgente VSPackage deve essere registrato per esporre tali a Visual Studio. Se più di un controllo del codice sorgente VSPackage è registrato, l'utente può selezionare i package VS da caricare in momenti appropriati. Selezionare una destinazione per il progetto.
Registrare un pacchetto del controllo del codice sorgente
Il pacchetto del controllo del codice sorgente viene registrato in modo da poter trovare l'ambiente di Visual Studio e la query per le funzionalità supportate. Ciò è soggetto a una combinazione di caricamento ritardato in cui un'istanza di un pacchetto viene creato soltanto quando le funzionalità o controlli sono obbligatori o necessari in modo esplicito.
Le informazioni in una chiave del Registro di sistema specifico, \SOFTWARE\Microsoft\VisualStudio HKEY_LOCAL_MACHINE \X.Ydel posto di VSPackages, dove x è il numero di versione principale e y è il numero di versione secondario. Questa procedura consente di supportare l'installazione affiancata di più versioni di Visual Studio.
L'interfaccia utente di Visual Studio (UI) supporta la selezione tra i collegamenti del controllo del codice sorgente installati più (tramite pacchetto del controllo del codice sorgente nonché dal controllo del codice sorgente Vspackage. Può esistere un plug-in controllo del codice sorgente o package VS movie per volta. Tuttavia, se un VSPackage non viene chiamato dall'altro VSPackages, è possibile presupporre che la matrice di comando contiene solo un ID di comando perché i metodi QueryStatus e Exec vengono eseguiti in un ordine definito. Esistono alcuni requisiti da parte del controllo del codice sorgente VSPackage abilitare questo meccanismo di selezione.
Voci del Registro di sistema
Un pacchetto del controllo del codice sorgente sono necessari tre GUID privati:
pacchetto GUID: Si tratta del GUID principale del pacchetto che contiene l'implementazione del controllo del codice sorgente (chiamata ID_Package in questa sezione).
Source Control GUID: This is a GUID for the source control VSPackage used to register with the Visual Studio Source Control Stub and is also used as a command UI context GUID. Il servizio di controllo del codice sorgente GUID viene registrato nel controllo del codice sorgente GUID. Nell'esempio, il controllo del codice sorgente GUID viene chiamato ID_SccProvider.
Servizio di controllo del codice sorgente GUID: Si tratta del servizio privato GUID utilizzato da Visual Studio (denominato SID_SccPkgService in questa sezione). Oltre a questo, il pacchetto del controllo del codice sorgente necessario definire altri GUID per VSPackages, finestre degli strumenti, e così via.
Le seguenti voci del Registro di sistema devono essere eseguite da un controllo del codice sorgente VSPackage:
Nome della chiave |
voci |
|---|---|
|
(impostazione predefinita) = rg_sz: {} ID_SccProvider |
|
(impostazione predefinita) = rg_sz: <Nome descrittivo del pacchetto> servizio = rg_sz: {} SID_SccPkgService |
|
(impostazione predefinita) = rg_sz: # <ID di risorsa per il nome localizzato> pacchetto = rg_sz: {} ID_Package |
Notare che il nome della chiave, SourceCodeControl, già utilizzato da Visual Studio e non è disponibile come una scelta per <PackageName> ). |
(impostazione predefinita) = rg_sz: {} ID_Package |
Selezionare un pacchetto del controllo del codice sorgente
Diversi a collegamenti in base all'API di plug-in controllo del codice sorgente e il controllo del codice sorgente Vspackage contemporaneamente possono essere registrati. Il processo di selezionare un plug-in controllo del codice sorgente o VSPackage è necessario assicurarsi che Visual Studio carichi il plug-in o il package VS al momento giusto e può rinviare i componenti non necessari di carico finché non sono necessari. Inoltre, Visual Studio necessario rimuovere qualsiasi interfaccia utente dall'altro package VS inattivo, incluse le voci di menu, finestre di dialogo e barre degli strumenti e visualizza l'interfaccia utente per il package VS attivo.
Visual Studio carica un controllo del codice sorgente VSPackage quando una qualsiasi delle seguenti operazioni viene eseguita:
La soluzione è aperta (quando la soluzione viene incluso nel controllo del codice sorgente.
Quando una soluzione o un progetto incluso nel controllo del codice sorgente è aperta, l'ide causa il controllo del codice sorgente package VS che è stato definito per tale soluzione venga caricato.
Uno dei comandi del menu del controllo del codice sorgente VSPackage vengono eseguiti.
Un controllo del codice sorgente VSPackage necessario caricare tutti i componenti necessari solo quando effettivamente utilizzeranno essere utilizzate (altrimenti noto come caricamento ritardato).
Per scambiare basato su soluzione automatico di un VSPackage
È possibile eseguire manualmente lo scambio di controllo del codice sorgente Vspackage tramite la finestra di dialogo di Visual Studioopzioni nella categoria di Controllo del codice sorgente . Per scambiare basato su soluzione automatico del pacchetto significa che un pacchetto del controllo del codice sorgente definito per una soluzione particolare viene impostato automaticamente su attivo quando la soluzione viene aperta. Ogni pacchetto del controllo del codice sorgente deve implementare SetActive e SetInactive. Visual Studio gestisce l'opzione tra i collegamenti di controllo del codice sorgente (che implementano il plug-in controllo del codice sorgente API) che il controllo del codice sorgente Vspackage.
Il pacchetto di adattatori di controllo del codice sorgente consente di passare al plug-in controllo del codice sorgente al plug-in basato sull'API. Il processo di commutazione al pacchetto intermedio del controllo del codice sorgente e la definizione del plug-in controllo del codice sorgente deve essere impostato su attivo o in inattivo è trasparente all'utente. Il pacchetto dell'adattatore è sempre attivo quando il plug-in controllo del codice sorgente è attivo. La commutazione tra due collegamenti del controllo del codice sorgente ammonta semplicemente a carico e il download della DLL plug-in. La commutazione a un controllo del codice sorgente package VS, tuttavia, include interagire con l'ide per caricare il package VS appropriato.
Un controllo del codice sorgente VSPackage viene chiamato quando una soluzione aperta e la chiave del Registro di sistema per il package VS si trova nel file della soluzione. Quando la soluzione è aperta, Visual Studio trova il valore del Registro di sistema e carica il controllo del codice sorgente appropriato VSPackage. Qualsiasi controllo del codice sorgente Vspackage necessario disporre delle voci del Registro di sistema descritte in precedenza. Una soluzione inclusa nel controllo del codice sorgente è contrassegnata come associata a un controllo del codice sorgente particolare VSPackage. Il controllo del codice sorgente Vspackage deve implementare IVsSolutionPersistence per consentire allo scambio basato su soluzione automatico di un VSPackage.
Interfaccia utente di Visual Studio per la selezione e la commutazione del pacchetto
Visual Studio fornisce un'interfaccia utente per il controllo del codice sorgente VSPackage e la selezione plug-in nella finestra di dialogo di opzioni nella categoria di Controllo del codice sorgente . Consente di selezionare il plug-in controllo del codice sorgente o il package VS attivo. un elenco a discesa include:
Tutti i pacchetti installati del controllo del codice sorgente
Tutti i plug-in installati del controllo del codice sorgente
Un “none„ opzione, che disabilita il controllo del codice sorgente
Solo l'interfaccia utente per la scelta attiva il controllo del codice sorgente è visibile. La selezione di un VSPackage nasconde l'interfaccia utente per il package VS precedente e mostrata l'interfaccia utente per il nuovo oggetto. Attiva VSPackage è selezionato per ciascun utente. Se un utente dispone di più copie di Visual Studio aperte contemporaneamente, ognuno potenzialmente possibile utilizzare un VSPackage attivo diverso. Se più utenti connessi allo stesso computer, ogni utente può disporre istanze separate di Visual Studio aperte, ognuna con un VSPackage attivo diverso. Quando più istanze di Visual Studio sono chiusi da un utente, il controllo del codice sorgente package VS che attiva all'ultima soluzione aperta diventa il controllo del codice sorgente predefinito package VS, per essere attivo impostato sul riavvio.
A differenza delle versioni precedenti di Visual Studio, il riavvio dell'IDE non è più l'unico modo per passare il controllo del codice sorgente Vspackage. La selezione di un VSPackage è automatica. Passare i pacchetti richiede privilegi utente di Windows (non gestita) o utente di potenza).
Vedere anche
Riferimenti
Altre risorse
Funzionalità di un VSPackage del controllo del codice sorgente