Delen via


Invoegtoepassingsarchitectuur voor broncodebeheer

U kunt ondersteuning voor broncodebeheer toevoegen aan de IDE (Integrated Development Environment) van Visual Studio door een invoegtoepassing voor broncodebeheer te implementeren en te koppelen. De IDE maakt verbinding met de invoegtoepassing voor broncodebeheer via de goed gedefinieerde broncodebeheer-Plug-In-API. De IDE toont de versiebeheerfuncties van het broncodebeheersysteem door een gebruikersinterface (UI) te bieden die bestaat uit werkbalken en menuopdrachten. De invoegtoepassing voor broncodebeheer implementeert de functionaliteit van broncodebeheer.

Invoegtoepassingsbronnen voor broncodebeheer

De invoegtoepassing Broncodebeheer biedt bronnen om uw versiebeheertoepassing te maken en te verbinden met de Visual Studio IDE. De invoegtoepassing Broncodebeheer bevat de API-specificatie die moet worden geïmplementeerd door een invoegtoepassing voor broncodebeheer, zodat deze kan worden geïntegreerd in de Visual Studio IDE. Het bevat ook een codevoorbeeld (geschreven in C++) waarmee een invoegtoepassing voor skeletbronbeheer wordt geïmplementeerd om de implementatie van essentiële functies te demonstreren die compatibel zijn met de invoegtoepassing Broncodebeheer.

Met de API-specificatie voor broncodebeheer kunt u elk broncodebeheersysteem van uw keuze gebruiken als u een bronbeheer-DLL maakt met de vereiste set functies die zijn geïmplementeerd in overeenstemming met de invoegtoepassing Broncodebeheer-API.

Components

Het bronbeheeradapterpakket in het diagram is het onderdeel van de IDE waarmee de aanvraag van de gebruiker voor een bronbeheerbewerking wordt omgezet in een functieaanroep die wordt ondersteund door de invoegtoepassing voor broncodebeheer. Hiervoor moeten de IDE en de invoegtoepassing voor broncodebeheer een effectief dialoogvenster hebben dat informatie heen en weer doorgeeft tussen de IDE en de invoegtoepassing. Opdat deze dialoog kan plaatsvinden, moeten zij beiden dezelfde taal spreken. De invoegtoepassings-API voor broncodebeheer die in deze documentatie wordt beschreven, is de algemene woordenlijst voor deze uitwisseling.

Architectuurdiagram broncodebeheer

Architectuurdiagram met de interactie tussen Visual Studio en de broncodebeheer-invoegtoepassing

Zoals wordt weergegeven in het architectuurdiagram, host de Visual Studio-shell, gelabeld als VS Shell in het diagram, de werkprojecten en bijbehorende onderdelen van de gebruiker, zoals de editors en Solution Explorer. Het broncodebeheeradapterpakket verwerkt de interactie tussen de IDE en de invoegtoepassing voor broncodebeheer. Het broncodebeheeradapterpakket biedt een eigen gebruikersinterface voor broncodebeheer. Het is de gebruikersinterface op het hoogste niveau waarmee de gebruiker communiceert om het bereik van een broncodebeheerbewerking te initiëren en te definiëren.

De invoegtoepassing voor broncodebeheer kan een eigen gebruikersinterface hebben, die kan bestaan uit twee delen, zoals wordt weergegeven in de afbeelding. Het vak met het label 'Gebruikersinterface van leverancier' vertegenwoordigt aangepaste elementen van de gebruikersinterface die u als maker van de broncodebeheerinvoegtoepassing opgeeft. Deze worden rechtstreeks weergegeven door de invoegtoepassing voor broncodebeheer wanneer de gebruiker een geavanceerde bewerking voor broncodebeheer aanroept. Het vak met het label 'Helper UI' is een set ui-functies voor broncodebeheer die indirect worden aangeroepen via de IDE. De invoegtoepassing voor broncodebeheer geeft ui-gerelateerde berichten door aan de IDE via speciale callbackfuncties van de IDE. De gebruikersinterface van de helper vereenvoudigt een naadloze integratie met de IDE (vaak via het gebruik van een geavanceerde knop) en biedt zo een meer uniforme eindgebruikerservaring.

Een invoegtoepassing voor broncodebeheer kan geen wijzigingen aanbrengen in de Visual Studio-shell en bijgevolg in het broncodebeheeradapterpakket of de gebruikersinterface van broncodebeheer die door de IDE wordt geleverd. Het moet maximaal gebruikmaken van de flexibiliteit die wordt geboden door de implementatie van de verschillende API-functies voor broncodebeheer die bijdragen aan een geïntegreerde ervaring voor de eindgebruiker. De naslagsectie van de API-documentatie voor bronconfiguratiebeheer-plug-in bevat informatie over enkele geavanceerde mogelijkheden voor bronconfiguratiebeheer-plug-ins. Als u gebruik wilt maken van deze functies, moet de invoegtoepassing voor broncodebeheer de geavanceerde mogelijkheden voor de IDE declareren tijdens de initialisatie en moet deze specifieke geavanceerde functies implementeren voor elke mogelijkheid.