Vmesnik ukazne vrstice
Ta vodič vam pokaže, kako ustvariti aplikacije in jih razporedi na različne native mobilne platforme, z uporabo v cordova
vmesnik ukazne vrstice (CLI). To orodje vam omogoča, da ustvarite nove projekte, jih gradijo na različnih platformah in teči na pravi naprave ali znotraj emulators. CLI je glavno orodje za navzkrižno platformo potek dela (glej pregled za opis različnih potekov dela.) Vendar pa lahko uporabite tudi CLI Inicializacija projekta zakonika, po katerem uporabljate različnih platform SDK in shell orodja za nadaljevanje razvoja.
Predpogoji
Preden zaženete kateri koli orodja ukazne vrstice, morate namestiti SDK za vsako platformo, ki jih želite ciljati. (Glej navodila platformo za več podrobnosti.)
Dodajanje podpore ali obnovo projekt za vse platforme, morate zagnati vmesnik ukazne vrstice iz istega stroja, ki podpira SDK platformo. CLI podpira naslednje kombinacije:
- iOS (Mac)
- Amazon ogenj OS (Mac, Linux, Windows)
- Android (Mac, Linux)
- BlackBerry 10 (Mac, Linux, Windows)
- Windows Phone 7 (Windows)
- Windows Phone 8 (Windows)
- Windows 8 (Windows)
- Firefox OS (Mac, Linux, Windows)
Na Mac, ukazne vrstice je na voljo prek uporabe Terminal . Na PC, je na voljo kot zapoved uren pod dodatki.
Bolj verjetno je da zaženete CLI iz različnih strojev, bolj smiselno ohraniti remote source code repozitorij, katerih premoženje porušiti lokalne delovne imenikov.
Namestiti na cordova
zapoved-črta orodje, sledite tem korakom:
Travnato gričevje ter napeljati Node.js. Po namestitvi lahko sklicevanje na
node
alinpm
v ukazni vrstici.Namestite v
cordova
korist. V Unix, prefixing dodatnosudo
ukaz bo morda treba namestiti razvoj utilities sicer omejuje imenikov:$ sudo npm install -g cordova
Dnevnik namestitve lahko povzroči napake za vsako uninstalled platform SDK. Po namestitvi lahko teči
cordova
v ukazni vrstici.Opomba: na
-g
zastavo zgoraj pove npm namestiti cordova globalno. Morda boste morali dodati npm imenik v vaš STEZA za uveljavljanje globalno umestiti npm modulov. Na Windows, npm ponavadi najdete naC:\Users\username\AppData\Roaming\npm
in na Unix v/usr/local/share/npm
.
Ustvari App
Pojdite v imenik, kjer želite ohraniti vaše izvorne kode, in zaženite ukaz in sicer:
$ cordova create hello com.example.hello HelloWorld
To lahko traja nekaj časa za ukaz za dokončanje, zato bodite potrpežljivi. Tekmovanje v teku zapoved s je -d
možnost prikaže informacije o napredku.
Prvi argument hello določa imenik, za vaš projekt. Ta imenik že ne bi smela obstajati, Cordova bo ustvaril za vas. Svoje www
subdirectory hiše aplikacije domačo stran, skupaj z različnih virov pod css
, js
, in img
, ki sledijo skupne spletne razvoj poimenovanja datotek. Na config.xml
Datoteka vsebuje pomembno metapodatkov, potrebne za ustvarjanje in distribucijo uporabo.
Drugi argument com.example.hello
projektu zagotavlja povratne domene-style identifikator. Ta argument je neobvezno, vendar le, če izpustite tudi tretji argument, saj so argumenti položaja. Urejate lahko ta vrednost kasneje v v config.xml
datoteko, vendar se zaveda, da lahko pride do kode, ustvarjene zunaj programa config.xml
uporabo te vrednosti, kot so Java paket imena. Privzeta vrednost je io.cordova.hellocordova
, vendar je priporočljivo, da izberete ustrezno vrednost.
Tretji argument HelloWorld
zagotavlja aplikacije zaslona naslov. Ta argument je neobvezen. Urejate lahko ta vrednost kasneje v v config.xml
datoteko, vendar se zaveda, da lahko pride do kode, ustvarjene zunaj programa config.xml
uporabo te vrednosti, kot so imena razredov Java. Privzeta vrednost je HelloCordova
, vendar je priporočljivo, da izberete ustrezno vrednost.
Dodaj platforme
Vse kasnejše zapoved potreba teči v okviru projekta imenik, ali vse podimenike v njeno področje uporabe:
$ cd hello
Preden lahko zgraditi projekt, morate določiti nabor ciljne platforme. Vašo sposobnost za vožnjo teh ukazov odvisna od tega, ali računalnik podpira vsako SDK, in ali ste že namestili vsako SDK. Zaženete kateri koli od teh iz Mac:
$ cordova platform add ios
$ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
Zaženete kateri koli od teh s okno stroj, kjer wp se nanaša na različne različice operacijskega sistema Windows Phone:
$ cordova platform add wp7
$ cordova platform add wp8
$ cordova platform add windows8
$ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
Teči to v ček vaš trenutni nabor platforme:
$ cordova platforms ls
(Opomba za platform
in platforms
ukazi so sinonim.)
Zaženite enega od naslednjih sinonim ukazov umakniti platforma:
$ cordova platform remove blackberry10
$ cordova platform rm amazon-fireos
$ cordova platform rm android
Izvaja ukaze za dodajanje ali odstranjevanje platforme vpliva na vsebino projekta platforme imenik, kjer se zdi vsako določeno platformo kot podimenik. Www Izvorni imenik je povzeto v podimeniku vsako platformo, ki se pojavljajo na primer v platforms/ios/www
ali platforms/android/assets/www
. Ker CLI nenehno kopira nad datoteke v www mapi vir, naj le urejate te datoteke in ne tisti, ki se nahaja pod platform podimenikov. Če vi raba prevod pregled software, vi should povečati to vir www mapo, skupaj z mapo , ki se v vaši različici sistema nadzora. (Več informacij o mapi združuje najdete v razdelku Prilagajanje vsako platformo spodaj.)
Opozorilo: pri uporabi CLI zgraditi vaš zahtevek, se močno odvrača od urejanje datotek v v /platforms/
zgibalnik če veš kaj delaš, ali so posebej povedal drugače v dokumentaciji. Namreč datoteke v na /platforms/
direcotry prepišejo na pripravo ali plugin reinstallation.
Če želite na tej točki, lahko uporabite SDK, kot so za Eclipse ali Xcode odpreti projekt, ki ste jo ustvarili. Boste morali odpreti naboru izvedenih finančnih sredstev iz z /platforms/
imenik razviti s je SDK. To je zato, ker SDK posebne metapodatkov datoteke shranijo v ustrezno /platform/
podimeniku. (Glej navodila platformo za informacije o tem, kako razviti aplikacije znotraj vsakega IDE.) Ta pristop uporabite, če želite le inicializirati projekt using CLI in nato preklopiti SDK za native delo.
Berite naprej, če želite uporabiti potek dela prek-plosčad pristop (CLI) za celoten razvoj ciklus.
Graditi App
Privzeto je cordova create
scenarij ustvari skeletnih spletni program, katerega domača stran je projekta www/index.html
datoteke. Uredite ta program, pa hočeš, ampak vse inicializacijo mora biti naveden kot del je [deviceready](../../cordova/events/events.deviceready.html)
rutine, sklicuje privzeti izwww/js/index.js
.
Zaženite ukaz zgraditi iteratively projekta:
$ cordova build
To ustvarja platformo-posebno kodo v okviru projekta platforms
podimeniku. Po želji lahko omeji obseg vsake graditi na posebnih platformah:
$ cordova build ios
Je cordova build
ukaz je okrajšava za naslednje, kar je v tem primeru je tudi usmerjena v enotno platformo:
$ cordova prepare ios
$ cordova compile ios
V tem primeru, ko zaženete prepare
, uporabite Applov SDK Xcode kot alternativa za spreminjanje in pripraviti platformo-posebno kodo, ki Cordova ustvarja v platforms/ios
. Uporabite lahko enak pristop z drugih platform SDK.
Test App Emulator ali napravi
SDK za mobilne platforme, pogosto priti povesmo s emulators, ki izvaja naprava podoba, tako da lahko začetek app z za četnega zaslona in videli, kako komunicira z veliko funkcij platformo. Zaženite ukaz, in sicer za obnovo app in si ogledali na posebni platformi emulator:
$ cordova emulate android
Nekatere mobilne platforme tekmovati z posebno napravo privzeto, kot so iPhone iOS projektov. Za druge platforme, boste morda morali najprej povežite napravo z emulator.
Opomba: Emulator podpore trenutno ni na voljo za Amazon ogenj OS
(Glej navodila platformo za podrobnosti.) Na primer, boste morda najprej zagnati v android
ukaz za zagon Android SDK, nato zaženite določene naprave sliko, ki se začenja po svoje privzeto vedenje:
Naslednji up s je cordova emulate
ukaz Osveži prikaz zadnje prijave, ki je zdaj na voljo za zagon z za četnega zaslona emulator slike:
Izmenično, lahko slušalko priključite v računalnik in test app neposredno:
$ cordova run android
Preden zaženete ta ukaz, morate nastaviti napravo za testiranje, po postopkih, ki se razlikujejo za vsako platformo. V napravah Android in Amazon ogenj OS, bi morali usposobiti USB debugging možnost na napravi, in morda dodali USB voznik glede na razvoj environmnent. Glej platformo vodniki za podrobnosti o zahtevah za vsako platformo.
Dodaj Plugin funkcije
Ko boste graditi in si ogledate nov projekt, ne naredi privzeti program, ki se pojavi zelo veliko. Spremenite app v marsičem zavzeti ugodnost od standardne spletne tehnologije, ampak za app za tesno komunikacijo z različnih funkcij naprave-ravni, morate dodati plugins, ki zagotavljajo dostop do jedra Cordova API.
Plugin je malo add-on kodo, ki zagotavlja vmesnik za avtohtone komponente. Lahko oblikujete svoje plugin vmesnika, na primer pri načrtovanju hibridni app, ki meša Cordova spletni pogled z native komponent. (Glej Embedding spletni pogledi in Plugin razvoj vodnik za podrobnosti.) Bolj pogosto, bi dodal plugin, da eden od osebe Cordova osnovne funkcije naprave ravni podroben sklic API. Seznam teh plugins, vključno z dodatnih plugins, ki jih Skupnosti, je mogoče najti na plugins.cordova.io. CLI lahko uporabite za iskanje plugins iz tega registra. Na primer, iskanje bar
in code
Ustvari posamezen razultat, ki ustreza tako pogoji kot case-insensitive podnizov:
$ cordova plugin search bar code
com.phonegap.plugins.barcodescanner - Scans Barcodes
Iskanje samo v bar
term donosov in dodatni rezultat:
org.apache.cordova.statusbar - Cordova StatusBar Plugin
Je cordova plugin add
ukaz zahteva, da določite skladišča za plugin kodo. Prosimo, upoštevajte, da ko sledite spletni projekt Dev poteka dela in uporabo CLI, CLI bo poskrbel za dodajanje plugin kodo na primerno mesto za vsako platformo. (Če ste Native poteka dela projekta Dev, boste morali dodati plugins uporabljajo Plugman (vodnik link tukaj), večkrat za vsako platformo.)
Tukaj so primeri, kako lahko uporabljate CLI funkcije dodati app:
Osnovne naprave informacije o napravi:
$ cordova plugin add org.apache.cordova.device
Omrežno povezavo in baterija dogodkov:
$ cordova plugin add org.apache.cordova.network-information $ cordova plugin add org.apache.cordova.battery-status
Pospeška, kompas in Geolocation:
$ cordova plugin add org.apache.cordova.device-motion $ cordova plugin add org.apache.cordova.device-orientation $ cordova plugin add org.apache.cordova.geolocation
Fotoaparat, predvajanje medijev in zajema:
$ cordova plugin add org.apache.cordova.camera $ cordova plugin add org.apache.cordova.media-capture $ cordova plugin add org.apache.cordova.media
Dostop do datotek v napravi ali omrežju (datoteka API):
$ cordova plugin add org.apache.cordova.file $ cordova plugin add org.apache.cordova.file-transfer
Obveščanje preko pogovornega okna ali vibracij:
$ cordova plugin add org.apache.cordova.dialogs $ cordova plugin add org.apache.cordova.vibration
Stiki:
$ cordova plugin add org.apache.cordova.contacts
Globalizacija:
$ cordova plugin add org.apache.cordova.globalization
Splashscreen:
$ cordova plugin add org.apache.cordova.splashscreen
Plan nov obrv okno (InAppBrowser):
$ cordova plugin add org.apache.cordova.inappbrowser
Debug konzolo:
$ cordova plugin add org.apache.cordova.console
Uporaba plugin ls
(ali plugin list
, ali plugin
sama) za ogled trenutno nameščen plugins. Vsak za prikaz svojih identifikator:
$ cordova plugin ls # or 'plugin list'
[ 'org.apache.cordova.console' ]
Če želite odstraniti plugin, sklicujejo nanj z istim identifikatorjem, ki se prikaže na seznamu. Na primer, tukaj je, kako bi odstrani podporo za konzolo debug s izpust prevod:
$ cordova plugin rm org.apache.cordova.console
$ cordova plugin remove org.apache.cordova.console # same
Lahko batch-odstrani ali dodati plugins določite več argumentov za vsak ukaz:
$ cordova plugin add org.apache.cordova.console org.apache.cordova.device
Plugin napredne možnosti
Pri dodajanju plugin, več možnosti vam omogočajo, da določite, kje v puščati čep. Primeri zgoraj uporabljajo znane registry.cordova.io
registra, in plugin je določil na id
:
$ cordova plugin add org.apache.cordova.console
Na id
lahko vključujejo tudi v čep prevod števnik, dodan po je @
značaja. Je latest
različica je alias za najnovejšo različico. Na primer:
$ cordova plugin add org.apache.cordova.console@latest
$ cordova plugin add org.apache.cordova.console@0.2.1
Če plugin ni registrirana v registry.cordova.io
ampak se nahaja v drugi kreten skladišče, lahko določite nadomestni URL:
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git
Kreten zgornjem puščati čep od konca glavni podružnici, ampak nadomestnega kreten-ref tag ali podružnice je treba dodati po a #
znak:
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
Če plugin (in njenih plugin.xml
Datoteka) je v podimeniku v git repo, lahko določite z a :
znak. Upoštevajte, da je #
znak je še vedno potreben:
$ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
Lahko tudi združite kreten-ref in podmapo:
$ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
Izmenično, določite lokalna pot do imenika plugin, ki vsebuje v plugin.xml
datoteke:
$ cordova plugin add ../my_plugin_dir
Z uporabo spajanja prilagodite vsako platformo
Medtem ko Cordova omogoča preprosto uvajanje app za različne platforme, včasih boste morali dodati prilagoditve. V tem primeru ne želite spremeniti izvornih datotek v različnih www
imenikov v najvišje ravni platforms
imenik, ker so si redno nadomesti z najvišje ravni www
directory's prek-plosčad vir.
Namesto tega, najvišje ravni merges
imenik ponuja prostor za določanje sredstev za razporeditev na posebnih platformah. Vsake posamezne subdirectory v merges
ogledala directory struktura je www
vir drevo, ki vam omogoča, da preglasijo ali dodajanje datotek, kot je potrebno. Na primer, tukaj je, kako lahko uporab merges
povečati privzeto velikost pisave za naprave Android in Amazon ogenj OS:
Urejanje z
www/index.html
datoteko, dodal link za dodatne datoteke CSS,overrides.css
v tem primeru:<link rel="stylesheet" type="text/css" href="css/overrides.css" />
Če želite ustvariti prazno
www/css/overrides.css
datoteko, ki bi veljala za vse gradi Android, preprečuje napako manjkajoče datoteke.Ustvarite a
css
subdirectory vmerges/android
, nato dodamo ustrezenoverrides.css
datoteke. Določite CSS, ki preglasi 12-point privzeto velikost pisave, ki je določena vwww/css/index.css
, na primer:body { font-size:14px; }
Ko znova zgradite projekta, Android prevod značilnosti velikosti pisave po meri, medtem ko druge ostanejo nespremenjene.
Uporabite lahko tudi merges
dodati datoteke niso prisotni v izvirniku www
imenik. Primer app lahko vključi grafike prislon popek v iOS vmesnik, shranjeni v merges/ios/img/back_button.png
, medtem ko Android prevod lahko namesto kapitan [backbutton](../../cordova/events/events.backbutton.html)
dogodkov iz ustreznih železnina popek.
Pomoč ukazov
Cordova ponuja nekaj globalni ukazi, ki vam lahko pomaga, če vi zaslužiti zaljubljen ali pride do težave. Je help
ukaz prikaže vse razpoložljive ukaze Cordova in svoje sintakse:
$ cordova help
$ cordova # same
Je info
ukaz Ustvari seznam potencialno koristnih podrobnosti, kot so trenutno nameščenih platforme in plugins, SDK različice za vsako platformo in različice CLI in node.js
:
$ cordova info
Tako predstavlja informacije na zaslonu in ujame izhod v lokalni info.txt
datoteke.
Opomba: trenutno, samo podrobnosti na iOS in Android platforme so na voljo.
Posodabljanje Cordova in projekt
Po namestitvi v cordova
korist, jo lahko vedno posodobite v najnovejšo različico z tekmovanje v teku sledeč zapoved:
$ sudo npm update -g cordova
Za namestitev posebne različice, uporabite to sintakso:
$ sudo npm install -g cordova@3.1.0-0.2.0
Teči cordova -v
videti, katera različica je trenutno nameščena. Teči na npm
info
ukaz za daljši seznam, ki vključuje trenutno različico skupaj z drugimi na voljo različica številke:
$ npm info cordova
Cordova 3.0 je prva različica, ki podpira vmesnik ukazne vrstice, ki so opisane v tem razdelku. Če želite posodobiti iz različice pred 3,0, boste morali ustvariti nov projekt, kot je opisano zgoraj, torej ulitek starejši uporabe sredstev v najvišje ravni www
imenik. Po potrebi nadaljnje podrobnosti o nadgradnji na 3.0 so na voljo v platformo vodniki. Ko nadgradite na cordova
vmesnik ukazne vrstice in uporabo npm update
ostati veljavna, bolj zamudno tam opisani postopki niso več ustrezni.
Cordova 3.0 + lahko še vedno zahtevajo različne spremembe na ravni projekta imenik strukture in drugih odvisnosti. Ko zaženete na npm
zapoved zgoraj za posodobitev Cordova, sama, boste morda morali za zagotovitev vaš projekt virov s ki postaja latenten prevod zahteve. Zaženite ukaz kot sledi za vsako platformo ste izgradnjo:
$ cordova platform update android
$ cordova platform update ios
...etc.