Registrierung und Auswahl (Quellcodeverwaltung VSPackage)

Artikel
05/16/2015

Eine Quellcodeverwaltung VSPackage muss registriert sein, um ihn Visual Studioverfügbar zu machen. Wenn mehr als eine Quellcodeverwaltung VSPackage registriert wird, kann der Benutzer auswählen, der an den entsprechenden Zeiten VSPackages geladen werden soll. Weitere Informationen finden Sie unter VSPackages auf VSPackages und wie sie registriert.

Ein Quellcodeverwaltungs-Paket registrieren

Das Paket Quellcodeverwaltung wird registriert, sodass die Visual Studio Umgebung und seine unterstützten Funktionen für Abfrage findet. Dies stimmt mit einem verzögerte Laden Schema einher, in dem sich eine Instanz eines Pakets nur erstellt wird, wenn seine Funktionen erforderlich sind oder Befehle oder explizit angefordert werden.

VSPackages-Platz von Informationen in einem versionsspezifischen Registrierungsschlüssel HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ VisualStudio \X.Y, in dem X die Hauptversionsnummer und die Nebenversionsnummer J ist. Diese Vorgehensweise bietet die Möglichkeit, die parallele Installation mehrerer Versionen von Visual Studiozu unterstützen.

Die Visual Studio Benutzeroberfläche (UI) unterstützt Auswahl aus mehreren installierten unter Quellcodeverwaltung steckverbindungen (über das Quellcodeverwaltungs-Adapter-Paket) sowie von der Quellcodeverwaltung VSPackages. Es kann nur ein aktives Quellcodeverwaltungs-Plug-In jeweils einem VSPackage oder erteilen. Allerdings, wie im Folgenden beschrieben, ermöglicht die IDE den Wechsel zwischen steckverbindungen Quellcodeverwaltung und VSPackages von einem automatischen Projektmappe-basierten Paket Auslagerung Mechanismus. Es gibt mehrere Anforderungen der Seiten der Quellcodeverwaltung VSPackage den Auswahlmechanismus zu aktivieren.

Registrierungseinträge

Ein Quellcodeverwaltung Paket erfordert drei private GUID:

Paket GUID: Dies ist die Main GUID für das Paket, das die Implementierung der Quellcodeverwaltung enthält (ID_Package in diesem Abschnitt).
Quellcodeverwaltung GUID: Dies ist eine GUID für die Quellcodeverwaltung ein VSPackage, der verwendet wird, um mit dem Visual Studio-Quellcodeverwaltungs-Stub zu registrieren und wird auch als Elementkontext Befehlsbenutzeroberflächen verwendete GUID. Der GUID für Quellcodeverwaltung wird unter der Quellcodeverwaltung GUID registriert. Im Beispiel wird die Quellcodeverwaltung GUID ID_SccProvider aufgerufen.
GUID für die Quellcodeverwaltung: Dies ist der private Dienst GUID, der vom Visual Studio aufgerufen wird (SID_SccPkgService in diesem Abschnitt). Zusätzlich zu diesen muss das Paket anderen GUID für Quellcodeverwaltung VSPackages Toolfenster definieren, usw.

Die folgenden Registrierungseinträge müssen von einer Quellcodeverwaltung VSPackage gemacht werden:

