Posts Tagged ‘pouchdb’


Apple acaba de aprobar SuperComics v2 para iOS con lo que completo las 3 principales plataformas de aplicaciones: Android, Windows Phone y iOS. Finalmente, cumplo con entregar una aplicación que soporta casi todo lo que hay en el mercado con una sola base de código. Aún en el horno está la versión para Windows 10 y para cuando le encuentre la forma de monetizarlo, la versión Web.

La motivación tras este proyecto fue la de realmente darle una mano al mundo Cómic en Perú, pues esta muy bien que salgan muchos a publicar pero para el coleccionista, hace falta un orden y saber, al menos, que hay para comprar en el kiosco, así que inicialmente este proyecto es un catálogo. Y el segundo punto es que sea realmente una aplicación móvil que demuestre que se puede hacer una aplicación multiplataforma con soporte de datos fuera de línea y todo que funcione con recursos limitados. Hasta ahora, me parece que se han cumplido los objetivos y aún hay espacio para mejoras.

Sobre el tema del catálogo de cómics: no soy un experto en el mundo editorial pero por lo poco que me han ido contando las personas que si están en este mundo, me doy cuenta que el detalle común es el super esfuerzo que hacen muchos para publicar, incluso yo diría que lo hacen por un tema de orgullo personal, o simplemente decir que sacaron un cómic por lo tanto, no se les puede pedir planificación ni estrategias de distribución ni de marketing. La suerte es que hay mucho compromiso de gente fanática que ayuda, como por ejemplo las tiendas de cómic que cada día son mas donde los dueños son los más fanáticos. A todos los que piensan publicar o ya están publicando cómics localmente yo les recomendaría estos tips:

  • Creen un roadmap: Si van a sacar un cómic, piensen primero en cuantos cómics serán y el formato, 5 grapas o 2 libros o lo que quieran, y establezcan un cronograma de publicación, cada 15 días, cada mes. Con esto podrán distribuir mejor sus recursos, y por sobre todo, podrán dedicar a alguien a la difusión. ¿Que tan grande debe ser el roadmap? dependerá de cuantas publicaciones quieran hacer: el cielo es el límite.
  • Comuniquen: la idea de comunicar es la de dar a conocer el roadmap al público objetivo con una doble intención: que la gente se entere y lo más importante: MEDIR. Crear un grupo de Facebook no es suficiente, tienen que estar al tanto de que artículo, foto o video ha sido el más visto, o cuantos Likes obtienen o corazones en Twitter, o reproducciones en Vine. Medir les permite establecer el tamaño de su público objetivo y determinar el tiraje de su cómic. Mientras mas tiempo comuniquen y mas tiempo midan, podrán determinar mejor el tamaño de su mercado.
  • Presenten: Si son un cómic nuevo, lo mejor es dar avances. A SpiderMan ya lo conozco, pero si me dicen “Capitan Guachiman” no tendré idea de lo que encontraré al abrir la revista. Otro punto importante es la impresión, no soy fan de las que se imprimen en papel couché y tienen el acabado de fotocopia, prefiero el acabado simple y opaco tipo Frank Miller, lo mismo aplica con los colores, si no coloreas bien, o no tienes plata para la imprenta, ve por los dibujos a tinta china y listo.

Como Bonus: las portadas. SuperComics se basa en mostrar portadas porque es la forma más fácil de identificar un cómic, pero lo principal es saber que números hay, desde cuando están disponibles y todo lo demás. En algunos casos, hay celos de parte de la editora en sacar las portadas antes de la publicación y es comprensible, pero la realidad es que si hablamos de Cómics gringos, todas las portadas ya están en Internet desde hace tiempo. Es mejor salir a comunicar con las portadas, como lo hacía Comics21 al principio, pues te hace más fácil la búsqueda de números atrasados y eso lo digo por experiencia: casí le he hecho aprender Inglés a la señora del Kiosco en Jesús maría donde compro mis revistas, pues yo le pedía “SpiderMan: One More Day issue 2” y la señora se echaba a bucear en la pila de revistas que tenía y pues fácil no resultaba. Ahora sólo le enseño la imagen y ya me saca la revista. Si la editora no quiere soltar las portadas, no hay problema mientras suelte el cronograma, aunque lo ideal es que suelte los dos.

Sobre la aplicación: Cuando decides coleccionar cómics es como cuando juntabas las figuritas de tu álbum, necesitas saber cuantos son, cuáles y cuando los puedes encontrar en tienda. Yo comencé con los cómics de Perú 21 y la cosa no era muy fácil pues no había gente que supiera vender cómics así que encontrabas cómics doblados o escondidos cuando ibas al kiosco, o peor aún, una semana había, y la otra no, fatal. Ahora el tema es más ordenado y si vas a una de las tiendas especializadas, hasta sales con tu bolsicartón gratis. A pesar de la mejora, sigue siendo necesario saber, cuantos, cuáles y donde encontrar tus cómics.

SuperComics utiliza el concepto “Off-line first” para mantener la base de datos de cómics en tu celular para que puedas consultarlos hasta en un sótano o en algún centro comercial caleta bien al fondo. Incluye tanto la portada como la información general del cómic. Además, podrás marcar dos cosas:

  • Nola/Yala: tal cual era con las figuritas, marcas si ya tienes el cómic y te evites de comprar repetidos.
  • Lista de compras: cuando te das el tiempo de revisar tu colección, sueles encontrar que por alguna razón te falta alguno y lo marcas en un papelito que luego se pierde. Ya no más, si lo marcas en compras, tendrás una sección donde verás los cómics que te faltan comprar y de esa manera vayas confiado a la tienda o a la reunión de coleccionistas para hacer tu intercambio.

Finalmente, si tienes la portada te gustaría pasársela a alguien, ya sea porque la quieres cambiar, o simplemente para sacarle cachita a alguien, así que también es posible que compartas la carátula por redes sociales. No todas las redes sociales dejan compartir la misma información, por ahora Twitter es mi favorito, pero si te gusta, también puedes compartir por Whatsapp.

Además de eso, existe un catálogo de Editores, los que pude conseguir hasta ahora, donde encontrarás las colecciones publicadas todas ordenadas para que las busques como te de la gana.

Y como no podía ser de otra manera, incluí una sección con las tiendas especializadas en cómics y su mapa para que las encuentres fácil.

Ahora bien, todo esto no valdría mucho si es que no estuviera al día. Actualmente la base de cómics en la aplicación es de aprox 400 cómics publicados desde el 2012 en adelante, lo que quiere decir que hay como 300 cómics más publicados desde el 2008 que aún no están registrados, aunque es sólo cuestión de tiempo. Para los que ya instalaron el App habrán notado que la primera vez se toma algo de tiempo y esto es porque se indexan todos los cómics localmente. Esto es para que no tengan que estar descargando la info desde Internet a cada rato, así que se les agradece la paciencia.

Sobre las actualizaciones estás son automáticas y van de dos tipos:

  • Mayores: Si son actualizaciones muy grandes (Principalmente cuando suba cómics antiguos) sacaré otra versión del app con toda la información incluida. Es por esto que el instalador debe rondar los 20 mb.
  • Menores: Lo nuevo es pequeño y se va actualizando automáticamente en tu app cada vez que tengas Internet. Para que se hagan una idea, cada cómic nuevo pesa unos 24Kb y en promedio salen 2 por semana, así que casi no te cuesta, y si gorreas Wifi de StarBucks te sale gratis.

Lo que se viene: 

  • Creo que la dinámica que mueve todo el tema de cómics es el intercambio, por lo que estoy trabajando en algún método para que puedas publicar tus repetidos y que los que estén a tu alrededor vean y puedan interactuar.
  • Ahora ya puedes marcar los cómics que ya tienes, pero deberías poder respaldar esos datos. O deberías poder reinstalar el app y recuperar todos tus cómics marcados. Técnicamente, esto ya es posible en la versión actual, pero supone un costo que no puedo asumir, así que sigo trabajando para bajar ese costo,o ver la forma que la gente interesada pague por el servicio.

La decepción:

  • Los códigos de barras: Hubiera sido genial que estos códigos nos ayuden a identificar los cómics, pero la verdad es que no sirven por una simple razón: no son únicos. En el caso de Comics de Perú21, suelen poner un mismo código a toda una colección, o sea hay 4 o 6 cómics con el mismo código, incluso han llegado a poner el mismo código de barras en más de una colección, plop. En Editora Vuk, han sido más cuidadosos y si tienen código único, en realidad tienen dos: un código para la colección y otro más para identificar el cómic. Otros simplemente no lo usan y ya. En conclusión, el código de barras es inútil para identificar el cómic, así que olvídate. Sería genial que todas las editoras usaran un sólo formato de código de barras, mientras tanto no será posible aprovecharlos en el app.

Download_on_the_App_Store_Badge_ES_135x40Spanish_wstore_black_258x67en_generic_rgb_wo_60

Advertisements

Esta es una continuación de la serie sobre desarrollo en móviles que comencé aquí. Les recomiendo comenzar a escribir el código fuente desde la parte 1 ya que no se publica el código para descarga.

Con la parte 10, podríamos decir que comienza una nueva etapa del código así que debemos empezar con las cosas interesantes. Primero planifiquemos las siguientes funciones:

  • Alertas ante nuevas noticias. Esto ya me lo habían pedido, y recién ahora tiene sentido incluirlo pues ya tenemos todas las herramientas. Según lo que hemos visto, al activar la replicación estamos controlando el evento ‘paused’ para indicar que la sincronización terminó y no hay nada nuevo por el momento, pero no nos dice nada si hubieron noticias nuevas. Para eso debemos controlar otro evento llamado ‘change’ que se genera por cada cambio en la base de datos local, aquí simplemente ubicamos cuando se trate de una nueva noticia y podríamos ya lanzar la notificación, teniendo cuidado pues durante la primera ejecución del programa todas serán noticias nuevas y no queremos una avalancha de alertas.
  • Agregar un mecanismo para registrar las noticias más leídas. Esto supondrá que grabemos en algún lado que hemos leído la noticia. Recordemos que este documento será sincronizado hacia el servidor y a todos los usuarios con la versión actual, lo cual no queremos así que veremos como hacer para que la sincronización sea controlada: que los registros generados por el usuario sean sincronizados con el servidor pero que a los demás usuarios solamente lleguen los documentos con las estadísticas. Igual funcionaría para un mecanismo para registrar “Likes” tipo Facebook.

Comencemos con las alertas para nuevas noticias, para eso necesitamos un plugin para Ionic que nos ayude a manejar las notificaciones locales. Esto se refiere a las mismas alertas que reciben cuando tienen un correo o algún otro cambio relevante. Hay que recalcar que son locales, puesto que los datos ya están en la base de datos; en las apps normalmente se da todo lo contrario, primero llega la notificación y luego se descarga la información, pero como nuestro modelo es “off-line first” no podemos confiarnos en la red.

Para hacer la cosa aún más fácil, instalemos el componente Ng-Cordova que encapsula el código necesario para manejar plugins, mediante el siguiente comando:


bower install ng-Cordova --save

