La adición de la información de la versión de las aplicaciones

La adicion de la informacion de la version de las aplicaciones

La adicion de la informacion de la version de las aplicaciones : Multi-millones de consejos para hacer su vida mas facil.

Este articulo voy a investigar el medio por el cual la informacion de la version pueden estar disponibles dentro de una aplicacion, escribir una clase que puede ser incorporado en cualquier nuevo desarrollo.
la Adicion de la Informacion de la Version Para Aplicaciones
el Ultimo articulo que he analizado el concepto de una generacion, y por que un estandar de proceso para producir un conjunto consistente de los productos era una buena cosa.
Desde los primeros programas de ordenador se desplegaron, los desarrolladores querian tener alguna manera de identificar la version de que un cliente se ejecuta despues de todo, es, obviamente, vale la pena saber si es un bug que esta la presentacion ya ha sido corregido. Con bastante rapidez (y obviamente) un sistema numerico evolucionado, simplemente incrementando el numero de version cada vez que un lanzamiento se hizo. Como la frecuencia de los lanzamientos de mayor, los desarrolladores querian tener alguna manera de distinguir una nueva version, en comparacion con una provisional: el concepto de versiones principales y secundarias de un programa se introdujo va de V1.12 a V2.0 transmitio mucho mas (incluso a los laicos de los usuarios) que va desde la V12 a la V13. Durante muchos años la version principal y secundaria era el adecuado y normal, pero como de los programas que se hizo mas grande y complejo que requiere mas frecuentes correcciones terciario numero fue agregado a la final de la version para indicar una 'liberacion'. Todas las versiones con la misma version principal y secundaria numeros deben tener identica a la lista de caracteristicas, pero debe incluir acumulada correcciones de errores y otras mejoras sin la adicion de nuevas caracteristicas como tal. Ultimamente, se ha convertido en una buena practica para anexar el numero de compilacion de la version causando un numero de version con cuatro componentes, X. Y. Z. B, donde X representa la version principal, Y el menor de la version, Z el numero de version y B el numero de compilacion. Tenga en cuenta que aunque el menor y la liberacion de versiones se pueden restablecer a cero (con mayor y menor versiones), el numero de compilacion nunca se restablece y por lo tanto siempre aumenta con cada nueva version (aunque no necesariamente estrictamente incremental es muy posible que haya interno se construye dentro de una compañia que no se entregan a los clientes). Listado 1 se resumen cuando cada numero de la version del componente debe ser incrementado.

