Ionic 2 y Angular 2 – Segunda parte

Si quieres saber de que va esto, lee la primera parte.

La siguiente habilidad o conocimiento que tenía que obtener era saber llamar a una API externa para obtener unos datos.

Antes de crear un servicio, lo cual abordaré en la tercera parte, hay que saber lo más básico de todo: ¿cómo puedo hacer una llamada HTTP a una URL?

Para ello tiraremos de Angular y del módulo http:

import {Http} from '@angular/http';

Como mi idea desde el principio era hacer todo modular y poder abstraerme de las llamadas, lo que hice fue crear un componente que llamé Query y que será el que utilice para realizar las llamadas a la API externa:

import { Injectable } from '@angular/core';
import {Http} from '@angular/http';

@Injectable()
export class Query {

  constructor(private http: Http) {
    this.http = http;
  }

  get(url, mapper) {
    return this.http.get(url).map(data => mapper(data));
  }

  post(url, params, mapper) {
    return this.http.post(url, params).map(data => mapper(data));
  }
}

Dentro de la clase Query he se ven tres métodos:

  • constructor
  • get
  • post

El primero es el constructor de la clase, lo más interesante de él es definir las variables que recibe, las cuales son lo que antes hacíamos antes en ionic 1 al inyectar variables en el constructor del controlador. Por tanto aquí lo que estamos haciendo es definir la variable http que será de tipo Http. Después para poder usarla en el resto de métodos fuera del constructor lo que hacemos es asignarlo a this, que en este caso es la propia instancia de la clase.

Los otros dos métodos son llamadas de tipo GET y POST. Aquí cabe destacar el parámetro mapper, el cual lo voy a usar para formatear los datos que llegan de la API por si quiero hacer una transformación antes de usar los datos en la app.

Con todo esto, la manera de hacer una llamada sería la siguiente:


import { Query } from './query';

export class MiClase {
  constructor(private query: Query) {
    query.get('http://miapi.com/v1/metodo', (e) => e).subscribe(datos => this.datos = datos);
  }
};

Se puede ver en el ejemplo que en vez de usar promesas, ahora Angular usa Observables, que según dicen son mejores que las promesas, por tanto http devuelve un Observable al que hay que subscribirse para poder recoger los datos.

Por hoy ya es suficiente, en la próxima parte crearemos un servicio que haga uso de Query.

Ionic 2 y Angular 2 – Primera parte

Después de un tiempo resistiendome y engañandome a mi mismo de que Ionic con Angular 2 no era lo que yo necesitaba para crear nuevos proyectos. Después de dar mis primeros pasos con React y sobre todo después de asistir a un curso, muy bueno por cierto, de Angular 1.5.X orientado a componentes. Por fin, hace un par de semanas, le di una oportunidad a la nueva versión, reescrita desde cero y con Typescript, de Ionic.

Para probar cómo funcionaba y qué concimientos iba a necesitar para en un futuro no muy lejano implementar una app para algún cliente, vi que necesitaba adquirir unos conceptos básicos que me permitieran desarrollar desde cero una app sencilla con unas pocas pantallas, un par de listas, almacenamiento local y llamadas a una API externa para obtener contenido.

Por todo ello, voy a escribir una serie de artículos en los cuales voy a ir contando qué componentes básicos he usado, cómo he hecho la app y qué pasos he seguido para adquirir todos los conocimientos necesarios para crear una app con Ionic.

En esta primera parte voy a hablar de la estructura de la app, es decir de cómo organizar el proyecto para que luego cuando haya que ir añadiendo funcionalidad no tengas todo desperdigado y tengas que repetir código una y otra vez.

Lo primero que hice, aunque parezca muy básico, fue seguir la página de Get started,  con lo que instale ionic y cordova, y escogí la plantilla de tabs para crear mi app:

npm install -g cordova ionic

ionic start myApp tabs

