====== Cordova (legacy phonegap) ======

phonegap cordova

===== Instalar =====

TODO

===== Comandos =====

  * Crear proyecto
<code>
cordova create helloworld com.example.helloworld HelloWorld
</code>

  * Anyadir plataforma android

Ojo: se requiere tener instalado previamente el SDK de Android:

https://cordova.apache.org/docs/en/latest/guide/platforms/android/

<code>
cd /path/cordova/project
cordova platform add android
</code>

  * Instalar plugin
<code>
cd /path/cordova/project
cordova plugin add org.apache.cordova.geolocation
</code>

  * Instalar plugin desde git (plugins no oficiales)
<code>
cd /path/cordova/project
cordova plugin add https://github.com/brodysoft/Cordova-SQLitePlugin.git
</code>



  * Eliminar plugin
<code>
cd /path/cordova/project
cordova plugin rm org.apache.cordova.geolocation
</code>

  * Compilar para Android
<code>
cordova build android
</code>

  * Instalar paquete en dispositivo USB (requiere habilitar "debug USB" en el dispositivo)
<code>
cordova run android --device
</code>

  * Listar plugins instalados
<code>
cordova plugin ls
</code>

Buscar plugins:

http://plugins.cordova.io/#/

===== Errores ======

==== ERROR: Error: ERROR : executing command 'ant', make sure you have ant installed and added to your path. ====

**TODO**

==== Failed to install 'cordova-plugin-whitelist':CordovaError: Could not find gradle wrapper within Android SDK. Might need to update your Android SDK. ====

08/11/2017

Historia para no dormir que tiene que ver con una incompatibilidad entre cordova y la versión de SDK de Android.

Solución:

1. Descargar Android Studio:

https://developer.android.com/studio/index.html

2. Descomprimir, en mi caso en el directorio:

  /home/usuario/Downloads/android-studio
  
3. Arrancar:

  cd /home/usuario/Downloads/android-studio/bin
  ./studio.sh
  
Aceptar todo lo que propone y al final de todo crear un proyecto de prueba. Finalmente cerrar.

4. Eliminar el directorio "tools" que ha creado la instalación de Android Studio:

  rm -fr /home/usuario/Android/Sdk/tools
  
5. Descargar la versión 25.5.2 del SDK:

http://mirrors.neusoft.edu.cn/android/repository/
http://mirrors.neusoft.edu.cn/android/repository/tools_r25.2.5-linux.zip

6. Descomprimir el .zip

7. Copiar el directorio "tools" creado en el paso 6:

  cp -R /path/download/version_25_5_2/tools /home/usuario/Android/Sdk/
  
8. **NOTA** La última vez que he probado este procedimiento (04/10/2018) el "cordova build android" me funcionó, no seguí adelante con este paso.

Ahora aparece el siguiente error si queremos crear el proyecto de cordova:

<code>
FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred configuring root project 'android'.
> You have not accepted the license agreements of the following SDK components:
  [Android SDK Platform 24].
  Before building your project, you need to accept the license agreements and complete the installation of the missing components using the Android Studio SDK Manager.
  Alternatively, to learn how to transfer the license agreements from one workstation to another, go to http://d.android.com/r/studio-ui/export-licenses.html
</code>

Para aceptar la licencia lo más fácil es:

9. Actualizar el SDK:

  cd /home/usuario/Android/Sdk/tools/bin
  ./sdkmanager --update
  
Esto nos devuelve al punto 3. Por tanto:

10. Repetir los pasos 4 y 7

Y ahora si, usa la versión 25.5.2 del SDK con la licencia aceptada