Publicar librerías aar en un repositorio maven en Github

Desde que Android Studio nos lanzó al mundillo de Gradle cada vez da más rabia encontrar librerías que no podemos incluir en nuestro proyecto con un simple compile. Así que, va siendo hora de tener un método fácil de publicar nuestras librerías sin tener que pasar todo el proceso de publicación de Maven Central, que es bastante pesadito.

La idea es tener un repositorio de Github que actue como un repositorio de Maven. En este ejemplo utilizo Github, pero en realidad funciona para cualquier sistema con capacidad de compartir archivos, como por ejemplo BitBucket o incluso un servidor web propio.

Crear el repositorio local

Lo primero que necesitamos es una carpeta local donde establecer el repositorio. Por ejemplo, D:\m2-repo. Aquí en realidad alojaremos dos repositorios, uno para artefactos release y otro para artefactos snapshot. Simplemente tendremos dos subcarpetas con esos nombres. El sistema que seguimos ya las creará cuando las necesite.

En esta carpeta creamos un repositorio Git y lo enlazamos con nuestro repositorio Github. Si quieres utilizar otro sistema de publicación pues aquí es donde toca configurarlo.

Crear y configurar el proyecto de Android con la librería

Para simplificar, damos por supuesto que tenemos dos módulos, uno con la librería y otro módulo de aplicación que utilizamos para pruebas o samples.

Ahora toca aplicar el script de Gradle para publicar en Maven. Incluimos la siguiente referencia al final del fichero build.gradle de la librería:

Este es un script de Gradle que he creado a partir del script de Chris Bane. La gran diferencia es que el suyo está pensado para publicar en servidores Maven, por lo que aquí he quitado todo lo relativo a credenciales, ya que el repositorio Maven destino es una carpeta local del disco. También he modificado un par de cosas que fallaban con la última versión de Gradle.

Si lo prefieres, puedes sustituir esta linea por el contenido del script para tenerlo todo localmente. Up to you.

Las instrucciones de configuración están en el proyecto de Github: gradle-local-mvn-push. No las reproduzco aquí por no hacer este post eterno.

Generar y publicar

Una vez lo tenemos todo configurado, sólo tenemos que invocar las tareas de Gradle necesarias desde la raíz del proyecto:

Si usamos el wrapper desde Windows, hay que cambiar gradle por gradlew.

Esto generará los artefactos necesarios y los copiará en la carpeta del repositorio Maven, con sus sources, su javadoc y todo lo necesario.

Ahora sólo hay que subir el repositorio Maven a Github y nuestra librería estará lista para ser utilizada con un simple compile.

Primero añadimos nuestro repositorio como

y luego incluimos la librería deseada

¡Y listos!

Ya no dependemos de Maven Central y podemos publicar nuestras librerías donde queramos.

Este post va dedicado. Para DG que es la fan número 1 de este blog.

La navaja suiza de Android

Un pequeño listado de aplicaciones y sitios indispensables cuando trabajas con Android. Lo que yo llamo la navaja suiza:

Flat UI Colors: Listado de colores “planos” para utilizar en nuestras apps. Selecciona formato, haz clic en un color y ¡voilà! lo tienes en el portapapeles.

Android cheat-sheet for Graphic Designers: Una chuleta exhaustiva sobre cosas relacionadas con el diseño de apps. Para los que no somos capaces de recordar cosas como el tamaño de los iconos en cada densidad.

Android Holo Colors: Selecciona color, versión, controles y automáticamente nos genera un zip con los drawables y styles necesarios.

Android Asset Studio: Impresionante conjunto de generadores de assets para Android

Parcelabler: Hacer un objeto parcelable es bastante lento y tedioso. Con esta página, tan sólo pega el código de tu clase y a cambio la recibes completamente “parcelablizada”.

Android Layout Finder: Uno de mis favoritos. Pega un layout, elige los widgets/layouts que quieres y te genera el método findViews() de un layout, o todo un Adapter con ViewHolder y todo en el que sólo hay que rellenar el pintado de datos. Gracias a @EsteveAguilera por encontrarnos esta joya.

Android Layout/Style XML Converter: Muy útil para extraer estilos de un layout.

Jsonschema2Pojo: Genial página que nos propone un pojo a partir de un json. Además, permite añadirle anotaciones para Gson o Jackson.

Roman Nurik’s View Server: Pequeña librería que nos permite ejecutar el Hierarchy Viewer contra nuestra app aunque el dispositivo no esté rooteado.

¿Conoces más? Pues comparte en los comentarios e ire ampliando la lista.

Actualización 24 de julio

Algunas cosillas más que he ido obteniendo:

DPI calculator for Android: un rápido conversor entre DPIs. También disponible como extensión de Chrome.

Gradle, please: un buscador de dependencias en formato Gradle. Muy util para incluir rápidamente a los sospechosos habítuales.

Android drawable generator: esta web genera el tag para un objeto button y el drawable necesario. Multitud de parametros personalizables. Lástima que no haga también los múltiples estados.

APK Downloader: se supone que permite descargar apks no disponibles en tu país desde Google Play, pero nunca he conseguido hacerlo funcionar, ya que tenían muchas limitaciones de número de descargas diarias. Según dicen, ya está solventado.