El parámetro –save es para agregar este componente a la lista de dependencias.

Seguidamente, instalemos el plugin:

ionic plugin add https://github.com/katzer/cordova-plugin-local-notifications.git

Y listo, ahora hay que ver donde es el mejor lugar para detectar que se ha insertado una nueva noticia y ese lugar puede ser al detectar un cambio. Recordemos que al momento de replicar ya se genera un evento al detectar el fin de la replicación. Veamos el archivo services.js


db.replicate.from(remote,
{live:true,
retry:true})
.on('paused',changed);

Es bueno recordar aquí como es esto de los eventos de replicación:

  • Paused: indica solamente que la replicación ha parado. Como hemos establecido el parámetro live en true, significa que ya no hay mas cambios que sincronizar. Esto también significa que la replicación no ha recibido mas registros en un rato largo, lo que sucede a cada rato cuando la velocidad del internet es bastante lenta.
  • Complete: Si es que establecemos live en false, significa que la replicación se hará una sola vez y al terminar se generará el evento Complete.

Noten que si queremos asegurar que la base local está al día, quizá haya que hacer un mecanismo de control como establecer un registro con la fecha de ultima actualización. Además, la replicación manual puede servir si sabemos que los cambios son poco frecuentes o si queremos que sea el usuario final quien controle la actualización.

Bien, entonces regresando al código, cuando la replicación se completa o se para, se ejecuta la función “changed” que está definida así:


function changed(){
console.log('cambios en la base de datos');
if (!initiated)
{
initiated=true;
db.changes({live: true, since: 'now', include_docs: true})
.on('change', newNews);
};

};

Aquí lo que hacemos es verificar que la base de datos está inicializada y usamos una variable “initiated” para controlar que solamente una vez llamemos  a la función db.changes. Con db.changes lo que hacemos es verificar un evento mas: cuando se ha modificado algún registro en la base de datos. Cuando se detecte este cambio se ejecuta la función “newNews”.

NOTA: fijense bien la secuencia, primero se replica y luego se monitorea el evento cambios. Por lo tanto, la secuencia de datos será así: inicias la aplicación, sincronizas, cuando se completa, cada registro nuevo o modificado generará una alerta. De esta manera, las noticias antiguas no generarán alertas.

Ahora veamos la funcion newNews:


function newNews(change){
if (!change.deleted){
if (change.doc.tipo=="news")
$rootScope.$broadcast('db:newNews',{newsId:change.id,
newsTitle:change.doc.titular});
}
}; function newNews(change){
if (!change.deleted){
if (change.doc.tipo=="news")
$rootScope.$broadcast('db:newNews',{newsId:change.id,
newsTitle:change.doc.titular});
}
};

Bien, notarán que esta función toma un parámetro llamado change que es el documento que ha sido afectado. El documento puede haber sido borrado, creado o modificado. Si es borrado la propiedad change.deleted será verdadera. Si el documento es creado o modificado por ahora los trataremos como iguales pues tendríamos que revisar la fecha de creación en alguna propiedad.

En la línea 10 verificamos que no se trate de un documento borrado y seguidamente verificamos que el documento sea del tipo news, porque también hay documentos del tipo cat y esos no queremos que manden notificaciones. Si todo se cumple, mandamos un broadcast para que se genere el evento de generación de la notificacion. Para ver eso vamos al archivo app.js.


.run(function($rootScope,$state,$cordovaLocalNotification){
$rootScope.$on('db:newNews',function(event,args){
var id = new Date().getMilliseconds();
$cordovaLocalNotification.schedule({
id: id,
title: 'Super Datos',
text: args.newsTitle,
data: {
newsId: args.newsId,
newsTitle: args.newstitle
}
}).then(function (result) {
console.log('Notificación registrada');
});

$rootScope.$on('$cordovaLocalNotification:click', function (
event,
notification,
state) {
var datos = JSON.parse(notification.data);
$state.go('app.detail',{id:datos.newsId});
});
});
})

Aquí notarán que hemos agregado una sección .run() para manejar dos eventos en la aplicación: el primero el evento que generamos anteriormente para avisar que hay una nueva noticia y otro mas para el evento $cordovaLocalNotification:click, este último evento es el que se genera cuando un usuario hace click encima de la notificación, es decir, que cuando llegue la notificación, el usuario vera el aviso en su teléfono y al hacer click se abrirá la aplicación y se abrirá en el estado detalle para que pueda leer el contenido. Creo que estamos de acuerdo que mas complicado ha sido encontrar y fijar el evento que lanza la notificación que programarla, pero lo hago así por una razón: trato que todos los eventos sean manejados en el app.js para no tener problema luego para mantenerlos y gestionarlos, incluso trato que los broadcast estén aquí en la medida de lo posible, o en su defecto en el archivo services.js, nunca en un controlador.

Y listo, ya pueden probar su nuevo lector de noticias, y cada vez que tengan una nueva noticia o una noticia antigua ha sido actualizada, recibirán una notificación que les permitirá enterarse e ir directamente al nuevo contenido.

Recalco que esto no es una notificación tradicional, pues el contenido ya está en el teléfono y es la misma aplicación la que genera la notificación. Las apps conectadas que son las mas comunes, mandan la notificación por la red y recién hacen la recuperación de los datos, todo depende de como quieren que su app se comporte.

Finalmente, pueden jugar con más opciones de las notificaciones locales, como agregar un botón para que el app te recuerde leer una noticia dentro de 15 minutos, o poner una notificación cuando el app esté sincronizando y demás cosas. Todo queda en ustedes.


Ya hace un par de meses que empecé esta serie de código sobre Ionic Framework poniendo especial atención en la integración con bases de datos NoSQL, principalmente por la capacidad de sincronización. La intención es la de hacer fácil lo que me llevó a mí una gran cantidad de tiempo, principalmente porque eso de cambiar el tipo de base de datos es realmente algo confuso por naturaleza.

En este post voy a hacer el primer intento por ordenar los posts indicando el tema al que se refiere cada uno.

Recordarles que no hay código para descarga, pues para entender una sección deben entender la anterior, por lo que es realmente importante que escriban el código desde la parte 1. Antes de publicar el post, verifico que el código funciona correctamente, pero hay veces en los que se me pasa algún detalle. Pueden colaborar con sus comentarios.

Simplemente por utilizar Ionic Framework, todo el código que obtienen es funcional en al menos Android, iOS y Windows Phone, por lo que la recomendación general para todo es que comiencen desde lo más básico.

Por ahora ahi tienen los post de la serie Ionic, PouchDB y Cloudant

Post Tema
Part 1 Basics
Part 2 Ionic: Environment and Binary generation
Part 3 Organizing the code
Part 4 Master-Detail and UI-Router
Part 5 Improving the off-line experience of the app
Part 6 MVC review
Part 7 Filtering data with Cloudant Views.
Part 8 Abstract states and Views
Part 9 Abstract states and Views and Dynamic Menu
Part 10 AngularJS Style guide
Part 11 New features: Adding local notifications
Part 12 New features: Writing docs and sync with the Server
Part 13 General Review and tips for PouchDB

Como siempre sus comentarios son bienvenidos,así como su ayuda para encontrar bugs


Esta es una continuación de la serie sobre desarrollo en móviles que comencé aquí. Les recomiendo comenzar a escribir el código fuente desde la parte 1 ya que no se publica el código para descarga.

El día de hoy un lector me hizo saber un error en mi código y pude darme cuenta que hay algo que no he explicado y es muy importante para cuando nuestra aplicación se hace cada vez mas grande. Más que con javascript, lo que hay que aclarar es con el modelo MVC.

MVC-web-application-development

Este es el gráfico mas conocido del modelo MVC, pero creo que podríamos fijarnos también en este otro:

ocEWx

La idea principal es que la Vista es manipulada solamente por el Controlador, mientras que el Controlador es el único que manipula el Modelo.

En el código que hemos hecho hasta ahora, el Controlador tiene referencias a los Servicios que representan al Modelo. Revisemos el archivo controllers.js

angular.module('controllers',['services'])
.controller('newsController',function($scope,db){
    db.init();
    $scope.notas=[];
    $scope.$on('refrescar',function(event,news){
       $scope.$apply(function(){
            $scope.notas = news;
       }) 
    })
})
.controller('detailController',function($scope,db,detail){
 db.get(detail).then(function(doc){
 $scope.event=doc;
 })
})

Podemos ver que en la definición de cada controlador hemos ingresado unas referencias a cada controlador. Para el controlador “newsController” se tiene $scope y db, donde $scope es un objeto Angular para intercambiar datos con la vista, y db es el servicio que hemos escrito en el archivo services.js. Por lo tanto si tenemos algún problema con el objeto db, donde debemos ir a revisar es en la definición del objeto db, así que si revisamos el archivo services.js.

angular.module('services',[])
.factory('db',function($rootScope){
        var key = 'XXXXXXXXXXXXXXX';
	var pass = 'XXXXXXXXXXXXXXX';
	var remote = 'https://'+key+':'+pass+'@servidor.cloudant.com/news';
	var db;
	var mostrar = function(){
        db.allDocs({startkey:'news_\uffff',endkey:'news_',descending: true,include_docs:true})
                    .then(function(result){
                    $rootScope.$broadcast('refrescar',result.rows);
                });
    };
    return {
        init: function(){
            if (!db) {
                db = new PouchDB('news');
            };
            mostrar();
            this.replicate();
        },
        replicate: function(){
            db.replicate.from(remote,{live:true,retry:true})
                .on('paused',function(info){
                mostrar();
            });
        },
        get: function(id){
            return db.get(id);
        }
    }
})

Vemos que el factory ‘db’ en la sección return publica tres métodos: init(), replicate() y get()
Por lo tanto, si el objeto db nos da algún error en alguna llamada en el controlador, debemos revisar esta parte del código para encontrar el error.

Lo que puede crear algo de confusión es que el factory se llama ‘db’ y luego internamente existe la variable ‘db’ que en realidad es un objeto de la clase PouchDB. En el controlador siempre debemos usar el objeto indicando el nombre del Factory.

Finalmente, regresando al concepto MVC de nuestro código, vemos que cada vez que encontramos un cambio en los datos, generamos un mensaje broadcast que es recibido en el controlador, como vemos en el controlador ‘newsController’ en el archivo controllers.js

.controller('newsController',function($scope,db){
    db.init();
	$scope.notas=[];
	$scope.$on('refrescar',function(event,news){
		$scope.$apply(function(){
			$scope.notas = news;
		})		
	})
})

Pueden ver que en la línea 5, definimos la lógica que se ejecutará al recibir el evento generado por el Modelo mediante el Factory db en el archivo services.js. Podrán notar que el evento es generado en el método mostrar:

        var mostrar = function(){
        db.allDocs({startkey:'news_\uffff',endkey:'news_',descending: true,include_docs:true})
                    .then(function(result){
                    $rootScope.$broadcast('refrescar',result.rows);
                });
    };

En la línea 10 generamos el mensaje incluyendo los registros que queremos mostrar como parámetro.

