Leer código QR con Android | Programación de app

Introducción

Leer un código QR debería ser lo más fácil de hacer en Android utilizando Java, pero no es así.

Podemos utilizar la API que ha introducido Google para leer códigos QR, pero el usuario final necesitará tener los Google Play Services.

Otras alternativas sugieren que usemos otra aplicación que ya lea códigos QR (llamar a otra aplicación desde la nuestra) y tomar lo que devuelva; esto confiando en que el usuario tenga una aplicación para leer dichos códigos.

Pero hoy veremos cómo podemos incorporar un lector QR programado por alguien más, que no tiene dependencias más que el mismo lector.

App final

La app que crearemos al final se verá algo así:

Puedes descargarla y probarla por ti mismo.

Incluir librería

Comencemos con lo básico. La librería está alojada aquí en GitHub. No es muy popular ni tiene miles de estrellas, pero sí que sirve.

Para incluirla, abrimos el archivo build.gradle (el que dice Project:TuProyecto) y en el apartado allprojects > repositories agregamos lo siguiente:

maven { url 'https://jitpack.io' }

De manera que ese fragmento de nuestro archivo puede quedar así:

Personalmente, y sólo para que sirva de guía, mi archivo se ve así:

Ahora modificaremos nuestro archivo gradle para nuestra app (dice Module: app), en el apartado dependencies. En ese apartado agregaremos lo siguiente:

compile 'com.github.blikoon:QRCodeScanner:0.1.2'

De manera que el fragmento  puede quedar así:

Y aquí una imagen del mío:

Seguramente nos pedirá que instalemos las dependencias en un mensaje en la parte superior,  así que lo hacemos haciendo click en Sync Now. Una vez hecho esto ya hemos incluido la librería.

Solicitando permisos

El autor de la librería no lo deja claro, pero necesitamos dos permisos: acceder a la cámara y a la vibración. Cuando comencé a probar la librería, habilité permisos para la cámara, pero no para que el dispositivo vibrase, así que la app se cerraba inesperadamente.

En fin, recordemos agregarlos en el manifest. Así:

El mío luce así:

Y con ello ya podemos, ahora sí, programar.

Leer código QR

Hagamos un ejemplo básico. Vamos a poner un botón, cuando se haga click en ese botón llamaremos a un método de Java que lanzará el lector, luego recuperaremos lo que se devuelva y lo mostraremos en un Toast.

Botón

Voy a poner un simple botón en la vista y también una etiqueta. Vamos a escuchar más tarde el click del botón, en dicho click se llamará al método onClick.

La vista queda así:

Actividad

Ahora, en nuestra actividad vamos a poner este código:

REQUEST_CODE_QR_SCAN es un número único, ya que siempre podremos hacer peticiones, pero esas peticiones serán hechas con un número único para que cuando respondan podamos ver a cuál de todas están respondiendo. En este caso sólo haremos una, pero puede que luego agreguemos más.

En resumen, puedes cambiar el número. Luego vamos a escuchar cuando se responda nuestra solicitud, así:

Básicamente vemos si pudimos leer, y también si el código QR era válido. En caso de que sí, mostramos un toast con lo que leímos. En caso de que no, pues avisamos.

Juntando todo, nuestra actividad se ve así:

Con ello podemos ejecutar nuestra app y ver qué pasa…

Probando app

Al abrir la app se ve esto:

Ventana principal de aplicación para leer códigos QR en Android

Ventana principal de aplicación para leer códigos QR en Android

Generé un código en mi computadora utilizando AngularJS (sólo para probar rápidamente, pero podemos leer un código QR impreso, de cualquier página web, etcétera) así:

Si quieres entrar y generar uno, haz click aquí.

Luego abrí el lector, se ve así:

Escaneando código QR desde Android

Escaneando código QR desde Android

Y finalmente, al leer, se mostró el toast:

Código QR leído correctamente

Código QR leído correctamente

Internacionalización, idiomas o traducción

No hace falta que lo digan; yo también noté que algunas o todas las etiquetas están en inglés. Pues bien, hay una forma de “traducir” esto aunque me parece que no es un método permanente.

Se trata de un archivo que se queda en la caché. Podemos buscarlo en Android Studio con Ctrl + Shift + N, escribiendo “values.xml” y eligiendo editar el que pertenece al lector QR. Es el siguiente:

Ahí vamos a encontrar muchos valores y también colores. Podemos traducir algunos. En mi caso cambié  “Scan” por “Escanear” y “Picture” por “Elegir imagen“:

Y la app se ve así (notar que en la parte superior tiene los valores que cambié):

Pero infiero que, como dice caché, se borrará en la siguiente sincronización. Para ello podemos tener un archivo aparte que guardará los valores, o algo que se nos ocurra.

Conclusión

Lo único que tengo que decir es que, si podemos, dejemos una estrella al repositorio en GitHub. Si quieres, descarga la aplicación desde aquí 🙂