Android Design Tips: una chuleta con cosas básicas de diseño y UI (tamaños, márgenes, etc). También incluye un conversor de DPIs

The Android Arsenal: repositorio de librerías y componentes clasificados por categorías.

WSDL2Code: últimamente me está tocando atacar servidores SOAP. Esta ultra-útil página genera la capa cliente de Android a partir de un WSDL. Generar, copiar, y utilitzar.

Actualización 3 de agosto de 2014

Mockup Phone: un sistema rápido de hacer mockups de capturas de pantalla. Rápido y fácil:

The Android swissknife

This is a comprehensive list of applications and websites that will make your life much easier when developing Android apps, or at least, my life will be much harder without them. I call it the Android swissknife.

Flat UI Colors: A list of flat colors to use in our apps. Select the format, click the color, and it will be copied to your clipboard.

Android cheat-sheet for Graphic Designers: A big cheatsheet about UI and design related concepts for Android apps. For those like me, who can’t remember the specific size of each icon on each density.

Android Holo Colors: Select the colors, version, controls, and hop! you have a zip file with all the needed drawables and the theme.

Android Asset Studio: Amazing set of assets generators for Android

Parcelabler: Making objects parcellable is boring as hell. With this page, just paste your class code and it will generated a “parcelled” version. Easy peasy.

Android Layout Finder: One of my favorites. Just paste a layout, select the widgets and views and it will automatically generate a findViews method, or an Adapter (even with a ViewHolder). Thanks @EsteveAguilera for sharing it.

Android Layout/Style XML Converter: From layout to style and back.

Jsonschema2Pojo: this is a great one. It generates a pojo from a Json file. You can choose if you want to use Gson or Jackson annotations (and your’ll learn a lot seeing how it does some things).

Roman Nurik’s View Server: This library allows us to use the Hierarchy Viewer from a device apk even if the device is not rooted.

Am I missing something? share in the comments and I’ll update the list.

Update – July 24th

Some other niceties:

DPI calculator for Android: quick DPIs conversion tool. Also available as a Chrome extension.

Gradle, please: a gradle-format dependencies search tool. Useful for the usual suspects.

Android drawable generator: this web generates all the xml stuff for buttons with a lot of settings to play with. It’s a pitty it doesn’t make multiple states.

APK Downloader: this one is supposed to let you download apps from Google Play that are not allowed in your country, but I never managed to make it work as they had a lot of limitations on daily downloads. According to their latest comments, now it works much better, I didn’t tested it lately.

Android Design Tips: another design cheatsheet with a dpi conversion tool

The Android Arsenal: a library and views repository classified by categories.

WSDL2Code: in the last times I had to consume data from SOAP web services. This website will generate pure Android code to access these services from the WSDL specification.Generate, paste and use

Looking for the perfect Android architecture II: General architecture of an app

Hello!

Today, I’m going to talk about the architecture I use to apply on my apps. First, a few basic guidelines I always respect:

  • This is intended for client apps attacking a REST api (or similar). This is not valid for games or certain stuff.
  • All data should be persisted. If you respect your user then persist the data!
  • The local database it’s not a database per se, it’s a cache.
  • The real database is located on the server and we only have a part of it. Keep this always in mind.
  • I would sometimes ignore the normal forms for simplicity and performace sake. It does not matter, remember, I’m just a cache, the good database with normalized data is on the server.
  • The splash screens on Android apps are evil.
  • The style guide is sacred. It only can be ignored to innovate and improve. I don’t know anyone capable to do this. Doing it differently does not mean innovation. Doing it like in iPhone it’s not innovation.
  • My rules are mine and I skip then whenever I want.

General architecture by layers

For a couple of years I worked with Code Igniter, an excellent Framework MVC in PHP (yes, I have a past as PHP developer, I was young, I needed the money). I’m sorry, but I don’t think Android is MVC. This is like discussing the sex of the angels, there will be people agreeing with me and others not, so we will assume that our architecture is NOT based on MVC.

When talking about layers, I split the application between Frontend and Backend. Or as I use to call them: ui and sdk (or core).

In fact, in big projects I usually create the sdk in a library project and the ui in a main project. This helps a lot to separate these two layers and to distribute the work.

On the ui layer I got everything in charge of managing the interface: activities, fragments, views, adapters, etc. All of them, data consumer objects.  It can be that something else is included here because of Android nature, even if they are not ui, like object Application, Notifications, Push, NFC handlers, etc.

On the other side, on the sdk layer (the one with the main part) I got the parts managing the data: beans, clients, ContentProviders and tasks (and some other things such as helpers).

The UI layer

We will talk deeply about this one with examples another time. By now, here go some overviews and rules I use to follow.

All the elements from this layer are included inside the ui package. So, we will have ui.activity, ui.fragment, ui.adapter, ui.view, etc.

All classes have as suffix what they are , for example,  MainActivity, FooAdapter, etc.

Each element has a set of public constants, final and static that start with EXTRA with the name of the parameters that can be expected in the bundle provided to this class.

The Intents between activities and fragments do not send full objetcs (and even less arrays). They only send the object id. For example, if I have an activity (or fragment, in this case it’s the same) ProductListActivity with a list of products when selecting one I invoke the following activity ProductActivity I just only send the id and this second one invokes the content provider to return the record and to read it. If the data can change during the view by external elements I use a loader to show the details, and it receives notifications from content providers.