Este envío de mensajes es muy importante porque de lo contrario estaremos declarando y verificando el valor de variables de control a cada rato, lo cual no es bueno ni para respetar el modelo MVC ni para el mantenimiento de su código. Incluso, ya cuando tengan aplicaciones grandes, notarán que necesitarán pasar mensajes entre objetos que no necesariamente alteran la vista, por ejemplo si quieren registrar la posición del móvil y guardarla cada 15 minutos, tendrán que invocar a un servicio enviando un broadcast desde otro servicio que controla el tiempo. El mejor lugar para indicar la lógica de estos eventos que no alteran es en el archivo app.js que podríamos considerar como parte de la capa Controller.

En un próximo post veremos un poco de este manejo mediante la creación de servicios lo más parecido a las clases que utilizamos en programación orientada a objetos donde podremos identificar los datos por un lado y los métodos por otro diferenciando cuáles son públicos y cuáles privados.

Espero que con esto me puedan ayudar a corregir errores ya sean por no incluir el código, o porque de verás se metió un bug, aunque les aseguro que primero me aseguro que el código funciona antes de publicar el post.


Esta es una continuación de la serie sobre desarrollo en móviles que comencé aquí. Les recomiendo comenzar a escribir el código fuente desde la parte 1 ya que no se publica el código para descarga.

En esta parte, haremos una introducción a lo que creo que es lo más potente que se ha incluido en Ionic, UI-Router. Hay otros componentes que hacen lo mismo, pero creo que lo más importante aquí es el concepto de estados.

Un estado es un conjunto de vista, controlador y modelo que hace una labor específica en nuestro programa. Tenemos que pensar en una labor muy simple para ver la potencia de este concepto. Por ejemplo, listar todos los correos que tenemos, es un estado, o ver un email en particular es otro estado. Mientras más simple que sea, más reutilizable será el estado.

Ahora, quizá me adelante, pero es posible que un conjunto de estados compartan una base común, por ejemplo, la lista de correos tienen que mostrarse dentro de una ventana con un menú de controles. Para eso, existe el concepto de estados abstractos.

Primero vamos por lo más simple, agregemos los estados. En nuestro caso, es simple pues tenemos solamente un estado que lista todas las noticias. Así que modificamos el archivo app.js para definir el estado.

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

.run(function($ionicPlatform,$rootScope) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
  });
})
.config(function($stateProvider, $urlRouterProvider) {
  $stateProvider
    .state('news', {
      url: "/",
      views: {
          "home":{
              templateUrl: "templates/news.html",
              controller: "newsController as news"
          }
      }
  })
  // if none of the above states are matched, use this as the fallback
  $urlRouterProvider.otherwise('/');
});

Desde la línea 15 se puede ver la definición del estado. En nuestro caso, hemos llamado al estado con el nombre de “news” y le hemos asignado el url “/”, también se le ha asignado una vista llamada “home” que tiene un template llamado news.html en la carpeta templates y tiene asignado el controlador newsController al que le hemos puesto un alias news. ¿Qué significa todo esto?

Traducción: Al invocarse el estado “news”, AngularJS va a tomar el archivo news.html y le va a asignar el controlador newsController para ejecutarlo. Simple.

En la línea 27 se pone que la aplicación tomará la ruta “/” como ruta por defecto, lo que llevará a la aplicación al estado “news”.

Veamos el archivo news.html.

<ion-view view-title="Noticias">
 <ion-header-bar class="bar-stable">
 <h1 class="title">Ionic Blank Starter>/h1>
 </ion-header-bar>
 <ion-content>
 <p> Hay {{notas.length}} noticias</p>
 <div class="list"
 ng-repeat="noticia in notas">
 <div class="card">
 <div class="item item-divider">
 {{noticia.doc.fecha}}</br>{{noticia.doc.titular}}
 </div>
 <div class="item item-text-wrap">
 <b>{{noticia.doc.resumen}}</b>
 </div>
 <div class="item item-divider">
 Autor: {{noticia.doc.autor}}
 </div>
 </div>
 </div>
 </ion-content>
</ion-view>

El contenido es casi todo lo que antes había en el archivo index.html pero con las tags iniciales en lugar de las <ion-content< que habían antes. Esto le indica a AngularJS que estamos definiendo una vista.

Lo que hemos hecho es separar la vista y asignarle un controlador de forma programática lo cual es muy conveniente para poder reutilizar el código.

Ahora, para que todo esto funcione falta indicarle a AngularJS donde vamos a mostrar el resultado del estado, y para eso veamos como queda el archivo “index.html”

<!DOCTYPE html>
<html>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
 <title></title>
 <!-- compiled css output -->
 <link href="css/ionic.app.css" rel="stylesheet">
 <!-- ionic/angularjs js -->
 <script src="lib/ionic/js/ionic.bundle.js"></script>
 <!-- cordova script (this will be a 404 during development) -->
 <script src="cordova.js"></script>
 <!-- your app's js -->
 <script src="js/services.js"></script>
 <script src="js/controllers.js"></script>
 <script src="js/app.js"></script>
 <script src="lib/pouchdb/dist/pouchdb.js"></script>
 </head>
 <body ng-app="starter">
 <ion-nav-view name="home"</ion-view>
 </body>
</html>

En la línea 20 notarán que hemos reemplazado toda la parte que mostraba las noticias por el tag . Aquí le estamos diciendo a AngularJS que queremos que se muestre la vista llamada “home”, que la hemos definido antes en el archivo app.js.

Traducción, AngularJS cargará news.html, le asignará el controlador newsController y la mostrará en el tag denominado “home”.

¿Cuál es la ventaja de todo eso? la respuesta es separación de responsabilidades. El diseñador Web podrá trabajar en la parte de la presentación con el html y el CSS y colores y demás, mientras que el programador podrá trabajar en el controlador, y si por ahí hay nuevas versiones de la vista o el controlador, pues simplemente se cambia en la definición de la vista y nuestra aplicación no sufrirá el cambio.

Ahora bien, regresemos a la pregunta inicial que recibí y que generó todos estos posts. La pregunta fue que si tenemos una lista de objetos de la base de datos, como hacemos para mostrar los detalles de estos objetos. Pues bien, en nuestro ejemplo, ya estamos recuperando todos los datos así que podríamos tener los detalles ocultos mostrando sólo las cabeceras. Para eso podemos usar la ayuda de Angular-bootstrap, así que instalemos rápidamente.

Paso 1: agregar el CSS en el index.html

<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">

Paso 2: instalar el componente angular-bootstrap con bower

bower install angular-bootstrap --save

Paso 3: agregar la referencia en el archivo index.html

<script src="lib/angular-bootstrap/ui-bootstrap-tpls.js"></script>

Con el angular-bootstrap listo, sólo nos queda modificar el template news.html para utilizar el componente accordion:

<ion-view view-title="Noticias">
 <ion-header-bar class="bar-stable">
 <h1 class="title">Ionic Blank Starter</h1>
 </ion-header-bar>
 <ion-content>
 <p> Hay {{notas.length}} noticias</p>
 <accordion close-others="oneAtATime">
 <accordion-group ng-repeat="noticia in notas"
 heading='{{noticia.doc.fecha}}-{{noticia.doc.titular}}'>
 <b>{{noticia.doc.resumen}}>/b>;
 </br>
 Autor: {{noticia.doc.autor}}
 </accordion-group>
 </accordion>
 </ion-content>
</ion-view>

Y obtendremos algo como esto, donde haciendo click en los títulos se despliega el contenido de la noticia:
gen21

Todo bien, pero hay otra alternativa, sobre todo si es que queremos ver los detalles de la noticia de forma mas flexible sobre todo si hay mucho texto, pues en ese caso deberíamos tener una lista de noticias y al seleccionar un titular, ir a otra pantalla para ver solamente esa noticia en toda la pantalla.

Para esto debemos crear otro estado a nuestra app, así que hagámoslo. En el archivo app.js agregamos ese nuevo estado y nuestro nuevo app.js lucirá así:

angular.module('starter', ['ionic','controllers','ui.bootstrap'])

.run(function($ionicPlatform,$rootScope) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
  });
})
.config(function($stateProvider, $urlRouterProvider) {
    $stateProvider
        .state('news', {
        url: "/",
        views: {
            "home":{
                templateUrl: "templates/news.html",
                controller: "newsController as news"
            }
        }
    })
        .state('detail', {
        url: "/detail/:id",
        views: {
            "home":{
                templateUrl: "templates/detail.html",
                controller: "detailController as detail"
            }
        },
        resolve:{
            detail: function($stateParams){
                return $stateParams.id;
            }
        }
    })
    $urlRouterProvider.otherwise('/');
});

Los puntos de interés son la línea 27 donde fijamos el URL y también indicamos que el url vendrá con el parámetro ‘:id’; la línea 34, donde estamos fijando que la variable “detail” será pasada al controlador y tendrá el valor del parámetro ‘id’.
Ahora veamos como ha quedado el controlador nuevo en el archivo controller.js:

.controller('detailController',function($scope,db,detail){
	db.get(detail).then(function(doc){
        $scope.event=doc;
    })
})

Prestemos atención en la línea 11 que estamos pasando la variable ‘detail’ que definimos en la definición del estado y usamos ese valor para recuperar el objeto desde la base de datos. El valor del parámetro ‘id’ debe ser el id del documento que hemos elegido. La función db.get la estamos invocando desde el servicio que hemos definido en el archivo services.js así que tenemos que agregar este a la definición:

return {
  init: function(){
        db.replicate.from(remote,{live:true,retry:true})
        .on('paused',function(info){
            db.allDocs({startkey:'news_\uffff',endkey:'news_',descending:    true,include_docs:true})
            .then(function(result){
                  $rootScope.$broadcast('refrescar',result.rows);
            });
          });
        },
   get: function(id){
        return db.get(id);
   }
}

El documento resultante lo grabaremos en la variable de escope event para usarla en el template para mostrar.

Para verificar esto, veamos como quedan los templates.
Primero, index.html:

<!DOCTYPE html>
<html>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
 <title></title>
 <!-- compiled css output -->
 <link href="css/ionic.app.css" rel="stylesheet">
 <link href="lib/angular-bootstrap/ui-bootstrap-csp.css" rel="stylesheet">
 <link href="css/bootstrap.css" rel="stylesheet">
 <!-- ionic/angularjs js -->
 <script src="lib/ionic/js/ionic.bundle.js"></script>
 <script src="lib/angular-bootstrap/ui-bootstrap-tpls.js"></script>
 <!-- cordova script (this will be a 404 during development) -->
 <script src="cordova.js"></script>
 <!-- your app's js -->
 <script src="js/services.js"></script>
 <script src="js/controllers.js"></script>
 <script src="js/app.js"></script>
 <script src="lib/pouchdb/dist/pouchdb.js"></script>
 </head>
 <body ng-app="starter">
 <ion-nav-bar class="bar-positive">
 <ion-nav-back-button class="button-clear">
 <i class="ion-arrow-left-c"></i> Regresar
 </ion-nav-back-button>
 </ion-nav-bar> 
 <ion-nav-view name="home"></ion-view>
 </body>