Schlüsselname	Einträge
`HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ VisualStudio\ X.Y\ SourceControlProviders\`	(Standard) = rg_sz: {ID_SccProvider}
`HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ VisualStudio\ X.Y\ SourceControlProviders\ {ID_SccProvider}\`	(Standard) = rg_sz: <Friendly name of Package> Dienst = rg_sz: {SID_SccPkgService}
`HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ VisualStudio\ X.Y\ SourceControlProviders\ {ID_SccProvider}\ Name\`	(Standard) = rg_sz: # <Resource ID for localized name> Paket = rg_sz: {ID_Package}
`HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ VisualStudio\ X.Y\ SolutionPersistence\ <PackageName>\` (Beachten Sie, den der Schlüsselname, SourceCodeControl, bereits durch Visual Studio verwendet wird und nicht als Auswahl für <PackageName> Englisch verfügbar).	(Standard) = rg_sz: {ID_Package}

Ein Quellcodeverwaltungs-Paket auswählen

Einige API-basierte VSPackages des Plug-Ins und Quellcodeverwaltung Quellcodeverwaltungs-Plug-In werden gleichzeitig registriert werden. Der Prozess der Auswahl eines VSPackage oder Quellcodeverwaltungs-Plug-In müssen sicherstellen, dass Visual Studio VSPackage oder des Plug-Ins zum entsprechenden Zeitpunkt lädt, kann das Laden und unnötiger Komponenten verzögern, bis sie benötigt werden. Außerdem muss Visual Studio alle Benutzeroberfläche von anderem inaktivem VSPackages einschließlich Symbolleisten, Dialogfelder und Entfernen von Menüelementen. Darüber hinaus wird die Benutzeroberfläche für aktive VSPackage an.

Visual Studio lädt eine Quellcodeverwaltung VSPackage, wenn einer der folgenden Vorgänge ausgeführt:

Projektmappe geöffnet (wenn die Projektmappe unter Quellcodeverwaltung steht).

Wenn eine Projektmappe oder ein Projekt in die Quellcodeverwaltung geöffnet ist, führt die IDE die Quellcodeverwaltung ein VSPackage, die festgelegt wurde, sodass diese Projektmappe geladen werden kann.
Jede der Menübefehle der Quellcodeverwaltung VSPackage ausgeführt werden.

Eine Quellcodeverwaltung VSPackage sollte alle Komponenten laden, die nur bei Bedarf sie tatsächlich verwendet werden (andernfalls wesen bekannt als verzögertes Laden).

Automatisches Projektmappe-basiertes VSPackage-auslagern

Sie können die Quellcodeverwaltung VSPackages vom DialogfeldOptionenVisual Studio unter der Kategorie Quellcodeverwaltung manuell auslagern. Automatische Projektmappe-basierte Paket auslagerung Quellcodeverwaltung bedeutet, dass ein Paket mit einer bestimmten Projektmappe festgelegt wurde, automatisch auf Aktiv festgelegt wird, wenn diese Projektmappe geöffnet ist. Jedes Paket muss SetActive Quellcodeverwaltung und SetInactiveimplementieren. Visual Studio behandelt den Schalter zwischen den steckverbindungen Quellcodeverwaltung (das Quellcodeverwaltungs-Plug-In API implementiert) und VSPackages Quellcodeverwaltung.

Das Quellcodeverwaltungs-Adapter-Paket wird verwendet, um jedem Quellcodeverwaltungs-Plug-In API-basiertes Plug-In zu wechseln. Der Prozess der den Wechsel zwischen dem Quellcodeverwaltungs-Adapter-Paket und das Bestimmen, das Quellcodeverwaltungs-Plug-In auf Aktiv oder inaktivem festgelegt werden muss, ist für den Benutzer transparent. Das Adapter-Paket ist immer aktiv, wenn ein Quellcodeverwaltungs-Plug-In aktiv ist. Quellcodeverwaltung Wechsel zwischen zwei steckverbindungen beläuft sich einfach auf Laden und Entladen des Plug-Ins DLL. setzt den Wechsel zu einer Quellcodeverwaltung, jedoch VSPackages mit der IDE zu interagieren, um entsprechende VSPackages geladen werden soll.

Eine Quellcodeverwaltung VSPackage wird aufgerufen, wenn eine Projektmappe geöffnet ist und die Registrierung für ein VSPackage in der Projektmappendatei ist. Wenn die Projektmappe geöffnet ist, sucht Visual Studio den Registrierungswert und lädt die entsprechende Quellcodeverwaltung VSPackage. Alle Quellcodeverwaltung VSPackages muss die Registrierungseinträge verfügen, die zuvor beschrieben werden. Eine Lösung, die der Quellcodeverwaltung unterliegt, wird als, zuordnend mit einer bestimmten quellcodeverwaltung VSPackage. Quellcodeverwaltung VSPackages muss IVsSolutionPersistence implementieren, um die automatische Projektmappe-basiertes VSPackage-Auslagern zu aktivieren.

Visual Studio Benutzeroberfläche für Paket-Auswahl und den Wechsel

Visual Studio stellt eine Benutzeroberfläche für die Quellcodeverwaltung und VSPackages Plug-In Auswahl im Optionen Dialogfeld Quellcodeverwaltung unter der Kategorie bereit. Sie ermöglicht dem Benutzer das aktive VSPackage oder Quellcodeverwaltungs-Plug-In auswählen. Eine Dropdownliste enthält:

Alle installierten Lösungspaketen Quellcodeverwaltung
Alle installierten steckverbindungen Quellcodeverwaltung
Keines „Option“ Deaktivieren der Quellcodeverwaltung

Nur die Benutzeroberfläche für die aktive Quellcodeverwaltungs-Auswahl ist sichtbar. Die VSPackage-Auswahl blendet die Benutzeroberfläche für vorherige VSPackage aus und zeigt die Benutzeroberfläche für den neuen an. Aktive VSPackage wird pro Benutzer ausgewählt. Wenn ein Benutzer die mehrere Kopien von Visual Studio gleichzeitig geöffnet ist, kann jeder andere aktives VSPackage nutzen. Wenn mehrere Benutzer bei der gleichen Computer angemeldet sind, kann jeder Benutzer die separaten Instanzen von Visual Studio geöffnet, jeweils mit anderen aktiven VSPackage haben. Wenn mehrere Instanzen von Visual Studio von einem Benutzer geschlossen werden, nimmt die Quellcodeverwaltung ein VSPackage, die für geöffnete Projektmappe aktiv war, wird die standardmäßige Quellcodeverwaltung auf Neu starten, um ein VSPackage Aktiv festgelegt ist.

Im Gegensatz zu früheren Versionen von Visual Studio, ist ein IDE-Neustart nicht mehr die einzige Möglichkeit zur Quellcodeverwaltung VSPackages zu wechseln. VSPackage-Auswahl ist automatisch. Das Wechseln von Paketen benötigt Fenster-Benutzer privilege (kein Administrator oder Hauptbenutzer).