ビルド、配置、およびコルドバを管理するコマンド ライン ツール-ベースのアプリケーション。
Apache のコルドバは、HTML、CSS、JavaScript を使用してネイティブ モバイル アプリケーションを構築することができます。 このツールは、コルドバのプラグインの統合と同様、マルチプラット フォーム向け cordova アプリの管理に役立ちます。
コルドバのサブ プロジェクトを操作する方法の詳細については、入門ガイドをチェックしてください。
ツール
を必要があります、あなたのシステムのパスそれ以外の場合 Android 対応のプラットフォーム固有のツール
ディレクトリが失敗します。msbuild
がなければ、このツールは動作しない Windows Phone サポートが失敗するそれ以外の場合 (msbuild.exe
一般にあるC:\Windows\Microsoft.NET\Framework\v4.0.30319
).dependencies/tools/bin
フォルダーを確認してください!Xcode
とXcode コマンド ライン ツール
msbuild
がなければ、このツールは動作しない Windows Phone サポートが失敗するそれ以外の場合 (msbuild.exe
一般にあるC:\Windows\Microsoft.NET\Framework\v4.0.30319
).コルドバ cli
は、 Mac OS X、 Linux、 Windows 7、およびWindows 8でテストされています.
いくつかのプラットフォームに OS の制限があることに注意してください。 たとえば、Windows 8 または Mac OS x、Windows Phone 8 ビルドすることはできませんも Windows で構築することができます。
Ubuntu 13.10 (生意気) (現在のリリース) として (開発中) 14.04 (信頼できる) PPA の Ubuntu のパッケージがあります。
sudo apt-add-repository ppa:cordova-ubuntu/ppa sudo apt-get update sudo apt-get install cordova-cli npm install -g cordova
Ubuntu のプラットフォームのアプリケーションをビルドするには、次の追加パッケージが必要です。
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
Git
からCLIとPlugmanの両方をインストールする必要があります。 1 つの故宮博物院のバージョンと他の*(git) マスター バージョン*を実行する苦しみで終わりそうです。
Sudo を使用して避けるために、"を参照してください須藤から得る: 故宮博物院ルートなし.
次のコマンドを実行します。
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
今コルドバ
とplugman
あなたのパスには、ローカルの git バージョンです。それらを最新に保つことを忘れないでください!
apt-get install cordova-cli
コルドバ cli
には、指定したディレクトリにコルドバの新しいプロジェクトを作成します作成
1 つグローバルなコマンドがあります。 プロジェクトを作成したら、 cd
にはさまざまなプロジェクト レベルのコマンドを実行できます。 完全に git のインターフェイスに触発されました。
help
create <directory> [<id> [<name>]]
します。platform [ls | list]
プロジェクトはビルド対象のすべてのプラットフォームの一覧を表示platform add <platform> [<platform> ...]
プロジェクトのビルド ターゲットとして 1 つ (または複数) のプラットフォームを追加します。platform [rm | remove] <platform> [<platform> ...]
1 つ (または複数) のプラットフォーム ビルド ターゲットをプロジェクトから削除します。platform [up | update] <platform>
-特定のプラットフォームの使用コルドバのバージョンを更新plugin [ls | list]
プロジェクトに含まれるすべてのプラグインを一覧表示plugin add <path-to-plugin> [<path-to-plugin> ...]
プロジェクトに 1 つ (または複数) のプラグインを追加します。plugin [rm | remove] <plugin-name> [<plugin-name> ...]
プロジェクトからの 1 つ (または複数) のプラグインを削除します。plugin search [<keyword1> <keyword2> ...]
キーワードのリストに一致するプラグインのプラグイン レジストリを検索します。prepare [platform...]
、 Xcode
などによる建物の準備ができて、それになります。compile [platform...]
します。パラメーターなしで、すべてのプラットフォーム用のビルドとそれ以外の場合指定したプラットフォームのビルドします。build [<platform> [<platform> [...]]]
コルドバの準備
の別名がコルドバをコンパイル
続いてemulate [<platform> [<platform> [...]]]
エミュレーターを起動し、アプリケーションを展開します。 パラメーターなしでエミュレートをプロジェクトに追加するすべてのプラットフォームで、それ以外の場合、指定したプラットフォームをエミュレートserve [port]
します。-d
または--verbose
、シェルにより冗長な出力をパイプします。 Cordova.on ('log'、関数 {})
またはcordova.on ('warn'、関数 {})
を呼び出してノード モジュールとしてのかかるコルドバ cli
のならは、またlog
およびwarn
イベントを購読することができます。.-v
または--verbose
、コルドバ cli
のバージョンを印刷がインストールされます。コルドバ cli
で構築されたコルドバ アプリケーションには、次のディレクトリ構造があります。
myApp/ |-- config.xml |-- hooks/ |-- merges/ | | |-- android/ | | |-- blackberry10/ | | `-- ios/ |-- www/ |-- platforms/ | |-- android/ | |-- blackberry10/ | `-- ios/ `-- plugins/
このディレクトリには、コルドバ cli コマンドをカスタマイズに使用するスクリプトが含まれます。 このディレクトリが.cordova/フック
で存在して今プロジェクトのルートに移動されています。 これらのディレクトリに追加する任意のスクリプトは、する前に、ディレクトリ名に対応するコマンドの後に実行されます。 ビルド システムを統合またはバージョン管理システムと統合するために役立ちます。
詳細についてはフック ・ ガイド 』を参照してください。
プラットフォーム固有の web 資産 (HTML、CSS、JavaScript ファイル) は、このディレクトリ内の適切なサブフォルダーに含まれます。 これらは、準備
するためのネイティブの適切なディレクトリに配置されます。 ファイルの下に配置マージ/
内の対応するファイルよりも優先されます、 www/
関連のプラットフォームのフォルダー。 簡単な例のプロジェクト構造を想定して:
merges/ |-- ios/ | `-- app.js |-- android/ | `-- android.js www/ `-- app.js
Android と iOS のプロジェクトをビルドした後 Android アプリケーションapp.js
とandroid.js
の両方が含まれます。 ただし、iOS アプリケーションにはのみが含まれます、 app.js
とmerges/ios/app.js
、内にある「共通」 app.js
をオーバーライドするから 1 時であるwww/
.
.Html、.css と .js ファイルなど、プロジェクトの web アイテムが含まれています。これらは、メインのアプリケーション資産です。彼らは、コルドバを準備
する各プラットフォームの www ディレクトリにコピーされます。
このファイルは、する必要があります編集、アプリケーションのメタデータを変更します。 コルドバ cli のすべてのコマンドを実行すればいつでもツールにconfig.xml
の内容を見て、このファイルからすべての関連情報を使用して、ネイティブのアプリケーション情報を定義します。 コルドバ cli では、 config.xml
ファイル内の次の要素を使用して、アプリケーションのデータを変更することをサポートしています。
< name >
要素のコンテンツを介して変更できます。< widget >
要素のid
属性によって変更できます。< version >
要素のバージョン
属性によって変更できます。< access >
要素を使用して変更できます。 ようにしてください、 < acess >
要素のポイントのorigin
の属性 ( *
として使えますワイルドカード) の有効な URL。 ホワイト リストの構文の詳細については、 docs.phonegap.comを参照してください。 属性のuri
(ブラックベリー独自) または起源
のいずれかを使用できます (標準に準拠した) ドメインを示すために。< preference >
タグを介してプラットフォームに固有の設定をカスタマイズできます。 使用できる設定の一覧についてはdocs.phonegap.comを参照してください。< コンテンツ src >
要素 + 属性を介して、アプリケーションのエントリ/スタート ページを定義できます。アプリケーションに追加のプラットフォームでお越しの際にもネイティブ アプリケーション プロジェクトの構造は、このディレクトリ内に置かれています。
任意の追加のプラグインを抽出またはこのディレクトリにコピーされます。
コルドバ cli によって作成されたプロジェクトがbefore
とafter
それぞれのプロジェクト コマンドのフック.
フックの 2 種類があります: プロジェクトに固有のものとモジュール レベルのもの。どちらのフックの種類は、プロジェクトのルート フォルダーをパラメーターとして受け取ります。
これらは、コルドバのプロジェクトのルートのhooks
ディレクトリ下にあります。 これらのディレクトリに追加する任意のスクリプトは、適切なコマンドの前後に実行されます。 ビルド システムを統合またはバージョン管理システムと統合するために役立ちます。 注意: スクリプトを実行可能にします。 詳細についてはフック ・ ガイド 』を参照してください。
大きいNodeアプリケーション内のモジュールとしてコルドバ cli を使用する場合標準のEventEmitter
メソッドを使用して、イベントにアタッチできます。 イベントには、 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
、 before_prepare
が含まれます。 Library_download
進行状況イベントもあります。 また、上記のすべてのイベントのafter_
味があります。
一度、 require('cordova')
ノード プロジェクトで、あなたが通常EventEmitter
利用できるメソッドon
、off
removeListener
、 removeAllListeners
とemit
またはtrigger
).
この例では、iOS および Android プラットフォームのサポート付け KewlApp ゼロからプロジェクトを作成する方法を示していて、Kewlio という名前のプラグインが含まれています。プロジェクトが ~/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
KewlApp のディレクトリ構造は、このようになります。
KewlApp/ |-- hooks/ |-- merges/ | |-- android/ | `-- ios/ |-- www/ | `-- index.html |-- platforms/ | |-- android/ | | `-- … | `-- ios/ | `-- … `-- plugins/ `-- Kewlio/
npm test
npm run cover
CLI コンポーネントとコルドバの問題を確認してください。 とても親切にしてください場合は、このツールを使って問題を見つけるなどの問題をデバッグするために必要な関連情報を含めます。
作成
で使用される識別子Xcode
バージョンの問題を提出する場合は iOS に関連貢献のためのみんなに感謝!関係者のリストは、 package.json
ファイルを参照してください。
コルドバ cli
npm
のプロキシ設定が使用されます。 故宮博物院
経由でコルドバ cli をダウンロード、プロキシの背後にある可能性がありますコルドバ cli は、それは最初の場所でそれらの設定を使用して、あなたのため動作するはずです。 Https プロキシ
とプロキシ
の故宮博物院構成変数が正しく設定されていることを確認します。 詳細については故宮博物院の構成に関するドキュメントを参照してください。
次のエラー メッセージに実行する場合、Windows マシンにプラットフォームを追加しようとしたとき:「アンドロイド」のコルドバ ライブラリは既に存在します。 ダウンロードする必要はありません。 続けています。 プラットフォーム「android」が最小要件を渡す場合をチェック. Android の要件を確認しています. 「Android リスト ターゲット」(に従って出力) を実行しています。
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)
android list target
のコマンドを実行します。 表示された場合。
'xcopy' is not recognized as an internal or external command, operable program or batch file.
コマンドの出力の先頭、それは xcopy を含めるように Windows の Path 変数を修正する必要がありますを意味します。この場所は、C:\Windows\System32 の下で通常です。
住んでいるアプリを表示するVisual Studioをオープンする必要がありますので、Windows 8 サポート起動/実行/エミュレート、する機能は含みません。 Windows8 で次のコマンドを使用するまだことができます。
platform add windows8
platform remove windows8
prepare windows8
compile windows8
build windows8
アプリを実行するのには、 Visual Studio 2012を使用してplatforms/windows8
フォルダー内.sln
を開く必要があります。.
Visual Studioでは、プロジェクトが読み込まれる間、上記のコマンドのいずれかを実行する場合は、プロジェクトを再読み込みするように指示されます。
アマゾンの火の OS では、エミュレートする機能は含まれません。まだアマゾン火 OS で次のコマンドを使用することができます。
platform add amazon-fireos
platform remove amazon-fireos
prepare amazon-fireos
compile amazon-fireos
build amazon-fireos
コルドバ ubuntu の最初のリリースは、armhf デバイスの自動的にアプリケーションの構築をできません。アプリケーションを作成し、いくつかの手順でパッケージをクリックしても不可能です。
このバグ レポートそれのための問題およびソリューションのドキュメント: https://bugs.launchpad.net/ubuntu/+source/cordova-ubuntu/+bug/1260500 将来のリリース開発者クロス コンパイル armhf x 86 デスクトップから直接パッケージをクリックしてできるようになります。
Firefox OS をエミュレートし、実行し、提供する機能は含みません。 建物後、すべての Firefox ブラウザーに付属しているWebIDEでアプリのfirefoxos
プラットフォーム ディレクトリを開く必要があります。 このウィンドウを開いたままでき、アプリのビルドが終了するたびに、「再生」ボタンをクリックします。