</html>

Aquí solamente hemos añadido una cabecera para facilitar la navegación en las líneas 23 a la 27.
Ahora veamos el archivo donde mostramos la lista de noticias: ‘news.html’

<ion-view view-title="Noticias">
 <ion-header-bar class="bar-stable">
 <h1 class="title">Noticias</h1>
 </ion-header-bar>
 <ion-content>
 <ion-list>
 <ion-item ng-repeat="noticia in notas" 
 ui-sref='detail({id:"{{noticia.id}}"})'>
 {{noticia.doc.fecha}}-{{noticia.doc.resumen}}</ion-item>
 </ion-list>
 </ion-content>
</ion-view>

Notaremos en las líneas 6 a la 10 que hemos incluido una lista y cada item tiene una directiva nueva: ui-sref que se encarga de llevarnos al estado que se indica cuando se hace click en el item; además le estamos pasando el parámetro id con el valor del id del documento.
Y ahora, para mostrar la noticia usamos el template detail.html que lucirá así:

<ion-view view-title="Noticia">
 <ion-header-bar class="bar-stable">
 <h1 class="title">Detalle</h1>
 </ion-header-bar>
 <ion-content>
 <div class="card">
 <div class="item-divider">
 <h2>{{event.fecha}} {{event.titular}}</h2>
 </div>
 <div class="item-body">
 {{event.resumen}}
 </div>
 <div class="item-divider">
 <h2>{{event.autor}}</h2>
 </div>
 </div>
 </ion-content>
</ion-view>

Como ven, los detalles del documento recuperado los leemos usando la variable ‘event’.

Y el resultado es una app con dos estados: news que muestra la lista de noticias disponibles y al hacer click en alguna llegamos al segundo estado llamado detail donde se muestra la noticia seleccionada completa, para lo cual recibe un parámetro que nos sirve para recuperar los datos desde la base de datos.

gen22

gen23

Seguramente notaremos que para el ejemplo que he desarrollado, hacer otra llamada a la base de datos puede parecer un desperdicio, pero lo que he tratado de hacer es mostrar como pasar parámetros y como utilizar los estados.Lo mas importante es que tenemos dos estados que podemos reutilizar en el resto de nuestra app.

NOTA: Parece que tengo un lector que ha sido responsable y ha seguido todos los pasos. Muchas gracias a Tercio Santos. Al parecer tiene un problema con el app y luego de pruebas en mi equipo, puedo decir que no hay problema con el código. Sólo por si acaso, recomiendo la instalación del plugin Cordova Whitelist:

ionic plugin add cordova-plugin-whitelist

Sucede que en las últimas versiones de Android, es necesario especificar los lugares donde el app puede ingresar y para eso se puede usar whitelist. Si es que no está, Android puede bloquear el acceso a internet de su app, por eso es mejor que esté aunque no lo utilicen todavía. Para una implementación en producción si es necesario configurar bien esos permisos. Ya llegaremos a eso.
Y para que vean que el código camina, aquí va un pantallazo. Recuerden, corre el app la primera vez con red, se muestran los datos, y listo, ya pueden ponerlo en modo avión si quieren y el app tendrá que mostrarle los datos.


Esta es una continuación de la serie sobre desarrollo en móviles que comencé aquí. Les recomiendo comenzar a escribir el código fuente desde la parte 1 ya que no se publica el código para descarga.

Ayer mencioné que iba a publicar un nuevo post para contestar una pregunta que recibí en la semana. Notarán el post sobre tips para rendimiento donde la moraleja resumida es que preocuparse por la velocidad de PouchDB contra Sqlite es detenerse en el arbol en lugar de apreciar todo el bosque.

La primera pregunta que recibí fue sobre como hacer para recuperar una lista de objectos y luego recuperar los detalles de un objeto en particular. Como en cualquier correo, tienen la lista de correos y cuando hacen click en uno en particular, verán el contenido en otra ventana. Este mecanismo es la perfecta introducción al concepto de estados que Ionic soporta mediante la inclusión de UI-Router.

Primero hagamos un poco de orden en el código que dejamos en la parte 2 de esta serie. Para los que recién llegan, no hay un download del código, así que vayan a la Parte 1 para que hagan el código paso a paso con el post.

Como podrán ver, tenemos el código todo regado en el archivo app.js lo cual esta mal. Lo que yo suelo hacer es tener un archivo para los controladores (controller), otro para los servicios (service, factory) y dejamos el app.js lo más limpio posible. Esperen!!, services y factories es algo que no había mencionado hasta ahora. Así que toca un poco de introducción.

Los que venimos del mundo de cliente/servidor y objetos y todo eso recordaremos que solíamos tener un super objeto casi global para ciertas tareas que estaba corriendo todo el tiempo esperando que le pidamos cosas. Si es que necesitábamos mantener la consistencia de sus operaciones, entonces declarábamos este objeto como un Singleton y listo, estabamos seguros que todas las operaciones las podíamos verificar antes de mandarlas. Pues eso en el mundo de AngularJS lo encontramos en las estructuras Service y Factory. ¿Cuál usar? Personalmente yo utilizo Factory la mayor parte del tiempo, pero Service también debería hacer el trabajo. La diferencia principal es que Factory es un Singleton y Service no, nada mas.

Comencemos por el mas fácil, pongamos todos los controladores en un módulo:

angular.module('controllers',[])
.controller('newsController',function($scope){
	$scope.notas=[];
	$scope.$on('refrescar',function(event,news){
		$scope.$apply(function(){
			$scope.notas = news;
		})
	})
})

Llamemos a este archivo controllers.js y pondremos aquí todos los demás controladores que nos hagan falta.

Ahora, para que el cambio sea completo, hay que cambiar tanto el app.js y el index.html.

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

Esta es la única línea que cambia del archivo app.js. Simplemente le estamos diciendo a AngularJS que el módulo App.js llamado ‘starter’, tiene una dependencia adicional llamada ‘controllers’.

<!DOCTYPE html>
<html>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
 <title></title>
 <!-- compiled css output -->
 <link href="css/ionic.app.css" rel="stylesheet">
 <!-- ionic/angularjs js -->
 <script src="lib/ionic/js/ionic.bundle.js"></script>
 <!-- cordova script (this will be a 404 during development) -->
 <script src="cordova.js"></script>
 <!-- your app's js -->
 <script src="js/controllers.js"></script>
 <script src="js/app.js"></script>
 <script src="lib/pouchdb/dist/pouchdb.js"></script>
 </head>

En el caso de index.html, hemos agregado la línea 14 donde le indicamos que tiene que cargar el archivo controllers.js con nuestros controladores. Y listo, ya tenemos algo mas de orden.

Ahora nos toca ordenar la base de datos. Lo ideal sería tener un objeto que esté siempre disponible gestionando las llamadas a la base de datos, por lo que aplica a ser un Service o un Factory. Prefiero un factory como ya les había dicho así que esto quedaría en un módulo de la siguiente manera.

angular.module('services',[])
.factory('db',function($rootScope){
    var key = 'bentareadyessharyinessee';
	var pass = 'OnEixgKgpt8LyEtl0S5DkAon';
	var remote = 'https://'+key+':'+pass+'@supermio.cloudant.com/news';
	var db = new PouchDB('news');

    return {
        init: function(){
            db.replicate.from(remote,{live:true,retry:true})
                .on('paused',function(info){
                db.allDocs({startkey:'news_\uffff',endkey:'news_',descending: true,include_docs:true})
                    .then(function(result){
                    $rootScope.$broadcast('refrescar',result.rows);
                });
            });
        }
    }
})

Llamaremos services.js a este archivo y como podrán ver es un Factory que publica solamente un método llamado init. Este método tenemos que invocar para que se inicie el manejo de la base de datos. Si queremos simplificar nuestro archivo de controladores quedará así:

angular.module('controllers',['services'])
.controller('newsController',function($scope,db){
 db.init();
 $scope.notas=[];
 $scope.$on('refrescar',function(event,news){
 $scope.$apply(function(){
 $scope.notas = news;
 })
 })
})

Notarán que en la línea 1 se ha agregado el módulo services como dependencia y en la línea 3 estamos llamando al método init del Factory db.

Y el app.js quedará así:

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

.run(function($ionicPlatform,$rootScope) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
  });
})

Comparado con el desorden que teníamos al principio ahora todo se ve más ordenado. Pero lo mas importante es que podemos centrarnos en escribir servicios o factories de forma general y reutilizarlos en otros proyectos simplemente copiando los archivos, lo mismo con controladores.

Una sugerencia final es que según estuve leyendo, esto de separar el código en controladores y servicios es bueno, pero no sirve si nuestro proyecto crece demasiado. La solución es la de hacer la separación por funciones de nuestro app y dentro de cada función poner los controladores y servicios separados en archivos. Esto lo veremos mejor cuando incluyamos el concepto de estados.

Continuaremos en otro Post porque el tema de estados es muy importante entender el concepto antes de programar.

NOTA: Soy muy flojo programando, así que hacer todo esto paso a paso lo hago para combatir este defecto. Así que para notar que este esfuerzo vale la pena, les pido que sigan el tutorial desde la parte 1, si les paso el código para que lo copien simplemente no vale ni mi esfuerzo ni ustedes tampoco van a entender.


En la semana he recibido un par de consultas que me parecen super importantes y que trataré de responder en un par de post y de pasada repasar los fundamentos.

La segunda pregunta que recibí creo que es mejor tratarla primero: ¿Ionic con PouchDB y Cloudant es más rápido que usar MySQL y websql? Veamos, desde mi punto de vista por más que parece lo mismo, no lo son.

Antes debemos revisar un par de puntos:

Primero, PouchDB es además una capa de abstracción de datos porque puede utilizar varios tipos de archivos para almacenar los datos (Adaptadores), principalmente puede usar IndexedDB, WebSQL y otros menos usados. La recomendación es que le indiquemos a PouchDB que utilice WebSQL si queremos que sea más rápido. En alguna eventualidad, PouchDB nos libra del problema pues puede elegir automáticamente cual es el mejor almacenamiento para nuestros datos.

Segundo, WebSQL, sqlite o como lo quieran llamar, es un estándar que ya está “depreciado”. El consorcio que maneja los estándares de Internet ya ha fijado que IndexedDB sea el estándar. Los navegadores siguen teniendo soporte para WebSQL pero no se sabe exactamente hasta cuando, mas bien IndexedDB es una obligación para todos.

Ahora comparemos:

PouchDB y Cloudant (o CouchDB en general) es realmente una solución de gestión de datos de extremo a extremo que parte del concepto denominado “offline first” donde la aplicación cliente, luego de una sincronización inicial, está preparada para trabajar sin conectarse al Servidor. Incluso, hay otro movimiento más radical denominada “No Backend”, pero no lleguemos a extremos, de alguna manera la base de datos es el backend y, si fuera necesario, se puede colocar una capa de lógica intermedia. Para resumir, PouchDB – CouchDB incluye, gestión de datos, sincronización y segmentación de datos. Un aspecto adicional es que, dado que no hay esquemas, es necesario “transformar” los datos del modelo relacional para que cuadre en el modelo “documental” de CouchDB y para esto pensaremos en la estructura que mejor nos acomode en la aplicación cliente lo que significa que vamos a “limpiar” el modelo para tener solamente lo que nos interesa.

