Componentes de control de versiones

Cada ensamblado tiene un número de versión que consta de cuatro partes como parte de su identidad. La inclusión de la versión como parte de la identidad es esencial para distinguir las distintas versiones de un ensamblado para la ejecución simultánea.

Este número de versión de compatibilidad se representa físicamente mediante un número dividido en cuatro partes con el formato siguiente:

MajorVersion.MinorVersion.BuildNumber.Revision.

Las partes del número de versión son principal, secundaria, compilación y revisión. No se aplican reglas semánticas a las partes del número de versión. Es decir, Common Language Runtime no deduce la compatibilidad ni ninguna otra característica de un ensamblado basándose en la forma en que está asignado el número de versión (la versión 1.0.0.0 y la versión 2.1.0.2 de algunos ensamblados son identidades completamente diferentes en lo que respecta al cargador de clases). El programador es libre de cambiar cualquier parte de este número de la forma más adecuada. Aunque no se apliquen reglas semánticas al formato de número de versión, es probable que las organizaciones individuales encuentren útil establecer convenciones sobre cómo se debe cambiar el número de versión. Esto ayuda a mantener la coherencia en una organización y la determinación de aspectos como saber de qué versión de compilación procede un ensamblado determinado. A continuación se muestra una convención típica:

Principal o secundaria. Los cambios en la parte principal o secundaria del número de versión indican un cambio incompatible. Por tanto, de acuerdo con esta convención la versión 2.0.0.0 se consideraría incompatible con la versión 1.0.0.0. Entre los ejemplos de cambio incompatible se puede señalar el cambio de los tipos de algunos parámetros de métodos o la eliminación por completo de un tipo o un método.

Compilación. El número de versión de compilación se utiliza normalmente para diferenciar entre las compilaciones diarias y las versiones compatibles más pequeñas.

Revisión. Los cambios del número de revisión se reservan normalmente para una generación incremental necesaria para resolver un error determinado. En algunos casos, a éste se le denomina número de "resolución de errores de emergencia", en el que lo que se cambia a menudo es la revisión cuando se envía una solución para un error específico a un cliente.

Por lo tanto, un ensamblado con el número de versión de compatibilidad 2.0.0.0 se considera incompatible con un ensamblado cuyo número correspondiente es 1.0.0.0. Asimismo, el número de compatibilidad 2.0.2.11 se considera un QFE para el número de compatibilidad 2.0.2.1.

Vea también

Control de versiones de nombres seguros | Resumen de empaquetado e implementación | Apéndice A: Información adicional acerca del empaquetado y de la implementación | Apéndice B: Herramientas de empaquetado e implementación