Event Listeners en Cordova para Android y iOS

Al empezar una aplicación de Cordova una de las primeras cosas a tener en cuenta son sus event listeners, relacionados con el ciclo de vida de una app. Se trata de unos pocos eventos que conviene tener en cuenta, especialmente cuando tenemos que conservar cambios o estados al pasar nuestra aplicación a segundo plano (porque entra una llamada o porque el usuario aprieta el backbutton) y al volver a primer plano.

Así que examinemos brevemente estos event listeners:

Relacionados con el Ciclo de Vida

deviceready

el evento esencial, marca cuando Cordova está cargada y preparada para accederse, para evitar que la parte del Javascript sea llamada antes de que esté accesible en el DOM. Una vez se dispara este evento, el sistema ya escucha nuestra programación.

pause

se dispara cuando una aplicación pasa a segundo plano o background (ver especificaciones particulares para iOS). Es especialmente importante para guardar estados o datos importantes que no queramos que el usuario pierda.

resume

se dispara cuando una aplicación pasa a primer plano (ver especificaciones particulares para iOS)

Relacionados con los Botones (sólo Android)

backbutton

sobrescribe el comportamiento por defecto del botón de ir atrás

menubutton

sobrescribe el comportamiento por defecto del botón de menú

searchbutton

sobrescribe el comportamiento por defecto del botón de buscar

Ejemplos

function writeConsole() {
 console.log("DEVICE READY");
 document.addEventListener("pause", onPause, false);
 document.addEventListener("resume", onResume, false);
 document.addEventListener("backbutton", onBackKeyDown, false);
 document.addEventListener("menubutton", onMenuKeyDown, false);
 document.addEventListener("searchbutton", onSearchKeyDown, false);
 cordova.plugins.email.isAvailable( function (isAvailable) {
 console.log("EMAIL PLUGIN AVAILABLE");
 });
}
function onPause() {
 console.log("ON PAUSE");
}
function onResume() {
 console.log("ON RESUME");
}
function onBackKeyDown() {
 console.log("ON BACK KEY DOWN");
}
function onMenuKeyDown() {
 console.log("ON MENU KEY DOWN");
}
function onSearchKeyDown() {
 console.log("ON SEARCH KEY DOWN");
}

Ponemos nuestra llamada a writeConsole() en el ready del documento. El ready dependerá del framework de vista que utilicemos. Por ejemplo, si utilizamos (muy recomendable) ionic, lo deberíamos poner en el $ionicPlatform.ready:

.run(function($ionicPlatform) {
  $ionicPlatform.ready(function() {
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
    writeConsole()
  });
})

Más información en la página oficial de Cordova.

 

Cómo utilizar Genymotion con Ionic

Genymotion es una más que esperada alternativa a los AVD. Aunque es de pago en su versión completa, la versión gratuita nos permite trabajar con un emulador sólo con unas pocas limitaciones (entre ellas el trabajo en red).

Es sencillo utilizar Genymotion, pero algunos aspectos pueden resultar problemáticos. Esta pequeña guía pretende permitir empezar a trabajar con Genymotion sin más problemas. Para profundizar en las posibilidades, recomendamos su la guía de inicio de Genymotion, muy completa.

Paso 1

Vamos a la página de descargas de Genymotion y escogemos la versión FREE.

Tenemos que registrarnos. El registro es gratuito. Necesitaremos esa cuenta para empezar a utilizar Genymotion.

Seleccionamos nuestra versión y ejecutamos el archivo descargado. Observad que con Genymotion se nos instala VirtualBox, dado que cada virtual device será una máquina virtual.

Paso 2

Iniciamos Genymotion. Nos indicará que no tenemos ningún dispositivo y que si queremos añadir uno. Para añadir un nuevo dispositivo, nos pedirá que nos identifiquemos. Una vez identificados podremos escoger la máquina virtual que queramos, tanto el modelo como la distribución de Android.

Una vez escogida, la bajaremos (se trata de máquinas pesadas, de más de 100M) y la tendremos dispuesta.

Paso 3

Para utilizar nuestra máquina virtual primero debemos encenderla. Genymotion abre cada máquina virtual como un dispositivo externo conectado mediante USB, de manera que tenemos que tener abierta la máquina y debemos abrirla como:

