Información general sobre la integración de Control de código fuenteSource Control Integration Overview

Esta sección comparan las dos maneras de integrar en control de código fuente de Visual Studio; un control de código fuente complemento y un VSPackage que proporciona una solución de control de código fuente y resalta las nuevas características de control de código fuente.This section compares the two ways to integrate into Visual Studio source control; a source control Plug-in and a VSPackage that provides a source control solution and highlights the new source control features. Visual Studio permite la conmutación manual entre el control de código fuente VSPackages y los complementos de control de código fuente, así como basados en soluciones cambiar de forma automática.Visual Studio allows for manual switching between source control VSPackages and source control plug-ins as well as automatic solution-based switching.

Integración del Control de código fuenteSource Control Integration

Visual StudioVisual Studioadmite dos tipos de opciones de integración de control de código fuente. supports two types of source control integration options. En todas las versiones de Visual StudioVisual Studio, aún podrá integrar un complemento basado en el origen de Control API de complementos (anteriormente también denominados MSSCCI API), que proporciona funcionalidad de control de código fuente básico al usar Visual Studio origen (de interfaz de usuario de control INTERFAZ DE USUARIO).In all versions of Visual StudioVisual Studio, you can still integrate a plug-in based on the Source Control Plug-in API (previously also referred to as the MSSCCI API), which provides basic source control functionality while using Visual Studio source control user interface (UI). Un control de código fuente VSPackage, por otro lado, proporciona una integración profunda nueva, Visual Studio SDKVisual Studio SDK ruta de acceso adecuado para la integración de control de código fuente que requiere un alto nivel de sofisticación y autonomía en su modelo de control de origen.A source control VSPackage, on the other hand, provides a new, deep-integration Visual Studio SDKVisual Studio SDK path suitable for source control integration that demands a high level of sophistication and autonomy in its source control model.

Información general del Control de origenSource Control Overview

Complemento de Control de código fuenteSource Control Plug-in

Todas las versiones de Visual Studio admiten la API de complementos de Control de la versión 1.2 de la especificación de origen como una ruta de acceso de integración.All versions of Visual Studio support the Source Control Plug-in API specification version 1.2 as an integration path. Un implementador de complemento de control de código fuente escribe un archivo DLL que implementa las funciones de API de complemento de Control de código fuente para la integración del control de código fuente y el registro como se describe en crear un complemento de Control de código fuente.A source control plug-in implementer writes a DLL that implements the Source Control Plug-in API functions for source control integration and registration as described in Creating a Source Control Plug-in. En este enfoque, el entorno de desarrollo integrado (IDE) utiliza el Visual StudioVisual Studio interfaz de usuario para los cuadros de diálogo, como la protección, la desprotección, páginas de propiedades de herramientas/opciones, las barras de herramientas y glifos de control de código fuente.In this approach, the Integrated Development Environment (IDE) uses the Visual StudioVisual Studio UI for dialog boxes, such as check in, checkout, tools/options property pages, toolbars, and source control glyphs. Estricta observancia de la API de complemento de Control de origen garantiza una fácil integración en Visual Studio y una experiencia sin problemas para el usuario.Strict adherence to the Source Control Plug-in API insures an easy integration into Visual Studio and a trouble-free experience for the user. Esto significa que el complemento de control de origen debe implementar la mayoría de las funciones y las devoluciones de llamada que se detallan en la API.This means the source control plug-in must implement most of the functions and callbacks detailed in the API.

Para implementar un complemento mediante la API de complemento de Control de origen de control de código fuente, siga estos pasos:To implement a source control plug-in using the Source Control Plug-in API, follow these steps:

  1. Crear un archivo DLL que implementa las funciones especificadas en complementos de Control de código fuente.Create a DLL that implements the functions specified in Source Control Plug-ins.

  2. Registrar el archivo DLL mediante la realización de las entradas del Registro adecuados (se describe en Cómo: instalar un complemento de Control de código fuente).Register the DLL by making the appropriate registry entries (described in How to: Install a Source Control Plug-in).

  3. Crear una aplicación auxiliar de interfaz de usuario y la presentación cuando se lo solicite el paquete de adaptador de Control de origen (el componente de Visual Studio que controla la funcionalidad de control de código fuente a través de complementos de control de código fuente)Create a helper UI and display when prompted by the Source Control Adapter Package (the Visual Studio component that handles source control functionality via source control plug-ins)

    En respuesta a un comando de control de código fuente, el IDE de Visual Studio presenta una interfaz de usuario estándar para las operaciones básicas y, a continuación, pasa la información para el control de código fuente complemento a través de las funciones definidas en la API de complementos de Control de código fuente.In response to a source control command, the Visual Studio IDE presents a standard UI for the basic operations and then passes the information to the source control plug-in via the functions defined in the Source Control Plug-in API. Para las opciones avanzadas, el complemento de control de código fuente puede llamarse en para presentar su propia interfaz de usuario, por ejemplo, exploración de un proyecto controlado por código fuente.For advanced options, the source control plug-in may be called on to present its own UI, for example, browsing for a source-controlled project. Esto significa que el usuario puede presentarse con dos estilos posiblemente diferentes de interfaz de usuario cuando se trabaja con control de código fuente: la interfaz de usuario que presenta Visual Studio y la interfaz de usuario que presenta el complemento de control de código fuente.This means that the user may be presented with two possibly different styles of UI when dealing with source control: the UI that Visual Studio presents and the UI that the source control plug-in presents. Esto resulta más evidente con las operaciones de control de origen avanzado.This is most noticeable with advanced source control operations.