MySQL y WebSQL (o sqlite para los amigos) es en el sentido estricto solamente un gestor de datos. Pasar datos desde MySQL a la base local en WebSQL es algo que tenemos que hacer nosotros, al igual de la segmentación de datos. Además, dado que en sqlite tenemos tablas y un dialecto de SQL, nuestra primera tentación será la de repetir el modelo de datos que tenemos en el backend.

Entonces, para comparar papas con papas, hablemos del aspecto de gestión de datos solamente de ambas soluciones. La verdad dura y simple es que consultar datos con sqlite es más rápido que consultar datos con PouchDB. Hay un documento que explica el rendimiento comparado de las bases de datos en el lado del cliente que pueden consultar Comparación datos móviles

Ahora bien, esto no me parece determinante porque, dependiendo del modelo de datos que tengamos, es muy probable que con el modelo relacional de sqlite tengamos que hacer más consultas que con PouchDB. Esto no tengo como sustentarlo en números, pero en los proyectos que he realizado es algo evidente que si modelas bien, consultas menos y dado que en un “Documento” de CouchDB puedes organizar los datos en más de 1 nivel, puedes traer más datos en una sola consulta.

Otro punto importante es la cantidad de datos. Mientras más datos tengas, será más claro el tema de la velocidad. En mi caso, tengo apps donde guardo mas de 300 documentos en el móvil y la velocidad es aceptable. Debemos considerar que los documentos no son tan simples, incluso la gran mayoría contiene BLOBs de 20K en promedio de tamaño con un tamaño total de 12 MB de la base de datos, lo que sería una locura en un entorno sqlite. Si el volumen de datos que vas a manejar es menor a mi ejemplo, entonces la diferencia de performance no la vas a sentir.

Guardo el tema de índices para el final porque es muy importante. Con Sqlite podemos crear índices donde y cuando nos dé la gana lo cual casi no tiene costo en procesamiento ni en almacenamiento. En el caso de PouchDB, los índices no se hacen por nada: Existe un índice por defecto que solamente contiene el campo _id de todos los documentos en la base de datos, y como no hay tablas pues estamos hablamos de absolutamente todos los registros. Suena a limitación, pero significa que recuperar un registro es super mega extra rápido y recuerden que un registro puede tener mucha información que en Sqlite podría tomar más de una consulta, además, si usamos el ID correcto nuestras consultas pueden beneficiarse de este super índice: la clave es crear los IDs manualmente incluyendo los criterios de búsqueda que necesitemos. Por ejemplo, si queremos guardar un documento para el Comic 1 de la editorial DC que salió en 01 de febrero del 2015, el ID que nos convendría sería com_dc_2015-02-01_01, de esta manera podremos hacer consultas muy rápidas con el método allDocs de PouchDB:

– Todos los comics: startkey: ‘com_’, endkey: ‘com_\uffff’;

– Todos los comics de la editorial DC: startkey: ‘com_dc_’, endkey:’com_dc_\uffff’

– Todos los comics de DC que salieron el 2015: startkey: ‘com_dc_2015_’, endkey: ‘com_dc_2015_\uffff’

La mala palabra en PouchDB es ‘Joins’ al estilo sql. No existe, así de simple, pero no desesperen pues existen muy buenas alternativas. Aquí van dos: Podemos crear vistas que son parecidas a las del mundo relacional pero que siguen el modelo Map/Reduce que es lo mejor en lo referido a escalabilidad, igual la recomendación es usarla solamente en condiciones extremas tal como se explica en este artículo. La segunda opción se llama Mango y es una forma de indexar toda la base de datos de la forma que nos de la gana y podrán encontrar información aquí.

Finalmente, y creo que es la razón definitiva por la cual se debería usar el modelo con PouchDB, es que tenemos que valorar que estamos usando una solución completa para el manejo de datos, no es solamente un modo de tener una base local, es una solución de sincronización. En un modelo Sqlite, la sincronización es un proceso que tiene que ocurrir de modo secuencial, es decir: ingresas datos, modificas datos, parar para sincronizar, lees datos, modificas datos. Con PouchDB, la sincronización es un proceso que se ejecuta en una tarea paralela, por lo que podremos ingresar, leer, modificar datos sin parar.

Si realmente necesitan velocidad, Sqlite no va a estar en el vecindario por mucho tiempo, así que mi recomendación está en mejorar el modelo.


Este post lo hago de urgencia pues acabo de experimentar todo lo que no se debe hacer en el tema de sincronización. Para esto les doy un resumen de mi entorno de desarrollo:

  • Servidor: Instancia en Cloudant.com
  • Cliente: PouchDB como base de datos con sincronización al iniciar el app
  • Framework: Ionic

En resumen, se inicia una sincronización entre mi base de datos local en PouchDB y la base remota en Cloudant. Y puede ser todo lindo en Producción, pero como estamos en Desarrollo, el proceso normal es parar e iniciar el app a cada rato. Ahora veamos las consecuencias en desarrollo:

  • Costo: Cloudant te cobra por transacciones y te dice que por transacciones “pesadas” te va a cobrar mas, y pone varias transacciones HTTP y las define como pesadas. Lo que no dice es que hay otras transacciones que se utilizan para la sincronización que también se califican como pesadas, principalmente OPTIONS que se manda a cada rato. Por lo tanto, cada sincronización es bastante intensiva en costo.
  • Tráfico: Para un modelo de desarrollo, no es bueno iniciar conexiones de datos muy seguido. Entonces, el modelo debe saber cuando es bueno iniciar la sincronización sin importar que sea en Desarrollo o Producción.
  • Batería: Como consecuencia de la reducción de tráfico, estaremos también bajando el consumo de energía en el móvil.

No malentiendan, CouchDB/PouchDB es muy bueno, y si existe la necesidad, podemos activar la sincronización “live”, pero como no todos tenemos servidores y ancho de banda de sobra, tenemos que pensar en servicios en demanda en la red, como Cloudant en mi caso. Tengan en cuenta que otros servicios como IrisCouch, también cobran por transacciones.

La salida que encontré depende de como se necesita que fluyan los datos:

  • El recolector de datos: si nuestra app necesita solamente capturar datos y no necesito bajar información desde el servidor. En este caso, lo mejor es implementar un contador que incrementaremos cada vez que se actualice o se inserte un dato nuevo. Lo bueno es que para un entorno NoSQL, insertar o actualizar es el mismo método, así que en ese método podremos insertar el incremento del contador. Luego, al momento antes de sincronizar, verificaremos si es que el contador es mayor a 0, de lo contrario no iniciaremos la sincronización. Sincronizar solamente cuando hayan datos locales.
  • El visualizador de datos: Aquí es totalmente al revés, el app jala información del servidor. En este caso, la primera alternativa es la de fijar un tiempo de sincronización relativamente alto, agregar un visor de la última fecha de sincronización y la opción para forzar la sincronización manualmente.
  • Finalmente, como siempre, en la vida real tendremos una combinación de necesidades, así que la recomendación final es la de utilizar un proceso de sincronizacion para descargar datos y otro para subir datos.

Hay una función que no he mencionado aún: Sincronización filtrada. Esto es super útil y lo voy a desarrollar en otro Post, Básicamente es la de descargar solamente la información que me interesa. Esto es tan importante que todos deben usarlo si es que tenemos que descargar datos.

En conclusión, es muy fácil sincronizar sin límites, pero en la vida real, no hay que pedir más de lo que debemos consumir.


Ya publiqué hace unas semanas mi primera aplicación multiplataforma y con el tiempo y las pruebas que vengo realizando, confirmo cada día que esta combinación es realmente de mucho potencial, por su facilidad y su potencia. Ahora creo que es tiempo de hacer un ejemplo “End to End” que muestre el proceso desde la teoría hasta la ejecución de un app. Así que nada de código para que te bajes, sigue paso a paso y tendrás al final de este post un app en javascript que sincroniza con una base remota y que de yapa puede funcionar en cualquier móvil. “Fasten your seatbelt” y nos vemos al final del Post.

Empecemos definiendo el problema: Tienes tu smartphone super ultra plus y quieres abrir algún App de los miles que tienes instalado y te das cuenta de que se te acabó el saldo y no estas ni siquiera cerca de un Starbucks, o estas en una zona donde la cobertura es recontra mala. Lo que normalmente sucederá es que el App te dirá que no hay red y que no se puede usar. Este escenario parece trivial pero para algunas aplicaciones, es un escenario que tiene que evitarse a toda costa. Llevando el tema más allá, creo que todas las aplicaciones deberían considerar que en algún momento la red se puede caer y deben poder seguir funcionando, al menos en un conjunto básico de funciones. Desde el punto de vista de programación estamos hablando de aplicaciones que soporten trabajar “Off-Line”.

Para hacer todo esto posible hay miles de recetas disponibles y la que presento ahora combina simpleza y potencia. Para ver como debemos comenzar veamos el gráfico:

gen01

Si vamos componente por componente:

  • Servidor: Cloudant es parte de la propuesta Bluemix de la plataforma de servicios cloud de IBM. Está basado en Apache CouchDB con algunas mejoras en el campo de autenticación, manejo de información geográfica y búsquedas. Digamos que es la implementación mas segura y confiable de CouchDB con la gran ventaja de que podemos acceder al nivel gratis del servicio muy fácilmente. De hecho, si generas un tráfico por un total de 50 USD o menos, no pagas y gracias al esquema que les voy a explicar, eso es un montón.
  • Cliente: Ionic Framework es una herramienta para el desarrollo de aplicaciones basadas en HTML 5 con javascript. Está basado en Apache Cordova y permite desarrollar para Android, iOS, Windows Phone 8, Windows 8, y otras mas aunque por ahora solamente Android y iOS son oficialmente soportados. Lo mas importante puede ser que Ionic está basado en AngularJS que es un framework para el desarrollo de aplicaciones JavaScript que facilita el desarrollo de aplicaciones basados en el modelo MVC.
  • Base de datos cliente: PouchDB es un proyecto que trata de implementar CouchDB en javascript. Debido a que el soporte de formatos de base de datos en los móviles es muy variado, PouchDB funciona además como una capa de abstracción de almacenamiento aunque su mayor fortaleza es en la implementación del protocolo de sincronización.

Hay algo que no he dicho aún y es que para los que estamos acostumbrados al mundo SQL significa días difíciles. Personalmente, me parece que el cambio ya se dió al enterarme que el estándar WebSQL, (SQLite para los amigos) ya no es el estándar en muchas de las plataformas móviles. Esto significa que tenemos que empezar a lidiar con NoSQL.

