L'utilizzo di Plugman per gestire i plugin

Dalla versione 3.0 in poi, Cordova implementa dispositivo tutte le API come plugin e li lascia disattivata per impostazione predefinita. Supporta inoltre due modi per aggiungere e rimuovere il plugin. Il primo è tramite il cordova CLI descritto in l'interfaccia della riga di comando. Il secondo è tramite un'interfaccia della riga di comando di Plugman basso livello ("piattaforma nativa dev" flusso di lavoro). La differenza principale tra questi percorsi di due sviluppo è che Plugman può solo aggiungere plugin alla uno piattaforma alla volta, mentre il CLI aggiungere plugins per tutte le piattaforme che vi si rivolgono. Per questo motivo, ha più senso utilizzare Plugman quando si lavora strettamente con un'unica piattaforma, da qui il nome "Dev Platform Native" del flusso di lavoro.

Per ulteriori informazioni su Plugman, soprattutto se siete interessati a consumare Plugman come modulo nodo o hacking sul codice Plugman, vedere il file README nel suo repository.

L'installazione Plugman

Per installare plugman, è necessario disporre di nodo installato sulla vostra macchina. Poi è possibile eseguire il seguente comando da ovunque nel vostro ambiente per installare plugman globalmente, in modo che è disponibile da qualsiasi directory sul tuo computer:

$ npm install -g plugman

Deve anche avere git sul tuo PATH per poter installare il plugin direttamente da URL remoto git.

Suggerimento: Se si trova che dopo l'installazione di plugman con npm siete ancora in grado di eseguire qualsiasi plugman comandi, assicurarsi che sono aggiunti il /npm/ directory nel tuoPATH.

Nota: Si può saltare questo passaggio se non vuoi inquinare lo spazio dei nomi globale GEMAP installando Plugman globalmente. Se questo è il caso, poi quando si crea un progetto di Cordova con gli strumenti di conchiglia, ci sarà un node_modules directory all'interno del progetto che contiene Plugman. Dato che hai fatto non instally a livello globale, si dovrà richiamare il nodo per ogni comando di Plugman, ad esempio node ./node_modules/plugman/main.js -version . Il resto di questa guida presuppone che sia stata installata Plugman globalmente, significato che è possibile richiamarla con soloplugman.

Creare un progetto di Cordova

Prima di utilizzare Plugman, è necessario creare un progetto di Cordova. È possibile farlo con entrambi l'interfaccia della riga di comando o con gli script di shell di livello inferiori. Istruzioni per utilizzare gli script di shell per creare il progetto si trovano nelle varie guide "Gli strumenti della riga di comando" elencati nella pagina guide piattaforma.

L'aggiunta di un Plugin

Una volta che hai installato Plugman e hanno creato un progetto di Cordova, è possibile iniziare l'aggiunta di plugin per la piattaforma con:

$ plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]

Utilizzando i parametri minimi, questo comando installa un plugin in un progetto di cordova. È necessario specificare un percorso di progetto piattaforma e cordova per tale piattaforma. È necessario specificare anche un plugin, con le diverse --plugin parametro forma essendo:

  • name: Il nome della directory dove il contenuto del plugin esiste. Questo deve essere una directory esistente sotto il --plugins_dir percorso (vedi sotto per maggiori informazioni) o un plugin del registro di sistema di Cordova.
  • url: Un URL che inizia con https:// o git: / /, che punta a un repository git valido che è duplicabile e contiene un plugin.xml file. Il contenuto di questo archivio verrebbero copiato nella--plugins_dir.
  • path: Un percorso di una directory contenente un valido plugin che include un plugin.xml file. Contenuti di questo percorso verranno copiati nella--plugins_dir.

Altri parametri:

  • --plugins_dirimpostazione predefinita è <project>/cordova/plugins , ma può essere qualsiasi directory che contiene una sottodirectory per ogni plugin scaricato.
  • --wwwimpostazioni predefinite per il progetto www percorso di cartella, ma può essere qualsiasi directory che deve essere utilizzata come attività di cordova progetto applicazione web.
  • --variablepermette di specificare determinate variabili in fase di installazione, necessario per alcuni plugin che richiedono chiavi API o altri parametri personalizzati, definito dall'utente. Si prega di consultare la specifica di plugin per ulteriori informazioni.

Rimuovere un Plugin