The adapters ALWAYS uses ViewHolder.

The SDK layer

This layer is the one in charge of data input and output to the server and its persistence. See below a graphic with the main elements:

android architecture

A review on the packages I use to create the what’s included in each:

  • bean: all the data objects. Maybe you call them DTO, domain or something similar. No problem. But I make no difference here. I try the beans to be as POJO as possible and I don’t make them getters or setters. They are simple structures with annotations for the JSON deserialization.
  • client: These are the representations of the web services. For example, a LoginClinet class invokes the login service , manages the answers and returns it processed. I use a a structure from simple IntentService that invokes the web service that the client provides as parameters. We will discuss about this topic on another article. The advantage of the system is that you make easily a lot of  clients. Here takes place the serialization/deserialization to JSON ( or what ever it’s needed).
  • model: all the persisted data model, on the root I place the data contract, the set of constant that define tables, fields and entities of the content provider. In some cases, when the applications are quite big, I split the database contract and the one from the content provider. But please take into account that then the maintenance is complex and tedious.
  • model.content: the content provider, following the structure explained in previous article with DespicableContentProvider and MinionContentProvider
  • model.cursor: here I have one CursorHelper per entity. Basicaly, they are in charge of passing from cursor record to object and viceversa.
  • model.db: contains DatabaseHelper and similar.
  • service: the IntentService invoked by clients, and any other service that might be needed.
  • task: these are atomics process that invoke clients and ContentProviders. For example, the typical task of UpdateProductsTask invokes GetProductsClient, makes a delete over the Content Provider of products and then a bulk insert. This process has an output showing if it has been successful or not.

The key is also in my library to accessing web services called Rarest. For more information, please check www.rarestandroid.com.

On the next article we will see a nice example showing the above explained.

En busca de la arquitectura de Android perfecta II: arquitectura general de una app

¡Hola!

Hoy voy a hablar de la arquitectura que suelo seguir en mis apps. Para empezar, unas cuantas normas básicas que siempre sigo:

  • Estoy hablando de apps cliente de una api REST (o similar). Esto no sirve para juegos ni para según que cosas.
  • Todos los datos van a ser persistidos. ¡Si respetas a tu usuario, persiste los datos!
  • La base de datos local no es una base de datos per se, es una caché. La base de datos de verdad está en el servidor, y nosotros sólo tenemos una parte de ella. Tengamos esto siempre en cuenta.
  • Me permito ignorar algunas veces las formas normales en pro de la simplicidad y el rendimiento. Total, sólo soy una caché, la base de datos buena y con datos normalizados está en servidor.
  • Las pantallas de splash en apps de Android son el demonio
  • La guía de estilo es sagrada. Sólo se puede romper para innovar y mejorar. Todavía no he conocido a nadie capaz de hacerlo. Hacerlo diferente no es innovar. Hacerlo como en iPhone no es innovar.
  • Mis reglas son mías y me las salto cuando quiero

Arquitectura general por capas

Durante un par de años trabajé con Code Igniter, un excelente Framework MVC sobre PHP (sí, tengo un pasado como programador de PHP, era joven, necesitaba el dinero). Y yo lo siento, pero por más que miro, no creo que Android sea MVC. Esto es discutir el sexo de los ángeles, hay gente que está de acuerdo conmigo, y gente que no, así que vamos a partir de la idea de que nuestra arquitectura NO se va a basar en MVC.

En cuanto a capas hablamos, yo divido la aplicación en Frontend y Backend, o como les suelo llamar, ui y sdk.

De hecho, en grandes proyectos suelo montar el sdk en un proyecto librería y la ui en un proyecto principal. Esto ayuda mucho a separar estas dos capas y a distribuir el trabajo.

En la capa ui tengo todo aquello encargado de gestionar la interfaz: activities, fragments, views, adapters, etc. Todo ello objetos consumidores de datos. Cae alguna cosilla más que a veces tiene que estar aquí por la idiosincracia de Android aunque no sean ui tal cual, como el objeto Application, Notifications, el Push, etc.

Por otro lado, en la capa de sdk (que tiene la chicha) tengo lo que gestiona los datos: beans, clientes, ContentProviders y tareas (y algunas cosillas más del tipo helpers).

La capa UI

De esta hablaremos otro día a fondo con ejemplos, de momento ahí van algunas generalidades y normas que uso.

Todos los elementos de esta capa los incluyo dentro del paquete ui. Así tendremos ui.activity, ui.fragment, ui.adapter, ui.view, etc.

Todas las clases tienen como sufijo lo que son, por ejemplo MainActivity, ForlayosAdapter, etc.

Cada elemento tiene un conjunto de constantes públicas, finales y estáticas que empiezan por EXTRA con los nombres de los parámetros que pueden ir en el bundle del intent de llamada.

Los Intents entre activities y fragments no se mandan objetos enteros (y mucho menos arrays). Sólo se mandan el id del objeto. Así por ejemplo, si tengo una actividad (o fragment, ahora da igual) ProductListActivity con una lista de productos, al seleccionar uno invoco a la siguiente actividad ProductActivity sólo le paso el id, y esta segunda invoca al content provider para que le retorne el registro y lo lee. Si además los datos pueden cambiar durante su visualización por elementos externos, utilizo un loader para mostrar el detalle.