Listado 1 - Componentes de numero de version X. Y. Z. B
a Pesar de que los departamentos de marketing secuestrado el concepto de los numeros de version para sus propios fines, una vez que se dio cuenta de que un gran numero de personas podria invertir en actualizaciones cuando el numero de version principal cambiado o se saltaba la competencia, todavia es muy util tener algun tipo de un oficial de la version numero en sus aplicaciones, es mucho mas facil para confirmar que el cliente se esta ejecutando Construir 134 o mas tarde, en lugar de 'SuperApp 97 SR-2a Parche 13 (Y2K)'. Esto se hizo particularmente importante con el advenimiento de archivo DLL compartido de bibliotecas dentro de Windows que podria ser sustituido por un recien instalada la aplicacion. Aunque no muy buenos usando el esquema de numeracion constantemente, practicamente todos los de Microsoft los archivos de la aplicacion (EXE y DLL) que contengan algun tipo de 4 digitos de su numero de version incrustada dentro de ellos. De hecho, Windows 2000 hace un amplio uso de esta informacion en un intento de evitar que los archivos importantes del sistema que se sobrescriban anteriores, o a veces mas tarde, las versiones. Los procedimientos de instalacion tambien hacer uso de esta informacion por parte de advertencia cuando un archivo se sobrescribira un nombre similar pero mas tarde la version de si mismo.
Embebido Informacion de la Version
Si hace clic derecho en un archivo EXE o DLL archivos en el Explorador en el menu emergente que aparece tiene una entrada en la parte inferior llamado 'Propiedades'. La seleccion de esta muestra algunos detalles sobre el archivo. Si esta disponible, la segunda ficha (Version) muestra la informacion incrustada en el archivo sobre el numero de version, nombre del producto, los detalles de copyright y asi sucesivamente. Cualquier archivo que puede tener un recurso segmento puede tener esta informacion incrustada dentro de ella, y esto incluye las aplicaciones compiladas con Delphi. Microsoft ha publicado la informacion y el formato que debe ser proporcionada en la seccion de recursos para que esta informacion se muestre. En Delphi 2, la unica manera de que esto podria lograrse fue mediante la creacion de un archivo de recursos con exactamente el derecho cadenas dentro de ella, de su compilacion por separado con el compilador de recursos y, a continuacion, vincular a la aplicacion (esta formando parte de los principales proceso de construccion). Aunque no es dificil, estos pasos se requiere un nivel de conocimiento tecnico y de competencia tal que algunos de los desarrolladores de aplicaciones se molesto en hacerlo. Dentro de su filosofia de hacer de Windows en desarrollo mas productivo, Delphi 3 introdujo un dialogo especial por el cual esta informacion puede ser facilmente conectado a la aplicacion. La figura 1 muestra este cuadro de dialogo, disponible desde el Delphi menu Proyecto, elemento Opciones.
activando la casilla de verificacion en la parte superior de la pestaña para mostrar que el numero de version debe incluirse informacion es posible añadir los detalles acerca de no solo el numero de version, pero tambien banderas acerca de si la construccion esta previsto para su divulgacion publica, y en la parte inferior es posible añadir detalles a toda una lista de categorias predefinidas, tales como una descripcion de los archivos y los derechos de autor. Delphi automaticamente los cambios de la FileVersion categoria como el modulo de numero de la version de los detalles anteriores se actualizan. Cuando este cuadro de dialogo se confirma, Delphi construcciones de los recursos necesarios archivo (que tambien contiene detalles tales como el icono de la aplicacion) en una medida transparente, que se vinculara automaticamente en el ejecutable final. Si usted hace esto, incluso el mas simple proyecto, usted vera que usted puede ahora haga clic derecho sobre el ejecutable y obtener informacion de version, al igual que todo buen comportamiento de las aplicaciones de Windows.
¿Que Version de yo Soy?
Ahora que sabemos como colocar la informacion de la version dentro de la aplicacion, seria util para obtener acceso a la informacion. Despues de todo, si usted esta tratando de establecer a traves del telefono ¿que version de un usuario ejecuta seria mucho mas facil describir como mostrar el cuadro de dialogo Acerca de, en lugar de encontrar el ejecutable de la aplicacion en el Explorador, haga clic derecho, seleccione Propiedades y seleccionando la ficha Version.
Como la informacion de version es solo almacenan como cadenas en un formato especifico en la seccion de recursos de la aplicacion, seria posible utilizar el estandar de recursos Win32 archivo de comandos para extraer la informacion relevante, la decodificacion de las estructuras. Sin embargo, hay algunas especificas de la API de Win32 comandos disponibles que hacer esto en una forma mas conveniente. Estos son GetFileVersionInfoSize (que devuelve datos sobre el espacio requerido para almacenar la informacion de la version), GetFileVersionInfo (que se extrae de los detalles dentro de un nucleo de amortiguamiento de la talla correcta), y VerQueryValue (que se extrae un pedazo de informacion de la version del bufer, tales como 'LegalCopyright'). Como de costumbre, a la hora de interactuar con la API de Win32, estos comandos deben ser llamados en la secuencia correcta, la preservacion de ciertos valores internos regresaron de comandos anteriores a traves de parametros var.
es una muy buena idea para encapsular cualquier tipo de interaccion con la API de Windows con un usuario mas y Delphi-interfaz amigable. Tipico de los programadores de Delphi no quiere lidiar con la asignacion de bloques de memoria y de Win32-tipos especificos tales como DWORD y UINT, y tampoco deben. Mucho mejor el diseño de una clase de niza que, en la mejor tradicion de la OO, se esconde la cruda acceso a la informacion de la version y presenta una mucho mas utilizable de la interfaz. Esto tiene la ventaja añadida de que si en el almacenamiento de esta informacion de la version de cambiar siempre, a la misma clase pueden encapsular las dependencias del sistema manteniendo la misma interfaz publica.
Hay un par de cosas a tener en cuenta a la hora de diseñar esta clase. En primer lugar, debe ser capaz de ser utilizado con cualquier archivo de la aplicacion, incluida la de que se esta ejecutando. En segundo lugar, se debe proporcionar un acceso adecuado a la norma y el mas utilizado informacion de la version de teclas (FileVersion, ProductName etc.). Por ultimo, como es posible que el usuario adicionales de la version personalizada de claves y valores dentro de su estructura, la clase debe exponer a estos de una manera natural. Listado 2 muestra la interfaz publica de la clase.
TVersionInfo = clase
privada
& nbsp & nbsp funcion GetVersionInfo (Index: Integer): String
publico
& nbsp & nbsp constructor Create (ThisSourceFile: String)
& nbsp & nbsp destructor Destruir reemplazar
& nbsp & nbsp // clave Arbitraria de informacion
& nbsp & nbsp Clave de propiedad de[nombre de Clave: String]: Cadena de leer GetKey
& nbsp & nbsp // Estandar de informacion clave
& nbsp & nbsp propiedad CompanyName: indice de Cadena 0 leer GetVersionInfo
& nbsp & nbsp & nbsp & nbsp escribir SetVersionInfo
& nbsp & nbsp propiedad FileDescription: indice de Cadena 1 leer GetVersionInfo
& nbsp & nbsp propiedad FileVersion: indice de Cadena 2 leer GetVersionInfo
& nbsp & nbsp propiedad InternalName: Indice de cadena 3 leer GetVersionInfo
& nbsp & nbsp propiedad de derechos de Autor: indice de Cadena 4 leer GetVersionInfo
& nbsp & nbsp propiedad de las Marcas: indice de Cadena 5 leer GetVersionInfo
& nbsp & nbsp propiedad OriginalFileName: indice de Cadena 6 leer GetVersionInfo
& nbsp & nbsp propiedad ProductName: indice de Cadena 7 leer GetVersionInfo
& nbsp & nbsp & nbsp & nbsp escribir SetVersionInfo
& nbsp & nbsp propiedad ProductVersion: Indice de cadena 8 leer GetVersionInfo
& nbsp & nbsp & nbsp & nbsp escribir SetVersionInfo
& nbsp & nbsp propiedad Comentario: indice de Cadena 9 leer GetVersionInfo
& nbsp & nbsp de la propiedad numero de compilacion: Cadena de leer GetBuildNumber
fin
Listado 2 - interfaz Publica de TVersionInfo

Como se puede ver en la clase, todas las teclas estandar, los nombres se exponen como propiedades con nombre, mientras la Llave de la propiedad proporciona acceso a la costumbre informacion adicional por su nombre. La clase se construye por la que pasa una ruta de acceso completa y el nombre de archivo de la version que la informacion debe ser extraida. Hay un aspecto muy interesante acerca de esta clase, que demuestra que un infrautilizado aspecto de Delphi de la clase de diseño: usando el indice identificador para asignar un numero de propiedades diferentes en el mismo descriptor de acceso de la funcion. Como puede verse a partir de la aplicacion privada de GetVersionInfo utiliza para leer las propiedades, este valor del indice se aprobo en funcion de la propiedad se accede, lo que permite la funcion para determinar el valor a devolver. Como veremos en la aplicacion, esto a menudo facilita muy concisa de codificacion.
Como se menciono anteriormente, el GetFileVersionInfo comando extrae los datos de la seccion de recursos y los almacena en el buffer que se pasa como parametro a la llamada a la API. Por lo tanto, tiene sentido para realizar esto como una operacion puntual en el constructor. Una vez que esta informacion ha sido extraida, podemos interrogar por conocidos nombres de claves. Conveniente para la codificacion y un aumento en el rendimiento, vamos a extraer los valores de la clave de todas las claves de estandar de nombres y almacenar estos valores en una matriz con el mismo valor ordinal como cada uno de los indice de propiedad. Estos significa que la aplicacion de la GetVersionInfo descriptor de acceso de propiedad de la funcion puede ser de forma transparente sencillo y simplemente devuelve el valor de matriz en el adaptador de indice. De la costumbre de las claves que podrian ademas ser proporcionada simplemente tendremos que llamar a la API de comando para extraer los detalles de la informacion de la version del bufer. Aunque esto sera un poco mas lento que el acceso a los detalles directa de un pre-calculado de la matriz, no se anticipa que estas propiedades se accede con frecuencia, y este es, por tanto, de un diseño aceptable decision. El listado 3 muestra la implementacion de la clase.
constructor TVersionInfo.Crear (ThisSourceFile: String)
const
& nbsp & nbsp VersionKeyNames: array [0..MaxVersionKeys] of String =
& nbsp & nbsp & nbsp ('CompanyName', 'FileDescription', 'FileVersion', 'InternalName',
& nbsp & nbsp & nbsp & nbsp 'LegalCopyright', 'LegalTrademarks', 'OriginalFilename',
& nbsp & nbsp & nbsp & nbsp 'Producto', 'ProductVersion', 'Comentarios')
var
& nbsp & nbsp ThisInfo: Integer
& nbsp & nbsp InfoLength: UINT
& nbsp & nbsp Len: DWORD
& nbsp & nbsp Mango: DWORD
& nbsp & nbsp PCharset: PLongInt
begin
& nbsp & nbsp heredado Crear
& nbsp & nbsp // Obtiene el tamaño de la informacion de version de
& nbsp & nbsp Len := GetFileVersionInfoSize (PChar (ThisSourceFile), Mango)
& nbsp & nbsp // Asignar VersionInfo tamaño de bufer
& nbsp & nbsp SetLength (VersionInfo, Len 1)
& nbsp & nbsp // Obtener informacion de la version
& nbsp & nbsp si GetFileVersionInfo (PChar(ThisSourceFile), Mango, Len,
& nbsp & nbsp & nbsp & nbsp Puntero(VersionInfo)) entonces
& nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp // Obtener la traduccion info para los Idiomas / CharSet Id
& nbsp & nbsp & nbsp & nbsp si VerQueryValue(PointerVersionInfo), '/VarFileInfo/Traduccion',
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp Puntero(PCharset), InfoLength), a continuacion,
& nbsp & nbsp & nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp LangCharset := Format ('%.4x%.4x',
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp [LoWord (PCharset^), HiWord (PCharset^)])
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp InfoAvailable := True
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp // Obtener la version estandar de la informacion
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp para ThisInfo := 0 a MaxVersionKeys hacer
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp StandardKeys[ThisInfo] :=
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp & nbsp GetKey(VersionKeyNames[ThisInfo])
& nbsp & nbsp & nbsp & nbsp final
& nbsp & nbsp final
fin
funcion TVersionInfo.GetKey (ThisKeyName: string): string
var
& nbsp & nbsp InfoLength: UINT
begin
& nbsp & nbsp si InfoAvailable, a continuacion,
& nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp SetLength (Resultado, 255)
& nbsp & nbsp & nbsp & nbsp si VerQueryValue (Puntero(VersionInfo),
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp PChar(Format('/StringFileInfo/%s/%s',
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp [LangCharset, ThisKeyName])), Indicador(Resultado),
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp InfoLength) a continuacion,
& nbsp & nbsp & nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp SetString(Resultado, PChar(Resultado), InfoLength - 1)
& nbsp & nbsp & nbsp & nbsp end else
& nbsp & nbsp & nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp & nbsp & nbsp Resultado := '
& nbsp & nbsp & nbsp & nbsp final
& nbsp & nbsp end else
& nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp Resultado := 'N/A'
& nbsp & nbsp final
fin
funcion TVersionInfo.GetVersionInfo(Index: Integer): string
begin
& nbsp & nbsp Resultado := StandardKeys[Indice]
fin
procedimiento TVersionInfo.SetVersionInfo(Index: Integer
& nbsp & nbsp Valor: string)
begin
& nbsp & nbsp StandardKeys[Indice] := Valor
fin
funcion TVersionInfo.GetBuildNumber: string
begin
& nbsp & nbsp // Tira el ultimo elemento de la version del archivo
& nbsp & nbsp Resultado := FileVersion
& nbsp & nbsp mientras Pos ('.', Resultado) > 0 hacer
& nbsp & nbsp empezar
& nbsp & nbsp & nbsp & nbsp Resultado := Copy (Resultado, Pos ('.', Resultado) 1, Length(Resultado))
& nbsp & nbsp final
fin
Uno de los matices de la forma en que la informacion de la version almacenada en la aplicacion de recursos de la seccion es que es posible definir que conjunto de caracteres del lenguaje ha sido utilizado para crear la informacion de version (y la aplicacion o DLL). Este se define dentro de la informacion de version como una palabra doble, o de 32 bits entero sin signo, y debe estar presente como parte de la informacion de la version de la cadena (en formato hexadecimal) para cada una de las claves que se extraen. Uno de los trabajos de la constructora, asi como la extraccion de la informacion de version en un bufer de cadena (una forma conveniente de almacenar estatica datos devueltos por las llamadas a la API) es extraer el idioma y el juego de caracteres de la informacion y construir una correcta cadena hexadecimal que se utilizara en el futuro llama a VerQueryValue. Una vez hecho esto el constructor, a continuacion, hace una llamada a la rutina que devuelve realmente una version de el valor de la informacion para una llave de serie. Esta rutina vive una doble vida, ademas que disfraza la funcion de descriptor de acceso de la Llave de la propiedad. De nuevo, un aspecto interesante de este proceso es que el constructor obtiene una lista de los estandar de los nombres clave de un privado constante de cadena fija de la matriz que se declara y define en una sola instruccion. Esto tambien es un poco usada, pero muy util, tecnica que tambien es permitido para las variables globales, asi como constantes.
Si usted se refiere de nuevo a la Figura 1 se puede ver algo mas de informacion de control de versiones en el grupo llamado 'Modulo de atributos', principalmente un conjunto de indicadores que describen el estado de la aplicacion, si se trata de una depuracion o privado a construir y asi sucesivamente. Esta informacion tambien esta disponible en el archivo de recursos, y se puede acceder utilizando la API VerQueryValue comando, pero con un segundo parametro de solo '/', en lugar de '/VarFileInfo/Traduccion'. En esta instancia, lo que se devuelve es un puntero a una estructura que contiene detalles acerca del tipo de archivo y el contenido, haga doble pares de palabras que pueden ser combinados para representar una estricta version de 64 bits de numero que se utiliza para la estricta comparaciones numericas (por los programas de instalacion), asi como el Modulo de atributos definibles dentro de Delphi. Seria una tarea sencilla para extender la TVersionInfo constructor para extraer esta informacion y exponerlo a traves de simples propiedades Booleanas y, en Delphi 5, Int64 tipos de propiedad para la version estricta de los numeros.
Esta capacidad para encapsular el acceso a estructuras de datos complejas a traves de una comoda interfaz es una de las bellezas de la Orientacion a Objetos, y a la que vamos a estar volviendo continuamente. La clase definida aqui ya ha expuesto el numero de compilacion como propiedad separada, que a su vez deriva del ultimo elemento de FileVersion para proporcionar a los usuarios de la clase con los datos de la manera mas conveniente. Por ejemplo, un uso apropiado de esto seria en el cuadro Acerca de una aplicacion, mostrando no solo el nombre de la aplicacion y los detalles de copyright, sino tambien la version del programa y el numero de compilacion para una facil referencia.
Para completar nuestro examen de un proceso de construccion seria muy bonito si, despues de haber completado con exito, se podria incrementar el numero de compilacion (y posiblemente el numero de version) dentro de la informacion de version de todos los entregables. Delphi aparece para almacenar esta informacion de la version dentro de la .DOF archivo que acompaña al proyecto, este es en formato de archivo INI y contiene la mayoria de los detalles expuestos por el Proyecto | Opciones de dialogo. Sin embargo, mediante programacion de hacer cambios a este archivo (no hay entradas en la [Informacion de Version] de la seccion para cosas como MajorVer, Liberacion y asi sucesivamente) no es realmente el resultado de los cambios a la aplicacion compilada. Esto es debido a que Delphi genera el archivo de recursos compilado (Proyecto.RES) a partir de esta informacion unicamente cuando se cambia de forma interactiva desde dentro mismo Delphi. El .RES compilado archivo de recursos es simplemente vinculado a la aplicacion en tiempo de compilacion, por lo que la realizacion de cambios a la .DOF archivo y, a continuacion, volver a compilar la aplicacion no causa el archivo de recursos para ser regenerado y la fecha de salida de uno es usado. Es una buena practica, por tanto, la actualizacion de la acumulacion y la liberacion de los numeros de Delphi de cada proyecto con la mano al final de cada generacion correcta.
En el siguiente articulo vamos a empezar a diseñar las clases que vamos a necesitar para producir un verdaderamente orientado a objetos de la aplicacion, la encapsulacion de los objetos de negocio y acceso a bases de datos en un altamente productiva. Este sera un gran odisea que cubren casi todos los aspectos del desarrollo de aplicaciones Windows.
el Siguiente en la serie