Cómo acceder desde un dispositivo con sistema Android a un servidor de base de datos MySQL Server. Para ello usaremos el IDE de desarrollo Eclipse, Java y JDBC para la conexión. Realizaremos una conexión directa sin necesidad de usar un servidor web con PHP, ni JSON ni nada por el estilo. Además, este método servirá para cualquier base de datos que admita JDBC. Explicamos cómo crear una aplicación Android desde cero, paso a paso.

Introducción, antecedentes, Android y bases de datos

La conexión directa a una base de datos MySQL, PostgreSQL, Oracle, SQL Server, Firebird, etc. desde un dispositivo con sistema Android (móvil, tablet) es perfectamente posible. En muchos sitios web hemos leído que Android sólo admite acceso a bases de datos SQLite y esto es un error. Lo que sí es cierto es que el propio sistema Android, como tal, sólo admite trabajar de forma independiente (sin un servidor de base de datos externo) con base de datos SQLite. Lo que quiere decir que en nuestro móvil o tablet con Android no podremos instalar un servidor de MySQL, Oracle, PostgreSQL, etc.

Por lo tanto lo que explicaremos en este tutorial será cómo acceder y trabajar con una base de datos externa al dispositivo Android usando la conexión de red o de Internet. No necesitaremos hacer ningún tipo de instalación adicional en nuestro dispositivo Android, más allá de nuestra propia aplicación, no necesitaremos realizar tunneling, ni usar PHP, ni JSON ni nada por el estilo. El único requisito es que la aplicación desarrollada en Android requerirá de permiso para acceso a Internet, nada más. Y, por supuesto, necesitaremos de un servidor de bases de datos externo al que accederemos desde Android.

Repetimos para aclarar las dudas al respecto: Android sólo admite de forma local trabajar con bases de datos SQLite, la base de datos residirá en el dispositivo móvil con Android. Pero Android, puesto que cuenta con compilador Java y todo lo que ello conlleva, admite perfectamente trabajar con cualquier motor de base de datos que permita acceso mediante JDBC. En este último caso la base de datos, obviamente, residirá en un servidor externo con Windows o Linux como sistema operativo y el dispositivo accederá a dicho servidor mediante la conexión de red o Internet.

En el siguiente tutorial explicamos cómo trabajar con bases de datos SQLite desde Android:

Por supuesto, cada desarrollador estimará qué método usar para conectar una aplicación Android con un motor de base de datos externo, puede estimar usar PHP y JSON, nosotros no decimos que no se haga así, sólo decimos que puede realizarse una conexión directa desde Android a MySQL usando JDBC y Java como explicaremos a continuación.

Requisitos para desarrollar aplicación para dispositivos Android con Eclipse

Entorno de desarrollo de aplicaciones para Android con Eclipse

En el siguiente enlace mostramos un tutorial donde explicamos paso a paso cómo instalar Eclipse y cómo preparar el entorno para desarrollar aplicaciones para dispositivos con Android en Linux:

Para Microsoft Windows 8:

Equipo o servidor con MySQL Server

Como ya hemos comentado necesitaremos disponer de un servidor de MySQL, en los siguientes tutoriales explicamos cómo instalarlo sobre Windows y Linux:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