Los adapters SIEMPRE con ViewHolder.

La capa SDK

Esta capa es la que se encarga de la entrada y salida de datos hacia el servidor y de la persistencia de la misma. Aquí u gráfico con los elementos principales:

android architecture

Repasemos los paquetes que suelo crear y que hay en cada uno:

  • bean: pues aquí van todos los objetos de datos. ¿qué tu le llamas DTO, domain o algo así? pues bién, no me pelearé por eso, pero lo que no hago son distinciones. Cada vez intento que sean los más POJO posibles y no les hago ni getters ni setters, vamos, que son estructuras tontitas con anotaciones para la deserializacíon JSON.
  • client: aquí todos los clientes. Son las representaciones del los servicios web. Por ejemplo, una clase LoginClient invoca al servicio de login, gestiona la respuesta y nos la devuelve procesada. Uso una estructura de IntentService tonto que invoca al servicio web que el client le pasa como parámetros. Ya hablaremos de esto en otro artículo. La gracia del sistema es que haces los client como churros. Aquí se produce la serialización/deserialización a JSON (o lo que toque).
  • model: aquí todo el modelo de datos, en la raíz coloco el contrato de datos, el conjunto de constantes que definen tablas, campos y entidades del content provider. En algunos casos cuando las aplicaciones son muy grandes, separo el contrato de base de datos y el de content provider, pero ojo que entonces el mantenimiento es farragoso y complicado.
  • model.content: los content provider, siguiendo la estructura del artículo anterior con DespicableContentProvider y MinionContentProvider
  • model.cursor: aqui tengo un CursorHelper por entidad. Básicamente se encargan de pasar de registro del cursor a objeto y viceversa
  • model.db: el DatabaseHelper y similares.
  • service: aquí va el IntentService que invocan los clientes, así como cualquier otro servicio que pueda necesitar.
  • task: son procesos atómicos que invocan clientes y ContentProviders. Por ejemplo, la típica tarea de UpdateProductsTask invoca a GetProductsClient, hace un delete sobre el Content Provider de productos y luego un bulk insert. Este proceso tiene una salida indicando si ha ido bien o mal.

El meollo de esto está también en mi librería de acceso a servicios web llamada Rarest. Teneis info en www.rarestandroid.com.

Ale, el próximo día veremos un lindo ejemplo con todo esto.

Looking for the perfect Android architecture I: Despicable Content Providers

I’ve been looking for the best architecture for an Android app. I’m not looking for the best speed or performance, but they should be acceptable. It should be quite Android-compliant and above everything, easy to replicate. My final target is to have a foundation for new projects (pro and personal ones) and be able to say “this is the way I work”. I have a lot of ideas in my mind, but without sharing or discussing them, they are worthless. So, let’s share them, discuss them and let´s improve together.

I’ll start talking about Content Providers (CP). I’m assuming that you know what they are and how they work, and also about SQLite and all the related stuff. If you don’t know about these topics, check out the tutorial from our friend Vogella at  http://www.vogella.com/articles/AndroidSQLite/article.html.

Check section 9.4 of that tutorial. You’ll see the structure of a CP. Basically, four functions, one per operation (query, insert, delete and update) with an structure like this:

I hate the switch statement. I think is ugly and unmaintainable. Also, the example is using only two URLs, but an app with 20 entities will easily become a God class.

My proposal is an structure I call the DespicableContentProvider. Why? because it has MinionContentProviders (I know, don’t use cute names, but I couldn’t resist and the analogy helps a lot to understand it). If you don’t know anything about Despicable and Minions, chech this: http://www.youtube.com/watch?v=jzpOLs1t8Hg

You can check the code both for the Despicable base class and the Minion base class at https://gist.github.com/sergiandreplace/8165986. Free, cute and distributables.

Before start working with them, let’s see some rules I follow when working with CP:

  • The CP works like a web api. Authority is the host name.
  • Every url is an endpoint for an entity.
  • Urls are like content://<authority>/<entity>[/#id].
  • Urls ending with an id are asking for an specific element and are type Item. Other ones are Dir type (for coherence with MIME types)
  • Mime type will be vnd.android.cursor.{dir|item}/vnd.{AUTHORITY}.{ENTITY}. My CP are usually private for the app, so I don’t care too much about MIME types.
  • CP consumers know NOTHING about the database. In fact,  the only one accessing the database is the CP. Even for big projects I use different contracts. One for the database and another one for the CP consumers.
  • When performing an Item request (one with an id in the url) all the filtering parameters are ignored (I’m already asking for only one, why filter?)

Basically, every Minion knows how to perform an Insert, Update, Delete or Query against an entity for an Item or a Dir (not both). Here is an example:

Basically I’ve implemented three things, first getBasePath, that returns the specific url path to the entity, getType function, that returns the name to be used to indentify this entity as MIME type, and the four operations for this specific entity. The main difference with the CRUD opeartions are that you receive the db object via parameter and you don’t need to notify the change as the Despicable will do it.

An Item type is very similar:

The main differences are:

  1. Class name is singular (it’s my way…)
  2. Return path now includes /# as per UriMatcher syntax
  3. On each one of the CRUD operations we ignore the parameters received for filtering and we just query by _id
  4. In this case, I’ve decided you can’t insert an Item specifying an id in the path. This is just an example, and real behaviour will be domain-specific.

