ビルド、配置、およびコルドバを管理するコマンド ライン ツール-ベースのアプリケーション。
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 のインターフェイスに触発されました。
helpcreate <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 windows8platform remove windows8prepare windows8compile windows8build windows8アプリを実行するのには、 Visual Studio 2012を使用してplatforms/windows8フォルダー内.slnを開く必要があります。.
Visual Studioでは、プロジェクトが読み込まれる間、上記のコマンドのいずれかを実行する場合は、プロジェクトを再読み込みするように指示されます。
アマゾンの火の OS では、エミュレートする機能は含まれません。まだアマゾン火 OS で次のコマンドを使用することができます。
platform add amazon-fireosplatform remove amazon-fireosprepare amazon-fireoscompile amazon-fireosbuild amazon-fireosコルドバ ubuntu の最初のリリースは、armhf デバイスの自動的にアプリケーションの構築をできません。アプリケーションを作成し、いくつかの手順でパッケージをクリックしても不可能です。
このバグ レポートそれのための問題およびソリューションのドキュメント: https://bugs.launchpad.net/ubuntu/+source/cordova-ubuntu/+bug/1260500 将来のリリース開発者クロス コンパイル armhf x 86 デスクトップから直接パッケージをクリックしてできるようになります。
Firefox OS をエミュレートし、実行し、提供する機能は含みません。 建物後、すべての Firefox ブラウザーに付属しているWebIDEでアプリのfirefoxosプラットフォーム ディレクトリを開く必要があります。 このウィンドウを開いたままでき、アプリのビルドが終了するたびに、「再生」ボタンをクリックします。