Una vez hecho esto observé que la estructura directorios había cambiado un poco, para empezar ya no metes el código en www, sino que existe un directorio src en el cual metes todo el código de la app, antes tenías por un lado el los js en www/js y las plantillas en www/templates, ahora como estás orientando tu programación a componentes tienes en src un directorio pages que a su vez contiene un directorio por cada componente y dentro de estos últimos, tres archivos: plantilla, estilos y javascript(typescript):

home.html home.scss home.ts

Seguimos analizando y vemos una carpeta app en la que tenemos los mismo elementos que en una página pero la parte de funcionalidad dividida en componente, modulo y principal:

app.component.ts	app.module.ts		main.ts
app.html		app.scss

Esto se correspondería con el archivo app.js que teníamos antes y donde inyectábamos todos los módulos necesarios para la app, así como la configuración de la app y la definición de las rutas, y alguna que otra directiva.

El archivo app.component.ts, define el componente principal sobre el cual se va construir la app, yo lo he dejado tal y como estaba y no me ha hecho falta modificarlo.

En cambio el archivo app.module.ts, lo he tenido que tocar y mucho ahí es donde tienes que importar todos los componentes que vayas a usar en la app, tanto páginas completas, como partes de estas, así como servicios.

Dentro del NgModule hay 5 apartados:

  • declarations,
  • imports
  • bootstrap
  • entryComponents
  • providers

En declarations van el componente de la app, así como todos los componentes de páginas y tabs, imports y bootstrap no los he tocado. en entryComponents vuelve a estar la páginas y los tabs. Y en providers he añadido los servicios que he ido creando.

main.ts, sinceramente ni había mirado lo que tenía dentro, así que se queda sin modificar.

Con todo esto me di cuenta que la estructura que crea Ionic por defecto no está mal y se puede usar para desarrollar una app medianamente compleja, el único añadido que he hecho ha sido crear a la altura de pages un directorio services que es dónde van a ir todos los servicios de la app.

En la siguiente parte hablaré de cómo hacer llamadas a una API externa para obtener los datos que queremos visualizar en la app.

 

Yeoman, Angular, ng-table y html-minifier

Últimamente cada vez que tengo que hacer un aplicación web suelo implementarla usando Angular. Para construir la estructura y automatizar tareas me apoyo en Yeoman, que es una herramienta muy útil para el desarrollo web.

El tema es que estaba yo con mi proyecto en angular, usando ng-table, un módulo que permite de manera sencilla usar tablas con filtros, ordenación, paginación, etc.

Todo funcionaba muy bien hasta que he hecho un grunt build del proyecto y al subir la versión de distribución del mismo no me funcionaba la parte de ordenación de tablas.

Al hacer un grunt build, yeoman, crea una versión minimizada y comprimida tanto de los css, como los js y el html del proyecto. He pensando que en alguna parte del proceso algo estaba mal y me dejaba sin esa funcionalidad.

Después de ver que no era por algo que había hecho yo mal, he revisado qué es lo que hace la tarea build dentro del fichero Gruntfile.js. He visto que todas las vistas del proyecto se convertían a javascript y se usaba $templateCache para las mismas.

En un primer intento, he comentado la subtarea que se encargaba de convertir las vistas en HTML a javascript y he visto que todo funcionaba bien, por tanto el problema está en cómo se hace la conversión.

He visto que primero se minimiza el HTML con html-minifier y analizando el resultado he visto que ese HTML minimizado perdía la parte del código HTML que indicaba al módulo ng-table la ordenación de las columnas.

Me he instalado el html-minifier para usarlo en el Terminal y he visto que opciones usaba la tarea de grunt, concretamente eran las siguientes:

 options: {
          collapseWhitespace: true,
          conservativeCollapse: true,
          collapseBooleanAttributes: true,
          removeCommentsFromCDATA: true
        }

He ido probando una por una las opciones, pero en su versión de Terminal para ver qué salida producían:

html-minifier --collapse-whitespace --conservative-collapse  --collapse-boolean-attributes  main.html 

Y cuando he llegado a la opción de collapseBooleanAttributes, he visto que esa era la opción que transformaba la plantilla y que hacía que dejara de funcionar la ordenación. Concretamente:

<td sortable="'valor'">  => <td sortable>

Por lo que comentando collapseBooleanAttributes: true en el fichero Gruntfile.js he conseguido que funcionara perfectamente la versión de distribución del proyecto.

Angular y rendimiento

Últimamente estoy haciendo muchos proyectos utilizando Angular, bien sea usando solo Angular + Bootstrap o Ionic que está basado en él.

Me suele gustar buscar información sobre buenas prácticas y mejorar el rendimiento de las aplicaciones hechas con dicha tecnología y hoy he encontrado un artículo en el cual con una sola línea se mejora de manera notable el rendimiento en producción de una aplicación hecha con Angular.

La línea en cuestión es la siguiente:

$compileProvider.debugInfoEnabled(false);

Concretamente su uso completo sería el siguiente:

myApp.config(['$compileProvider', function ($compileProvider) {
  $compileProvider.debugInfoEnabled(false);
}]);

Lo he probado en dos proyectos que tengo hechos con Angular y en uno con Ionic, y en los de Angular la mejora ha sido bastante buena, las páginas renderizan mucho más rápido. En Ionic he notado que la fluidez de la app al cambiar de vista mejoraba de manera considerable.

La recomendación de todas formas es que lo actives cuando la aplicación esté en producción así que yo la he usado de la siguiente manera:

// Angular

myApp.config(['$compileProvider', function ($compileProvider) {
  if (document.location.host.indexOf('localhost') === -1) {
    $compileProvider.debugInfoEnabled(false);
  }
}]);

// Ionic

myApp.config(['$compileProvider', function ($compileProvider) {
  if (window.cordova) {
    $compileProvider.debugInfoEnabled(false);
  }
}]);

Aquí dejo la referencia al artículo en cuestión y alguno más que da consejos para mejorar el rendimiento de aplicaciones hechas con Angular:

https://medium.com/swlh/improving-angular-performance-with-1-line-of-code-a1fb814a6476#.ov0lfveqz
http://maxmautner.com/post/135816438020/11-huge-ionic-performance-tips
http://julienrenaux.fr/2015/08/24/ultimate-angularjs-and-ionic-performance-cheat-sheet/

Cifrado en Javascript compatible con openssl_encrypt de PHP

Tengo un proyecto entre manos en el cual necesito cifrar una cadena de texto desde Javascript y que esta se descifre en un servicio que está hecho en PHP.

Una búsqueda por Internet me ha dado las siguientes librerías:

  • https://github.com/mdp/gibberish-aes
  • https://github.com/bitwiseshiftleft/sjcl
  • https://github.com/brainfoolong/cryptojs-aes-php
  • https://code.google.com/p/crypto-js/

Con ninguna de ellas he conseguido que metiendo yo el iv como parámetro sea equivalente a la siguiente llamada en php:

openssl_encrypt('Hola', 'aes-256-cbc', 'My32charPasswordAndInitVectorStr', false, '1234567890123456');

Después de más búsquedas, he encontrado la solución:  node-crypto + browserify

La idea es usar la librería crypto de node en el navegador mediante la herramienta browserify.
Para ello instalo browserify:

npm install -g browserify

Instalo crypto:

npm install crypto

Creo el fichero cifrar.js con el siguiente contenido:

var crypto = require('crypto');

var Crypto = {};

Crypto.encrypt = function (plain_text, encryptionMethod, secret, iv) {

      var encryptor = crypto.createCipheriv(encryptionMethod, secret, iv);

      encryptor.setEncoding('base64');
      encryptor.write(plain_text);
      encryptor.end();

      return encryptor.read();
};

Crypto.decrypt = function (encryptedMessage, encryptionMethod, secret, iv) {
      var decryptor = crypto.createDecipheriv(encryptionMethod, secret, iv);
      return decryptor.update(encryptedMessage, 'base64', 'utf8') + decryptor.final('utf8');
};

window.Crypto = Crypto;

Y por último utilizo browserify para crear el fichero que incluiré en el proyecto:

browserify cifrar.js -o crypto.js