Inconvenientes para implementar un complemento de Control de código fuenteDrawbacks to Implementing a Source Control Plug-in

  • Para las funciones avanzadas, el usuario puede ver dos estilos diferentes de las interfaces, dando lugar a posibles confusiones.For advanced features, the user may see two different styles of interfaces, leading to possible confusion.

  • El complemento de control de código fuente se limita al modelo de control de origen implicado en la API de complementos de Control de código fuente.The source control plug-in is confined to the source control model implied by the Source Control Plug-in API.

  • La API de complemento de Control de origen puede ser demasiado restrictiva para algunos escenarios de control de código fuente.The Source Control Plug-in API may be too restrictive for some source control scenarios.

Ventajas de implementar un complemento de Control de código fuenteAdvantages to Implementing a Source Control Plug-in

  • Visual Studio proporciona todas la interfaz de usuario para todas las operaciones de control de código fuente básico para que el complemento de control de origen no tiene que implementar la interfaz de usuario potencialmente compleja.Visual Studio supplies all the UI for all the basic source control operations so that the source control plug-in does not have to implement potentially complex UI.

  • Debido a la API estricta, el complemento de control de código fuente puede interactuar con facilidad con programas de control de origen externo para proporcionar funcionalidad más amplia; Visual Studio no ocupa demasiado mucho cómo se logra la funcionalidad de control de código fuente, solo que se lleva a cabo según la API de complementos de Control de código fuente.Because of the strict API, the source control plug-in can readily interact with external source control programs to provide more extensive functionality; Visual Studio does not care too much how the source control functionality is accomplished, only that it is accomplished according to the Source Control Plug-in API.

  • Es más fácil de implementar un complemento que un VSPackage del control de código fuente de control de código fuente.It is easier to implement a source control plug-in than a source control VSPackage.

Paquete de VS de Control de código fuenteSource Control VSPackage

Visual Studio SDKVisual Studio SDKpermite que integra perfectamente en Visual Studio con el control total de la funcionalidad de control de código fuente y reemplazo completo de la interfaz de usuario de control de código fuente proporcionados por Visual Studio. allows for deep integration into Visual Studio with full control of source control functionality and complete replacement of the Visual Studio-provided source control user interface. Un control de código fuente VSPackage se registra con Visual Studio y proporciona la funcionalidad de control de código fuente.A source control VSPackage is registered with Visual Studio and provides source control functionality. Aunque el control de código fuente varios paquetes VSPackage se puede registrar con Visual Studio, sólo uno de ellos pueden activar en cualquier momento.Although several source control VSPackages can be registered with Visual Studio, only one of them can be active at any one time. Un control de código fuente VSPackage tiene control total sobre la apariencia y la funcionalidad de control de código fuente en Visual Studio mientras está activa.A source control VSPackage has full control over the source control functionality and appearance in Visual Studio while it is active. Todos los otro paquetes VSPackage que puede estar registrada en el sistema de control de código fuente están inactiva y no mostrará ninguna interfaz de usuario en absoluto.All other source control VSPackages that may be registered in the system are inactive and will not display any UI at all.

La implementación de un control de código fuente VSPackage requiere una estrategia de "todo o nada".Implementing a source control VSPackage requires an "all or nothing" strategy. El creador de un control de código fuente VSPackage debe invertir una considerable cantidad de trabajo en la implementación de una serie de interfaces de control de código fuente y los nuevos elementos de interfaz de usuario (cuadros de diálogo, menús y barras de herramientas) para cubrir la funcionalidad de control de código fuente.The creator of a source control VSPackage must invest a significant amount of effort in implementing a number of source control interfaces and new UI elements (dialog boxes, menus, and toolbars) to cover the entire source control functionality. Vea crear un VSPackage de Control de código fuente para obtener más detalles.See Creating a Source Control VSPackage for more details.

Inconvenientes para implementar un paquete de VS de Control de código fuenteDrawbacks to Implementing a Source Control VSPackage

  • El VSPackage debe implementar un número de interfaces complejas para integrar correctamente con Visual Studio.The VSPackage must implement a number of complex interfaces to integrate successfully with Visual Studio.

  • El VSPackage debe proporcionar todas la interfaz de usuario necesaria para el control de código fuente; Visual Studio no proporcionará ninguna asistencia en esta área.The VSPackage must supply all the UI required for source control; Visual Studio will provide no assistance in this area.

  • Un control de código fuente VSPackage está estrechamente vinculado a Visual Studio y no puede funcionar con programas independientes, por lo que la funcionalidad no se puede compartir fácilmente con una versión del programa de control de origen externa.A source control VSPackage is intimately tied to Visual Studio and cannot operate with stand-alone programs, so functionality cannot be as easily shared with an external version of the source control program.

Ventajas de implementar un paquete de VS de Control de código fuenteAdvantages to Implementing a Source Control VSPackage

  • Dado que el VSPackage tiene funcionalidad y control total sobre la interfaz de usuario de control de código fuente, se presenta al usuario con una interfaz sin problemas de control de código fuente.Because the VSPackage has full control over the source control UI and functionality, the user is presented with a seamless interface for source control.

  • El VSPackage no se limita a un modelo de control de origen determinado.The VSPackage is not confined to a particular source control model.

Vea tambiénSee Also

Control de código fuente Source Control
Crear un Control de código fuente complemento Creating a Source Control Plug-in
Crear un VSPackage de Control de código fuente Creating a Source Control VSPackage
Novedades del control de código fuenteWhat's New in Source Control