$ ionic run

Paso 4

Si queremos utilizarlo con Eclipse, podemos instalar el plugin para Eclipse de su página. En las instrucciones de Genymotion encontraréis el link para instalarlo desde Install New Software y los pasos.

 

 

 

Crear una web app con Cordova y Ionic utilizando la cámara

Una de las ventajas de utilizar Cordova es la facilidad con la que podemos utilizar muchas de las características de los móbiles, como cámara, geolocalización, agenda, contactos, etc. La ventaja de utilizar Ionic es la facilidad con la que Angular.js (aunque no utilicemos ngCordova) interactúa con los plugins de Cordova y nos permite utilizarlos. Veamos nuestro ejemplo con la cámara en Android.

Paso 1 – Entorno de desarrollo

Instalamos el entorno de desarrollo, con Cordova y Ionic. Si no lo tenéis ya instalado, podéis consultar nuestro tutorial sobre cómo instalar Cordova y Ionic.

Paso 2 – Creación de la app

Creamos una web app vacía Ionic:

$ ionic start miCameraApp blank

Vamos al directorio:

$ cd miPrimeraApp

Le añadimos la plataforma Android y hacemos el build.

A continuación importamos el proyecto a Eclipse y empezamos a trabajar.

Paso 3 – Instalación del plugin

Volvemos a la consola y en el directorio de la app, instalamos el plugin:

$ cordova plugin add org.apache.cordova.camera

Paso 4 – HTML

Añadimos al HTML básico preparado por Ionic nuestro botón para tomar la foto y un tag img en el que mostrar la última foto tomada:

<ion-content>
    <button ng-click="tomaFoto()" class="button button-block button-primary">Foto!</button>
    <img ng-src={{lastPhoto}} style="max-width: 100%" />
</ion-content>

Al hacer click en el botón ejecutará el método tomaFoto() de Angular.js.

Paso 5 – app.js (Angular)

Abrimos el fichero app.js, en www\js, y añadimos al final de todo el documento, fuera de todas las llaves, el siguiente controlador:

.controller('MainCtrl', function($scope, Camara) {
    $scope.tomaFoto = function() {
        Camara.tomaFoto().then(function(imageURI) {
            $scope.ultimaFoto = imageURI;
        }, function(err) {
            console.err(err);
        }, {
            quality: 75,
            targetWidth: 200,
            targetHeight: 200,
            saveToPhotoAlbum: false
        });
    };
})

Este controlador llama a un servicio angular.js creado por nosotros y que nos devuelve un objeto Camara, que nos permite utilizar la cámara del teléfono. Este servicio lo creamos en otro archivo que crearemos nosotrosahora, services.js, y que debemos cargar cuando se cargue este módulo starter de angular.js. Así, añadimos starter.services a la definición del módulo:

angular.module('starter', ['ionic', 'starter.services'])

IMPORTANTE: añadimos también el controlador al body del html:

<body ng-app="starter" ng-controller="MainCtrl">

Paso 4 – la factoría de Cámaras

Creamos un nuevo fichero services.js en el mismo directorio que app.js, www\js, y añadimos la factoría de Cámaras, que es donde Angular interactúa con el plugin de Cordova:

angular.module('starter.services', [])
.factory('Camara', ['$q', function($q) {
    return {
        tomaFoto: function(options) {
            var q = $q.defer();
            navigator.camera.getPicture(function(result) {
                q.resolve(result);
            }, function(err) {
                q.reject(err);
            }, options);
            return q.promise;
        }
    }
}]);

IMPORTANTE: no olvidéis añadir la referencia a services.js en el had de vuestro index.html:

 <script src="js/services.js"></script>

Final

A partir de aquí podemos jugar con esas fotos, pero eso ya son otros plugins…

 

 

Empezar a utilizar Sass en un proyecto IONIC Cordova

Como Bootstrap o muchos otros frameworks, Ionic viene ya con SASS. Estos frameworks para utilizar CSS de manera avanzada, con herramientas de programación, cada vez son más presentes y permeables. En este pequeño artículo vamos a echar un vistazo a la presencia de SASS en Ionic.

Instalación de SASS

Instalamos SASS en nuestro sistema, para que Ionic pueda utilizarlo.

Uso de SASS en Ionic

En cuanto a Ionic y CSS, podemos utilizar directamente el css vacío (/* Empty. Add your own CSS if you like */) que nos aparece en:

nombre_app\www\css\style.css

O podemos trabajar con Sass directamente, que es el que va a generar el css final. Este css final generado por Ionic lo encontramos en:

nombre_app\www\css\ionic.app.css

Para sobrescribir las variables de estilo de scss no vamos directamente a los scss sino que los sobrescribimos en los archivos del directorio nombre_app\scss, que terminan todos unidos en:

nombre_app\www\lib\ionic\scss\ionic.scss

Por ejemplo, si abrimos el fichero:

nombre_app\www\lib\ionic\scss\_variables.scss

podremos en él cambiar variables globales, y empezaremos a disfrutar de poder progamar, o por lo menos acercarnos más a lo que es programar, en CSS.

IMPORTANTE: si queremos trabajar directamente con sass en la compilación de la app en tiempo real, debemos hacer un gulp sass;

gulp sass

Declarando SASS en la página index.html

En la página index.html declararemos nuestro CSS de una manera u otra dependiendo de si queremos escribir directamente css o de si queremos trabajar directamente con SASS.

Así, en el HEAD, debemos escribir:

Si no utilizamos sass:

<link href=“lib/ionic/css/ionic.css” rel=“stylesheet”>

<link href=“css/style.css” rel=“stylesheet”>

Si utilizamos sass:

<link href=”css/ionic.app.css” rel=”stylesheet”>

 

Instalar SASS en Windows

SASS, junto con LESS, es una manera de llevar las ventajas de la programación a CSS, dándonos las ventajas del uso de variables o de subclases. En este link podéis leer una buena comparativa entre ambos.

Por nuestra parte, simplemente os echamos una mano para instalar vuestro SASS en Windows para empezar a utilizarlo.

Con RUBY

