Compilar desde línea de comnandos en Windows (CLI) usando Visual C++

Introducción

Para mi tesis doctoral tengo que desarrollar una serie de programas escritos en C. Trabajo sobre Windows y uso el Matlab, Modelsim y Xilinx ISE. Para realizar una cosimulación hardware/software entre Matlab, Modelsim y mis programas C debo usar ciertas bibliotecas estáticas (lib) y generar biblotecas dinámicas (dll) para comunicar los distintos procesos. Como estoy en Windows debo usar Microsft Visual Studio y Visual C++ [1].

En este caso no me sirve usar un compilador tan potente como GCC sobre MinGW porqué no soportar biblotecas tipo .lib ni generar .dll.

Pero aún así soy y seré un enamorado de la consola, tanto en Windows y sobre todo en sistemas tipo Unix. Y desde luego a menos que desarrolle una gran aplicación y necesite de verdad un gran IDE (como Eclipse o Visual Studio) no me gusta compilar un programa de apenas 800 líneas usando un IDE que genera una gran cantidad de ficheros y además no me permite automatizar nada desde consola.

Por ello he decidido investigar un poco y ver cómo se compila un programa usando el compilador de C/C++ de Microsft (cl.exe) en consola (cli). Además de cómo se enlazan todos los objetos usando el enlazador (linker) de Microsoft (link.exe).

¡Ojo! Depende de la versión de Visual Studio para poder compilar en consola se deberá abrir la misma usando un enlace instalado por Visual Studio como “Visual Studio Command Prompt (2010)” sino ciertas biblotecas y variables de entorno no estarán configuradas correctamente.

Makefile de ejemplo

A continuación vemos un ejemplo de Makefile para compilar con cl.exe. Para descargar Make para windows véase el enlace [2] y para saber más sobre el funcionamiento de make [3]. Este makefile para generalizar el proceso y simplificarlo usa una regla basada en patrones (%.obj: %.c %.h):

#
# Miscrosoft Visual Studio generic Makefile
#

RM=del /q
CC=cl
CFLAGS=/02
LINKFLAGS=
LINK=link
OUTPUT=/out:programa.exe
OBJ=programa.obj lib.obj
MAIN_TARGET=programa.exe
INC_DIR=

.phony: clean edit

all: $(MAIN_TARGET)

$(MAIN_TARGET): $(OBJ)
	$(LINK) $(LINKFLAGS) $(OBJ) $(OUTPUT)

%.obj: %.c %.h
	$(CC) -c $(CFLAGS) $<

clean: 
	$(RM) $(OBJ)

Caso de ejemplo

Supongamos que tenemos los ficheros libreria.c, libreria.h y programa.h, libreria.c. La primera pareja contine algunas funciones de utileria y los dos segundos el grueso de nuestro programa.

Si ejecutamos el comando make:

C:\ejemplos>dir>make
cl -c libreria.c
Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 16.00.30319.01 for 80x86
Copyright (C) Microsoft Corporation.  All rights reserved.

libreria.c
cl -c principal.c
Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 16.00.30319.01 for 80x86
Copyright (C) Microsoft Corporation.  All rights reserved.

principal.c
link  libreria.obj principal.obj /out:programa.exe
Microsoft (R) Incremental Linker Version 10.00.30319.01
Copyright (C) Microsoft Corporation.  All rights reserved.

Generando el fichero ejecutable programa.exe, si vemos el contenido del directorio veremos los ficheros de código fuente, los objetos, el ejecutable y el Makefile:

C:\ejemplos>dir
 El volumen de la unidad C no tiene etiqueta.
 El número de serie del volumen es: xxx-yyyy

 Directorio de C:\ejemplos>

05/04/2014  12:10              .
05/04/2014  12:10              ..
26/03/2014  17:59             1.433 libreria.c
26/03/2014  17:59               216 libreria.h
05/04/2014  12:10             1.540 libreria.obj
05/04/2014  12:10               409 Makefile
05/04/2014  11:01             8.800 principal.c
05/04/2014  10:59             1.117 principal.h
05/04/2014  12:10             9.565 principal.obj
05/04/2014  12:10            90.624 programa.exe
               8 archivos        113.704 bytes
               2 dirs  41.752.834.048 bytes libres

De este modo hemos conseguido generar un sencillo ejecutable sin necesidad de abrir el IDE completo de Visual Studio y generar toda esa cantidad de ficheros basura inccesarios que generan los proyectos y soluciones de Microsoft Viusal Studio.

Referencias

  1. Sitio oficial de Visual Studio: http://msdn.microsoft.com/en-US/vstudio
  2. Make para Windows: http://gnuwin32.sourceforge.net/packages/make.htm
  3. GNU Make: https://www.gnu.org/software/make/manual/html_node/

Desinstalar el plugin Subeclipse (svn) de Eclipse/Aptana Studio 3

Hace unos días, instalé el pluigin subeclipse para integrar SVN en Aptana Studio. Después de probarlo quedé contrariado al detectar que tiene un problema con el sistema de claves de gnome y no hacía más que darme problemas. Decidí seguir usando svn en consola y desinstalarlo. ¿Pero cómo hacerlo definitivo?