Y la llamada equivalente en Javascript sería la siguiente:

Crypto.encrypt('Hola', 'AES-256-CBC', 'My32charPasswordAndInitVectorStr', '1234567890123456');

SuperSefile

En el último proyecto que he realizado por encargo, he tenido que utilizar una serie de herramientas que me han parecido interesantes y que comparto aquí por si alguien las necesita para otros proyectos.

Es una app de fotografía, en la cual sacas una foto, la puedes firmar, y después puedes componer la firma con la foto e incluso añadir algún que otro texto incluyendo emojis.

Para empezar decidí no usar ningún framework de javascript, ya que quería que la app fuera lo más ligera posible, si que es cierto que he tenido que sacrificar un poco la legibilidad del código de la misma, pero siendo estricto en la nomenclatura de las funciones he conseguido estructurar bien el código y que no fuera muy difícil su depuración.

El único sacrificio que he tenido que hacer ha sido meter jQuery, ya que la librería que he usado para la firma era un plugin de jQuery, si bien es cierto que lo usa para un par de accesos y eventos, desvilcularla de jQuery o usar una librería más liviana, tipo Zepto.js, no era mi prioridad y podría meterme en jardines que realmente no quería pisar.

Para la firma entonces usé el plugin de jQuery, jSignature. Básicamente lo que hace es crear un canvas en el cual se puede realizar la firma, el algoritmo que usa es bastante bueno y tienen un rendimiento aceptable incluso en Android 4.0.4.

Para la composición de la firma y la foto use una librería con muchas más funcionalidades de las que necesitaba pero con vistas a una posible evolución de la app. La librería es Fabric.js. Como pone en su web es un modelo de datos intercativo que proporciona una API para realizar operaciones sobre un objeto de tipo canvas. La verdad es que es muy completa y tiene un montón de ejemplos a parir de los que empezar a trabajar.

Para finalizar me hacía falta un colorPicker y ya que tenía que usar jQuery busqué uno que se amoldara a mis necesidades y que fuera un plugin de jQuery: Spectrum. Al igual que Fabric.js, este plugin tiene más funcionalidades de las que necesito, pero lo elegí por poder implementar las mismas en una futura evolución de la app.

Por lo demás el resultado lo podéis ver aquí:

https://play.google.com/store/apps/details?id=com.javray.SuperSelfie
https://itunes.apple.com/es/app/superselfie/id957281514

Compartir con Whatsapp en Phonegap (iOS y Android)

Una de las funcionalidades que últimamente me están demandado para las aplicaciones es la de poder compartir un texto o un foto por Whatsapp.

Al ser un producto de terceros y no tener una API pública, mi respuesta siempre era la de que no era posible. Hasta ahora, o hasta hace relativamente poco tiempo.

Buscando si era posible, me encontré con el siguiente FAQ la propia aplicación:

http://www.whatsapp.com/faq/en/iphone/23559013

Esto ya me dio una pista de hacia dónde orientar mis pruebas de cómo implementarlo.

La parte fácil es la de compartir texto, ya que usando el esquema de URL whatsapp:// se puede usar en ambas plataformas y es tan sencillo como poner un enlace o abrir una página:

<a href="whatsapp://send?text=Hello%2C%20World!">Whatsapp></a>
window.open('whatsapp://send?text=Hello%2C%20World!');

Para las imágenes las cosas se complica y tendremos que usar métodos diferentes según la plataforma.

iOS

Aquí vamos a usar la API de Document Iteration, básicamente es una API que nos permite sacar las aplicaciones que pueden abrir un tipo de documento, como sucede con Dropbox cuando te bajas un archivo y te da la opción de editarlo con aplicaciones externas que tengas instaladas.

Para usar esta API nos instalaremos el siguiente plugin de Phonegap:

https://github.com/phonegap/phonegap-plugins/tree/master/iOS/ExternalFileUtil 

Este plugin lo único que hace es abrir un cuadro con las aplicaciones compatibles con el tipo de documento que queremos compartir. Yo he modificado un par de cosas ya que el plugin devolvía siempre una cadena vacía abriera o no el cuadro, lo cual no es muy útil ya que no permite controlar si está o no instalado el Whatsapp en el dispositivo.