SASS está escrito en Ruby, de manera que para instalar SASS en nuestro sistema necesitamos primero instalar Ruby (aunque hace poco han sacado http://sass-lang.com/libsass como un puerto C/C++ para Sass). Instalamos Ruby desde su oágina oficial.

Una vez instalado podemos ir a la consola de Windows e instalar Sass desde gem, el gestor de packages de Ruby:

gem install sass

Para asegurarnos de que todo ha ido bien consultamos la versión instalada de sass:

sass -v

que nos tiene que dar, en el momento de este tutorial:

sass 3.4.7 (Selective Steve)

En el caso de que tengamos sass pero queramos actualizarlo a la última versión:

gem update sass

Con Node

Recientemente tenemos la posibilidad de instalar SASS mediante npm:

npm install node-sass

Cómo debugar una web app en Chrome

Cuando hacemos una web app, ya sea con jQuery Mobile, con Ionic, con Sencha Touch, etc., una de las cosas que más quisiéramos tener es poder actuar con la web app con F12 y ver y depurar todos los procesos. Es cierto que podemos abrir la app con el navegador, pero no es lo mismo, ya que muchas llamadas u otros procesos se pierden.

Pues bien, entre otros métodos que analizaremos en futuros artículos, hoy queremos comentar la herramienta que nos ofrece Google Chrome. Así es, debugar una aplicación web con Google Chrome es posible a partir de Android 4.0!

Tenéis toda la documentació en la página de desarrollo de Chrome, pero vamos a ver los pasos principales.

Paso 1: Requisitos

Como desarrolladores de web apps, ya tendréis habilitada la conexión USB developer entre el teléfono y el ordenador (en caso de que no fuera así, el tutorial de Chrome incluye también instrucciones, o podéis también consultar aquí: http://www.fandroides.com/que-es-y-como-habilitar-la-depuracion-usb-en-android/; recordad también de instalar los controladores usb de vuestro dispositivos, que normalmente se encuentran en la web del fabricante o incluido en los paquetes de instalación (como el KIES en el caso de Samsung). Para la conexión es lo único que necesitamos.

Paso 2: Google Chrome

En Chrome nos vamos a:

Menú -> Más Herramientas ->Inspeccionar dispositivos

Se abrirá la pestaña de DevTools y el apartado devices.

Menú > Más Herramientas > Inspeccionar Dispositivos

Menú > Más Herramientas > Inspeccionar Dispositivos

Paso 3: Debugar

Nos aseguramos de que “Discover USB devices” está marcado, y nos aseguramos de que nuestro dispositivo ha sido encontrado.

Si tenemos alguna web view activa (nuestra app u otra), ésta se mostrará; si no en cuanto la abramos se mostrará.

Una vez se muestre la app, podemos hacer click en “inspect”, y se mostrará nuestro conocido F12 (en caso de que no sea conocido, podéis echarle un vistazo a este tutorial: https://developer.chrome.com/devtools )

Chrome DevTools - Inspect Devices

Chrome DevTools – Inspect Devices

Como hemos dicho, hay otras herramientas, pero esta es una rápida y magnífica manera de conseguir debigar de verdad una web app!

 

Como instalar Ionic para trabajar con Cordova en entorno Android

Recientemente ha saltado con fuerza a la cyber-palestra un framework para mobile apps que une las ventajas de jQuery Mobile y las de Bootstrap junto con los avances en programación web de la mano de Angular.js. Hablamos de Ionic.

Ionic Framework Logo

Ionic Framework

Si bien su getting started es muy claro y sencillo, hemos creado esta pequeña continuación de nuestro tutorial sobre la instalación y configuración de Cordova 3 porque consideramos que en breve esta será la manera de trabajar con Cordova 3.

Pasos 1-3

Corresponden a la instalación de todo el entorno Android y Java. Son los pasos 1 a 3 de nuestro mencionado artículo sobre la instalación y configuración de Cordova 3.

En cuanto al IDE de desarrollo, podemos optar por el Eclipe ADT que aparece en nuestro tutorial, o podéis probar el flamante, aunque todavía en fase beta, Android Studio.

Paso 4

Queremos trabajar con Cordova utilizando Ionic y Angular, de manera que instalaremos ambos a la vez. Abrimos la consola y escribimos:

$ npm install -g cordova ionic

De hecho van tan unidos que a partir de la instalación de ionic, vamos a hacer las tareas de Cordova en su CLI mediante el comando ionic.

Paso 5

Creamos nuestra primera app. Ionic ofrece algunas plantillas de base para empezar. Algunas con elementos que probablemente utilicemos, y una vacía.

Nos situamos en la carpeta de neustro workspace (el comando de ionic creará por nosotros la carpeta del proyecto) y escribimos:

$ ionic start "nombre de la app" "plantilla"

Así, si queremos iniciar una app vacía:

$ ionic start miPrimeraApp blank

Si queremos iniciar una nueva app con tabuladores:

$ ionic start miPrimeraApp tabs

 

Si queremos iniciar una con menú lateral:

$ ionic start miPrimeraApp sidemenu

 

Paso 6

No olvidemos que queremos trabajar con Cordova y Ionic, pero también con Android, de manera que tenemos que añadir también al proyecto la plataforma Android y hacer un build. Para ello nos siatuamos en la nueva carpeta (en este caso miPrimeraApp):

$ cd miPrimeraApp

Añadimos la plataforma Android:

$ ionic platform add android

Lo mismo haríamos con su equivalente ios. Para Windows Phone podéis consultar este link al foro de Ionic.

Hacemos build:

$ ionic build android

Y ya podemos deployar. Con emulate para emulador o run para dispositivo:

$ ionic emulate android
$ ionic run android

Paso 7

Para trabajar con Ionic podemos utilizar cualquier editor de texto, como nuestro preferido Sublime 3, o el más caro pero al parecer más adecuado para javascript y preferido por muchos desarrolladores de Angular WebStorm.

En todo caso, para trabajar con Android sí queremos el mencionado Eclipse ADT o el Android Studio. Para ver cómo cargamos en nuestro Eclipse esta primera aplicación Cordova con Android, lo abrís desde el Eclipse como un Nuevo Proyecto Android desde Código Existente, tal y como se ve en nustro artículo sobre Córdova 3.

Y hasta aquí. ¡Buena suerte, y a disfrutar de este nuevo framework!

 

Generar una debug API Key para Google Maps Android en Windows

Hay dos tipos de certificados, el debug, que se genera automáticamente cuando se lanza un proyecto; se utiliza para aplicaciones de test o desarrollo, no para publicar en Google Play. Para una app que vaya a publicarse se utiliza el certificado release. En este apartado nos centraremos en la creación de una debug.

La API Key que obtendremos se puede usar con todas las aplicaciones creadas con el mismo certificado (es decir, a efectos prácticos, en el mismo ordenador), independientemente del nombre del package.

Para la creación de una reléase, podéis consultar la página oficial de Android en la que hemos basado este tutorial.

Para utilizar la API Key de debug

1) Localizamos el archivo keystore debug.keystore en C:\Users\<Usuario>\.android

debug.keystore

debug.keystore

2) Abrimos la consola (Inicio -> Ejecutar -> cmd) y lanzamos el siguiente comando:

keytool -list -v -keystore "C:\Users\<Usuario>\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
cmd - comando para generar el SHA1

cmd – comando para generar el SHA1

3) Copiamos el SHA1 (haz click aquí para ver cómo copiar y pegar en la consola de windows) generado:

cmd - recuperando el SHA1

cmd – recuperando el SHA1

4) Vamos a la consola de desarrollador de Google y creamos un nuevo proyecto:

Google Developer Console - Create New Project

Google Developer Console – Create New Project

5) Vamos a APIs:

Google Developer Console - APIs

Google Developer Console – APIs

6) Y activamos Google Maps Android API v2 (una vez activada pasa arriba de la lista):

Google Developer Console - Maps Android v2

Google Developer Console – Maps Android v2

7) Hacemos click en credentials:

Google Developer Console - Credentials

Google Developer Console – Credentials

8) Hacemos click en create new key:

Google Developer Console - Create New Key

Google Developer Console – Create New Key

9) Seleccionamos Android Key

Google Developer Console - Android Key

Google Developer Console – Android Key

10) Pegamos nuestra clave en el text área que se nos ofrece y le unimos:

;<nombre del package>
Google Developer Console - Introducimos nuestro SHA1 junto con el package de nuestra app

Google Developer Console – Introducimos nuestro SHA1 junto con el package de nuestra app

11) Copiamos la API key y la pegamos en el manifest.xml

Google Developer Console - Copiamos la SHA1

Google Developer Console – Copiamos la SHA1

 

¡Y ya está! Si encontráis algo que comentar, bueno o malo, no dudéis en hacerlo, cualquier feedback es bien recibido!

 

Instalar Sublime Text 3

Este post es una pequeña introducción a la instalación y uso de Sublime Text 2. Podéis encontrar una exhaustiva y provechosa introducción en los vídeo tutoriales de Jeffrey Way.

Instalación