Easy peasy, isn’t? So we only need to create one per entity.

Once we have the Minions, let’s work on the Despicable. Check this:

GetAuthority method just returns the name of the authority. It’s used by the parent class to retrieve it on runtime. The method getDb should return a database to work with. The recruitMinions method is responsible to add an instance of each Minion to the collection of the Despicable.

That’s it. Quite cool, isn’t it. At least is tidier and easier to maintain.

Now, our CP implements the  four operations for each entity, and also a bulk insert that just executes the insert in a loop inside a transaction.

And for the same price, a couple of helping functions I usually include in the CP.:

They are very useful in the contract and the CursorHelpers that will be discussed in next entry.

I’d love to receive comments about this and see other points of view and ways of working with CP. And also, any suggestion or improvement will be very welcome.

En busca de la arquitectura Android perfecta I: Despicable Content Providers

Desde hace tiempo vengo buscando cual puede ser la mejor arquitectura de una aplicación Android. Ojo, no tiene por que ser la mejor en cuanto a rendimiento o velocidad, pero tiene que dar un buen rendimiento, ser lo más Android-compliant y sobre todo, fácil de replicar. Mi objetivo no es más que sentar las bases para nuevos proyectos (tanto profesionales como personales) y decir “pues yo trabajo así”. Tengo muchas ideas en la cabeza, pero sin compartirlas y discutirlas, pues no hay manera, así que voy a ir compartiendo algunas de estas ideas, y a ver que sucede.

Hoy empezaré por los ContentProviders. Voy a asumir que ya sabes que es y como funciona un ContentProvider y el acceso a SQLite. Si no lo sabes, mírate el tutorial del amigo Vogella en http://www.vogella.com/articles/AndroidSQLite/article.html. Si os fijas en el punto 9.4 del tutorial, vereis que el estructura el ContentProvider de la siguiente manera por cada una de las operaciones (query, insert, delete y update):

Odio el switch. Me parece la estructura más fea y poco mantenible que existe. Además, en el ejemplo, sólo utiliza dos URLs, pero imaginad una aplicación donde tengo 20 entidades. Vamos, lo que viene siendo una clase Dios.

Mi propuesta para esto es lo que denomino el DespicableContentProvider. ¿Y por qué lo llamo así? Por que tiene MinionContentProvider (lo se, don’t use cute names, pero no pude resistirme, y la analogía se entiendo muy bien). Si no sabes de que va lo de Despicable y Minions, mira esto: http://www.youtube.com/watch?v=jzpOLs1t8Hg

Todo el código base, tanto del DespicableContentProvider como del MinionContentProvider están en https://gist.github.com/sergiandreplace/8165986 y son bonicos, libres y distribuibles.

Antes de todo, establezcamos como uso los ContentProvider y cual es mi approach:

  • El ContentProvider (CP a partir de ahora) lo veo parecido a una api web.
  • Cada url representa una entidad.
  • Las url estan formadas por content://<nombre de la autoridad>/entidad[/#id].
  • Las url acabadas en id estan pidiendo un elemento específico, y las conocemos como tipo Item. Las otras son tipo Dir (por coherencia con los tipos MIME)
  • El tipo mime será vnd.android.cursor.{dir|item}/vnd.{AUTORIDAD}.{ENTIDAD}. Mis CP suelen ser internos no publicados, así que el tipo MIME me da un poco igual.
  • El consumidor del CP no sabe NADA de la base de datos. En realidad, lo monto para que el único que tenga acceso a la bd sea el CP. Incluso los contratos son diferentes, uno para la bd y otro para el CP (a menos que sean algo muy pequeño).
  • Cuando una petición es de tipo Item, es decir, pido uno con un id espécifico, los parametros de filtrado son ignorados (si ya pido uno ¿para que quiero filtrar?)

La idea básica de esta estructura es que cada Minion sabe hacer Insert, Update, Delete y Query de una entidad para Item o para Dir (no ambos). Veamos un ejemplo:

Como veis, he hecho tres cosas, por un lado getBasePath que devuelve la url específica de la entidad, getType, que devuelve el nombre básico para construir el tipo MIME si queremos, y hemos implementado cuatro funciones muy parecidas a las de un ContentProvider normal. Las diferencias son, que por un lado recibo el objeto db para poder lanzar las aplicaciones y no notifico el cambio al acabar.

Uno de tipo Item no tiene mucha diferencia:

Diferencias:

  1. La clase en singular (soy así…)
  2. El path incluye el /# según la sintaxis del UriMatcher
  3. En cada operación, decidimos ignorar los parámetros que recibimos y filtramos por el id de la ruta a piñón.
  4. Decido que el insert de Item no se puede hacer. No hay razón para esto, era por poner un ejemplo. La otra opción sería cambiarlo en el contentValues por el de la url antes del insert. Ahí ya depende de vuestro modelo.

¿A que es facil? Pues creariamos uno de estos por cada entidad Dir o Item  y ale.

Una vez hechos, hay que implementar el Despicable. Que ya vereis que facil:

El método GetAuthority sólo devuelve el nombre de la autoridad que vamos a utilizar. Es usado por la clase padre. El método getDB() debe devolver un objeto Database con el que trabajar. Y el método recruitMinion se encarga de añadir cada uno de los Minions a la colección instanciando las clases que heredan de MinionContentProvider.