NoSQL significa que ya no hay esquemas o “tablas”, simplemente hay documentos que lo único seguro es que tienen un id único ( aunque por ahí ya vi un caso donde incluso esto no es cierto ). No se engañen, No Tablas no significa No Diseño, al contrario, el diseño tiene que ser mayor con la ventaja de que no hay esquemas que ir impactando. De nuestro diagrama, Cloudant y PouchDB son NoSQL y serán a partir de ahora la columna vertebral de nuestras aplicaciones móviles.

Bien, creo que las explicaciones ya están, ahora lo que queremos ver es una aplicación que nos muestre lo fácil que es entrar al mundo de móviles. Preparemos entonces el entorno.

Organizando las herramientas

Empecemos instalando las herramientas. Primero se debe instalar NodeJS. Es una serie de librerías Javascript que son necesarias para Ionic. En el link podrán encontrar la versión para los sistemas operativos más populares.

Con el NodeJS listo, vamos a instalar ahora Ionic. En una ventana de consola:

c:\>npm install -g ionic

No es requisito pero también deberían instalar Cordova:

c:\>npm install -g cordova

Y listo, Ionic ya está y lo pueden comprobar así:

c:\>ionic info

Ahora, hay que instalar PouchDB, para lo cual necesitamos instalar Bower que es una herramienta para instalar librerías JavaScript. Para eso utilizamos el siguiente comando:

c:\>npm install -g bower

Ahora lo que tenemos que hacer es crear un proyecto Ionic y agregarle las librerías de PouchDB. Para crear un proyecto Ionic, procedemos con el siguiente comando:

c:\>ionic start superdatos

Mediante este comando estamos creando el proyecto llamado “superdatos”. Se ha creado una carpeta con todos los archivos necesarios. Una vez que el comando haya terminado debemos hacer la configuración de SASS que es algo super potente que explicaremos después, por ahora simplemente ejecuten el comando siguiente:

c:\>cd superdatos
c:\superdatos\> ionic setup sass

Para los que entienden CSS, SASS es un CSS con parámetros. Yo todavía no lo entiendo bien, pero lo poco que he hecho es suficiente para darme cuenta de su importancia, así que ahi está. Ahora instalemos PouchDB:

c:\superdatos\>bower install pouchdb

Y listo. Si quieren ver lo que han hecho hasta ahora entonces ejecuten el siguiente comando:

c:\superdatos>ionic serve

Ahora abran un navegador, ingresen el url http://localhost:8100 y listo:

gen07

Así es, sin darse cuenta han hecho una aplicación con una barra de título. Casí nada, pero al menos ya hemos comenzado

Organización de la aplicación

Ahora revisemos todo lo se que ha hecho. Veamos los archivos:

En la carpeta raíz no hay mucho que ver:

gen05

Nos enfocaremos inicialmente en la carpeta www

gen06

  • index.html: es el punto de entrada de nuestra aplicación y donde registramos todas las librerías que queremos usar
  • Carpeta js: es donde colocamos todos los archivos javascript. El principal archivo javascript es app.js que es donde configuramos nuestra aplicación.
  • Carpeta lib: Si ingresan es donde están grabadas todas las librerías que tenemos disponibles para la aplicación. Ionic y PouchDB estarán ahí, además de otras propias de Angular
  • Carpeta img: obvio, las imágenes van aquí.
  • Carpeta css: y aquí van los archivos CSS

Y listo. Ahora nos toca entender por donde comenzar, para lo cual debemos entender el concepto de MVC o Model – View – Controller.

MVC-web-application-development

Según esto, una aplicación se divide en estos tres elementos: modelo, vista y controlador, donde vista es toda la parte gráfica de la aplicación y como el usuario interactúa con ella. El controlador es quien maneja la lógica detrás de las pantallas, cuál es la lógica que se lanza al hacer click en un botón. El modelo es como la lógica del negocio, que también controla lo que grabamos en una base de datos, si al hacer click en un botón que dice grabar, el controlador le tendrá que decir al modelo que tiene grabar una entrada de producto, seguidamente, la vista se refrescará para mostrar todas las entradas de producto. Exacto, el producto es el modelo.

Ya dijimos que Ionic se basa en AngularJS donde es muy fácil identificar al modelo, la vista y el controlador, de hecho sería así:

  • Vista : carpeta templates, archivos HTML o simplemente index.html
  • Controlador: carpeta js, archivos js. Entidad controller en AngularJS
  • Modelo: carpeta js, archivos js. Entidad factory en AngularJS

Es mas simple de lo que parece. Y para eso revisemos nuestra simple aplicación tal cual está ahora. Primero veamos el archivo index.html que tiene definida la vista:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
<title></title>
<!-- compiled css output -->
<link href="css/ionic.app.css" rel="stylesheet">
<!-- ionic/angularjs js -->
<script src="lib/ionic/js/ionic.bundle.js"></script>
<!-- cordova script (this will be a 404 during development) -->
<script src="cordova.js"></script>
<!-- your app's js -->
<script src="js/app.js"></script>
</head>
<body ng-app="starter">
<ion-pane>
<ion-header-bar class="bar-stable">


<h1 class="title">Ionic Blank Starter</h1>


</ion-header-bar>
<ion-content>
</ion-content>
</ion-pane>
</body>
</html>

Las líneas que nos interesan por ahora son la 14 y la 16. Primero en la 14 veremos

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

Esta línea le dice a la aplicación que la lógica que necesita está en el archivo app.js que está escrito en javascript como podrán sospechar. Cualquier otra librería tiene que ser declarada aquí para poder ser utilizada. Recuerden esto pues tenemos que regresar aquí mismo para ver que hacemos con PouchDB.

<body ng-app="starter">

Y en la línea 16 le decimos que la aplicación que estamos haciendo es ng-app osea Angular con nombre “starter”.

Ahora revisemos el famoso app.js:

// Ionic Starter App
// angular.module is a global place for creating, registering and retrieving Angular modules
// 'starter' is the name of this angular module example (also set in a <body> attribute in index.html)
// the 2nd parameter is an array of 'requires'
angular.module('starter', ['ionic'])

.run(function($ionicPlatform) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
  });
})

En la línea 5 está definido el módulo ‘starter’ que es el que encontramos en el archivo index.html. Cuando index.html quiera saber que hacer, vendrá a buscar la lógica a este archivo app.js.

Luego en la linea 7 vemos algo importante. Para los que ya tienen experiencia con aplicaciones en Cordova, entenderán la importancia del evento CordovaReady. Para ponerlo simple, Ionic es Cordova en esteroides, así que también hay que esperar por el evento CordovaReady, pero como Ionic habla el dialecto AngularJS entonces tenemos que usar el código tal cual está aquí.

Integrando PouchDB

Pues bien, ya estamos listos para integrar nuestra base de datos así que debemos preguntarnos ¿qué queremos hacer? Pongamos las cosas en el nivel mas simple posible. Digamos que queremos hacer un lector de noticias donde las noticias mas nuevas se muestren al comienzo. Nada complicado. Con esto en la mente, comencemos agregando activando PouchDB en nuestro proyecto, de la siguiente manera. Nuestro archivo index.html debería ser así ahora:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
    <title></title>
    <!-- compiled css output -->
    <link href="css/ionic.app.css" rel="stylesheet">
    <!-- ionic/angularjs js -->
    <script src="lib/ionic/js/ionic.bundle.js"></script>
    <!-- cordova script (this will be a 404 during development) -->
    <script src="cordova.js"></script>
    <!-- your app's js -->
    <script src="js/app.js"></script>
    <script src="lib/pouchdb/dist/pouchdb.js"></script>
  </head>
  <body ng-app="starter">
    <ion-pane>
      <ion-header-bar class="bar-stable">


<h1 class="title">Ionic Blank Starter</h1>


      </ion-header-bar>
      <ion-content>
      </ion-content>
    </ion-pane>
  </body>
</html>

Hemos agregado una línea indicando donde está el archivo con la librería PouchDB. Si se fijan bien, dentro de nuestra carpeta lib está la carpeta con toda la info requerida por PouchDB, aquí simplemente hemos apuntado al archivo de distribución.

NOTA: es una buena idea que tengan una consola abierta solamente para que el comando Ionic serve esté corriendo todo el tiempo ya que Ionic permite que todo lo que hacemos se compile en tiempo real.

En Google Chrome veremos que nuestra app no ha cambiado mucho. Nos toca entonces, crear la base de datos. Para eso, agregamos la siguiente línea en nuestro app.js:

// Ionic Starter App

// angular.module is a global place for creating, registering and retrieving Angular modules
// 'starter' is the name of this angular module example (also set in a <body> attribute in index.html)
// the 2nd parameter is an array of 'requires'
angular.module('starter', ['ionic'])

.run(function($ionicPlatform) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
    var db = new PouchDB('news');
  });
})

En la línea 18, creamos la variable que tendrá nuestra base de datos local y le ponemos de nombre ‘news’. Al grabar los cambios, notarán que el navegador se refresca solo y volvemos a ver nuestra app. Parece que todo sigue igual pero no. Para desengañarnos, tenemos que abrir las herramientas (Ctrl + Mayus + I) y vamos a la sección Resources y veremos:

gen08

En recursos, veremos que se ha agregado una base de datos con el nombre _pouch_news y no es coincidencia. Es nuestra base de datos ‘news’ creada por PouchDB en el formato IndexedDB. Todo bien hasta ahora. Ahora veamos como nos conectamos a IBM Bluemix para acceder a Cloudant.

Jugando con Cloudant

En el mundo CouchDB, encontré muchas alternativas “cuasi” gratuitas para comenzar a trabajar pero es lamentable como la falta de visión a largo plazo hace que la confiabilidad no sea algo característico. Todo esto se terminó con Cloudant, ya que IBM es quien está detrás y eso es ya bastante. ¿Porqué no instalar mi propia instancia de CouchDB en mi PC? Simple, Cloudant es gratis hasta 50 USD de tráfico, es super rápido, confiable y otros adjetivos todos muy buenos. Además, estamos en la onda de utilizar herramientas Cloud así que va a tono.

Como siempre, primero hay que crear una cuenta en https://cloudant.com/sign-up/ y ya podrán acceder a esta pantalla:

gen09

Para los fans de CouchDB, esta es una versión algo mejorada de Fauxton con las mejoras que les comenté al inicio. No perdamos mas tiempo y creemos nuestra primera base de datos. Un click en Add new Database, ponemos el nombre ‘news’ por facilidad y listo, veremos esta pantalla ahora:

gen10

Ahora es el momento de reflexionar sobre la estructura de datos que necesitamos. Una noticia tiene un titular, un resumen y el cuerpo, además, tiene una fecha y un autor. Para comenzar, creo que es suficiente, así que agregaremos nuestro primer documento. Hacemos click en el signo mas junto a All Documents  y seleccionamos nuevo documento. Y luego empecemos a crear nuestro documento en formato JSON:

gen12

