Me temo que el primero de ellos no es más que una traducción más o menos libre y adaptada de «Developing a Gadget for Windows Sidebar Part 1: The Basics» de la base de datos del MSDN.
En posteriores entregas desarrollaremos paso a paso un gadget desde cero. Supongo que os será de utilidad (al menos a los que no controléis bien el inglés)
Introducción
Un gadget es una aplicación desarrollada con HTML, XML y algún lenguaje de script que ofrece una funcionalidad normalmente muy limitada obtenida de otras aplicaciones de mayor envergadura. Su principal objetivo es facilitar el acceso a esa información o funcionalidad.Los archivos
Un gadget básico para el sidebar de Windows Vista debe constar, al menos, de dos archivos:- El manifesto del gadget (gadget.xml) que contiene la información general sobre el gadget.
- El archivo html que proporciona el código del gadget. Se le puede dar cualquier nombre siempre que se indique en el campo adecuado ( < base> ) del gadget.xml
Pasos a seguir
- Crear la carpeta de desarrollo para guardar los archivos del gadget. El nombre de la carpeta debe formarse con el nombre del gadget seguido de un punto y la cadena «gadget». Así, para nuestra aplicación de ejemplo crearemos la carpeta PruebaGadget.gadget. Dicha carpeta se debe guardar en una de las carpetas del sistema del sidebar de Windows:
- %USER_DATA%\Local\Microsoft\Windows Sidebar\Gadgets (gadgets de usuario)
- %SYSTEM_ROOT%\Archivos de Programa\Windows Sidebar\Gadgets (gadgets globales)
Aunque las normas respecto al nombre de la carpeta y su ubicación no son obligatorias, el hacerlo de este modo beneficia la productividad a la hora de probar el gadget durante su desarrollo. - Crear el archivo del manifiesto (gadget.xml) y guardarlo en la carpeta del gadget.
<?xml version="1.0" encoding="utf-8" ?>
< gadget>
< name> Ejemplo de gadget </name>
< namespace> windows.sdk </namespace>
< version> 1.0.0.0 </version>
< author name="angeldp">
< info url="blog.soydelafp.es" />
< logo src="logo.png" />
</author>
< copyright>ies galileo</copyright>
< description>
Ejemplo de gadget para el sidebar de Windows Vista
</description>
< icons>
< icon height="48" width="48" src="icon.png" />
</icons>
< hosts>
< host name="sidebar">
< base type="HTML" apiVersion="1.0.0" src="gadgetPrueba.html" />
< permissions> Full</permissions>
< platform minPlatformVersion="1.0" />
< defaultImage src="icon.png" />
</host>
</hosts>
</gadget> - Crear el archivo html y guardarlo en la carpeta de desarrollo.
< html>
< head>
< meta http-equiv="Content-Type" content="text/html; charset=Unicode" />
</head>
< body>
< div id="gadgetContent">
</div>
</body>
</html> - Si es necesario, instalar el gadget.
Dependiendo del nombre y la ubicación de la carpeta de desarrollo, puede hacerse necesario renombrarla y situarla dentro de una de las carpetas del sistema del sidebar. Una forma rápida de instalar un gadget en Windows Vista es guardar el contenido de la carpeta de desarrollo (no la carpeta, sólo el contenido) en un archivo zip con el nombre del gadget; después cambiaremos la extensión del archivo de .zip a .gadget; ahora, al hacer doble clic en el archivo renombrado, el sistema procederá a instalar el gadget. - Probar el funcionamiento del gadget y hacer las revisiones necesarias.
El ejemplo
Veamos cómo crear un simple gadget con el «Hola mundo».- Ejecutar el sidebar: Inicio >> Todos los programas >> Accesorios >> Windows sidebar.
- Localizar y abrir la carpeta de los gadgets. Algo parecido a:
%USER_DATA%\Local\Microsoft\Windows Sidebar\Gadgets - En ella crear una nueva carpeta llamada HolaMundo.gadget.
- Escribir en el Notepad++, o donde sea, el siguiente código. Guardando el archivo resultante en la carpeta HolaMundo.gadget con el nombre HolaMundo.html.
< html >
< head>
< title> Hola mundo</title>
< style type="text/css">
body {
margin: 0;
width: 130px;
height: 75px;
font-family: verdana;
font-weight: bold;
font-size: small; }
#gadgetContent {
margin-top: 20px;
width: 130px;
vertical-align: middle;
text-align: center;
overflow: hidden; }
</style>
< script type="text/jscript" language="jscript">
// Inicializar el gadget.
function init() {
var oBackground = document.getElementById("imgBackground");
oBackground.src = "url(images/background.png)"; }
</script>
</head>
< body onload="init()">
< g:background id="imgBackground">
< span id="gadgetContent"> ¡Hola mundo!</span>
</g:background>
</body>
</html> - A continuación creamos el manifiesto del gadget copiando el texto siguiente y guardándolo en la carpeta del proyecto con el nombre gadget.xml y codificación UTF-8.
< gadget>
< name> Gadget Hola Mundo</name>
< version> 1.0.0.0</version>
< author name="Nombre del desarrollador">
< info url="blog.soydelafp.es" />
</author>
< copyright> © IES Galileo.</copyright>
< description>
Ejemplo de "HolaMundo" en un gadget del sidebar de Vista.
</description>
< hosts>
< host name="sidebar">
< base type="html" apiVersion="1.0.0" src="probandoG.html" />
< permissions> Full</permissions>
< platform minPlatformVersion="1.0" />
</host>
</hosts>
</gadget> - Abrir el selector de gadgets haciendo clic en el símbolo “+” en la parte superior del sidebar.
- En la galería de gadget deberá aparecer el “Gadget Hola Mundo”.
- Al hacer doble clic en el gadget, éste aparecerá cargado en el sidebar.
Sobre el contenido del archivo gadget.xml
Elemento < xml> : Obligatorio.- Define la versión del lenguaje XML y el juego de caracteres que emplea el manifiesto del gadget. En el ejemplo anterior, gadget.xml se valida como XML 1.0 y emplea el juego de caracteres UTF-8 de Unicode. Atributos:
- Version. Obligatorio. El valor esperado es 1.0.
- Encoding. Obligatorio. El valor esperado es UTF-8.
- Elemento < gadget> : Obligatorio.
- Sirve de contenedor para los elementos hijos que definen el gadget: Elementos obligatorios:
- < name>
- Nombre del gadget para mostrar en el selector de gadget, en la página del sidebar en el Panel de Control; y en el propio sidebar.
- < version>
- Define la version del gadget.
- < hosts>
- Es un contenedor para elementos < host> hijos. Elemento hijo:
- < host> : Obligatorio.
- Identifica la aplicación que aloja el gadget, de momento solo soporta “sidebar” como valor válido. Sus elementos hijos definen el comportamiento del gadget para una determinada aplicación que le aloje. Atributo: Name. Obligatorio. Su valor esperado es "sidebar". Elementos hijo requeridos:
- < base>
- Proporciona al sidebar el tipo y la ruta al archivo del gadget. Atributos:
- Type. Obligatorio. Su valor esperado es "HTML".
- Src. Obligatorio. Indica el archivo que el sidebar debe cargar para ejecutar el gadget.
- < permissions>
- Su valor esperado "Full".
- < platform>
- Indica la version minima del sidebar necesaria para ejecutar el gadget. Atributo: MinPlatformVersion. Obligatorio. Su valor esperado es "1.0".
Elementos hijo obligatorios:
- < defaultImage>
- Imagen que se mostrará cuando el usuario arrastre el gadget desde el selector al sidebar. Atributo: Src. Obligatorio. La ruta a la imagen.
Elementos opcionales:
- < namespace>
- Reservado para usos futuro.
- < author>
- Información sobre el desarrollador. Atributo:
- Name. Obligatorio.
- Autor del gadget. Elementos hijo:
- < info> Opcional.
- De momento solo permite un atributo. Atributo: url. Obligatorio. Enlace proporcionado por el autor.
- < logo> Opcional.
- Icono que se mostrará junto al nombre del autor en la vista detalles del selector de gadget. Atributo: Src. Obligatorio. La ruta al archivo gráfico.
- < copyright>
- Puede contener cualquier cadena de caracteres.
- < description>
- Se muestra al usuario en la ventana de la Galería de Gadgets.
- < icon>
- Define el tamaño y el archivo que se empleará como icono del gadget. Un archivo gadget.xml puede contener cualquier número de elementos < icon> . Su tamaño ideal es de 64x64 píxeles, aunque no se impone ninguna limitación
Atributos:
- Height. Opcional. Altura, en píxeles, del icono.
- Width. Opcional. Anchura, en píxeles, del icono.
- Src. Obligatorio. La ruta al archivo gráfico.