Y ya. Mirad que bonico todo.

Ahora nuestro CP ofrece todas las operaciones en cada minion, incluso, de regalo, un bulkInsert que ejecuta un loop de inserts dentro de una transacción.

Ah, suelo añadir estos dos métodos de regalo en el ContentProvider:

Son muy útiles en los contratos y los CursorHelper, que es algo de lo que hablaré el próximo día.

Me encantaría recibir comentarios al respecto y ver como vosotros abordáis el problema. Y cualquier sugerencia, ya sabes, será bienvenida.

Mails para mi concuñado II – Internet no existe

Segundo mail que le mando a mi cuñado. Parece que el primero le gustó, así que sigo taladrando. Creo que en el próximo le meteré el vi por vena, a ver si sobrevive (mwahahaha)…

Internet no existe. Bueno, existe, pero no es “nada”, es una amalgama de muchas cosas.

Cuando hablamos de redes informáticas se suelen dividir en tres tipos, lan, wan, y man la primera (local access network) es la red de tu casa o la mia, la segunda (wide access network) es la de por ejemplo una empresa o entre varios edificios, etc. La tercera (metropolitan access network) es una red accesible en toda un ciudad (ej: la wifi de bcn). Aunque esta división ha quedado un poco anticuada.

Pues bién, Internet no es más que un conjunto de wanes, lanes y manes. Pero muchas. Muchisimas. Cuando nació en los 50 existían mapas con las redes y los ordenadores puestecitos, pero enseguida fué indibujable debido a la gran cantidad.

¿Y como se aclaran los ordenadores en estas lanes, wanes y manes? pues con protocolos. Un protocolo no es más que un conjunto de reglas que especifican como comunicarse. Hay protocolos para aburrir, y suelen estar especificados en reglas definidias por comités como el IEEE (esto igual te suena de electróncia), la ISO, o los conocidos RFP (request for proposal) RFC (Request for comment).

Hay protocolos para enrutar señales y protocolos para dibujar en pantalla. ¿Cómo nos aclaramos? pues como dije en el mail anterior, por CAPAS. TODO son capas. Las redes se suelen especificar a partir de un sistema de capas llamados OSI (de la ISO, el que inventó la siglas ese dias estaba de cachondeo). Esto divide la red en siete capas (el próximo dia te las recito de memoria, que me las se). Al final son teoricas, y cada protocolo de red establece un poco las que quiere, pero siempre con estas en mente.

Las capas de más abajo, son más “cercanas” al hardware, las de más arriba son más cercanas a “a la persona” (esto hay que tomarlo con pinzas, que estoy siendo super generalista). ¿Te suena esto de alto y bajo nivel?

Así, por ejemplo, el router con el que te conectas al interné, actua en capas bajas, mientras que firefox actua en capas medias-altas (vas pillando la idea?)

A la hora de resolver problemas ayuda mucho moverse por capas, de arriba a abajo o viceversa (depende del caso) para ser ordenador. Por ejemplo, si no puedo navegar por internet, antes de mirar si mi proveedor de internet me la esta jugando, miro si puedo comunicarse con el router. Si esto no sucede, ya no hace falta que mire más “arriba”, el problema está en mi router, mi ordenador o entre ambos.

Entonces, tenemos cosas abajo, y cosas arriba funcionando. Las de arriba se basan en las de abajo. Si mi tarjeta de red (capa 0 o 1, según) está rota, pues no puedo ver páginas web (capa 7).

Además, cuando dos ordenadores se comunican en Internet, se comunican de capa a capa. Es decir, si estoy usando un servicio de capa 6 para conectar a otro ordenador, pues la “señal” baja a la capa 0, llega al otro ordenador, y vuelve a subir a la capa 6. En teoría, es una comunicación de capa 6 a capa 6.

En la práctica, no hablamos de capas, si no de servicios. Algunos servicios serán más altos y otros más bajos, pero son servicios.

Cuando vemos una página web, estamos haciendo uso del servicio HTTP, cuando chateas por Google Talk, estamos usando el servicio XMPP, cuando envias un mail, estas usando el servicio SMTP, y cuando recibes, el POP3 o el IMAP, depende del formato de correo. Hay hasta aburrir. TODO lo que usas en internet son servicios.

Vamos a empezar a poner nombres a las cosas.

Lo más básico que tenemos es TCP/IP. Es lo que se conoce como el protocolo de red, y todos los servicios que he comentado, funcionan sobre él. Existen otros protocolos de red, pero en la actualidad, casi que sólo se utiliza este (hablo de uso común, cosas raras hay a miles).

En redes TCP/IP, cada conexión tiene una (o más) dirección de red. Está dirección de red está formada por 4 bytes (32 bits) y se suele mostrar como cuatro cifras de 1 byte, por ejemplo 192.168.1.1, conocidas como dirección ip (de TCP/IP v4, las de v6 son diferentes).

Tengo un libro entero de 500 páginas SÓLO hablando de esto. Es complejo, denso, y no espero que entiendas la mitad de lo que explico, pero es bastante entretenido.

Entonces, si yo quiero acceder a un servicio en una máquina, necesito saber tres cosas:

1. Su dirección IP
2. El servicio que estoy usando
3. el puerto

Anem a pams.

