GUÍA DE PRINCIPIANTES PARA ANDROID MIOIO
INTRODUCCIÓN
Esta es la guía de principiantes para el uso de la tarjeta MIOIO , y está pensado para los usuarios que nunca han escrito una aplicación para Android . El objetivo de este tutorial es mostrar cómo escribir una aplicación sencilla que comunica con la tarjeta MIOIO.
MIOIO
El lenguaje de programación utilizado para escribir una aplicación para Android es Java. Si no estás familiarizado con Java, este tutorial sólo repasa una aplicación sencilla de Java utilizando la biblioteca MIOIO . Este tutorial no cubre cómo escribir código Java tampoco cubrirá cómo usar las características avanzadas en su dispositivo Android, como el GPS , acelerómetro , pantalla táctil, etc. Una vez que llegues al punto en el que desea utilizar la amplia gama de características de su Android, te sugerimos primero que mire la sección de recursos técnicos sobre developer.android.com . Si todavía no puedes encontrar los ejemplos que buscas , simplemente navegando por internet encontrarás un montón de información y ejemplos que muestran cómo comunicarse con todas las grandes piezas de hardware en el dispositivo Andriod .
En general, el santo grial para el desarrollo de aplicaciones Android es developer.android.com . Allí se encuentra la mayoría de la información sobre el desarrollo de Android.
Aquí están las piezas de hardware que necesitarás para completar este tutorial:
Android dispositivo habilitado con OS 1.5 o superior
Tarjeta MIOIO, con cable adaptador o bluetooth compatible.
Cable USB que sea compatible con su dispositivo Android
Una fuente de alimentación de entre 4,5 - 6V con al menos 1A de la corriente .
INSTALACIÓN DEL ENTORNO DE DESARROLLO
Lo primero que debes hacer es descargarte el entorno de desarrollo Eclipse desde aquí.
También debes de descargarte e instalar el JDK6 para 32bits, que lo puedes descargar desde aquí y para 64bits desde aquí.
Cuando tengas instalado el JDK6, ya puedes arrancar el ECLIPSE.
Ahora, hay que preparar el Eclipse para que nos sirva como entorno de desarrollo para Android.
Paso1:
Iniciar el Eclipse.
Paso 2:
Ir al menú Help -> Install new software.
En la casilla work with, introduce lo siguiente: https://dl-ssl.google.com/android/eclipse/
Selecciona la casilla Developers Tools, y continua.
Pulsa en Continua .
Acepta las condiciones y Finaliza. Se instalará el software necesario para usar el SDK de Android en Eclipse.
Puede que te salga un letrero como este, ignoraló y continua con la instalación.
Se te pedirá que reinicies el Eclipse.
Paso3:
Reinicia el Eclipse.
Paso 4:
Debe haber aparecido en el menu de arriba unos iconos como estos:
Pulsa sobre el icono que tiene la flecha hacía abajo es el SDK MANAGER DE ANDROID. Se abrirá una ventana en la que deberás descargar el SDK necesario para programar en la versión que quieras de android.
Selecciona la versión en la que quieras programar tu aplicación e instala los paquetes, recomiendo que utilices al menos de la 2.3.3. en adelante. (sobre todo para la compatibilidad del Bluetooth).
Paso 5;
Importe el Ejemplo HelloIOIO
En lugar de crear un nuevo proyecto desde cero , podemos importar un proyecto IOIO existente que tiene todos los archivos listos para ir. Si necesita instrucciones sobre cómo crear un nuevo proyecto , vea el ejemplo Hello World en developer.android.com .
PARA IMPORTAR UN PROYECTO EXISTENTE...
1 ) Descarga el Software imagen' archivo zip MIOIO.
2 ) Descomprimir el paquete descargado en un lugar seguro en el que deseas guardar los archivos del proyecto .
3 ) A continuación, con Eclipse abierto, en el menú Ir Archivo> Importar y selecciona Proyectos existentes en áreas de trabajo. Después haz clic en Siguiente.
4 ) Se abrirá una ventana, ( como se muestra más abajo) . Seleccione " Seleccionar directorio raíz ' y navegue hasta el archivo que acaba de extraer y seleccione la carpeta HelloIOIO encuentra en / Aplicaciones / HelloIOIO . Asegúrate de que la casilla de verificación para tu proyecto. Ahora termina aceptando.
5 ) Ahora deberías tener HelloIOIO en el explorador de proyecto en Eclipse. Ten en cuenta que hay una pequeña x roja junto al nombre del proyecto. Esto significa que hay errores de compilación , por lo que cada vez que veas esto, sabrás que algo necesita ser arreglado . En esta situación , es necesario vincular la biblioteca MIOIO a nuestro proyecto , como se indica en el siguiente paso.
6 ) Ahora tenemos que vincular la biblioteca y la biblioteca IOIO Bluetooth IOIO a tu proyecto que te dará pleno acceso a la API IOIO . Los directorios IOIOLib y IOIOLibBT contienen las bibliotecas que le permiten comunicarse a la MIOIO .
Sigue los mismos pasos exactos en 3 y 4 , excepto utilizando el archivo IOIOLib y luego el IOIOLibBT en lugar del archivo HelloIOIO .
Después de que añadas los archivos de la biblioteca en el espacio de trabajo , seleccione el proyecto HelloIOIO , a continuación, en la barra de herramientas superior Ir a: Proyecto > Propiedades. A continuación, seleccione ' Android ' en la lista de la izquierda. En la sección " Library " , haga clic en Agregar y, a continuación añadir tanto las bibliotecas IOIOLib y IOIOLibBT . Debes de ver a ambos con una marca verde como se muestra a continuación ( nota : la imagen no muestra la IOIOLibBT , pero debería estar allí si se utiliza Bluetooth) .
También, asegúrate de que el 'Proyecto Build Target' esté correctamente seleccionado de acuerdo con el sistema operativo Android específica que esté utilizando.
Nota : Si alguna vez tiene que cambiar su destino de generación ( si se está usando un dispositivo con un sistema operativo diferente Android) , puede cambiar aquí.
7 ) Lo siguiente que hay que hacer es asegurarse de que su aplicación tiene permisos de Internet. Para ello , abra el archivo AndroidManifest.xml situado en el árbol principal del proyecto. Asegúrese de que está en la ficha permisos , haga clic en Agregar > Permisos de uso , a continuación, asegúrese de que el campo 'Nombre' es android.permission.INTERNET . Ver la imagen de abajo como referencia:
Después de haber hecho esto y guardado el proyecto , la ventana del explorador de proyectos debería ser algo como esto :
Observe los indicadores de error x rojos se han ido.
En caso de que sigan saliendo los indicadores de error x, prueba a desmarcar la opción Build Automatically en el menu Proyect. Selecciona el proyecto Hello_ioio en el arbol de archivos y en el mismo menú Proyect pulsa Clean para limpiar el proyecto.
El árbol del proyecto tiene muchos archivos. Realmente no tienes que meterte con el árbol del proyecto IOIOLib para que pueda minimizar esa. El archivo que contiene el código java para el IOIO está en HelloIOIO > scr > ioio.examples.hello > MainActivity.java . Haz doble clic en el archivo MainActivity.java y deberías ver esto:
Aquí puedes empezar a escribir código y cambiar el programa HelloIOIO . En este punto se puede seguir leyendo o saltar inmediatamente a la compilación del programa IOIO y probar la aplicación.
El archivo MainActivity.java contiene el código que comunica con la MIOIO . Si deseas cambiar la interfaz de usuario ( interfaz de usuario o gráficos ) de su aplicación, la resolución de archivo > layout > main.xml es donde se hacen los cambios. El archivo main.xml en el ejemplo HelloIOIO utiliza una interfaz que se parece a esto :
Para obtener más información sobre diseños de XML, vea el ejemplo hola mundo en developer.android.com , a continuación, desplácese hacia abajo para el " Actualiza la interfaz de usuario para XML Layout ' sección.
En este punto, debes estar listo para escribir tu propia aplicación Android IOIO . Ahora puedes seguir leyendo o saltar inmediatamente a la compilación del programa IOIO y probar la aplicación.
Errores de proyecto
Eclipse tiene la capacidad de compilar el código en tiempo real. Cuando se produce un error , aparecerá una x roja en algún lugar de su proyecto. Esto puede significar muchas cosas. Para saber qué son los errores , Eclipse tiene pestaña llamada "problemas" que muestra lo que los errores que está recibiendo. Esta pestaña se encuentra generalmente hacia la parte inferior de la ventana de Eclipse . A veces, el error le dirá exactamente lo que está mal y, a veces los errores son más oscuros.
Si se producen errores desconocidos en su proyecto , por favor consulte la guía de solución de problemas IOIO - OTG .
El Ejemplo IOIO
Una vez importado el archivo HelloIOIO y vinculado al archivo IOIOLib , usted está listo para empezar a escribir código. El ejemplo muestra un botón de activación en la pantalla , lo que permite controlar el bordo LED. Este ejemplo muestra un uso simple del IOIO y le dará una idea de qué esperar cuando se programa .
El código en el archivo MainActivity.java se muestra a continuación.
package ioio.examples.hello;
import ioio.examples.hello.R;
import ioio.lib.api.DigitalOutput;
import ioio.lib.api.exception.ConnectionLostException;
import ioio.lib.util.AbstractIOIOActivity;
import android.os.Bundle;
import android.widget.ToggleButton;
/**
* This is the main activity of the HelloIOIO example application.
*
* It displays a toggle button on the screen, which enables control of the
* on-board LED. This example shows a very simple usage of the IOIO, by using
* the {@link AbstractIOIOActivity} class. For a more advanced use case, see the
* HelloIOIOPower example.
*/
public class MainActivity extends AbstractIOIOActivity {
private ToggleButton button_;
/**
* Called when the activity is first created. Here we normally initialize
* our GUI.
*/
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
button_ = (ToggleButton) findViewById(R.id.button);
}
/**
* This is the thread on which all the IOIO activity happens. It will be run
* every time the application is resumed and aborted when it is paused. The
* method setup() will be called right after a connection with the IOIO has
* been established (which might happen several times!). Then, loop() will
* be called repetitively until the IOIO gets disconnected.
*/
class IOIOThread extends AbstractIOIOActivity.IOIOThread {
/** The on-board LED. */
private DigitalOutput led_;
/**
* Called every time a connection with IOIO has been established.
* Typically used to open pins.
*
* @throws ConnectionLostException
* When IOIO connection is lost.
*
* @see ioio.lib.util.AbstractIOIOActivity.IOIOThread#setup()
*/
@Override
protected void setup() throws ConnectionLostException {
led_ = ioio_.openDigitalOutput(0, true);
}
/**
* Called repetitively while the IOIO is connected.
*
* @throws ConnectionLostException
* When IOIO connection is lost.
*
* @see ioio.lib.util.AbstractIOIOActivity.IOIOThread#loop()
*/
@Override
protected void loop() throws ConnectionLostException {
led_.write(!button_.isChecked());
try {
sleep(10);
} catch (InterruptedException e) {
}
}
}
/**
* A method to create our IOIO thread.
*
* @see ioio.lib.util.AbstractIOIOActivity#createIOIOThread()
*/
@Override
protected AbstractIOIOActivity.IOIOThread createIOIOThread() {
return new IOIOThread();
}
}
En el código anterior , hay un montón de comentarios que explican lo que hace cada línea. Esta aplicación es un gran punto de partida para asegurarse de que su entorno de desarrollo y la placa MIOIO funciona correctamente .
Eclipse es una herramienta muy potente y da información de depuración en tiempo real. Por ejemplo , si usted escribe el código que no tiene sentido, Eclipse mostrará una x roja junto a la línea en cuestión , e incluso le dará sugerencias sobre cómo cambiar la línea de código . Simplemente coloque el cursor del ratón sobre la línea y verá algo como esto:
Tenga en cuenta que si tiene errores , no serás capaz de compilar y ejecutar el código, tendrá que corregir los errores .
También , la IOIOLib tiene JavaDocs exhaustivas que pueden ser generados y explorado desde Eclipse . Ir a Proyecto> Generar Javadocs .
Éstos son algunos más recursos para ayudar a salir con la escritura de código:
Para todos los tipos de Android , consulte el índice de paquetes Android.
Por tipos IOIO y ejemplos , vea el Wiki IOIO - OTG .
Compilar , cargar y ejecutar la aplicación en su dispositivo Android
Si cambias alguna parte del código , simplemente guardar el proyecto compila el programa y se crea un nuevo archivo HelloIOIO.apk . Un archivo apk es un archivo del paquete Android comprimido, similar a zip y jar . archivos, que se utiliza para crear una aplicación en su dispositivo Android . Este archivo se puede encontrar en el árbol de proyecto HelloIOIO en el directorio bin.
Aquí están los pasos para obtener la aplicación de ejemplo de trabajo en un teléfono N1 Android corriendo la plataforma 2.3.3 .
1 . Habilitar la depuración USB. Ajustes > Aplicaciones> Desarrollo > USB depuración Habilitar
2 . Instale el archivo apk . La forma más fácil de obtener el archivo apk en el dispositivo es conectar el dispositivo a su ordenador. Cuando se le pida para instalar los controladores , selecciona el controlador que se encuentra en Android ( debe estar en Archivos de programa para usuarios de Windows ) > android -sdk > extras > google > USB_Driver . A continuación, haga clic derecho en el proyecto HelloIOIO en el explorador de proyectos en Eclipse Ir Ejecutar como> Aplicación para Android (o pulsar el botón verde toco en la barra de herramientas superior se ejecuta la aplicación también). Su archivo apk ahora debe ser instalado en su dispositivo Android . Desconecte su dispositivo Android desde su ordenador , a continuación, pasar al siguiente paso. Más información sobre el controlador USB Google se encuentra aquí .
3 . Prepare la placa MIOIO . Lo único que tiene que hacer para el ejemplo HelloIOIO es alimentar la placa IOIO . Tenga en cuenta, la junta IOIO siempre necesitará una fuente de alimentación externa entre 4,5 -6V . Soltero baterías lipos celulares no funcionan , se necesita una entrada de 4,5 -6V . Puede conectar la fuente de alimentación a los terminales de VIN y GND ( tendrán que ser soldadso en su sitio los conectores).
4 . Con el MIOIO alimentado puede conectar el cable USB en el MIOIO y en su dispositivo Android. El dispositivo Android debe mostrar que la depuración USB está conectado en la barra de notificaciones , además, el Android debe indicar que se está cargando.
5 . Abra la aplicación Hello IOIO y pulse el botón , usted debe ver como ed LED de estado se enciende y se apaga. ¡Enhorabuena! Ahora se encuentra en camino paraa la creación de sus propias aplicaciones para MIOIO !
Nota : La mejor manera de desarrollar aplicaciones para MIOIO es tener el teléfono conectado a su ordenador mientras está escribiendo y editando el código. Después de ejecutar la aplicación (como se muestra en el paso 2 ) eliminará la aplicación antigua y cargar la aplicación que acaba de editar en el teléfono . Ahora puede desconectar el teléfono de la computadora , a continuación, conéctelo al MIOIO para probar lo que has hecho .