Simple, ¿Queremos mas campos? no hay problema, le agregas nomas al JSON y listo. ¿Y los índices, llaves primarias, foráneas y otros? Pues no hay, al menos no aquí. Lo único que hay que respetar aquí es que el campo “_id” es obligatorio y debe ser único. ¿Y la clave no es autoincrement? no necesariamente, podemos dejar que se autogenere pero nos perdemos de mucho si hacemos eso. Si se dan cuenta la _id que estoy usando es “news_20150507_vpease_001” que sospechosamente parece ser hecha a propósito y la verdad es que si. Es altamente recomendable utilizar una convención para la creación de claves. En este caso:

  • “news” : indica el tipo de documento. Recuerden que no hay esquemas así que mejor si identificamos así a nuestras entidades.
  • “20150507” : así es, se refiere a la fecha, pues ya dijimos que queremos mostrar las últimas noticias primero.
  • “vpease” : correcto otra vez, es el autor de la noticia.
  • “001” : una pequeña cadena al final para asegurar que el id sea único.

¿Porque todo este lio con la clave? Si bien es cierto que tenemos un campo “tipo” que nos permite diferenciar las entidades entre todos los documentos de la base, CouchDB tiene un método super rápido llamado AllDocs que sólo puede ser ordenado por el campo “_id”. Podemos crear nuevos indices pero ocupan espacio adicional, así que para ahorrarnos algo de espacio y ganar algo de velocidad, NO DEBEMOS AUTOGENERAR LA CLAVE, SIEMPRE DEBEMOS COMPONER LA CLAVE CON CAMPOS DE ORDENACION.

Y finalmente, grabamos y listo.

gen13

Notarán que se ha agregado un campo “_rev”, esto es un mecanismo interno de CouchDB para controlar los cambios y hacer lo que mejor hace: sincronizar.

Podríamos agregar mas noticias, pero por ahora es suficiente. Finalmente tenemos que crear algún tipo de identidad o usuario para poder acceder a los datos. Esta es una de las mejoras de Cloudant, todas las llamadas deben ser autenticadas y el HTTPS viene de gratis. En Cloudant, volvamos a la lista de base de datos:

gen14

Entremos a la sección de permisos ahora:

gen15

Hay dos maneras de dar acceso:

  • Le damos permiso a todos a entrar a los datos
  • Crear un API key/clave

Hay una tercera opción que es la de usar nuestras credenciales administrativas para dar acceso, lo cual es a todas luces incorrecto, como también es incorrecta la opción 1, así que API Keys es la voz. También se puede compartir la base a otro usuario de Cloudant pero eso no es masivo, así que nos quedamos con las API keys. En simple, un API key es un usuario temporal que solamente sirve para acceder a los datos y le podemos asignar permisos. Para mantener todo simple, vamos a darle a esta API key los privilegios de Replicator y Reader.

gen16

Y listo, apunten bien esta combinación de Key y password porque ya no puede volver a generarse. Podrán generar una nueva Key pero ya no podrán recuperar la clave. Fijense que ya le asignamos los privilegios de Reader y Replicator. Ahora, toca finalizar nuestro app cliente.

NOTA CRITICA: Antes de salir hay que activar CORS, así que denle click en Account – CORS y activen All Domains. ¿Qué es CORS? es una protección de los navegadores para no ejecutar código remoto. Para nuestro caso, CORS debe estar siempre activado. La pantalla debe lucir así:

gen18

Agregando la sincronización 

Para esto, debemos entender un tema previamente. La sincronización tiene muchas variantes pero por ahora sólo nos va a importar tres cosas: Dirección, Frecuencia y Eventos.

La dirección se refiere al sentido que tendrán los datos, del Servidor al móvil o del Móvil al Servidor. Dado que solamente vamos a leer, consideraremos la sincronía de Servidor al Móvil.

La frecuencia se refiere a que tan seguido queremos actualizar los cambios. Convenientemente, PouchDB tiene una opción “live” que tratará  de actualizar los datos lo más rápido posible, suena bien pero es mas costosa del lado de Cloudant, así que debemos usarla con mucho cuidado. Igual siempre podemos sincronizar manualmente cuando lo creamos conveniente.

Finalmente, los eventos nos indican como va el proceso. En resumen:

  • change (info) – Generado cada vez que se detecta un nuevo documento escrito.
  • complete (info) – Se genera cuando una sincronización manual termina o cuando se interrumpe una sincronización live.
  • paused (err) – cuando una sincronización live ha terminado y espera por nuevos cambios o cuando se ha interrumpido por algún err.
  • active – cuando una sincronización comienza o cuando se recupera de algún error.
  • denied (err) – cuando las credenciales son rechazadas por el servidor.
  • error (err) – cuando se genera un error irrecuperable como cuando se corta la red.
  • uptodate (deprecated) – Este evento ya esta de salida así que no lo usen

Ahora, como por arte de magia, agregaremos las líneas para activar la sincronización. La magía será en el archivo app.js.

// Ionic Starter App

// angular.module is a global place for creating, registering and retrieving Angular modules
// 'starter' is the name of this angular module example (also set in a <body> attribute in index.html)
// the 2nd parameter is an array of 'requires'
angular.module('starter', ['ionic'])

.run(function($ionicPlatform) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
	var key = 'bentareadyessharyinessee';
	var pass = 'OnEixgKgpt8LyEtl0S5DkAon';
	var remote = 'https://'+key+':'+pass+'@supermio.cloudant.com/news';
	var db = new PouchDB('news');
	db.replicate.from(remote,{live:true,retry:true});	
  });
})

Veamos, simplemente hemos agregado unas variables con el API Key y la clave de acceso y el url de la base de datos en Cloudant. Verán que estoy agregando las credenciales al url, sería algo asi: https://user:pass@servidor/basededatos.

En la línea 22 está la línea que hace la verdadera llamada a la sincronización donde hemos indicado un par de parámetros: live y retry que como su nombre lo indica, activarán la replicación “live” y en el caso de algún error, la replicación se intentará nuevamente.

Veamos como se ve la app hasta ahora en Chrome, primero en la consola:

gen17

Si vemos líneas con XHR significa que ya estamos sincronizando. Y para que me crean vamos al tab Resources:

gen20

Y ahí vemos nuestro documento!! Es cierto!

Guardemos ánimo para hacer lo que de veras hace falta que es presentar los datos.

Finalmente, Presentando los datos

Antes de presentar los datos debemos tomar en cuenta los eventos pues recuerden que la base de datos en el móvil comienza vacía y luego irán llegando las noticias debemos poder refrescar la vista. Los eventos ya los vimos así que recordemos que estamos haciendo una replicación “Live” y cuando acabe se generará un evento “paused”, también podríamos usar “change” pero este evento sólo funcionaría para los nuevos cambios. Si por alguna razón, la base remota y la local están iguales, el evento “change” no se generaría, mientras que “paused” si. Primero veamos como va la cosa con “paused”. Para eso agregamos las siguientes líneas a app.js justo después del comando de replicación:

.on('paused',function(info){
		db.allDocs({startkey:'news_\uffff',endkey:'news_',descending: true,include_docs:true})
		.then(function(result){
			$rootScope.$broadcast('refrescar',result.rows);			
		});		
	})

Veamos línea por línea:

  • Línea 23: agregamos un manejador para el evento “paused”. Fijense que el comando db.replicate no tiene el “;” al final, por lo que “.on” es una propiedad del comando “db.replicate”. Luego de la “,” tenemos la función que se ejecutará cuando ocurra el evento.
  • Línea 24: aquí viene el primer choque para los que venimos del mundo SQL. El comando “db.allDocs” es el comando más potente de PouchDB y de hecho de CouchDB también y permite recuperar documentos mediante el índice principal que si se habrán dado cuenta, incluye a todos los documentos en la base de datos. Inicialmente, allDocs recupera todos los documentos, pero toma parámetros para limitar un poco eso. Por ejemplo, aquí le hemos pasado los dos primeros “startkey” y “endkey” que se refieren a algo así como un like y como notarán la cadena que pasamos es “news_” y agregándole el caracter “\uffff” es como ponerle el asterisco, por lo que los dos primeros parámetros significan que debemos traer todos los documentos cuya clave comience con “news_” que gracias a la estructura de claves que fijamos es equivalente a decir que traiga todas las noticias en la base de datos. Seguidamente verán que hemos fijado “descending” a “true” y eso es por la fecha, si recuerdan la estructura de nuestra clave que era “news_fecha_autor_XXX” así que decirle que sea descendente significa que las noticias más recientes estarán al principio, lindo truco. Finalmente, con “include_docs” le decimos que nos traiga todos los datos en el documento, de lo contrario solamente tendremos la clave.
  • Línea 25: Aquí vemos una de las mayores características de aplicaciones NodeJS, Promesas. Dado que db.allDocs se ejecuta de forma asíncrona, no sabemos en que momento ejecutará la siguiente línea, así que con “.then” le decimos que al terminar, ejecute la función incluida.
  • Línea 26: La función que pasamos como promesa ejecuta una sola línea y esta es: “$rootScope.$broadcast” que en simple significa que se enviará un mensaje a todos los contextos indicando que un evento se ha realizado. El evento se llamará “refrescar” y tendrá como parámetros todos los “rows” incluidos en el objeto result, o más simple, todos los documentos recuperados desde la base de datos.

Y listo, hasta ahora hemos trabajado en lo que puede decirse que es el “Controller” de toda la aplicación y como no está asociada a ninguna vista, no podremos crear ninguna lógica que presente los datos. Entonces ahora tenemos que ligar la vista que tenemos ( osea “index.html”) con algún controller.

Primero en la vista “index.html” declaramos el controlador asi:

<body ng-app="starter">
    <ion-pane ng-controller="newsController">
      <ion-header-bar class="bar-stable">


<h1 class="title">Ionic Blank Starter</h1>


      </ion-header-bar>
      <ion-content>
      </ion-content>
    </ion-pane>
  </body>

En la línea 18 verán que hemos agregado la directiva “ng-controller” donde le indicamos a la vista que el controlador es “newsController”. Ahora definamos el controlador en el archivo “app.js”. Pongamos todo el código en el archivo pues los “;” y “.” se vuelven muy importantes:

// Ionic Starter App

// angular.module is a global place for creating, registering and retrieving Angular modules
// 'starter' is the name of this angular module example (also set in a <body> attribute in index.html)
// the 2nd parameter is an array of 'requires'
angular.module('starter', ['ionic'])

.run(function($ionicPlatform,$rootScope) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      StatusBar.styleDefault();
    }
	var key = 'bentareadyessharyinessee';
	var pass = 'OnEixgKgpt8LyEtl0S5DkAon';
	var remote = 'https://'+key+':'+pass+'@supermio.cloudant.com/news';
	var db = new PouchDB('news');
	db.replicate.from(remote,{live:true,retry:true})
	.on('paused',function(info){
		db.allDocs({startkey:'news_\uffff',endkey:'news_',descending: true,include_docs:true})
		.then(function(result){
			$rootScope.$broadcast('refrescar',result.rows);			
		});		
	})
  });
})
.controller('newsController',function($scope){
        $scope.notas='';
	$scope.$on('refrescar',function(event,news){
		$scope.$apply(function(){
                      $scope.notas = news;
                })
	})
})

