17 Agosto, 2016

Contenidos

Introduccin
Git
Configuracin de Git
Enlaces importantes
Java Oracle
Android SDK
NodeJS y NPM
Libreras de NodeJS
Editor de texto
Emmet

Taller de aplicaciones hbridas

17 Agosto, 2016

Introduccin

Este documento ha sido elaborado para el taller de aplicaciones

hbridas, que ser llevado a cabo en el Tecnolgico de Costa Rica
(TEC) el 17 de agosto del 2016 impartido por GoTouch en alianza
con la rama estudiantil de la IEEE del TEC.
Con este documento el participante del taller podr configurar su
equipo con todas las herramientas necesarias para el taller. Todas
las herramientas que se utilizarn en el taller son libres. Este manual
se encuentra orientado a sistemas operativos Linux y ha sido
probado en las distribuciones Debian, Ubuntu y Linux Mint.
Los programas y libreras que se utilizarn se listan a continuacin:
Git
Android SDK y Java Oracle
NodeJS y NPM
gulp-cli
bower
cordova
ionic
grunt-cli
yo
Atom

En el documento encontrar una serie de comandos que inician con $. Este dlar indica
que es un comando que debe ser ejecutado en consola y no debe ser incluido como parte
del comando. En algunos casos, los editores de textos como LaTeX cambian el tipo de las
comillas y los guiones, por lo que se recomienda escribir cada uno de los comandos y no
copiar y pegar desde este documento.

Taller de aplicaciones hbridas

17 Agosto, 2016

Git
Basado en el manual de DigitalOcean, tomado el 16 de agosto.
https://www.digitalocean.com/community/tutorials/how-to-install-gi
t-on-debian-8
Git es un sistema de control de versiones distribuido, lanzado en el
2005 bajo la licencia GNU General Public License v.2.
Es un software utilizado principalmente para control de versiones,
que permite el desarrollo de proyectos de forma paralela. Cada
directorio de trabajo (working directory) en Git es un repositorio
completo e independiente con historial y trazabilidad asociada y con
una referencia a un servidor central.
La principal ventaja de utilizar Git es la forma en que el programa
almacena los datos. A diferencia de otros sistemas de control de
versiones, Git almacena la informacin en forma de snapshots o
capturas de estado de un sistema de archivos propio en el disco
local, con esto y a travs de un sistema de ramificaciones Git
maximiza la eficiencia y habilita un poderoso conjunto de comandos
para ser utilizados en el desarrollo de sistemas.
Para instalar git utilizamos los siguientes comandos
1. Actualizamos la lista de paquetes
$sudoaptgetupdate
2. Instalamos Git
$sudoaptgetinstallgitcore
3. Verificamos la instalacin
$gitversion
Lo anterior debera indicar la versin de git instalada. Debera ser una
versin reciente superior a la 2.0.0.
$gitversionX.X.X

Configuracin de Git
1. Configuramos el nombre de usuario

Taller de aplicaciones hbridas

17 Agosto, 2016

$gitconfigglobaluser.name"SammyShark"
2. Configuramos el correo
$gitconfigglobaluser.email"sammy@shark.com"

Enlaces importantes
Como usar Git de forma efectiva
https://www.digitalocean.com/community/tutorials/how-to-use-git-e
ffectively
Como utilizar las ramas de Git
https://www.digitalocean.com/community/tutorials/how-to-use-git-b
ranches

Java Oracle
Para utilizar el SDK y obtener un correcto funcionamiento y
rendimiento debemos utilizar la distribucin Java de Oracle y no la de
OpenJDK. Para saber si tenemos instalado el Java utilizamos el
comando java -version. Lo anterior debera indicar un error diciendo
que no se encuentra el programa instalado.
En caso de indicar que se posee la versin 1.8.X o 1.7.X de Oracle no
es necesario continuar con este paso, ya que se cuenta con todo lo
necesario. Si la consola muestra que se posee una versin de
OpenJDK entonces utilice el siguiente comando para desinstalarlo.
$sudoaptgetpurgeopenjdk7jregcj4.7base
gcj4.7jreopenjdk6jreheadless
Ahora instalaremos la versin ms estable de Oracle (tutorial tomado
de TecAdmin.net http://tecadmin.net/install-java-8-on-debian/#).

1. Con un editor de texto abrimos con permisos de administrador el

archivo /etc/apt/sources.list
$sudogedit/etc/apt/sources.list
2. Colocar las siguientes lneas de repositorios y guardar el archivo.
debhttp://ppa.launchpad.net/webupd8team/java/ubuntu
trustymain

Taller de aplicaciones hbridas

17 Agosto, 2016

debsrc
http://ppa.launchpad.net/webupd8team/java/ubuntutrusty
main
3. Agregamos la firma que permite validar la autenticidad de los
nuevos repositorios
$sudoaptkeyadvkeyserverkeyserver.ubuntu.com
recvkeysEEA14886
4. Actualizamos la lista de paquetes disponibles
$sudoaptgetupdate
5. Instalamos Java
$sudoaptgetinstalloraclejava8installer
A partir de este momento podemos ejecutar en consola java -version
y debera lanzar un resultado como el siguiente

6. Instalamos un paquete que permite configurar las variables de

entorno de Java
$sudoaptgetinstalloraclejava8setdefault

Android SDK
Para compilar el proyecto de Ionic en un dispositivo mvil se
necesita nicamente el SDK (Software Development Kit) de android.
0. Si usted tiene una arquitectura de 64 bits deber instalar el
siguiente paquete.
$sudoaptgetinstallia32libs
(Para saber la arquitectura del equipo utilice el comando uname -a)
Si usted utiliza el sistema operativo Ubuntu 13.04 o superior el
paquete ia32-libs ya no existe, por lo que puede reemplazarlo por el
siguiente comando
sudoaptgetinstalllib32z1lib32ncurses5lib32bz21.0

Taller de aplicaciones hbridas

17 Agosto, 2016

1. Para descargar el SDK debes utilizar el navegador Chrome, ya que

en otros no muestra los enlaces de descarga. Ingresa al enlace
https://developer.android.com/studio/index.html y dirigete al final
del contenido del sitio. En esta seccin vers el enlace de descarga
del SDK.

El enlace va a descargar una carpeta con el SDK de android. A

continuacin abrimos la consola.
2. Nos colocamos en la carpeta de descarga del SDK. Si es un
sistema operativo ubuntu o debian, debera estar en la carpeta:
Descargas o Downloads.
$cdDescargas
3. Descomprimir el SDK, reemplazando el nombre del archivo por la
versin descargada en la pgina oficial de android. Este paso crear
una carpeta llamada android-sdk-linux.
$tarxvfandroidsdk_r24.4.1linux.tgz
4. Movemos el SDK a la ruta /opt para paquetes generales.
$sudomvandroidsdklinux/opt/
5. Le damos permisos de ejecucin general a la carpeta
$sudochmod777/opt/androidsdklinuxR
$sudochownR$(whoami)/opt/androidsdklinux
6. Agregamos el SDK a las variables de entorno del sistema
operativo. Con un editor abrimos el archivo /home/<tu
usuario>/.bashrc y colocamos la siguiente lnea al final del archivo.
Debes tener permisos de administrador para editar este documento.

Taller de aplicaciones hbridas

17 Agosto, 2016

export
PATH=/opt/androidsdklinux/tools:/opt/androidsdklinu
x/platformtools:$PATH
7. Cargamos las variables de entorno.
$source~/.bashrc
A partir de este momento debera de poder ejecutar android desde la
consola. Vamos a ejecutarlo y actualizar las herramientas de
compilacin necesarias. Para ejecutar android simplemente
escribimos el siguiente comando: android.
Lo anterior abrir el administrador del SDK de android

En este administrador indicaremos cules herramientas de

compilacin queremos instalar. Por ejemplo, si tenemos un
dispositivo Android cuya versin de sistema operativo es 6.0.0
entonces debemos marcar el API 23 que se visualiza en el
administrador. No deben instalar el API 24, ya que an no es una
versin estable y genera problemas al compilar con Ionic.

Taller de aplicaciones hbridas

17 Agosto, 2016

NodeJS y NPM
NodeJS es un entorno de ejecucin de JavaScript (JS) basado en V8,
el motor de JS de Google Chrome. Posee un modelo orientado a
eventos y de entrada y salida sin bloqueos, lo que lo convierte en un
entorno ligero y eficiente. Posee un ecosistema de paquetes llamado
npm, que es el repositorio de libreras ms grande del mundo.
Para instalar NodeJS utilizaremos las indicaciones oficiales en el
sitio de NodeJS https://nodejs.org/en/download/package-manager/.
1. Utilizando curl, descargamos la versin ms estable de Node:
$curlsLhttps://deb.nodesource.com/setup_6.x|sudo
Ebash
2. Instalamos la versin
$sudoaptgetinstallynodejs
3. Instalamos build-tools para compilar herramientas nativas
$sudoaptgetinstallybuildessential
A partir de este momento podr ejecutar node -v en consola, para lo
que debera obtener una versin equivalente o superior a la 6.0.0. De
igual forma, los comandos anteriores instalan la versin ms estable
de npm.
Si usted ya tena Node instalado pero tiene una versin ms vieja,
puede seguir este manual para actualizarlo:
https://davidwalsh.name/upgrade-nodejs.
Al instalar un comando con npm debe realizarse sin permisos de
administracin (sin sudo). Para garantizar esto debemos
asegurarnos de que los permisos de ejecucin de Node se
encuentren bien. Para hacer esto ejecutamos lo siguiente:
1. Obtenemos la ruta de instalacin de Node
npmconfiggetprefix

Taller de aplicaciones hbridas

17 Agosto, 2016

2. Si la ruta de instalacin es nicamente /usr contine al paso B. Si

la ruta de instalacin es /usr/local contine al paso A. Cualquier otra
ruta, contine al paso B.
A. Cambie los permisos de administracin de Node
sudochownR$(whoami)$(npmconfigget
prefix)/{lib/node_modules,bin,share}
B. Cree una nueva carpeta de instalacin y cambie los permisos y
configuraciones de Node:
Crear una carpeta en la raz del usuario

mkdir~/.npmglobal
Cambie configuracin de Node

npmconfigsetprefix'~/.npmglobal'
Con un editor, abra el archivo /home/<su usuario>/.bashrc y

agregue la siguiente lnea al final del documento. No importa

si ya ha hecho un paso similar antes, la lnea vuelve a integrar
la variable PATH para que no se modifiquen otras variables
de entorno.
exportPATH=~/.npmglobal/bin:$PATH
Actualizamos las variables de entorno.

source~/.profile
A partir de este momento usted puede instalar libreras utilizando el
gestor de paquetes de npm.

Libreras de NodeJS
Ahora se utilizar el gestor de npm para instalar programas
necesarios para el taller. Ejecutamos el siguiente comando en
consola:
npminstallgcordovaionicgulpcliboweryo
A partir de este momento usted podr utilizar cordova y ionic para
generar proyectos hbridos

10

Taller de aplicaciones hbridas

17 Agosto, 2016

Editor de texto
Para editar cdigo utilizaremos el editor Open Source ATOM. Para
descargarlo ingrese al sitio web oficial https://atom.io/. Descargue el
archivo .deb para linux. En una terminal abra la ruta de descarga y
ejecute la instalacin:
$cdDescargas
$sudodpkgiatomamd64.deb
Una vez ejecutado el comando anterior, podr buscar el programa en
el listado del sistema operativo o ejecutar atom en consola.
Ahora vamos a instalar una librera para ATOM que facilita el
desarrollo, para hacer esto en el men Editar de Atom, abra las
preferencias. Ac saldr un men lateral, donde una de las opciones
es Packages.

Emmet
Es una librera de autocompletado muy til para proyectos web. En la
barra de bsqueda del gestor de paquetes de ATOM escriba
emmet. El resultado de bsqueda mostrar varios resultados. Debe
instalar el que dice nicamente el texto Emmet.

11

Taller de aplicaciones hbridas