Gestión de plugins

En esta sección vamos a ver como buscar, añadir, listar y eliminar plugins, además de algunas características avanzadas adicionales.

Buscar plugins

En la dirección "http://plugins.cordova.io" podemos consultar la lista completa de todos los plugins, incluyendo los que han sido desarrollados por la comunidad.

También es posible utilizar el CLI para buscar plugins en este registro. Por ejemplo, para buscar un pluging para códigos de barras usaríamos:

$ phonegap plugin search bar code

com.phonegap.plugins.barcodescanner - You can use the BarcodeScanner plugin...
...

En este caso devuelve varios resultados, un plugin oficial de PhoneGap y varios desarrollados por la comunidad. Es importante destacar que las búsquedas no distinguen mayúsculas y minúsculas, por lo que también podríamos haber buscado "Bar Code".

Si buscasemos únicamente por "Bar" obtendríamos muchos más resultados, incluyendo un plugin para trabajar con la barra de estado y otro para mostrar notificaciones:

$ phonegap plugin search bar

org.apache.cordova.statusbar - Cordova StatusBar Plugin
org.chromium.notifications - This plugin allows apps to show notifications in the status bar.
...

Añadir un plugin

Para añadir un plugin a un proyecto simplemente tenemos que indicar el repositorio que deseemos y el sistema se encargará de descargarlo e instalarlo. A continuación se incluye una lista de los plugins oficiales más utilizados y como tendríamos que instalarlos.

Obtener información del dispositivo:

$ phonegap plugin add cordova-plugin-device

Información sobre la conexión y la batería: (ver sección sobre eventos)

$ phonegap plugin add cordova-plugin-network-information
$ phonegap plugin add cordova-plugin-battery-statusbattery-status

Acelerómetro, brújula y geolocalización:

$ phonegap plugin add cordova-plugin-device-motion
$ phonegap plugin add cordova-plugin-magnetometer
$ phonegap plugin add cordova-plugin-device-orientation
$ phonegap plugin add cordova-plugin-geolocation

Cámara, reproducción y captura de contenidos multimedia:

$ phonegap plugin add cordova-plugin-camera
$ phonegap plugin add cordova-plugin-media-capture
$ phonegap plugin add cordova-plugin-media

Acceso a ficheros del dispositivo y de la red:

$ phonegap plugin add cordova-plugin-file
$ phonegap plugin add cordova-plugin-file-transfer

Notificaciones mediante diálogos y vibración:

$ phonegap plugin add cordova-plugin-dialogs
$ phonegap plugin add cordova-plugin-vibration

Contactos:

$ phonegap plugin add cordova-plugin-contactscontacts

Globalización:

$ phonegap plugin add cordova-plugin-globalization

Splashscreen o pantalla inicial:

$ phonegap plugin add cordova-plugin-splashscreen

Abrir nuevas ventanas de navegador (InAppBrowser):

$ phonegap plugin add cordova-plugin-inappbrowser

Consola de depuración:

$ phonegap plugin add cordova-plugin-console

Nota: los plugins se descargarán para las plataformas que tenga el proyecto actualmente instaladas. Si posteriormente se añaden más plataformas estos plugins se descargarán también de forma automática para la nueva plataforma.

Nota: al instalar un plugin de forma automática también se actualizarán los permisos necesarios para cada plataforma. Por ejemplo, en Android se actualizará el Manifest para solicitar los permisos necesarios.

Ver los plugins instalados

Para ver los plugins añadidos al proyecto actual podemos usar alguno de los siguientes comandos (todos son equivalentes), los cuales mostrarán un listado de paquetes instalados, junto con su versión y nombre:

$ phonegap plugin

# O también:
$ phonegap plugin ls

# O también:
$ phonegap plugin list

cordova-plugin-battery-status 1.1.1 "Battery"
cordova-plugin-console 1.0.2 "Console"
cordova-plugin-device 1.1.0 "Device"
cordova-plugin-network-information 1.1.0 "Network Information"
cordova-plugin-vibration 2.0.0 "Vibration"

Eliminar un plugin

Para eliminar un plugin simplemente tenemos que referirnos a él por el mismo nombre del paquete que utilizamos para su instalación (o que podemos ver si ejecutamos phonegap plugin ls). Por ejemplo, para eliminar el soporte a la consola de depuración ejecutaríamos:

$ phonegap plugin rm cordova-plugin-console

# O también:
$ phonegap plugin remove cordova-plugin-console

Añadir o elminar varios plugins a la vez

Si queremos añadir o eliminar varios plugins a la vez simplemente tenemos que indicarlos usando el mismo comando pero separados por espacios, de la forma:

$ phonegap plugin add cordova-plugin-console cordova-plugin-device

$ phonegap plugin rm cordova-plugin-console cordova-plugin-device

Advanced Plugin Options

Para opciones más avanzadas sobre la gestión de plugins, como por ejemplo instalar una versión en concreto de un plugin o instalar desde otro repositorio, podéis consultar la dirección:

http://docs.phonegap.com/en/edge/guide_cli_index.md.html#The Command-Line Interface_advanced_plugin_options