miércoles, 31 de julio de 2013

Instalando y utilizando Mercurial para crear un repositorio local

1) Agregar uno de los siguientes PPA, mediante terminal:
sudo add-apt-repository ppa:mercurial-ppa/stable-snapshots
sudo add-apt-repository ppa:mercurial-ppa/snapshots
Luego,
sudo apt-get update
2) Instalar Mercurial con:
sudo apt-get install mercurial

3) Crear un archivo llamado .hgrc en home, que tenga como contenido:
[ui]
username = Tu Nombre <tu@email>
editor = tuEditorDeTextoFavorito
[extensions]
hgext.purge=
#or, if purge.py not in the hgext dir:
#purge=/path/to/purge.py

4) Crear y/o cambiar al directorio donde se encuentra el proyecto a versionar:
cd /home/Gaby/SourceCode/MyProject01
5) Crear el repositorio. Con ello se creará una carpeta oculta llamada “.hg”:
hg init
6) Agregar archivos para el próximo commit.
Si la carpeta ya tenía archivos, sólo basta con registrarlos para que sean incluidos en el commit. En cambio, si se trata de un nuevo proyecto, se deberán crear los archivos y luego registrarlos. En ambos casos, existiendo ya archivos en el directorio, la forma de registrarlos es:
hg add
En caso de querer agregar sólo determinados archivos, se lo debe especificar de la siguiente manera:

hg add nombreDelArchivo.extensión
8) Mostrar los cambios que hubo en el Working Directory.
Esto indicará el estado de los archivos del proyecto, donde por cada archivo se indicará:
  • “A” significa “added”,
  • “M” significa “Modified”,
  • “R” significa “Removed”,
  • “!” significa perdido, desaparecido.
  • “?” significa desconocido (Mercurial aún no sabe nada acerca de ese archivo).
Se puede consultar el estado con cualquiera de los siguientes comandos:
hg status
hg st
Si tenemos archivos perdidos que realmente queremos quitar de la nueva versión, entonces se puede optar por hacer un

hg addremove
en lugar de un simple remove, que además de agregar los nuevos archivos quita los faltantes, o simplemente un
hg remove -A

9) Generar un commit
Se puede generar con alguno de los dos siguientes comandos:
hg commit
hg commit -m "Descripción del cambio realizado"
La diferencia está en que el primero abrirá un archivo en el cual se deberá escribir y guardar la descripción de la versión, mientras que en el segundo se especifica directamente en el comando.

10) Hacer algunos cambios en el proyecto y generar un segundo commit.

11) Consultar el historial de revisiones del repositorio
Mostrará los changesets (versiones) registrados al momento, ordenados del más reciente al más antiguo. También se puede limitar el número de entradas a mostrar.
hg log
hg log -l 5
hg log --limit 5

12) Volver a un changeset anterior
Se debe conocer el número del changeset al que deseo volver. Este id puede consultarse mediante hg log.
hg update 0
*donde 0 es el número de changeset

13) Hacer modificaciones nuevamente sobre uno o varios archivos del proyecto.

14) Revertir los cambios efectuados
Aquí se puede elegir entre revertir todos cambios de todos los archivos, con alguno de los siguientes comandos:
hg revert -a
hg revert --all
O sólo revertir los cambios efectuados a determinados archivos:
hg revert filename.ext

15) Limpiar los archivos .orig (generados cuando se hage un revert)
hg purge
16) Generar un commit

17) Ver las diferencias de un determinado archivo en diferentes changesets
hg diff -r 0:1 unArchivo.extensión
*donde 0 y 1 son números de versiones

18) Mostrar el resumen del estado del Working Directory
hg summary

Para un completo tutorial, visitar:

sábado, 25 de mayo de 2013

Documentando código Javascript con JsDoc3

JsDoc es un generador de documentación de código JavaScript que utiliza cierto formato de comentarios para auto generarla.

En primer lugar, descargaremos el zip de JsDoc desde aquí y luego lo descomprimimos en una ubicación donde vaya a ser "instalado". Por ejemplo /home/usuario/Development

Para saber si todo funciona correctamete, abrir una terminal, cambiar al directorio raiz de JsDoc (ej: cd /home/usuario/Development/jsdoc-master/) y correr la siguiente línea para ejecutar los tests de verificación:
./jsdoc -T
Si todo ha ido bien, tendremos un mensaje similar a este:

Finished in 6.475 seconds706 tests, 1594 assertions, 0 failures.................Finished in 0.028 seconds17 tests, 34 assertions, 0 failures

Otra forma de instalarlo es ejecutando en consola:
sudo apt-get install jsdoc-toolkit
Esta segunda opción trae algunos cambios, que se marcarán como [Op2].


Ahora, para generar algo realmente vamos a hacer una prueba con código. Para ello vamos a utilizar este archivo, donde se pueden encontrar algunos tags específicos para indicar la descripción de una clase, sus parámetros de entrada, su return, entro otros. La lista completa de tags que se pueden utilizar puede ser consultada aquí

Para generar la documentación se debe ejecutar la siguiente línea, siempre reemplazando los directorios por los tuyos (yo muestro un ejemplo según mi archivo y directorios): 

./jsdoc /home/usuario/Desktop/prueba.js --destination /home/usuario/Desktop/out

[OP2]:
jsdoc /home/gaby/Desktop/prueba.js --directory=/home/user/Desktop/out 

También puede generarse sin especificar el parámetro "--destination" o "--directory", en cuyo caso la documentación se generará y quedará almacenada en la carpeta /out del directorio de la aplicación JsDoc (en mi caso /home/usuario/Development/jsdoc-master/out).

Por defecto, JSDoc usará la plantilla "default" para convertir los comentarios en HTML, pero es posible editar esta plantilla para adaptarla a otras necesidades, o crear una plantilla totalmente nueva.