Per disinstallare un plugin, è sufficiente passare il --uninstall bandiera e fornire l'ID del plugin.

$ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]

Aiuto comandi

Plugman dispone di un comando di aiuto globale che può aiutarvi se rimani bloccato o sono problemi. Visualizzerà un elenco di tutti i comandi Plugman e la loro sintassi:

plugman -help
plugman  # same as above

Nota: plugman -help possono mostrare alcuni comandi aggiuntivi del registro di sistema correlate. Questi comandi sono per gli sviluppatori di plugin e non possono essere implementati sui registri di plugin di terze parti.

Può anche aggiungere il --debug|-d bandiera a qualsiasi comando Plugman per eseguire quel comando in modalità dettagliata, che consentirà di visualizzare i messaggi di debug interni quanto vengono emessi e può aiutare a tenere traccia dei problemi come file mancanti.

# Adding Android battery-status plugin to "myProject":
plugman -d --platform android --project myProject --plugin org.apache.cordova.battery-status

Infine, è possibile utilizzare il --version|-v bandiera per vedere quale versione di Plugman si utilizza.

plugman -v

Azioni del registro di sistema

Ci sono un certo numero di comandi plugman che può essere utilizzato per interagire con il Registro dei Plugin. Si prega di notare che questi comandi del registro di sistema sono per il plugin plugins.cordova.io del registro di sistema e non possono essere attuati dai registri di plugin di terze parti.

Stai cercando un Plugin

È possibile utilizzare Plugman per il Registro dei Plugin per plugin id che corrisponde all'elenco dato spazio separato di parole chiave di ricerca.

plugman search <plugin keywords>

Modificando il registro di sistema di Plugin

È possibile ottenere o impostare l'URL del registro attuale plugin che utilizza plugman. Generalmente si dovrebbe lasciare questo insieme a http://registry.cordova.io, a meno che non si desidera utilizzare un registro di plugin di terze parti.

plugman config set registry <url-to-registry>
plugman config get registry

Ottenere informazioni di Plugin

È possibile ottenere informazioni su qualsiasi plugin specifici memorizzati nel repository con plugin:

plugman info <id>

Questo metterà in contatto il plugin del registro di sistema e recuperare informazioni quali il numero di versione del plugin.

L'installazione di plugin di Core

Negli esempi seguenti mostrano come aggiungere plugin come necessario affinché qualsiasi APIs Cordova è utilizzare nel progetto di lavorare ancora dopo l'aggiornamento alla versione 3.0. Per ogni comando, è necessario selezionare la piattaforma di destinazione e la directory del progetto della piattaforma di riferimento.

  • cordova-plugin-battery-status

    plugman --platform --project --plugin org.apache.cordova.battery-status

  • cordova-plugin-camera plugman --platform --project --plugin org.apache.cordova.camera

  • cordova-plugin-console plugman --platform --project --plugin org.apache.cordova.console

  • cordova-plugin-contacts plugman --platform --project --plugin org.apache.cordova.contacts

  • cordova-plugin-device plugman --platform --project --plugin org.apache.cordova.device

  • cordova-plugin-device-motion (accelerometer) plugman --platform --project --plugin org.apache.cordova.device-motion

  • cordova-plugin-device-orientation (compass) plugman --platform --project --plugin org.apache.cordova.device-orientation

  • cordova-plugin-dialogs plugman --platform --project --plugin org.apache.cordova.dialogs

  • cordova-plugin-file plugman --platform --project --plugin org.apache.cordova.file

  • cordova-plugin-file-transfer plugman --platform --project --plugin org.apache.cordova.file-transfer

  • cordova-plugin-geolocation plugman --platform --project --plugin org.apache.cordova.geolocation

  • cordova-plugin-globalization plugman --platform --project --plugin org.apache.cordova.globalization

  • cordova-plugin-inappbrowser plugman --platform --project --plugin org.apache.cordova.inappbrowser

  • cordova-plugin-media plugman --platform --project --plugin org.apache.cordova.media

  • cordova-plugin-media-capture plugman --platform --project --plugin org.apache.cordova.media-capture

  • cordova-plugin-network-information plugman --platform --project --plugin org.apache.cordova.network-information

  • cordova-plugin-splashscreen plugman --platform --project --plugin org.apache.cordova.splashscreen

  • cordova-plugin-vibration plugman --platform --project --plugin org.apache.cordova.vibration