La modificación es en el fichero CDVExternalFileUtil.m y hay que cambiar la línea 64, de esto:

[controller presentOpenInMenuFromRect:rect inView:cont.view animated:YES];

a esto:

BOOL result = [controller presentOpenInMenuFromRect:rect inView:cont.view animated:YES];

Y la línea 66, de esto:

pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString: @""];

a esto:

pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString: (result ? @"YES" : @"NO")];

Una vez hechos esos cambios la manera de usar el plugin es la siguiente:

ExternalFileUtil.openWith('http://example.com/imagen.wai', "net.whatsapp.image", 
                function(result) { 
                    if (result == 'NO') {
                        // No está instalado el Whatsapp
                    }
                }
            );

El fichero imagen.wai es un JPG pero renombrado a .wai que es la extensión que usa el Whatsapp para saber que es una imagen. Para vídeos es .wam y para sonidos .waa.

Android

Aquí lo tenemos algo más fácil ya que mediante Intents podemos compartir una imagen.

Usaremos el siguiente plugin para poder lanzar Intents:

https://github.com/phonegap/phonegap-plugins/tree/master/Android/WebIntent

También es necesario modificarlo un poco ya que no tiene implementada la opción de lanzar directamente un Intent asociado a un paquete.

Por tanto los cambios a realizar son en el fichero  WebIntent.java, en la línea 54, añadir debajo la siguiente línea:

String pack = obj.has("package") ? obj.getString("package") : null;

En la línea 70, cambiar esto:

startActivity(obj.getString("action"), uri, type, extrasMap);

por esto:

startActivity(obj.getString("action"), uri, type, pack, extrasMap);

En la línea 158, añadir debajo lo siguiente:

if (pack != null) {
  i.setPackage(pack);
}

El uso sería el siguiente:

var extras = {};
                            extras[window.plugins.webintent.EXTRA_STREAM] = imagen_b64;

                            window.plugins.webintent.startActivity({ 
                                action: window.plugins.webintent.ACTION_SEND,
                                type: 'image/*', 
                                package: 'com.whatsapp',
                                extras: extras 
                                }, 
                                function() {
                                    // OK
                                }, 
                                function() {
                                    // El Whatsapp no está instalado.
                                }
                            );

La variable imagen_b64 será una imagen codificada en base64, podremos usar un fileReader si la imagen está en el dispositivo o un fileTransfer si está en un servidor.

[Editado]

Parce que lo del esquema de URL solo lo han implementado para iOS, para Android habrá que usar también el WebIntent:

var extras = {};
                            extras[window.plugins.webintent.EXTRA_TEXT] = 'Hola mundo';

                            window.plugins.webintent.startActivity({ 
                                action: window.plugins.webintent.ACTION_SEND,
                                type: 'text/plain', 
                                package: 'com.whatsapp',
                                extras: extras 
                                }, 
                                function() {
                                    // OK
                                }, 
                                function() {
                                    // El Whatsapp no está instalado.
                                }
                            );

[/Editado]

Configurando el VIM para que suba por FTP

Tanto en mi trabajo como en mis proyectos personales utilizo como editor de texto y entorno de desarrollo el vim. Me gustan los entornos livianos y que respondan con rapidez cuando escribo.

Al usar únicamente el vim, cuando tengo que subir un fichero al servidor, me apoyo un un cliente de FTP, en este caso, el Filezilla. Y claro, pierdo tiempo entre :w!, CMD + TAB y por último arrastrar el fichero.

Para ser más productivo, decidí que ya era hora de mirar la manera de poder subir un fichero directamente desde el propio vim con alguna combinación de teclas.

Me puse manos a la obra y después de un rato buscando, encontré los plugins que me harían falta para lograrlo.

El primero de ellos y el más importante fue el netrw. Este plugin permite realizar operaciones de lectura y escritura en red, es decir permite editar ficheros en remoto y subir ficheros por FTP, SFTP, SCP e incluso RSYNC.