En primer lugar, si aún no lo tenemos creado, crearemos un nuevo proyecto en Eclipse, para ello lo abriremos y pulsaremos en el menú «File» – «New» – «Project»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Desplegaremos «Android» y seleccionaremos «Android Application Project»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Introduciremos los datos para el nuevo proyecto Eclipse para dispositivos Android:

  • Application Name: nombre de la aplicación, no recomendamos nombres muy largos pues de lo contrario no cabrán en los títulos y demás donde aparezcan. En nuestro ejemplo la llamaremos «AccesoMySQL».
  • Project Name: nombre del nuevo proyecto Eclipse Android, por ejemplo «AjpdSoftMySQL».
  • Package Name: nombre del paquete, por ejemplo «com.example.ajpdsoftmysql».
  • Buil SDK: API level con el que se compilará la aplicación, por ejemplo «Android 4.1 (API 16).
  • Minimun Required SDK: este campo es importante, deberemos indicar el API level mínimo requerido, a mayor API Level menor número de dispositivos Android soportarán nuestra aplicación. Por lo tanto deberemos indicar el API level más pequeño posible, según los procedimientos que usemos y los imports requeriremos uno u otro. En nuestro caso el API Level mínimo será 5 (API 5: Android 2.0 (Eclair).
  • Create custom launcher icon: si queremos que el asistente nos permita crear un icono para nuestra aplicación marcaremos este check.
  • Create Project in Workspace: maraceremos esta opción para crear el nuevo proyecto Android en el espacio de trabajo del usuario por defecto.

Tras introducir los datos para el nuevo proyecto Eclipse para dispositivos Android pulsaremos «Next»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Si hemos seleccionado la opción de crear un icono para la aplicación, el asistente nos mostrará la ventana para crear el icono personalizado, podremos cambiar el icono, cambiar color de fondo y otras opciones:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Marcaremos «Create Activity» para crear una activity (ventana) principal de la aplicación, seleccionaremos el tipo de activity que crearemos, en nuestro caso «BlankActivity»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Introduciremos los datos para la nueva activity:

  • Activity Name: nombre del activity (ventana), por ejemplo «AjdSoftMySQL».
  • Layout Name: nombre del fichero xml que contendrá los componentes visuales de la activity, por ejemplo «activity_ajpd_soft_my_sql».
  • Navitagion Type: podremos elegir aquí el tipo de navegación para la nueva actividad, las opciones: Tabs, Tabs + Swipe, Swipe Views + Title Strip y Dropdown. Estos tipos de navegación requerirán API Level iguales o superiores a la 14.
  • Title: título para la activity, por ejemplo «Acceso MySQL».

Para más información sobre los activity de Android podéis visitar este tutorial:

Tras introducir los datos para el activity pulsaremos «Finish» para crear el proyecto:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

El asistente para añadir un nuevo proyecto Eclipse para dispositivos Android creará todos los ficheros necesarios para el proyecto, a continuación indicamos algunos de los más importantes:

  • /src/AjpdSoftMySQL.java: código java de la activity principal del proyecto. En este fichero colocaremos todo el código java de nuestra aplicación Android, al menos todo el que tenga que ver con su activity correspondiente.
  • /bin/AndroidManifest.xml: fichero de configuración principal de la aplicación donde se indicarán, por ejemplo, todas las activity de la aplicación.
  • /res/drawable-hdpi, /res/drawable-ldpi, /res/drawable-mdpi, /res/drawable-xhdpi: carpetas del proyecto donde se guardarán los ficheros de imágenes (iconos y demás) para las diferentes resoluciones.
  • /res/layout/activity_ajpd_soft_my_sql.xml: carpeta y fichero para el layout, donde se indicarán los componentes gráficos del activity relacionado, en este fichero indicaremos todo lo que el usuario verá en la aplicación Android de su móvil.
  • /res/menu/activity_ajpd_soft_my_sql.xml: carpeta y fichero con los datos necesarios para mostrar el menú de nuestra aplicación, lo usaremos para mostrar el segundo activity que crearemos posteriormente para indicar los datos de conexión con el servidor MySQL.
  • /res/values/strings.xml: en este fichero indicaremos todas las cadenas de texto que se mostrarán al usuario en los menús, botones, etiquetas, mensajes, etc.

El asistente nos dejará la pestaña del layout abierta, para edición en modo gráfico, añadiremos al layout del activity principal de la aplicación los siguientes componentes:

  • De la paleta «Form Widgets» añadiremos un «Spinner», en este desplegable mostraremos los catálogos (bases de datos) del servidor de MySQL al que nos conectemos.
  • De la paleta «Form Widgets» añadiremos un Button, este botón será el que pulse el usuario para obtener los catálogos del servidor MySQL.
  • De la paleta «Text Fields» añadiremos un «EditText» multilínea (Multiline Text), en este campo el usuario podrá introducir la consulta SQL a ejecutar contra el servidor MySQL.
  • De la paleta «Form Widgets» añadiremos un «CheckBox», en este check el usuario marcará si es una consulta de selección (SELECT, DESC, SHOW) o es una consulta de modificación de datos (INSERT, UPDATE, DROP,CREATE, ALTER).
  • De la paleta «Form Widgets» añadiremos un Button, este botón será el que pulse el usuario para ejecutar la consulta SQL.
  • De la paleta «Text Fields» añadiremos un «EditText» multilínea (Multiline Text), en este campo la aplicación devolverá el resultado de la ejecución de la consulta SQL.
  • De la paleta «Text Fields» añadiremos un «TextView» en el que mostraremos un texto de aviso al usuario para que, si la consulta SQL es grande, use la cláusula LIMIT para limitar los registros a mostrar y que la aplicación no se ralentice en exceso.
Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Todos estos datos visuales se guardarán en el fichero /res/layout/activity_ajpd_soft_my_sql.xml, en nuestro caso tendrá este contenido:

El contenido del fichero donde se guardarán todas las cadenas de texto que usaremos en la aplicación «res/values/strings.xml«:

Acceso MySQL
Configuración
Acceso MySQL
Consulta SQL a ejecutar
Ejecutar
Resultado SQL
Acerca de …
Configuración
IP/Nombre red servidor
Puerto
Usuario
Contraseña
Base de datos
Acerca de
Guardar configuración
Catálogo/BD
Probar conexión
Catálogos
SQL de modificación
Utiliza LIMIT en las consultas SQL de selección,
si devuelven muchos registros podrían provocar que la
aplicación se ralentice en exceso o incluso deje de funcionar.
Por ejemplo: select * from factura limit 0,10 n(mostrará los 10
primeros registros)»
Introduzca consulta SQL

El contenido del fichero que mostrará el menú en el activity «/res/layout/menu/activity_ajpd_soft_my_sql.xml«:

Podremos compilar la aplicación para probarla y ver cómo quedan los componentes visuales, de momento ningún botón funcionará pues aún no lo hemos programado, pero nos servirá para comprobar que todo es correcto. Para ello pulsaremos en «Run» – «Run»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Seleccionaremos «Android Application» y pulsaremos «OK»:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Si todo es correcto se iniciará el emulador de dispositivos Android y se ejecutará la aplicación:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

Incluso podremos pulsar en «MENU» para comprobar que el menú aparece correctamente en la parte inferior:

Añadir proyecto Android a Eclipse para aplicación acceso MySQL, crear activity principal y menú

El código XML del fichero «/bin/AndroidManifest.xml«:

Cabe destacar «uses-permission android:name=»android.permission.INTERNET»» que será el permiso necesario para que la aplicación funcione, pues será necearia la conexión a Internet (o a una red wifi) para acceder al servidor de MySQL Server.

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Nuestra aplicación de ejemplo contará con dos activity, por un lado el anteriormente creado que será el principal, donde el usuario introducirá la consulta SQL a ejecutar y donde se mostrará el resultado. Por otro lado, nuestra aplicación requerirá de un segundo activity donde solicitaremos al usuario los datos de acceso al servidor MySQL al que nos conectaremos (IP, puerto, base de datos, usuario, contraseña).

Para añadir un segundo activity a nuestra aplicación para dispositivos Android desde Eclipse, pulsaremos con el botón derecho del ratón sobre el proyecto y seleccionaremos «New» – «Other»:

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Desplegaremos «Android» y seleccionaremos «Android Activity»:

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Seleccionaremos «BlankActivity» y pulsaremos «Next»:

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Introduciremos los datos para el nuevo Activity:

  • Activity Name: nombre del activity (ventana), por ejemplo «Activity_Configuracion».
  • Layout Name: nombre del fichero xml que contendrá los componentes visuales de la activity, por ejemplo «activity_activity_configuracion».
  • Navitagion Type: podremos elegir aquí el tipo de navegación para la nueva actividad, las opciones: Tabs, Tabs + Swipe, Swipe Views + Title Strip y Dropdown. Estos tipos de navegación requerirán API Level iguales o superiores a la 14. Seleccionaremos «None».
  • Title: título para la activity, por ejemplo «Configuración».
Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Pulsaremos «Finish»:

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

El asistente nos dejará la pestaña del layout abierta, para edición en modo gráfico, añadiremos al layout del activity secundario (el que mostrará los datos de conexión al servidor MySQL) los siguientes componentes:

  • De la paleta «Text Fields» añadiremos un «TextView» en el que mostraremos un texto «IP/Nombre red servidor».
  • De la paleta «Text Fields» añadiremos un «EditText», en este campo el usuario introducirá la IP/DNS del servidor de MySQL al que quiera conectarse.
  • De la paleta «Text Fields» añadiremos un «TextView» en el que mostraremos un texto «Puerto».
  • De la paleta «Text Fields» añadiremos un «EditText», en este campo el usuario introducirá el puerto del servidor de MySQL al que quiera conectarse.
  • De la paleta «Text Fields» añadiremos un «TextView» en el que mostraremos un texto «Usuario».
  • De la paleta «Text Fields» añadiremos un «EditText», en este campo el usuario introducirá el usuario del servidor de MySQL al que quiera conectarse.
  • De la paleta «Text Fields» añadiremos un «TextView» en el que mostraremos un texto «Contraseña».
  • De la paleta «Text Fields» añadiremos un «EditText», en este campo el usuario introducirá la contraseña del servidor de MySQL al que quiera conectarse.
  • De la paleta «Form Widgets» añadiremos un Button, este botón será el que pulse el usuario para ejecutar la consulta SQL.
Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Todos estos datos visuales se guardarán en el fichero /res/layout/activity_activity_configuracion.xml, en nuestro caso tendrá este contenido:

Este activity también incorporará un menú, el fichero xml del menú «/res/layout/menu/activity_activity_config.xml«:

El segundo activity en ejecución:

Añadir segundo activity para introducción de los datos de conexión con servidor MySQL

Nota: más adelante explicaremos y mostraremos todo el código Java para hacer funcionar todas las opciones visuales de la aplicación Android con acceso a MySQL.

Descargar y añadir JDBC a proyecto Eclipse para acceso a MySQL desde Android

En primer lugar necesitaremos el JDBC para el motor de base de datos al que queramos acceder desde Android, en nuestro caso, como ejemplo, accederemos a un servidor de MySQL Server instalado en un equipo Linux. Para descargar el JDBC accederemos a la web oficial del motor de base de datos y descargaremos el fichero correspondiente al JDBC, para MySQL accederemos a la URL:

A la fecha de este tutorial descargamos la versión Connector/J 5.1.24, podremos descargar el .tar o el .zip, ambos son válidos para cualquier sistema operativo. Una vez descargado el fichero mysql-connector-java-5.1.24.zip lo descomprimiremos pulsando con el botón derecho del ratón sobre él y seleccionado «Extraer aquí»:

Descargar y añadir JDBC a proyecto Eclipse para acceso a MySQL desde Android

Dentro de este fichero comprimido habrá varios (.jar, documentación, código fuente), el importante es el mysql-connector-java-5.1.24-bin.jar, copiaremos este fichero (pulsando sobre él con el botón derecho):

Descargar y añadir JDBC a proyecto Eclipse para acceso a MySQL desde Android

Desde Eclipse, exploraremos nuestro proyecto Android, pulsaremos con el botón derecho sobre la carpeta «libs» y pulsaremos en «Paste» (para pegar el fichero .jar del conector de MySQL):

Descargar y añadir JDBC a proyecto Eclipse para acceso a MySQL desde Android

Ejemplo acceso a BD MySQL desde Android con JDBC y Eclipse

Una vez agregado el conector .jar a nuestro proyecto (como hemos indicado aquí) ya podremos usar todas las funciones y prodedimientos para conectar con el motor de base de datos MySQL desde nuestra aplicación Android con Eclipse. Para ello será tan sencillo como agregar en los imports de nuestro fichero .java lo siguiente:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

Ejemplo acceso a BD MySQL desde Android con JDBC y Eclipse

Añadiremos la siguiente variable de tipo «Connection», que usaremos para conectarnos sólo una vez durante el proceso de ejecución de una consulta SQL en MySQL:

Connection conexionMySQL;

Ejemplo acceso a BD MySQL desde Android con JDBC y Eclipse

Añadiremos un procedimiento para conectarnos al servidor MySQL, así podremos usarlo cada vez que lo necesitemos. Dicho procedimiento necesitará usuario, contraseña, IP o DNS, puerto y catálogo del servidor de MySQL al que nos conectaremos, si hay algún error lo capturará y lo mostrará en una notificación Android:

Ejemplo acceso a BD MySQL desde Android con JDBC y Eclipse

Como ejemplo nos conectaremos al servidor MySQL desde nuestra aplicación Android, ejecutaremos una consulta SQL que devuelve registros y mostraremos el resultado en un cuadro de texto:

Código Java aplicación AjpdSoft Acceso MySQL Android

Código Java completo del fichero «/src/AjpdSoftMySQL.java«, este fichero contendrá el código Java del activity principal de la aplicación, desde donde el usuario podrá escribir las consultas SQL que desee y ejecutarlas. En el código incluimos todo lo necesario para conectar con el servidor MySQL especificado, guardar configuración, cargar configuración, obtener lista de catálogos de MySQL (bases de datos), consulta de selección, consulta de modificación, obtener datos de consultas de selección, mostrar menú, etc.:

Y el código del fichero «/src/Activity_Configuracion.java» correspondiente al activity donde introduciremos los datos de conexión al servidor MySQL y desde donde podremos realiar una conexión de prueba. En dicho código guardaremos los valores en un fichero de configuración y podremos probar la conexión al servidor MySQL, también mostramos el menú correspondiente a este activity:

En el siguiente enlace se puede descargar de forma gratuita el proyecto completo en Eclipse:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

A continuación explicamos cómo funciona la aplicación AjpdSoft Acceso MySQL Android, tras abrirla en el dispositivo smartphone o tablet con Android, pulsaremos en el botón de Menú del dispositivo:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Aparecerá el menú en la parte inferior, tocaremos en «Configuración»:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Introduciremos los datos de conexión al servidor MySQL al que queramos conectarnos (IP, Puerto, Usuario y Contraseña):

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Pulsaremos el botón de Menú del dispositivo y en el menú tocaremos en «Guardar configuración», de esta forma los datos de conexión se guardarán para futuras conexiones. Una vez establecidos los datos podremos pulsar en el botón «Probar conexión», si todo es correcto mostrará el mensaje «Conectado servidor MySQL», cerraremos esta ventana y volveremos a la ventana principal pulsando el botón Atrás del dispositivo:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Ahora deberemos elegir el catálogo (base de datos) que usaremos, para obtener las bases de datos del servidor al que nos hemos conectado pulsaremos en «Catálogos»:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Nos mostrará en una lista desplegable todos los catálogos a los que el usuario especificado anteriormente tendrá acceso, tocaremos en el que queramos usar, por ejemplo «bdajpdsoft»:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Ahora ya podremos introducir la consulta SQL que queramos para mostrar los datos que necesitemos, en el ejemplo mostramos la suma total de un campo de una tabla con:

select sum(counter) from nuke_stories

Tras escribir la consulta SQL tocaremos en «Ejecutar»:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

Nota: hay que tener en cuenta que la aplicación no realiza LIMIT en las consultas de selección (SELECT), por lo que si queremos ejecutar una consulta que puede devolver gran cantidad de datos recomendamos usar LIMIT para evitar que la aplicación se ralentice en exceso o incluso deje de responder. Por ejemplo:

select * from factura limit 0,10

(mostrará los 10 primeros registros de la tabla «factura»)

La aplicación mostrará todos los datos de la consulta SQL ejecutada (nombre de las columnas y valor de cada una de ellas):

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

AjpdSoft Acceso MySQL Android también permite ejecutar consultas SQL de modificación de datos (INSERT, UPDATE, DELETE, DROP, CREATE, ALTER), para ello escribiremos la consulta SQL y marcaremos «SQL de modificación»:

Aplicación Android AjpdSoft Acceso MySQL en funcionamiento

En el siguiente enlace se puede descargar de forma gratuita el proyecto completo en Eclipse:

Publicar aplicación Android en Google Play

En el siguiente tutorial explicamos cómo publicar una aplicación para dispotivos Android en Google Play (antes Google Android Market):