1. Abre la terminal y haz “ping www.google.com”

Verás como te dice algo así como “reply from 173.194.41.244″ (el número puede cambiar). Ese es un truco para saber la dirección ip de una dirección.

¿Recuerdas que he dicho que todo eran servicios? pues aquí hemos usado dos. Por un lado, el DNS, que traduce nombres a direcciones IP. Si no fuese por el, no tendriamos urls (el tipico www.hhh.jjj…). Y además, el ICMP que es un protocolo de control. Vamos, el ping. Esto sirve pa preguntar a una maquina “Hooola.. hay alguien?”, y la máquina dice “síiiii”. Tonto, pero es la forma que tenemos de ver si una máquina puede ver a otra.

Vale, ya tenemos el punto 1 resulto.

2. El servicio
Pues depende de lo que quiera de www.google.com. Normalmente, empezar por www ya indica que quiero acceder a web, pero en realidad se especifica con el HTTP:, lo que ocurre es que el navegador da muchas cosas por sentado, y si le pides google.com, ya presupone que en realidad lo que queres es http://www.google.com

3. El puerto
Es otra forma de saber el servicio a utilizar, cada servicio tiene un puerto estándar, que no es más que un número. Por ejemplo, la web es el 80, el ftp el 21, el smtp el 32 (digo de memoria), etc, etc. Tambien tienes hasta aburrir.

Mu bien, ya sabemos acceder a un servicio.

Cuando accedemos a un servicio, se dice que yo soy el cliente, y la máquina al otro lado es el servidor, de ahí lo de arquitectura cliente-servidor. Existe otro tipo, que es el P2P (peer-to-peer) o distribuido. En este tipo de servicios no hay “un” servidor, si no que el trabajo se distribuye entre todos los clientes (típico caso, el torrent o el emule).

Entonces, que necesito en mi ordenador para usar un servicio determinado…. pues un cliente. Firefox (y chrome, y IE, y todos los navegadores) son en realidad clientes web (y FTP y alguna cosilla más). Thunderbird es un cliente de correo.

Si quiero utilizar el servicio de torrent, necesito un cliente de torrent. O sea, un programa.

No creas que eso de servidor implica mega ordenadores y esas cosas, tu pc hace de servidor cuando por ejemplo, compartes una carpeta, o cuando ves una peli via dlna (otro protocolo, en este caso de transmision de media) uno es el servidor y el otro el cliente (llamados library y renderer en este caso).

El transmission hace un poco de trampa, por que puedes tenerlo en dos formas. Una como aplicación de escritorio, que es lo que te viene. El problema es que sólo funciona cuando lo abres, y eso no te interesa. También existe una versión daemon. Los daemons o demonios (en windows se llaman servicios) son programas que se ejecutan independientemente del usuario, es más, se inician ANTES de que inicies sesión.

La gran ventaja del transmission daemon es que está ahí paradico, y cuando tiene trabajo se arranca. ¿Y como se configura? pues tocando ficheros de configuración.Y para ver lo que está descargando? pues resulta…. que el transmission daemon es un cliente de torrent y además un servidor web (tachan) y puedes ver lo que hace iendo a una url determinada (que has configurado en el ficherito de marras).

Buf, que rollo macabeo he soltado. Cuando empieces a digerir esto, te mando más.

Mails para mi concuñado I – ¿Qué es un sistema operativo?

Mi concuñado es un tio majete. Y quiere aprender cosillas de informática. Como es médico (o MIR, o residente, o pokemon de agua, no se, no entiendo las diferencias) y chupa guardias, pues trastea con un portatilillo guarro que tiene, y no tiene miedo de nada. Como se lo curra y pregunta BIEN (algo que escasea), pues de vez en cuando le mando mails tocho con explicaciones muy bestias. Como creo que pueden servir a más gente, los comparto, y a ver que tal.

DISCLAIMER: se que técnicamente no estoy siendo preciso, y que incluso digo medias verdades, pero esto está escrito para gente NO técnica que no diferencia entre Ethernet y XBox, así que prefiero hacerlo divertido que exacto.

Ahí va el primer mail