Primero veamos todo el archivo en panorama y notaremos que el módulo ‘starter’ tiene propiedades “.run” y “.controller” que hemos definido. Esto se puede notar porque no hay “;” que los separe justo en la línea anterior. Ahora revisemos las líneas nuevas:

  • Línea 31: definimos el controlador ‘newsController’ y la funcion asociada que utiliza la entidad $scope. $scope es una entidad AngujarJS que identifica al ámbito definido en la vista que para nuestro caso es ‘index.html’ pero solamente en la sección donde está “ng-controller” definida. Para ponerla simple, nos permite declarar variables y funciones que serán visibles dentro de la vista.
  • Línea 32: declaramos una variable en el entorno llamada “notas”
  • Línea 33: Si la replicación envía eventos “paused”, pues es necesario que los recibamos en alguna parte así que aquí definimos que para cuando se reciba el evento ‘refrescar’, ejecutemos la función anexa la que toma dos parámetros: el evento y el objeto asociado donde están nuestros documentos.
  • Línea 34: En angular, si cambiamos el modelo tenemos que “aplicar” el cambio en el $scope
  • Línea 35: Finalmente, asignamos el array de documentos a una variable de entorno llamada “notas”

En la línea 34, sin notarlo, también estaremos usando una de las grandes potencias de AngularJS: “two-way data binding” que es el refresco automático de la vista cuando cambien las variables del entorno. Créanme que es mas fácil verlo que explicarlo.

Veamos, ya el controlador tiene los datos, así que vayamos a la vista a mostrar los datos. Para esto agregamos el siguiente código a “index.html”:

<ion-content>


 Hay {{notas.length}} noticias



<div class="list" ng-repeat="noticia in notas">


<div class="card">


<div class="item item-divider">{{noticia.doc.fecha}}</br>{{noticia.doc.titular}}</div>




<div class="item item-text-wrap"><b>{{noticia.doc.resumen}}</b></div>


			


<div class="item item-divider">Autor: {{noticia.doc.autor}}</div>


		</div>


	  </div>


      </ion-content>

Otra vez el línea por línea:

  • Línea 23: mostramos el tamaño de la variable notas y como es un Array de documentos acepta la propiedad length
  • Línea 24: Hacemos una lista para que se vean las noticias algo ordenadas mediante la clase CSS “list” y dejamos abierto el tag para agregarle otra directiva
  • Línea 25: al <div> de la lista le agregamos una directiva Angular para iterar en los elementos del array “notas” y a cada elemento lo conoceremos como “noticia”
  • Línea 26 a la 30: Cada elemento del array trae mucha información desde Cloudant, pero nos interesa uno en particular que es la propiedad “doc” que tiene todos los campos que hemos definido, así que lo incluimos. Además, incluimos el nombre de cada campo del documento noticia.

Graben y listo. Ya tienen su primera aplicación en Ionic con integración de base de datos local PouchDB y remota en Cloudant!!. Para ver más allá de lo evidente, pueden hacer la prueba agregando otro documento en Cloudant para que vean la potencia de la sincronización con PouchDB. Ya saben como agregar documentos a Cloudant así que tomen su reloj y tomen el tiempo que toma mostrarse la nueva noticia. Recuerden usar el formato para el campo “_id”: “news_fecha_autor_XXX”. En mi caso, el refresco fue casi instantáneo.

Y con esto podemos dar por terminado este largo Post con la satisfacción de tener una app completamente funcional. Para los que recién comienzan, los tags que vienen del mundo Ionic pueden confundir (<ion-pane>,<ion-content>, etc) pero no hay nada como leerse la documentación en la página de Ionic Framework pues está con ejemplos y todo. Para el caso de AngularJS, el peligro es que en javascript hay muchas maneras de hacer lo mismo y ya les adelanto que lo que les he explicado aquí es una forma muy simple de hacer las cosas. Una aplicación real hace la separación de la lógica en varios módulos, mientras que nosotros hemos usado uno solo para todo. Igual con las vistas, se suele tener muchas y no una sola. En lo que se refiere a Cloudant, hemos utilizado la instancia remota solamente cuando se sincroniza y luego la consulta a los datos ya es hecha localmente al PouchDB por lo que nuestro consumo será muy bajo. Además, si bien la sincronización “live” es muy potente, en una app real verán que a veces es mejor hacer una sincronización manual, sobre todo si sabemos que los cambios no se generan a cada rato, lo que nos permitirá ahorrar aún mas en Cloudant. Aún queda mas que aprovechar de Cloudant como las vistas (el famoso map/reduce de CouchDB), como manejar el almacenamiento, Sincronización filtrada  y algunas otras optimizaciones, todo con la seguridad de que sus datos están seguros y disponibles.

A ver si preparo el siguiente Post sobre vistas en Cloudant para poder combinar mas tipos de dato en el App y como generar sus apps para Android o iOS gracias a Ionic. Por ahora, jueguen con el app y modifíquenlo para que se vayan acostumbrando.

Mas información:

AngularJS: http://angularjs.org

Ionic Framework: http://ionicframework.com

PouchDB: http://pouchdb.com

IBM Cloudant: http://cloudant.com


Después montones de pruebas, ya publiqué mi app. Por ahora está en Windows Phone Store y en Google Play. Muy pronto en iOS.

Es un catálogo de comics publicados localmente, que les permitirá resolver el problema principal que como coleccionista he tenido que sufrir, ir al puesto de revistas y no saber cual cómic comprar o si es que ya salió el siguiente.

El app es muy simple en el uso, pero detrás tiene un par de cosas interesantes: Sincronización automática de datos y un código para 3 plataformas.

El código único está hecho en Cordova como les dije en un post anterior. Ionic Framework para ser exactos. Las ventajas que trabajar con esta herramienta son innumerables, pero me concentraré en decir que el ahorro de tiempo en programación es de lujo. El punto en contra podría ser que pierdes ciertas funciones nativas, pero me he dado cuenta que el real problema es otro: Interfase de Usuario nativa. Con Ionic, la interfase de usuario es HTML5 donde no hay Panoramas ni Pivots que hay en WP8, por lo demás, hay alternativas que puedes salvar. Entonces, a fin de que sus usuarios no se quejen, aprendan algo de CSS y de SASS y si pueden contraten a un buen diseñador. Si es que no tienen esa virtud de diseñar pantallas bonitas, hagan como yo, manténganlo todo simple. Igual les prometo que contrataré un diseñador para mejorar la presentación.

La sincronización automática se logró mediante la plataforma CouchDB. Para ser exactos, los datos están en un servidor Cloudant y en el cliente utilizo PouchDB, de tal forma que todos los datos son locales para la aplicación. Si es que se publican colecciones o comics nuevos, la data se sincroniza (sólo las diferencias) y desde ese punto todo es local. Ahora bien, existe un modo de sincronización que permite que los datos sean replicados en tiempo real, como resultado de las pruebas he llegado a la conclusión que sólo tiene que ser activado en algunas situaciones limitadas, por dos razones: Costo del tráfico y batería.

CouchDB es super inteligente para sincronizar, y si le dices que quieres hacer una sync “live” se va a encargar de tener los datos en el móvil super actualizados, y con PouchDB eso significa que se mantenga una conexión abierta con el Servidor la mayor parte del tiempo. Esto consume tráfico, batería y todo lo que puedas imaginar. Además, Cloudant te cobra por HTTP Request, lo que significaba, para el caso de mi app, mandar una transacción “pesada” cada 25 segundos por cada móvil. Haciendo las matemáticas, es mucha plata considerando que las publicaciones de comics se hacen por lo general cada semana. En JavaScript hay un método maravilloso llamado SetTimeOut que permite establecer un método donde el app sincroniza todo al iniciar y luego decirle que vuelva a sincronizar a los n minutos. De esa manera puedo hacer que las apps sólo sincronizen cuando es realmente necesario. Como por ahora no se cuantos usuarios pueda tener, mi estrategia de sincronizacion es cada 10 minutos si es que no se ven cambios y cada 100 minutos si es que se obtuvieron cambios, es decir, como los cambios los publico una sola vez, si los descargas, ya no volverás a ver otro lote de cambios hasta dentro de un largo tiempo, así que 100 minutos es el largo tiempo por ahora. Esto debe soportar las nuevas funciones que pienso introducir en el siguiente release.

Entre los principales problemas que tuve es el hecho de trabajar en un código único es posible mientras no tengamos que ver cosas muy pegadas al móvil. Por ejemplo, hay plugins para manejar beeps o para el manejo de estadísticas que sólo funcionan en el móvil haciendo las tareas de debug  bastante tediosas. Así que lo ideal es empezar el proyecto sabiendo que plugins se van a utilizar, para lo cual hay que certificarlos antes y probar que funcionan tal como deben. Por ejemplo, yo les comenté en un Post anterior que utilizaría Angulartics para el manejo de estadísticas, pues resulta que no trabaja tan fácil como lo pensé, y no es que el código sea complicado, simplemente tiene sus lios y listo. Gastar tiempo en investigar esos errores dentro del proyecto es una pesadilla, así que hagan su propio catálogo de plugins que ustedes hayan certificado y tendrán la ventaja.

Por el lado de los datos, PouchDB (o CouchDB como quieran) es un estándar que lo único que tiene fuerte es la sincronización y el manejo de los formatos de base de datos. Quiere decir que consultar los datos puede llegar a ser algo especial. Felizmente PouchDB es manejado por un tipo muy buena onda que se llama Nolan Lawson que está creando librerias y herramientas muy potentes que ayudan a bajar la complejidad, pero lo que si es un hecho es que NO ES SQL, así que hay que meterle algo de cabeza al inicio, como por ejemplo, crear llaves primarias con fecha y datos de la clase padre (plop!) y demás trucos que están todos documentados que en sistemas SQL ni te imaginas. Igual todo vale la pena porque funciona como un reloj suizo.

Un punto importante es el tema de los formatos de base de datos. Hasta ahora, SQLite ha sido la opción única para manejar datos en el móvil y resulta que es un estándar que ya fue. WebSQL definía el uso de archivos sql en aplicaciones HTML5 y actualmente ha sido reemplazado por IndexedDB que es como un super diccionario. El problema aquí es que SQLite sigue siendo muy veloz, y algunas plataformas ya han dejado de lado SQLite, como por ejemplo FirefoxOS y parece que Windows Phone 8.1 también. En fin, para evitar tener que recodificar ese soporte, PouchDB nos facilita la vida haciendo esa gestión por nosotros, si el sistema soporta WebSQL, lo usa y si sólo soporta IndexedDB, cambia todo tras bambalinas, genial. Tiene otros soportes, pero con estos dos es suficiente. Para los curiosos, PouchDB también trabaja en la PC para lo cual utiliza LevelDB que es otro rollo en base de datos para aplicaciones Web.

En conclusión, ya pueden probar mi App que principalmente les permitirá ver que un app puede tener datos actualizados de forma transparente y que comparte un código para todas sus plataformas, así no sean coleccionistas de comics.

Google Play Store:

Get it on Google Play

Windows Phone Store:

154x40_WP_Store_blk

 

Muy pronto para iOS:

 

NOTA FINAL: Disculpen los banners, pero también son parte del experimento

 





%d bloggers like this: