Sdílet prostřednictvím


Architektura balíčku VSPackage správy zdrojového kódu

Balíček správy zdrojového kódu je balíček VSPackage, který používá služby, které poskytuje integrované vývojové prostředí sady Visual Studio. Naopak balíček správy zdrojového kódu poskytuje své funkce jako služba správy zdrojového kódu. Balíček správy zdrojového kódu je navíc všestrannější alternativou než modul plug-in správy zdrojového kódu pro integraci správy zdrojového kódu do sady Visual Studio.

Modul plug-in správy zdrojového kódu, který implementuje rozhraní API modulu plug-in správy zdrojového kódu, se řídí striktní smlouvou. Například modul plug-in nemůže nahradit výchozí uživatelské rozhraní sady Visual Studio. Kromě toho rozhraní API modulu plug-in správy zdrojového kódu neumožňuje modulu plug-in implementovat vlastní model správy zdrojového kódu. Balíček správy zdrojového kódu však překoná obě tato omezení. Balíček správy zdrojového kódu má úplnou kontrolu nad prostředím správy zdrojového kódu uživatele sady Visual Studio. Kromě toho balíček správy zdrojového kódu může používat vlastní model a logiku správy zdrojového kódu a může definovat všechna uživatelská rozhraní související se správou zdrojového kódu.

Komponenty balíčku správy zdrojového kódu

Jak je znázorněno v diagramu architektury, součást sady Visual Studio s názvem Zástupný kód správy zdrojového kódu je balíček VSPackage, který integruje balíček správy zdrojového kódu se sadou Visual Studio.

Zástupný kód správy zdrojového kódu zpracovává následující úlohy.

  • Poskytuje běžné uživatelské rozhraní, které se vyžaduje pro registraci balíčku správy zdrojového kódu.

  • Načte balíček správy zdrojového kódu.

  • Nastaví balíček správy zdrojového kódu jako aktivní/neaktivní.

    Zástupný kód správy zdrojového kódu vyhledá aktivní službu pro balíček správy zdrojového kódu a směruje všechna příchozí volání služby z integrovaného vývojového prostředí (IDE) do daného balíčku.

    Balíček adaptéru správy zdrojového kódu je speciální balíček správy zdrojového kódu, který sada Visual Studio poskytuje. Tento balíček je centrální komponentou pro podporu modulů plug-in správy zdrojového kódu na základě rozhraní API modulu plug-in správy zdrojového kódu. Pokud je modul plug-in správy zdrojového kódu aktivním modulem plug-in, zástupný kód správy zdrojového kódu odesílá své události do balíčku adaptéru správy zdrojového kódu. Balíček adaptéru správy zdrojového kódu pak komunikuje s modulem plug-in správy zdrojového kódu pomocí rozhraní API modulu plug-in správy zdrojového kódu a také poskytuje výchozí uživatelské rozhraní, které je společné pro všechny moduly plug-in správy zdrojového kódu.

    Pokud je balíček správy zdrojového kódu aktivním balíčkem, na druhé straně zástupný kód správy zdrojového kódu přímo komunikuje s balíčkem pomocí rozhraní sady Visual Studio SDK balíčku správy zdrojového kódu. Balíček správy zdrojového kódu zodpovídá za hostování vlastního uživatelského rozhraní správy zdrojového kódu.

    Source Control Architecture graphic

    Pro balíček správy zdrojového kódu sada Visual Studio neposkytuje kód správy zdrojového kódu ani rozhraní API pro integraci. Porovnejte to s přístupem popsaným v části Vytvoření modulu plug-in správy zdrojového kódu, kde modul plug-in správy zdrojového kódu musí implementovat pevnou sadu funkcí a zpětných volání.

    Stejně jako jakýkoli VSPackage, balíček správy zdrojového kódu je objekt COM, který lze vytvořit pomocí CoCreateInstance. Balíček VSPackage se zpřístupní integrovanému vývojovému prostředí sady Visual Studio implementací IVsPackage. Po vytvoření instance obdrží balíček VSPackage ukazatel webu a IServiceProvider rozhraní, které poskytuje přístup VSPackage k dostupným službám a rozhraním v integrovaném vývojovém prostředí (IDE).

    Vytvoření balíčku správy zdrojového kódu založeného na VSPackage vyžaduje pokročilejší znalosti programování než psaní modulu plug-in založeného na rozhraní API pro správu zdrojového kódu.