Narzędzie wiersza polecenia do tworzenia, wdrażania i zarządzania Cordova-oparty zastosowania.
Apache Cordova pozwala na budowanie rodzimych aplikacji mobilnych przy użyciu HTML, CSS i JavaScript. Narzędzie to pomaga z zarządzania wieloplatformowych aplikacji Cordova, jak również integracji plugin Cordova.
Zajrzyj do przewodników wprowadzenie więcej szczegółów na temat pracy z Cordova podprojektów.
tools
i platform-tools
katalogi na wsparcie inaczej Android ścieżka systemu nie powiedzie się.msbuild
na twój system ścieżka w przeciwnym razie nie będzie wsparcie Windows Phone (msbuild.exe
zwykle znajduje się w C:\Windows\Microsoft.NET\Framework\v4.0.30319
).dependencies/tools/bin
folder wewnątrz katalogu SDK dodaje do Twojej ścieżki!Xcode
i Narzędzi wiersza polecenia Xcode
msbuild
na twój system ścieżka w przeciwnym razie nie będzie wsparcie Windows Phone (msbuild.exe
zwykle znajduje się w C:\Windows\Microsoft.NET\Framework\v4.0.30319
).Cordova-cli
został przetestowany na Mac OS X, Linux, Windows 7i Windows 8.
Należy pamiętać, że niektóre platformy mogą posiadać ograniczenia OS. Na przykład nie można budować dla Windows Phone 8 na Mac OS X lub Windows 8, ani nie można zbudować dla iOS na Windows.
Ubuntu pakiety są dostępne w PPA 13.10 Ubuntu (pyskaty) (obecnym wydaniu), a także 14.04 (sprawdzony) (w budowie).
sudo apt-add-repository ppa:cordova-ubuntu/ppa sudo apt-get update sudo apt-get install cordova-cli npm install -g cordova
Do budowania aplikacji na platformie Ubuntu, wymagane są następujące pakiety dodatkowe:
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
Będziesz musiał zainstalować CLI i Plugman z git
. Systemem npm wersja jeden i wersją główną (git) innych jest prawdopodobnie do końca z Tobą cierpienia.
Aby unikać sudo, zobacz uzyskać od sudo: npm bez głównego.
Uruchom następujące polecenia:
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
Teraz cordova
i plugman
w ścieżce są wersje lokalne git. Nie zapomnij, aby utrzymać je na bieżąco!
apt-get install cordova-cli
Cordova-cli
ma jeden globalny utworzyć
polecenia, który tworzy nowe projekty Cordova do określonego katalogu. Po utworzeniu projektu, cd
do niego i być może wykonać różne polecenia na poziomie projektu. Całkowicie inspirowane przez interfejs git.
help
wyświetlana strona pomocy z wszystkich dostępnych poleceńcreate <directory> [<id> [<name>]]
tworzenie nowego projektu Cordova z opcjonalną nazwę i identyfikator (Nazwa pakietu, styl domeny odwrotnej)platform [ls | list]
listę wszystkich platform, które zbuduje projektuplatform add <platform> [<platform> ...]
dodać jeden (lub więcej) platformy jako cel budowania projektuplatform [rm | remove] <platform> [<platform> ...]
usuwa jeden (lub więcej) cele budowy platformy z projektuplatform [up | update] <platform>
-aktualizacje wersji Cordova, stosowany dla danej platformyplugin [ls | list]
listy wszystkie pluginy zawarte w projekcieplugin add <path-to-plugin> [<path-to-plugin> ...]
dodać jeden (lub więcej) wtyczki do projektuplugin [rm | remove] <plugin-name> [<plugin-name> ...]
Usuń jeden (lub więcej) wtyczki z projektu.plugin search [<keyword1> <keyword2> ...]
Szukaj rejestru plugin dla wtyczek pasujących na liście słów kluczowychprepare [platform...]
kopiuje pliki do określonej platformy, lub wszystkich platform. To jest gotowy do budynku przez Eclipse
, Xcode
, itp.compile [platform...]
kompiluje aplikacji do binarny dla każdej z platform docelowych. Bez parametrów, buduje dla wszystkich platform, w przeciwnym razie buduje dla określonej platformy.build [<platform> [<platform> [...]]]
alias dla cordova przygotować
a następnie skompilować cordova
emulate [<platform> [<platform> [...]]]
uruchomić emulatory i wdrożenie aplikacji do nich. Bez parametrów emuluje dla wszystkich platform dodany do projektu, w przeciwnym razie emuluje dla określonej platformyserve [port]
wprowadzić na rynek lokalny serwer www pozwala na dostęp do każdej platformy www katalog na danym porcie (domyślnie 8000).-d
lub --verbose
rur będzie się bardziej gadatliwe wyjście do skorupy. Możesz również subskrybować zdarzenia dziennika
i ostrzec
jeśli jesteś czasochłonne cordova-cli
jako moduł węzła przez wywołanie cordova.on ('log', function() {})
lub cordova.on ("warn", function() {})
.-v
lub --version
zainstaluje wydrukować wersję swojego cordova-cli
.Aplikacją Cordova, zbudowany z cordova-cli
będą miały następującą strukturę katalogów:
myApp/ |-- config.xml |-- hooks/ |-- merges/ | | |-- android/ | | |-- blackberry10/ | | `-- ios/ |-- www/ |-- platforms/ | |-- android/ | |-- blackberry10/ | `-- ios/ `-- plugins/
W tym katalogu mogą zawiera skrypty używane do dostosowywania poleceń cordova cli. W tym katalogu użyta do istnieje w .cordova/hooks
, ale teraz został przeniesiony do katalogu głównego projektu. Skrypty, które można dodać do tych katalogów zostanie wykonana przed i po poleceniach odpowiadającą nazwę katalogu. Przydatne dla integracji systemów budować lub integracji z systemami kontroli wersji.
Odnoszą się do Haki Przewodnik dla więcej informacji.
Aktywa poszczególnych platform internetowych (HTML, CSS i JavaScript pliki) są zawarte w odpowiednich podfolderach w tym katalogu. Są one rozmieszczone podczas prepare
do odpowiedniego katalogu macierzystego. Pliki umieszczone pod merges/
zastąpi pasujące pliki w www /
folder dla odpowiednich platformy. Szybki przykład, zakładając, że struktury projektu:
merges/ |-- ios/ | `-- app.js |-- android/ | `-- android.js www/ `-- app.js
Po budynku projekty Android i iOS, Android aplikacja będzie zawierać zarówno app.js
i android.js
. Jednakże, iOS aplikacji będzie zawierać tylko app.js
, i będzie to jeden z merges/ios/app.js
, zastępując “wspólne” app.js
znajdujące się wewnątrz www /
.
Zawiera projekt web artefaktów, takich jak pliki HTML, CSS i js. Są to główne aktywa. Oni zostaną skopiowane na cordova przygotować
do każdej platformy www katalog.
Ten plik jest, co powinno edycji do modyfikowania metadanych aplikacji. Każdym razem, gdy można uruchomić polecenia cordova-cli, narzędzie będzie spojrzeć na zawartość pliku config.xml
i korzystać wszystkie istotne informacje z tego pliku do definiowania informacji o rodzimych aplikacji. Cordova-cli obsługuje zmianę danych aplikacji za pośrednictwem następujących elementów wewnątrz pliku config.xml
:
< nazwa >
.id
element najwyższego poziomu < widżet >
.< widżet >
na wersji
.< access >
. Upewnij się, że pochodzenie
atrybut punktów elementu < access >
prawidłowy adres URL (można użyć *
jako symbolu wieloznacznego). Aby uzyskać więcej informacji o składni białą zobacz docs.phonegap.com. Można użyć atrybut uri
(BlackBerry własności) lub origin
(zgodnych ze standardami) dla oznaczenia domeny.< preference >
. Zobacz docs.phonegap.com aby uzyskać listę preferencji, które można użyć.< zawartości src >
element.Dodawane do aplikacji platformy mają native stosowania projektu struktury określonymi w tym katalogu.
Wszelkie dodatkowe pluginy zostaną wyodrębnione lub skopiowane do tego katalogu.
Projekty tworzone przez cordova-cli mają before
i after
haki na każdego project command.
Istnieją dwa typy haków: te specyficzne dla projektu i poziom modułu ci. Oba typy haków otrzymują folderu głównego projektu jako parametr.
Znajdują się one w katalogu hooks
w katalogu głównym projektu Cordova. Skrypty, które można dodać do tych katalogów zostanie wykonana przed i po odpowiednie komendy. Przydatne dla integracji systemów budować lub integracji z systemami kontroli wersji. Pamiętaj: zrobić skryptów wykonywalnych. Odnoszą się do Haki Przewodnik dla więcej informacji.
before_build
hak na kompie jade szablon dzięki uprzejmości dpogueJeśli używasz cordova-cli jako moduł w większych aplikacji węzła , można również użyć standardowych metod EventEmitter
dołączyć do wydarzeń. Zdarzenia obejmują 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
i before_prepare
. Istnieje również library_download
zdarzenie progress. Dodatkowo istnieją after_
smaków wszystkich powyższych zdarzeń.
Raz ci require('cordova')
w projekcie węzła, będziesz miał zwykle EventEmitter
dostępnych metod (na
, wyłączyć
lub removeListener
, removeAllListeners
i emitują
lub wyzwalacza
).
Ten przykład pokazuje jak stworzyć projekt od nowa o nazwie KewlApp z iOS i Android platforma wsparcia i zawiera wtyczkę o nazwie Kewlio. Projekt będzie żyć w ~/KewlApp
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
W strukturze katalogów KewlApp teraz wygląda to tak:
KewlApp/ |-- hooks/ |-- merges/ | |-- android/ | `-- ios/ |-- www/ | `-- index.html |-- platforms/ | |-- android/ | | `-- … | `-- ios/ | `-- … `-- plugins/ `-- Kewlio/
npm test
npm run cover
Proszę sprawdzić Cordova problemów przy użyciu składnika CLI. Jeśli znajdziesz problemy za pomocą tego narzędzia, należy tak uprzejmy aby zawierać istotne informacje potrzebne do debugowania problemów takich jak:
tworzenia
Xcode
jeśli przesyłasz kwestie związane z iOSDzięki wszystkim za wkład! Lista osób biorących udział można znaleźć w pliku package.json
.
Cordova-cli
będzie używać ustawień serwera proxy npm
. Jeśli pobrano cordova-cli przez npm
i są za pośrednictwem serwera proxy, są szanse, że cordova-cli powinny pracować dla Ciebie, jak to będzie korzystać z tych ustawień w pierwszej kolejności. Upewnij się, że zmiennych config npm https proxy
i serwera proxy
są prawidłowo ustawione. Zobacz npm w dokumentacji konfiguracji dla więcej informacji.
Podczas trudny wobec dodać pewien platforma na komputerze z systemem Windows, jeśli napotkasz następujący komunikat o błędzie: Biblioteka Cordova “Android” już istnieje. Nie ma potrzeby pobierania. Kontynuacja. Sprawdzanie, czy platforma “android” przechodzi minimalne wymagania... Sprawdzanie wymagań Android... Kolejny “android listy cel” (wyjście do naśladowania)
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)
Uruchom polecenie android list target
. Jeśli widzisz:
'xcopy' is not recognized as an internal or external command, operable program or batch file.
na początku dane wyjściowe polecenia, to oznacza, że musisz naprawić Twoje zmienna ścieżka Windows obejmują xcopy. Lokalizacja ta jest zazwyczaj C:\Windows\System32.
Obsługa systemu Windows 8 nie obejmują możliwość uruchomienia/run/emulacja, więc trzeba będzie otworzyć Programu Visual Studio , aby zobaczyć swoją aplikację na żywo. Jesteś jeszcze w stanie windows8 za pomocą następujących poleceń:
platform add windows8
platform remove windows8
prepare windows8
compile windows8
build windows8
Aby uruchomić aplikację, trzeba będzie otworzyć .sln
w folderze platform/windows8
przy użyciu Visual Studio 2012.
Visual Studio powie, aby ponownie załadować projekt po uruchomieniu dowolnego z powyższych poleceń, podczas gdy projekt jest ładowany.
Amazon ogień OS nie obejmują zdolność do naśladowania. Nadal można użyć następujących poleceń z Amazon ogień OS
platform add amazon-fireos
platform remove amazon-fireos
prepare amazon-fireos
compile amazon-fireos
build amazon-fireos
Początkowej wersji cordova-Ubuntu nie obsługuje budowanie aplikacji dla urządzeń armhf automatycznie. Istnieje możliwość produkcji aplikacji i kliknij przycisk pakiety w kilku krokach choć.
Ten raport dokumentów problemu i rozwiązania to: https://bugs.launchpad.net/ubuntu/+source/cordova-ubuntu/+bug/1260500 przyszłej wersji będzie niech deweloperzy cross kompilacji armhf kliknij przycisk pakiety bezpośrednio z pulpitu x 86.
Firefox OS nie obejmują możliwość naśladować, biegać i służyć. Po budynku, trzeba będzie otworzyć katalogu platformy aplikacji firefoxos
w WebIDE , że pochodzi z każdej przeglądarki Firefox. Można zachować otwarte okno i kliknij na przycisk “play” za każdym razem możesz zakończeniu budowy aplikacji.