viernes, 24 de mayo de 2013

Registrar las tools del ADT de Android


Si ya tenés instalado el SDK de Android, saltea este paso. Sino, simplemente bajalo de http://developer.android.com/sdk/index.html y descomprimilo en una ubicación donde vayas a dejarlo "instalado". Por ej: /home/user/Development/

Para poder utilizar cualquiera de las herramientas dentro de /tools o /platform tools desde la terminal y desde cualquier ubicación, es necesario registrar la ubicación de las mismas. Sino, por ejemplo, cada vez que necesitemos utilizar el adb desde línea de comando necesitaremos:
/Development/adt-bundle-linux/sdk/platform-tools
./adb devices
Para evitar esto, creamos un par de paths en ~/.bashrc. Para ello, ejecutamos en terminal:
sudo gedit ~/.bashrc
Agregar las siguientes líneas al final del archivo abierto, editar los paths según la ubicación donde instalaste el SDK, guardar y cerrar.
# Android tools
export PATH=~/Development/adt-bundle-linux/sdk/platform-tools:~/Development/adt-bundle-linux/sdk/tools:$PATH
Por último, se debe ejecutar el siguiente comando para recargar el .bashrc:
source ~/.bashrc
Ahora se puede utilizar las herramientas sin necesidad de cambiar de directorio y tipear "./".

martes, 12 de febrero de 2013

Patrones de diseño

He abierto un nuevo blog exclusivamente para hablar sobre Patrones de Diseño. Quienes deseen leer sobre el tema, podrán acceder desde la siguiente URL o desde el vínculo permanente a mis otros blogs.

http://design-patterns-with-uml.blogspot.com.ar/

jueves, 13 de diciembre de 2012

OpenCV + Visual Studio 2008

Para poder crear proyectos haciendo uso de esta librería, se deben seguir los siguientes pasos:


  1. Bajar OpenCV desde aquí. Yo bajé la 2.4.0
  2. Hacer doble click al ejecutable. Esto descomprimirá los archivos. Elegir una ubicación para OpenCV y descomprimir (Yo elegí C:\, pero pueden elegir cualquier otra, por lo cual de ahora en  más me referiré a esa ruta elegida como INSTALL_PATH, pero esto debe ser reemplazado SIEMPRE por la ruta que eligió.
  3. Ir a Inicio y escribir en la barra de búsqueda "Variables del sistema". Click en el resultado que aparece como "Editar las variables de entorno del sistema".
  4. Dentro de la pestaña 'Opciones Avanzadas' ir a 'Variables de Entorno'.
  5. En la nueva ventana, buscar dentro del segundo listado (variables del sistema) una variable llamada Path. Seleccionarla y hacer click en editar.
  6. Ir al final del textbox 'Valor de la variable', agregar un punto y coma, y agregar las siguientes dos ubicaciones, también separadas por un punto y coma:
    • INSTALL_PATH\opencv\build\x86\vc10\bin
    • INSTALL_PATH\opencv\build\common\tbb\ia32\vc10
    donde
    *ia32 es en caso de tener Windows x32, sino ingresar a intl64.
    *vc10 es en caso de tener Visual C 2010. En caso de tener Visual C 2008, elegir vc9.
Luego, abrir un proyecto existente que utilice OpenCV (éste, por ejemplo), seleccionarlo en el 'Explorador de soluciones' y hacer click derecho para seleccionar 'Propiedades'.



En propiedades dirigirse a:
  • C/C++
    Agregar los siguientes directorios en Additional Include Directories:
    • INSTALL_PATH\opencv\build\include\opencv
    • INSTALL_PATH\opencv\build\include
  • Linker->General
    Agregar el siguiente directorio en Additional Library Directories:
    • INSTALL_PATH\opencv\build\x86\vc10\lib
  • Linker->Input
    Agregar el siguiente listado, tendiendo en cuenta que
    • debe reemplazarse el número por la versión de OpenCV que se utiliza. Por ejemplo, 242 para la versión 2.4.2 o 240 para la 2.4.0.
    • debe quitarse la letra 'd' final, si se trata de un Release Project.
opencv_core240d.lib
opencv_imgproc240d.lib
opencv_highgui240d.lib
opencv_ml240d.lib
opencv_video240d.lib
opencv_features2d240d.lib
opencv_calib3d240d.lib
opencv_objdetect240d.lib
opencv_contrib240d.lib
opencv_legacy240d.lib
opencv_flann240d.lib

Si se tratara de una solución, y no de un proyecto simple, repetir esto en cada proyecto.


sábado, 27 de octubre de 2012

Cómo instalar un APK en un AVD

  1. Descargar algún APK. Desde aquí se puede descargar el de Fennec.
  2. Abrir el AVD Manager y arrancar el dispositivo al que se le desea instalar el paquete.
  3. Abrir una terminal y ejecutar:
    sudo ./platform-tools/adb install /home/gaby/Downloads/fennec-16.0.2.multi.android-arm.apk 
  4.  Para el caso particular de Firefox, el dispositivo debe incluir en la configuración de hardware la "emulación GPU" seteada en yes.
Si en algún momento se desea desinstalar:
  1. Abrir el AVD Manager y arrancar el dispositivo al que se le desea desinstalar el paquete.
  2. Abrir una terminal y ejecutar:
    sudo ./platform-tools/adb uninstall org.mozilla.firefox

Usar el teclado de la PC para escribir en el AVD

  1. Eclipse > Window menu > AVD Manager
  2. Seleccionar el dispositivo y click en Edit
  3. En Hardware, Click en New
  4. Seleccionar Keyboard Support y click en OK
  5. Editar su valor a yes