Uporaba Plugman za upravljanje Plugins

Od različice 3.0 naprej, Cordova izvaja vse naprave API kot plugins, in nanje privzeto onemogočene. Podpira tudi dva različna načina za dodajanje in odstranjevanje plugins. Prvi je s pomočjo na cordova CLI, opisane v vmesnik ukazne vrstice. Drugi je z uporabo nižje ravni Plugman vmesnik ukazne vrstice (potek dela "Native platformo dev".) Glavna razlika med teh dveh razvojnih poti je, da Plugman lahko samo dodati plugins eno platformo naenkrat, ker CLI bo dodati plugins vse platforme, ki jih ciljate. Zaradi tega je bolj smiselno uporabiti Plugman, ko delate tesno z enotno platformo, zato ime "Native platformo Dev" potek dela.

Več informacij na Plugman, še posebej, če ste zainteresirani za uživanje Plugman kot vozlišče modul ali taksist na šifro Plugman, glejte README datoteko v svojem skladišču.

Namestitev Plugman

Namestite plugman, morate imeti sečišče nameščen v vašem računalniku. Potem vi moči prost dostop sledeč zapoved od kjerkoli v vašem okolju namestiti plugman globalno, tako da je na voljo od poljuben imenik v računalniku:

$ npm install -g plugman

Vi življati imeti tudi git na vaš PATH biti sposobni namestiti plugins neposredno iz oddaljenih kreten URLs.

Nasvet: Če ugotovite, da po namestitvi plugman z npm ste še vedno nezmožen teči poljuben plugman ukaze, se prepričajte, da ste dodali v /npm/ imenik v vašPATH.

Opomba: Ta korak lahko preskočite, če ne želite, da onesnažujejo globalni npm namespace z namestitvijo Plugman na svetovni ravni. Če je temu tako, potem ko ustvarite Cordova projekt z lupino orodja, bo na node_modules imenik znotraj vašega projekta, ki vsebuje Plugman. Ker si ne instally globalno, boste morali sklicevati vozlišča za vsak Plugman ukaz, na primer node ./node_modules/plugman/main.js -version . Preostanek ta vodnik prevzame ste namestili Plugman globalno, kar pomeni, da lahko zaženete s samoplugman.

Ustvarjanje Cordova projekta

Preden lahko uporabite Plugman, morate ustvariti projekt Cordova. To storite z bodisi z ukazno vrstico ali nižji ravni lupine skripte. Navodila za uporabo lupine skripte, da ustvarite svoj projekt se nahajajo v različnih "Ukazne vrstice orodja" vodniki, navedena na platformo vodniki.

Dodal Plugin

Nekoč vi življati umestiti Plugman ter ustvarili projekt Cordova, lahko začnete dodajanje plugins platformo z:

$ 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> ...]]

Z uporabo minimalne parametrov, ta ukaz namesti plugin v projektu cordova. Navesti morate mesto platformo in cordova projekta za to platformo. Prav tako morate navesti plugin, z različnimi --plugin parameter oblike bitje:

  • name: Ime imenika, kjer obstaja plugin vsebino. To mora biti obstoječ imenik pod na --plugins_dir poti (glej spodaj za več info) ali plugin v registru Cordova.
  • url: URL začne z https:// ali kreten: / /, če pokažete veljavno git skladišče, ki je clonable in vsebuje a plugin.xml pila. Bi program kopira vsebino tega skladišča v na--plugins_dir.
  • path: Pot do imenika, ki vsebuje veljavne plugin, ki vključuje a plugin.xml pila. Ta pot vsebine bodo kopirani v na--plugins_dir.

Drugi parametri:

  • --plugins_dirprivzeto <project>/cordova/plugins , vendar je lahko poljuben imenik, ki vsebuje podimenik za vsako nerealne plugin.
  • --wwwprivzete nastavitve v projekt www mesto mape, vendar lahko naslovnik, ki se uporablja kot cordova projekt uporabe spletnih sredstev.
  • --variableomogoča, da določite nekatere spremenljivke v napeljati čas, potreben za nekatere plugins, ki zahteva API tipke ali drugih parametrov, po meri, uporabniško definirane. Oglejte si specifikacije plugin za več informacij.

Odstranite Plugin

V uninstall plugin, da preprosto prenesti na --uninstall zastava ter zagotoviti plugin ID.

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

Pomoč ukazov

Plugman značilnosti globalnih pomoč ukaz, ki vam lahko pomagajo, če vi zaslužiti zaljubljen ali so težave. Prikaže seznam vseh ukazov Plugman in svoje sintakse:

plugman -help
plugman  # same as above

Opomba: plugman -help lahko kažejo nekatere dodatne ukaze povezan z registrom. Ti ukazi so plugin za razvijalce in ne smejo izvajati na tretji plugin registrov.

Lahko tudi dodate v --debug|-d zastave Plugman ukaz, da zaženete ta ukaz v podrobnem načinu, ki bo prikazal vse notranje informacije o iskanju napak, saj so oddane in vam lahko pomagajo izslediti težave, kot so manjkajoče datoteke.

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

Končno, lahko uporabite na --version|-v zastavo, da vidite, katera različica Plugman, ki ga uporabljate.

plugman -v

Registracija dejavnosti

Obstajajo številne plugman ukazov, ki se lahko uporabijo za interakcijo s registracija Plugin. Prosimo, upoštevajte, da ti ukazi register posebej za register plugins.cordova.io plugin, ne smejo izvajati tretji plugin registri.

Iščete Plugin

Plugman lahko uporabite za iskanje registracija Plugin za plugin id's, ki ustreza dani prostor ločen seznam ključnih besed.

plugman search <plugin keywords>

Sprememba Plugin registracija

Lahko dobite ali pa nastavite URL sedanji registracija plugin, ki uporablja plugman. Na splošno mora zapustiti ta nastavljena na http://registry.cordova.io, razen če vi biti brez rabiti a tretji stranka plugin registra.

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

Get Plugin informacije

Lahko dobite informacije o posebnih plugin shranjeni v plugin skladišču:

plugman info <id>

To bo stik plugin registracija ter puščati podatke, kot so številka različice je plugin.

Namestitvi Plugins jedro

Spodnji primeri kažejo, kako dodati plugins, kot je potrebno, da vse Cordova API uporabljate v vašem projektu še vedno dela, ko nadgradite na različico 3.0. Za vsak ukaz, morate izbrati ciljni platformi, in referenčno platformo imenik projekta.

  • 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