Das Kommandozeilen-Tool zum Erstellen, bereitstellen und Verwalten von Cordova-basierten Anwendungen.
Apache-Cordova ermöglicht native mobile Applikationen mit HTML, CSS und JavaScript erstellen. Dieses Tool hilft bei der Verwaltung von Multiplattform-Cordova-Anwendungen sowie Cordova Plugin Integration.
Schauen Sie sich die Erste Schritte-Handbücher für weitere Informationen zum Arbeiten mit Teilprojekte Cordova.
Werkzeuge
und Plattform-Tools
-Verzeichnisse auf Ihrem Systempfad sonst Android Unterstützung schlägt fehl.Msbuild
auf Ihrem Systempfad haben sonst Windows Phone Unterstützung fehl (msbuild.exe
im allgemeinen befindet sich im C:\Windows\Microsoft.NET\Framework\v4.0.30319
).Abhängigkeiten/Werkzeuge/bin
Ordner im SDK-Verzeichnis auf Ihrem Pfad hinzugefügt haben!Xcode
und Xcode-Befehlszeilen-Tools
Msbuild
auf Ihrem Systempfad haben sonst Windows Phone Unterstützung fehl (msbuild.exe
im allgemeinen befindet sich im C:\Windows\Microsoft.NET\Framework\v4.0.30319
).Cordova-Cli
wurde auf Mac OS X, Linux, Windows 7und Windows 8 getestet.
Bitte beachten Sie, dass einige Plattformen OS Beschränkungen. Zum Beispiel für Windows 8 oder Windows Phone 8 unter Mac OS X kann man nicht bauen, noch können Sie für iOS unter Windows erstellen.
Ubuntu-Pakete stehen in einer PPA für Ubuntu 13,10 (Saucy) (aktuelle Version) sowie 14.04. (Trusty) (in Entwicklung).
sudo apt-add-repository ppa:cordova-ubuntu/ppa sudo apt-get update sudo apt-get install cordova-cli npm install -g cordova
Um eine Anwendung für die Ubuntu-Plattform zu erstellen, werden die folgenden zusätzlichen Pakete benötigt:
sudo apt-get install cmake debhelper libx11-dev libicu-dev pkg-config qtbase5-dev qtchooser qtdeclarative5-dev qtfeedback5-dev qtlocation5-dev qtmultimedia5-dev qtpim5-dev qtsensors5-dev qtsystems5-dev
Du musst CLI und Plugman von Git
installieren. Die npm version von One und (git) master-Version des anderen wird voraussichtlich mit ihnen leiden zu beenden.
Um zu vermeiden, mit Sudo, siehe wegkommen von Sudo: Npm ohne Root.
Führen Sie die folgenden Befehle:
git clone https://git-wip-us.apache.org/repos/asf/cordova-plugman.git cd cordova-plugman npm install sudo npm link cd .. git clone https://git-wip-us.apache.org/repos/asf/cordova-cli.git cd cordova-cli npm install sudo npm link npm link plugman
Jetzt sind die Cordova
und Plugman
in Ihrem Pfad der lokalen Git-Versionen. Vergessen Sie nicht, sie auf dem laufenden halten!
apt-get install cordova-cli
Cordova-Cli
hat einen einzigen globalen Erstellen
Befehl, der neue Cordova-Projekte in einem angegebenen Verzeichnis erstellt. Sobald Sie ein Projekt erstellen, können cd
in es und Sie eine Vielzahl von Projektebene Befehle ausführen. Git Schnittstelle inspiriert vollständig.
help
anzeigen eine Hilfeseite mit allen verfügbaren Befehlecreate <directory> [<id> [<name>]]
erstellen ein neues Cordova-Projekt mit optionaler Name und Id (Paketname, Rückwärtsgang-Domäne-Style)platform [ls | list]
Listen Sie alle Plattformen für das Erstellen des Projektsplatform add <platform> [<platform> ...]
Fügen Sie eine (oder mehrere) Plattformen als Buildziel für das Projektplatform [rm | remove] <platform> [<platform> ...]
die Ziele von einem (oder mehreren) Plattform erstellen entfernt aus dem Projektplatform [up | update] <platform>
-aktualisiert die Cordova-Version für die Plattform verwendetplugin [ls | list]
Listen Sie alle Plugins, die Teil des Projektsplugin add <path-to-plugin> [<path-to-plugin> ...]
Fügen Sie eine (oder mehrere) Plugins zum Projektplugin [rm | remove] <plugin-name> [<plugin-name> ...]
Entfernen Sie eine (oder mehrere) Plugins aus dem Projekt.plugin search [<keyword1> <keyword2> ...]
Suchen Sie die Plugin-Registrierung für Plugins passend die Liste von Schlüsselwörternprepare [platform...]
kopiert die Dateien in den angegebenen Plattformen oder alle Plattformen. Es ist dann für den Aufbau von Eclipse
, Xcode
, etc. bereit.compile [platform...]
kompiliert die app in eine Binärdatei für jede gezielte Plattform. Ohne Parameter, Builds für alle Plattformen, ansonsten baut für die angegebenen Plattformen.build [<platform> [<platform> [...]]]
ein Alias für die cordova prepare
gefolgt von cordova compile
emulate [<platform> [<platform> [...]]]
Emulatoren starten und app für sie bereitstellen. Ohne Parameter emuliert für alle Plattformen, die dem Projekt hinzugefügt, ansonsten für die angegebenen Plattformen emuliertserve [port]
Starten Sie einen lokalen Webserver, so dass Sie Zugriff auf jede Plattform Www-Verzeichnis auf dem angegebenen Port (Standard 8000).-d
oder --verbose
wird heraus ausführlichere Ausgabe Ihrer Shell Pfeife. Sie können auch Ereignisse log
und warn
abonnieren, wenn Sie raubend Cordova-Cli
als Modul Knoten sind, durch Aufrufen von cordova.on ("log", function (){}
oder cordova.on ('warn', function () {}
.-v
oder --version
wird Ausdrucken Ihrer Cordova-Cli
-Version installieren.Eine Anwendung für Cordova mit Cordova-Cli
haben die folgende Verzeichnisstruktur:
myApp/ |-- config.xml |-- hooks/ |-- merges/ | | |-- android/ | | |-- blackberry10/ | | `-- ios/ |-- www/ |-- platforms/ | |-- android/ | |-- blackberry10/ | `-- ios/ `-- plugins/
Dieses Verzeichnis kann enthält Skripts zum Anpassen von Cordova-Cli-Befehle verwendet. Dieses Verzeichnis verwendet, um zu .cordova/hooks
vorhanden sein, aber jetzt nach dem Projektstamm wurde verschoben. Alle Skripts, die Sie diese Verzeichnisse hinzufügen werden vor und nach den Befehlen, die den Namen des Verzeichnisses entspricht ausgeführt. Nützlich für die Integration Ihrer eigenen Build-Systeme oder Integration mit Versionskontrollsystemen.
Weitere Informationen finden Sie unter Haken Guide .
Plattformspezifische Web Vermögenswerte (HTML, CSS und JavaScript-Dateien) sind in den entsprechenden Unterordner in diesem Verzeichnis enthalten. Diese sind während einer prepare
in das entsprechende Verzeichnis der native eingesetzt. Dateien unter merges/
überschreibt die entsprechende Dateien im der www /
Ordner für die entsprechende Plattform. Ein kurzes Beispiel, eine Projektstruktur des vorausgesetzt:
merges/ |-- ios/ | `-- app.js |-- android/ | `-- android.js www/ `-- app.js
Nach dem Aufbau der Android und iOS-Projekte, wird die Android-Anwendung app.js
und android.js
enthalten. Jedoch die iOS-Anwendung enthält nur eine app.js
, und es wird derjenige sein, der aus merges/ios/app.js
, überschreiben die “gewöhnlichen” app.js
innerhalb der www /
.
Das Projekt Web Artefakte wie HTML, CSS und JS-Dateien enthält. Dies sind Ihre Hauptanwendung Vermögenswerte. Sie werden auf eine cordova prepare
jede Plattform Www-Verzeichnis kopiert werden.
Diese Datei ist was Sie bearbeiten sollten um Ihre Anwendung Metadaten ändern. Jedesmal wenn Sie Cordova-Cli-Befehle ausführen das Tool betrachten Sie den Inhalt der Datei config.xml
und alle relevanten Informationen aus dieser Datei verwenden, um native Anwendungsinformationen zu definieren. Cordova-Cli unterstützt Ihre Anwendungsdaten über die folgenden Elemente in der Datei "config.xml"
ändern:
<name>
kann der Benutzer-Namen geändert werden.Id
-Attribut aus dem Element der obersten Ebene <widget>
verändert werden.version
-Attribut aus dem Element der obersten Ebene <widget>
geändert werden.<access>
Elemente geändert werden. Stellen Sie sicher das origin
-Attribut des Ihre Element <access>
punkte auf eine gültige URL ( *
als Platzhalter können). Weitere Informationen über die Whitelist-Syntax finden Sie unter docs.phonegap.com. Können Sie Attribut Uri
(BlackBerry-proprietäre) oder der origin
(standardkonforme) um die Domäne zu bezeichnen.<preference>
Tags angepasst werden. Siehe docs.phonegap.com für eine Liste der Einstellungen, die Sie verwenden können.<content src>
Element + Attribut definiert werden.Plattformen zur Anwendung hinzugefügt werden die Ausgangsanwendung Projekt Strukturen innerhalb des Verzeichnisses angelegt haben.
Keine zusätzlichen Plugins werden extrahiert oder in dieses Verzeichnis kopiert.
Erstellt von Cordova-Cli Projekte haben before
und after
Haken für jeden Befehl Projekt.
Es gibt zwei Arten von Haken: projektspezifische und auf Modulebene. Beide Typen der Haken erhalten den Stammordner des Projekts als Parameter.
Diese befinden sich unter dem hooks
-Verzeichnis im Stammverzeichnis Ihres Projekts Cordova. Alle Skripts, die Sie diese Verzeichnisse hinzufügen werden vor und nach der entsprechenden Befehle ausgeführt werden. Nützlich für die Integration Ihrer eigenen Build-Systeme oder Integration mit Versionskontrollsystemen. Denken Sie daran: Ihre Skripte ausführbar zu machen. Weitere Informationen finden Sie unter Haken Guide .
Before_build
Haken zum Kompilieren von jade Vorlage mit freundlicher Genehmigung von dpogueWenn Sie Cordova-Cli als Modul innerhalb einer größeren Node -Anwendung verwenden, können Sie die Ereignisse an auch EventEmitter
Standardmethoden. Die Veranstaltungen umfassen Before_build
, Before_compile
, Before_docs
, Before_emulate
, Before_run
, Before_platform_add
, Before_library_download
, Before_platform_ls
, Before_platform_rm
, Before_plugin_add
, Before_plugin_ls
, Before_plugin_rm
und Before_prepare
. Es gibt auch eine library_download
-Progress-Ereignis. Darüber hinaus gibt es after_
Aromen aller oben genannten Ereignisse.
Einmal Sie require('cordova')
in Ihrem Projekt Knoten, verfügen Sie über die üblichen EventEmitter
verfügbaren Methoden (on
, off
oder removeListener
, RemoveAllListeners
, und emit
oder trigger
).
In diesem Beispiel wird veranschaulicht, wie ein Projekt namens “KewlApp” mit iOS und Android-Plattform-Unterstützung erstellen und beinhaltet eine Plugin namens Kewlio. Das Projekt wird in ~/KewlApp Leben.
cordova create ~/KewlApp KewlApp cd ~/KewlApp cordova platform add ios android cordova plugin add http://example.org/Kewlio-1.2.3.tar.gz cordova build
Die Verzeichnisstruktur des KewlApp sieht nun folgendermaßen aus:
KewlApp/ |-- hooks/ |-- merges/ | |-- android/ | `-- ios/ |-- www/ | `-- index.html |-- platforms/ | |-- android/ | | `-- … | `-- ios/ | `-- … `-- plugins/ `-- Kewlio/
npm test
npm run cover
Bitte überprüfen Sie Cordova Probleme mit der CLI-Komponente. Wenn Sie Probleme mit diesem Tool finden, bitte seien Sie so nett, einschlägige Informationen zu Themen wie Debuggen benötigt:
Erstellen
Xcode
-Version, wenn Sie Fragen senden mit Bezug zu iOSVielen Dank an alle für Ihren Beitrag! Eine Liste der beteiligten Personen finden Sie in der Datei package.json
.
Cordova-Cli
wird Npm
-Proxy-Einstellungen verwenden. Wenn Sie hinter einem Proxy sind und Cordova-Cli über Npm
heruntergeladen, sind Wahrscheinlichkeiten Cordova-Cli für Sie arbeiten sollten, wie sie diese Einstellungen in erster Linie verwenden wird. Stellen Sie sicher, dass die Https-Proxy
und Proxy
Npm-Config-Variable korrekt gesetzt sind. Finden Sie weitere Informationen des Npm Konfigurationsdokumentation .
Wenn Sie versuchen, eine Plattform auf einem Windows-Computer hinzufügen, wenn Sie die folgende Fehlermeldung bekommen: Cordova Bibliothek für “Android” bereits vorhanden ist. Kein download erforderlich. Fort. Überprüfen, ob die Plattform “android” Mindestanforderungen übergibt... Kontrolle auf Android... Ausführen von “android Liste Ziel” (Ausgabe folgen)
Error: The command `android` failed. Make sure you have the latest Android SDK installed, and the `android` command (inside the tools/ folder) added t o your path. Output: at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\platform.js:185:42 at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\metadata\android_parser.js:50:13 at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\node_modules\shelljs\shell.js:1707:7 at exithandler (child_process.js:633:7) at ChildProcess.errorhandler (child_process.js:649:5) at ChildProcess.EventEmitter.emit (events.js:95:17) at Process.ChildProcess._handle.onexit (child_process.js:787:12)
Führen Sie den Befehl android list target
. Wenn Sie sehen:
'xcopy' is not recognized as an internal or external command, operable program or batch file.
zu Beginn der Ausgabe des Befehls bedeutet dies, dass Sie benötigen, um Ihre Windows Path-Variable um Xcopy erweitert zu beheben. Dieser Ort ist in der Regel unter C:\Windows\System32.
Windows-8-Unterstützung beinhaltet nicht die Fähigkeit zu Start/ausführen/emulieren, so Sie öffnen Sie Visual Studio um Ihre app Leben zu sehen müssen. Sie sind noch in der Lage, die folgenden Befehle mit windows8 zu verwenden:
platform add windows8
platform remove windows8
prepare windows8
compile windows8
build windows8
Um Ihre Anwendung auszuführen, müssen Sie die sln
im Plattformen/windows8
Ordner mithilfe von Visual Studio 2012 öffnen.
Visual Studio erfahren Sie das Projekt neu zu laden, wenn Sie einen der obigen Befehle ausführen, während das Projekt geladen wird.
Amazon Fire OS beinhaltet nicht die Fähigkeit zu emulieren. Sie sind noch in der Lage, die folgenden Befehle mit Amazon Fire OS zu verwenden
platform add amazon-fireos
platform remove amazon-fireos
prepare amazon-fireos
compile amazon-fireos
build amazon-fireos
Die erste Version von Cordova-Ubuntu unterstützt Gebäude keine Anwendungen für Armhf Geräte automatisch. Es ist möglich, Anwendungen und Pakete in wenigen Schritten aber auf.
Dieser Bug-Report dokumentiert das Problem und Lösungen dafür: https://bugs.launchpad.net/ubuntu/+source/cordova-ubuntu/+bug/1260500 einer zukünftigen Version wird Entwickler Kreuz-kompilieren Armhf Pakete direkt von einem X 86-Desktop klicken lassen.
Firefox-OS beinhaltet nicht die Fähigkeit zu emulieren, zu laufen und zu dienen. Nach Bau musst du das Firefoxos
-Plattform-Verzeichnis Ihrer Anwendung in der WebIDE zu öffnen, die mit jedem Firefox-Browser kommt. Sie können dieses Fenster offen halten und klicken Sie auf die Taste “play”, jedes Mal, wenn Sie fertig bauen Ihre app.