Empecemos por el principio. Tienes que entender que es un Sistema Operativo (SO).
Un SO es el encargado de construir elementos abstractos que te permitan interactuar con el equipo. Por ejemplo, cuando hablamos de un fichero ¿de que hablamos exactamente? ¿de una entrada en la tabla de archivos del SO? ¿en un conjunto de bytes? ¿en unos sectores y pistas del disco? ¿en un conunto de partículas en la superficie de un disco que están cargados magneticamente con una carga positiva o negativa? ¿microsurcos en un dvd? pos eso, que no lo sabemos, el SO se encarga de crear un elemnto abstracto llamado fichero (que en realidad no existe).
Los SO pueden ser de más alto nivel (piensan más como la persona) o de más bajo nivel (piensan más como la máquina). Ser de alto o bajo nivel no es bueno ni malo, son formas diferentes de trabajar. Mac es de muy alto nivel, Windows algo menos (pero están ahí ahi), linux es de muy bajo nivel, pero implementa escritorios que suben mucho el nivel, y mac en el fondo, es un bsd (un unix) que a la que abres la terminal, bajas de nivel drásticamente.
Android, por ejemplo, es un linux al que se le ha puesto una capa por encima que sube MUCHO el nivel, de hecho, en los SO moviles apenas hay gestión de ficheros (desde el punto de vista del usuario estándar).
El tema este de capas es muy importante en la informática en general, todo se hace por capas, todo. Es imposible abarcar la complejidad de un proyecto de SW sin dividirlo en capas. Incluso yo cuando hago cosas para el movil, divido mis apps en capas.
Tener un SO u otro, también determina que apps podemos ejecutar. Por ejemplo, si coges un EXE de windows y lo intentas ejecutar en linux o mac, te dirà que tururu. SI intentas instalar un DMG en windows se te reirá en la cara. Por que cada SO entiende los programas de una manera determinada. Es verdad que hay formar de “saltarse” esto, por ejemplo, WINE, permite cargar apps de windows en linux.
Claro, a la hora de programar, esto es un coñazo, por que si tengo que hacer una aplicación que funcione en diferentes SO, tengo que hacerlo por cada uno de ellos, y esto se intenta evitar. El conocido DODM (Develop Once, Deploy Many). Ahí entran lo que se conocen como lenguajes interpretados. Por ejemplo, Java. Las apps de Java, se ejecutan sobre una JVM (máquina virtual de java), y es este jvm lo que cambia por cada SO (por eso hay que bajarse java para XX antes de ejecutar una app java). Lo mismo sucede con Python, que es un lenguaje interpretado. (Aquí los puristas me saltarian al cuello, pero para lo que quiero explicar, me sirve)
¿Y que tiene que ver este rollazo con los que has visto? pues mucho.
Por ejemplo, vas a descargar Sickbeard TPB y te sale esto: http://sickbeard.com/downloads.html
¿Ein? ¿como que Windows o Github o Python? Calma, todo tiene explicación
Los usuarios de Windows están “mal” acostumbraditos (y los de mac) a bajarse un instalador, siguiente, siguiente, siguiente y pa casa. Bueno, pues en el mundo *nix (linux, unix, xenix, etc) esto no es así. Lo normal es que te bajes el código fuente y lo compiles/ejecutes a mano, como los hombres (aunque con los años también se ha simplificado mucho).
Estos de sickbeard son majetes de decir “hola monguer de windows, te hemos hecho un instalable para que te puedas defender tu solito”
Ah, pos que bien ¿y que otras opciones tengo?
Pues instalarte python (en muchos linux ya viene), bajarte el código fuente y currartelo tú.
Github es un repositorio de apliaciones open source. Ahí la gente sube el código fuente de cosas (apps, librerias, modulos, etc) y cualquiera puede bajarlo. Incluso yo tengo código: https://github.com/sergiandreplace)
El problema que habrás tenido, es que el señor de TPB pasa de los de windows. El que quiera series, que se moje el culo.
Y ahí es donde entra la terminal. Los hombres con pelo en el pecho hacen las cosas a pelo, y las hacen metiendo comandos.
Tienes que entender que la terminal es un programa, igual que el escritorio, igual que xbmc e igual que todo. Tu en linux configuras que app quieres que aparezca al arrancar/iniciar sesión. Y puede ser cualquiera de ellos.
TRUCO DE MASTER 1:
Linux es multiusuario, quicir, que varios usuarios pueden trabajar a la vez, y para cambiar de usuario, cambias de “pantalla”. Eso se hace pulsando CTRL+ALT+F#
Las de F1 a F6 son de texto, la F7 a F9 son gráficas. Pulutant, para meter todo el churro de comando en una terminal, según como es más rápido pulsar CTRL+ALT+F1 y meterse en una sesión de terminal que abrir la app. Sobretodo en XBMCBUNTU que no tienes app de terminal. Luego pa volver, pues CTRL+ALT+F7 y listos.
Y ahora llegamos a la parte de los usuarios.
Linux es muy seguro, y es por ello que no deja que los usuarios toquen nada “by default”. Para tocar algo, hay que elevar la sesión. Esto MacOsX y Windows lo han acabado copiando (mejor o peor)
En linux, el usuario con más privilegios es root, por lo tanto, dirias, pos nada, hago login como root y fuera. NOOORL, eso caca, de hecho, muchas distribuciones ni te dicen el pwd del root.
Lo que tienes que hacer es convertirte en un sudoer. Normalmente tu usuario con el que has instalado en un sudoer.
Los sudoers pueden lanzar comandos como root.
Por eso estas todo el rato metiendo comandos sudo estos o sudo lo otro.
Ahí venía el chiste este:
Sandwich
si haces “shutdown 0″ te dice que no
si haces “sudo shutdown 0″ apaga la máquina en 0 segundos
Obviamente, para evitar que alguien pueda hacer sudos por que tu te dejes la máquina desatendida, el sudo pide password otra vez.
Ale, luego más

Continuous testing on Scala SBT

A nice trick I’ve learned from Ignasi (@ignasi35) one of the BCN Dev Scala Meetup group (http://www.meetup.com/Scala-Developers-Barcelona/)

This is a shortcut to execute the tests while editing the exercises for the Functional Programming course on Coursera.

You can open SBT in your project folder and run the command test. This will compile and run the unit tests defined in the project.

If you run ~test it will run the tests and then it will keep waiting until a file is modified. Once you modify a file, tests will be executed again, and it will keep waiting again, and so on…

Little nice trick :)