Ahora mismo la version functional es la 2..0.2, pero la versión 3 lleva en beta desde hace bastante tiempo y es ya generalmente la que se usa, de manera que empieza a ser la recomendable. Vamos a la página de downloads (http://www.sublimetext.com/3) y descargamos la versión adecuada (en nuestro caso Windows 64 bits).

Descargar Sublime text 2

Descargar Sublime text 2

Instalar el Package Control

El Package Control es ya un plugin indispensable. Se trata de un repositorio de packages (plugins) para Sublime, desde donde buscar un package e instalarlo es cuestión de segundos.

Para instalar Sunlime Package Control nos dirigimos a la página del proyecto (https://sublime.wbond.net/installation) y seleccionamos el texto relativo a la versión que utilizamos (por defecto ya está escogido Sublime 3)

Código del Package Control

Código del Package Control

A continuación copiamos el texto completo de la pestaña.
Abrimos la consola de Sublime Text 3 (View => Show Console).

Abrir consola de Sublime Text 2

Abrir consola de Sublime Text 2

Pegamos en la línea de comandos (la línea de abajo) el texto que hemos copiado y apretamos Enter.

Insertar código en la línea de consola

Insertar código en la línea de consola

Reiniciamos.

Y ya tenemos en CTRL+SHIFT+P Package (Preferences => Package Control)

Package Control Manager

Package Control Manager

 

Consejos varios

Open folder

Para poder trabajar en un proyecto, lo mejor es abrir una carpeta en vez de un archivo. Al abrir una carpeta podemos trabajar con esa carpeta en la side bar, además de ver los archivos abiertos.

Trabajar con folders

Trabajar con folders

Usar cursor multiple (multiple cursor)

Ponemos el cursos en la palabra que queramos cambiar y apretamos Ctrl+D para seleccionar la siguiente aparición de esa palabra o Alt + F3 para seleccionar todas las apariciones a la vez.
Para seleccionar diferentes lugares en el documento apretamos Shift + botón derecho (o el botón del medio) y arrastramos, o añadimos mediante Ctrl + click y quitamos mediante Alt + click.

Trabajar con multicursor

Trabajar con multicursor

Atajos de teclado

Para activar la paleta de commandos, desde donde tenemos acceso a todos los commandos disponibles en el programa: Ctrl + Shift + P.
Búscar y abrir un archivo: Ctrl + P
Para navegar por símbolos: Ctrl + R (útil especialmente en CSS y en funciones js)
Mezcla de ambos: Ctrl + P “nombre de archivo”@symbol

Personalizar atajos de teclado

Para personalizar los atajos de teclado podemos cambiar los existentes o crear los nuestros.

Personalizar atajos de teclado

Personalizar atajos de teclado

Plugins útiles

Una vez tenemos instalado el Package Manager Control, ya podemos instalar los plugins que queramos. Tan fácil como abrir el Package Manager Control…

Instalar Package

Instalar Package

…y seleccionamos el plugin que queramos. Recomendados muchos, he aquí unos pocos:

Color Picker (CTRL+C)
EMMET
Advanced new file
HTTP Request Response

La documentación de cada uno de los plugins está en sus respectivas carpetas, que pueden consultarse mediante Browse Packages:

Browse Packages

Browse Packages

 

Instalar plugins manualmente

Algunos plugins deben instalarse manualmente. Para ello os bajáis el plugin de su página y lo ponéis en vuestra carpeta de Packages (Preferences => Browse Packages). Recordad reinicar el Sublime Text 2.

Recordad que podéis encontrar una gran introducción en los vídeo tutoriales de Jeffrey Way.

Cambiar el look del scroll: cómo configurar NiceScroll

Una de las mejoras de diseño que tarde o temprano queremos aplicar es un cambio de look al scroll. Para hacerlo bien no hay más, de momento, que aplicar javascript, y el mejor plugin que hay, o uno de los mejores, es el plugin de jQuery NiceScroll.

Para quien está habituado a trabajar con jQuery este pliugin es muy fácil, pero para los diseñadores que no necesariamente conocen jQuery o han trabajado nunca con él, puede resultar confuso. Estos puntos tratan de aclarar esa confusión, sin entrar en teoría:

1) Id a la página de descarga del plugin de NiceScroll.

2) Buscad la última versión

Imagen de la última versión funcional de la página de descarga de NiceScroll

Última versión funcional

Aseguraos de que no os bajáis la versión beta (en el momento del tutorial la útlima versión funcional es la 3.4 y la beta es la 3.5).

3) En el fichero hay muchos archivos, archivos de ejemplo, etc. A nosotros sólo nos interesa: jquery.nicescroll.js.

4) Una vez hemos bajado el plugin, tenemos que incluirlo en la página junto con el jQuery. Para ello en <head> ponemos primero el link al jQuery y después el link a nuestro archivo jquery.nicescroll.js:

<head>
    ...
    <script src="http://ajax.aspnetcdn.com/ajax/jquery/jquery-2.0.0.min.js"></script>
    <script src="jquery.nicescroll.js"></script>
</head>

Es importante poner primero el link a jQuery, sino no funcionaría el plugin.

5) En la página de NiceScroll, abajo, tenéis los ejemplos para empezar. Nos fijamos en el primero, que sirve para cambiar el scroll de toda la página, que es lo que en principio buscamos. Para ello, copiamos este código y lo ponemos al final, justo antes de cerrar el </body>:

<script type="text/javascript">
   $(document).ready(
      function() { 
         $("html").niceScroll();
      }
   );
</script>

Este código aplica nuestro plugin al html, es decir, a todo el contenedor de nuestro html.

6) Recordad que para probarlo tenéis que tener suficiente contenido como para que se muestre el scroll, de manera que no va mal un poco de Lorem ipsum.

!Y ya está! Os dejo el código completo y funcional (recordad poner el archivo jquery.nicescroll.js en el mismo directorio que el .html del ejemplo para que éste funcione):