$ cd APTANA_INSTALL_DIR/plugins
$ ls |grep org.tigris.subversion
org.tigris.subversion.clientadapter_1.6.12.jar org.tigris.subversion.subclipse.doc_1.3.0.jar org.tigris.subversion.subclipse.tools.usage_1.0.1.jar
org.tigris.subversion.clientadapter.javahl_1.6.15.jar org.tigris.subversion.subclipse.graph_1.0.9.jar org.tigris.subversion.subclipse.ui_1.6.17.jar
org.tigris.subversion.subclipse.core_1.6.17.jar org.tigris.subversion.subclipse.mylyn_3.0.0.jar
$ ls |grep org.tigris.subversion|xargs rm

Solucionada, reiniciamos Aptana Studio y todo ok.

Referencias

  • Eclipse: http://www.eclipse.org/
  • Aptana Studio: http://www.aptana.com/
  • Subeclipse: http://subclipse.tigris.org/

API de Google: Cómo leer en consola un XML del API de Google (u otro XML)

Introducción

Actualmente estoy desarrollando un aplicativo que debe manipular los contactos de una cuanta de Google Apps. Para ello uso el API de Google Contacts [1], Por defecto los mensajes que envía y recibe Google a través de su servicio (REST) son en XML. Como programador no supone un problema manipular un XML, pero si queremos depurar o hacer pruebas en consola leer un XML sin espacios, saltos de línea o tabulados puede ser especialmente engorroso.

Una solución es usar una herramienta cómo indent, pero para XML.Esta herramienta es tidy.

Instalar tidy en Debian/Ubuntu y cómo usarlo

Para instalar Tidy sólo hay que teclear:

sudo apt-get install tidy

Un ejemplo de uso sería, dado un fichero entrada.xml sin formatear, sin saltos de línea ni espacios si queremos guardarlo en un fichero salida.xml preparado para leerlo seres humanos podríamos hacerlo con la secuencia de comandos:

cat entrada.xml | tidy -utf8 -xml -w 255 -i -c -q -asxml > salida.xml

Para más opciones de tidy, leer su página de manual en la referencia [3].

Ejemplo de uso con el API de Google

Visto el apartado anterior y los ejemplos de uso visto en el enlace [1] podemos obtener la información de un contacto de nuestra libreta de contactos de Google en XML con el comando:

$ curl -H "Authorization: Bearer -------Your_OAuth_Access_Token_Here-----------------" https://www.google.com/m8/feeds/contacts/default/full?max-results=1 |tidy -utf8 -xml -w 255 -i -c -q -asxml
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  2799    0  2799    0     0   6327      0 --:--:-- --:--:-- --:--:-- 87545
<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gContact='http://schemas.google.com/contact/2008' xmlns:batch='http://schemas.google.com/gdata/batch' xmlns:gd='http://schemas.google.com/g/2005'>
  <id>jose.perez.martinez@gmail.com</id>
  <updated>2013-09-27T10:14:56.316Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>José Pérez Martínez's Contacts</title>
  <link rel='alternate' type='text/html' href='http://www.google.com/' />
  <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full' />
  <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full/batch' />
  <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full?max-results=1' />
  <link rel='next' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full?start-index=2&max-results=1' />
  <author>
    <name>José Pérez Martínez</name>
    <email>jose.perez.martinez@gmail.com</email>
  </author>
  <generator version='1.0' uri='http://www.google.com/m8/feeds'>Contacts</generator>
  <openSearch:totalResults>616</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
  <entry>
    <id>http://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/base/0</id>
    <updated>2011-02-23T13:06:29.313Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Alejandro Soler</title>
    <link rel='http://schemas.google.com/contacts/2008/rel#edit-photo' type='image/*' href='https://www.google.com/m8/feeds/photos/media/jose.perez.martinez%40gmail.com/0/jLnPaGKk4gRrJJff1sWXhg' />
    <link rel='http://schemas.google.com/contacts/2008/rel#photo' type='image/*' href='https://www.google.com/m8/feeds/photos/media/jose.perez.martinez%40gmail.com/0' />
    <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full/0' />
    <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/jose.perez.martinez%40gmail.com/full/0/1298466389313000' />
    <gd:email rel='http://schemas.google.com/g/2005#other' address='kirth.asf@gmail.com' primary='true' />
  </entry>
</feed>

Notad que la gestión del token para obtener esta información es responsabilidad del usuario. PAra saber más leed la referencia [2]

Postscriptum: Más adelante escribiré una entrada sobre el API de Google y el protocolo de autorización OAuth2.

Referencias

  1. Google Contacts API version 3.0:https://developers.google.com/google-apps/contacts/v3/?csw=1
  2. Using OAuth 2.0 for Web Server Applications: target=”_blank”>https://developers.google.com/accounts/docs/OAuth2WebServer
  3. Tidy man page: http://tidy.sourceforge.net/docs/tidy_man.html