I plugin di Cordova

Esplorando le API di Apache Cordova abbiamo avuto modo di vedere come coprire la maggior parte delle esigenze di sviluppo di un'app mobile. Le API ci consentono di utilizzare funzioni native mediante JavaScript ignorando i dettagli implementativi di ciascuna piattaforma mobile. Ma cosa fare se abbiamo bisogno di una funzionalità nativa non prevista dalle API? In questo caso possiamo far ricorso ai plugin.

Un plugin Cordova è un componente software che consente di mappare una funzione JavaScript ad una funzionalità nativa. Esso è costituito da un'unica interfaccia JavaScript e da tante implementazioni dipendenti dalla specifica piattaforma mobile. In realtà tutte le API di Cordova sono implementate secondo questo modello, quindi un plugin non fa altro che estendere le API aggiungendo nuove funzionalità.

Per rendercene conto possiamo dare un'occhiata al Cordova Registry, il repository che contiene i plugin di sistema oltre a qualcun altro di supporto. Per plugin di terze parti disponibili online citiamo il repository di Google, quello di Adobe e di Blackberry oltre naturalmente a plugin sviluppati da programmatori indipendenti.

Plugman, utilizzare un plugin di terze parti

Per utilizzare un plugin di terze parti nella nostra applicazione possiamo far ricorso all'utility a riga di comando plugman, che si integra in Cordova-Cli.

Per l'installazione della utility eseguiamo il seguente comando da una shell:

npm install -g plugman

A questo punto possiamo installare il plugin che vogliamo utilizzare nel nostro progetto Cordova utilizzando il comando:

plugman install

Supponiamo ad esempio di voler utilizzare il plugin BarcodeScanner, che consente di effettuare la scansione di codici a barre, in un nostro progetto che dovrà girare su Android e iOS. Possiamo farlo lanciano i comandi:

plugman install --platform android --project /CordovaProject --plugin /Cordova/plugins/BarcodeScanner

plugman install --platform ios --project /CordovaProject --plugin /Cordova/plugins/BarcodeScanner

I parametri minimi che dobbiamo specificare sono la piattaforma mobile di riferimento, la cartella del nostro progetto Cordova e il riferimento al plugin.

Il riferimento al plugin può essere specificato in diversi modi. Nell'esempio proposto abbiamo specificato il percorso locale in cui si trova il componente software. In alternativa possiamo specificare l'URL che punta al plugin; se invece specifichiamo soltanto il nome del plugin, allora ci stiamo riferendo ad un plugin che si trova nel Cordova Registry.

Il comando plugman install prevede altri parametri che consentono di specificare opzioni avanzate per l'individuazione e la configurazione dei plugin, ma per semplicità ci fermiamo alle opzioni di base.

Una volta installato un plugin possiamo utilizzarlo dal nostro progetto Cordova in modo analogo a come utilizziamo le API. Ad esempio, possiamo avviare la scansione di un codice a barre tramite il seguente codice JavaScript:

scanner.scan(onSuccess, onError);

Se desideriamo disinstallare un plugin da un progetto possiamo farlo sempre con plugman tramite il seguente comando:

plugman uninstall --platform ios --project /CordovaProject --plugin BarcodeScanner

La gestione dei plugin tramite plugman è stata introdotta nella versione 3.0 di Apache Cordova. L'introduzione di questo strumento richiede che la realizzazione di un plugin sia conforme ad apposite specifiche; quindi se intendete utilizzate un plugin nei vostri progetti assicuratevi che sia compatibile con la versione 3.0 di Cordova. In caso contrario sarà necessario seguire le istruzioni fornite dallo sviluppatore per installare lo specifico plugin, cosa che in taluni casi richiede la copia manuale di file per ciascuna piattaforma e la modifica di alcune configurazioni.