El segundo que hace falta es el localvimrc. Este plugin permite definir una configuración especifica para cada proyecto. En mi caso lo uso para definir el comando que voy a usar para subir el fichero que estoy editando al servidor.

Una vez instalados ambos plugins, lo que hay que hacer es ir a la carpeta local donde tienes el proyecto y crear el fichero .lvimrc, dentro del cual vamos a meter un comando similar a éste:

map <leader>S :execute 'Nwrite ftp://www.javray.com//home/miproyecto/' . expand("%")

Yo he definido <leader>S para subir el fichero que estoy editando, pero se puede definir la combinación que os sea más comoda. También se pueden definir distintos comandos.

Eso sí, al usar el protocolo FTP para que no me pida la clave he tenido que usar el fichero .netrc, en el cual he definido el servidor, el login y el password. Una opción más segura sería subir el fichero por SCP y meter la clave publica de mi ordenador en el servidor.

¿Lo siguiente?

Crear un comando que me suba al repositorio el fichero, a ver si investigo un poco y os lo cuento.

Debug remoto

Estoy probando una aplicación en el iPad que básicamente es una UIWebView que accede a una página de Internet que es la que realmente tiene la aplicación.

En el navegador de escritorio todo funciona perfectamente, pero a la hora de probarlo en el iPad he detectado un comportamiento distinto y necesito saber qué es lo que pasa y por dónde va el flujo de ejecución.

Para ello existen muchas soluciones, bastante complicadas desde mi punto de vista, que pueden servir para ver qué es lo que está pasando como por ejemplo: Enabling Remote Debugging via Private APIs in Mobile Safari.

Pero no me acaba de convencer, así que he optado por otra solución, que leí hace un tiempo y no recuerdo dónde.

La idea es redefinir el objeto console para que realice una petición a un servidor enviando el contenido con el que se le ha invocado, algo así como un log remoto.

Para ello con el siguiente código se puede conseguir:

(function(window, undefined) {
    var console_old = window.console,
        console = {};

    console.log = function() {
        var xhr = new XMLHttpRequest();
        
        xhr.open('POST', '/console.php', true);
        xhr.setRequestHeader('Content-type', 'application/x-www-form-urlencoded');
        xhr.send('log=' + JSON.stringify(arguments[0]));

        console_old.log(arguments[0]);
    };

    console.info = console.log;
    console.warn = console.log;

    window.console = console;

})(window);

El código en el servidor sería el siguiente:

 exec("echo '".$_POST['log']."' >> /tmp/console.log");    

Con todo lo anterior ya podemos poner debugs por el código y ver en tiempo real por dónde está pasando la aplicación y qué problemas tiene.

Ni que decir tiene que aplicar esto a un desarrollo web o aplicación nos puede servir para poder saber qué tipos de errores les da a los usuarios, eso sí habría que mandar un poquito más de información para poder resolver incidencias que les ocurran.

Github

Hace un tiempo que me hice una cuenta en Github para aprender a utilizar git, ya que me parece una mejor opción que SVN. De momento lo he usado bastante poco, he subido tres proyectos: dos de ellos muy sencillos y un tercero algo más complejo.

Empezando por el más complejo, Galert, es un aplicación para Android hecha en python usando SL4A, la tengo publicada en Google Play, como es gratuita y es más un experimento que otra cosa, he decidido liberar lo que he hecho:

https://github.com/javray/Galert

La siguiente es un sencillo script en PHP que coge un RSS y lo transforma en comandos SHELL para que se vea con colores en el terminal:

https://github.com/javray/RSS-Colorize

Y la última, es una única página que contiene HTML y Javascript, la cual sirve para realizar un sorteo entre varios participantes. La idea es que tienes los participantes en un fichero de texto, arrastras éste a la aplicación, eliges cuántos ganadores quieres y le das a sortear:

https://github.com/javray/Sorteo

Espero seguir publicando más aplicaciones que se me vayan ocurriendo, ya que es bueno compartir el código para aprender.