これがないドキュメントの最新バージョンです！ Click here for the latest released version.

コマンドラインインターフェイス

このガイドでは、アプリケーションの作成し、を使用してさまざまなネイティブモバイルプラットフォームに展開する方法を示します、 cordova コマンドラインインターフェイス (CLI)。このツールは、新しいプロジェクトの作成、異なるプラットフォームでビルドし、エミュレーター内で実行することができます。 CLI を使用して、プロジェクトコード、さらにそれらを開発する様々なプラットフォームの Sdk を使用するが後を初期化することもできます。

前提条件

任意のコマンドラインツールを実行する前にターゲットにするプラットフォーム用の Sdk をインストールする必要があります。(詳細については、プラットフォームのガイドを参照)。

サポートを追加する任意のプラットフォーム用のプロジェクトをリビルドプラットフォームの SDK をサポートしている同じマシンからコマンドラインインターフェイスを実行する必要があります。CLI には、次の組み合わせをサポートします。

iOS (Mac)
アンドロイド (マック、Linux)
ブラックベリー 10 (Mac、Linux、Windows)
Windows Phone 7 (Windows)
Windows Phone 8 (Windows)
Windows 8 (Windows)
Firefox OS （Mac、Linux、Windows）

Mac のコマンドラインですターミナルアプリケーション経由で利用できます。PC 上だアクセサリーの下でコマンドプロンプトとして使用可能.

多くの可能性、CLI リモートソースコードリポジトリでは、ローカルの作業ディレクトリにプルダウンその資産を維持するために理にかなってより多くの異なるマシンからに実行することです。

インストールする、 cordova コマンドラインツールは、次の手順に従ってください。

ダウンロードしてインストールNode.js。呼び出すことができる必要がありますインストール直後は、 node または npm コマンドライン。
インストール、 cordova ユーティリティ。Unix では、プレフィックス、追加 sudo 開発ユーティリティをインストールする必要があるかもしれませんコマンドでディレクトリを制限されてそれ以外の場合。
```
$ sudo npm install -g cordova
```
インストールログすべてアンインストールされたプラットフォーム Sdk の誤差が生じる可能性があります。インストール後、実行することができる必要があります cordova コマンド・ラインで。

アプリを作成します。

ソースコードを維持する、ディレクトリに移動し、次のようなコマンドを実行します。

    $ cordova create hello com.example.hello HelloWorld

いくつかの時間がかかるを完了するコマンドがかかります。実行、 cordova -d の進行状況に関する情報を表示します。

最初の引数は、プロジェクトに対して生成されるこんにちはディレクトリを指定します。その www サブディレクトリ、アプリケーションのホームページで、下にあるさまざまなリソースと一緒に家 css 、 js と img 、一般的な web 開発ファイル名前付け規則に従いますが。 config.xmlファイルには生成し、アプリケーションの配布に必要な重要なメタデータが含まれています。

他の 2 つの引数は省略可能: com.example.hello 引数は、逆ドメインスタイル識別子を使用してプロジェクトを提供します、 HelloWorld アプリケーションの表示テキストを提供します。これらの値の後の両方を編集することができます、 config.xml ファイル。

プラットフォームを追加します。

すべての後続コマンドは、プロジェクトのディレクトリまたはそのサブディレクトリのスコープ内で実行する必要があります。

    $ cd hello

プロジェクトをビルドする前に対象プラットフォームのセットを指定する必要があります。これらのコマンドを実行する能力にあなたのマシンが各 SDK をサポートしているかどうかに依存し、各 SDK をインストールされて既にがあるかどうか。 Mac からこれらのいずれかを実行します。

    $ cordova platform add ios
    $ cordova platform add android
    $ cordova platform add blackberry10
    $ cordova platform add firefoxos

Wpは Windows Phone オペレーティングシステムの異なるバージョンを参照 Windows マシンからこれらのいずれかを実行します。

    $ cordova platform add wp7
    $ cordova platform add wp8
    $ cordova platform add windows8
    $ cordova platform add android
    $ cordova platform add blackberry10
    $ cordova platform add firefoxos

現在のプラットフォームのセットを確認するこれを実行します。

    $ cordova platforms ls

（注、 platform と platforms コマンドは同じ意味です)。

プラットフォームを削除する次の同義のコマンドのいずれかを実行します。

    $ cordova platform remove blackberry10
    $ cordova platform rm android

各指定されたプラットフォームがサブディレクトリとして追加またはプラットフォームに影響を与えるプロジェクトのプラットフォームディレクトリの内容を削除するコマンドを実行します。 Wwwソースディレクトリは再現などに表示されるプラットフォームごとのサブディレクトリ内で platforms/ios/www または platforms/android/assets/www 。既定では、コルドバの Api のすべてにアクセスできるようにする各プラットフォームの構成ファイルが設定します。

希望する場合は、この時点で、SDK を使用して作成したプロジェクトを開くことができます。ただし、SDK 影響派生物内のプロジェクトへの編集は元クロスプラットフォームのソースファイルではなく、資産の設定します。単に、プロジェクトを初期化する場合は、このアプローチを使用します。（各 SDK 内のアプリケーションを開発する方法についての情報のためのプラットフォームのガイドを参照）。記事を読む場合、開発サイクル全体のコマンドラインツールを使用したいです。

アプリをビルドします。

既定で、 cordova create スクリプト生成骨格の web ベースのアプリケーションのホームページは、プロジェクトの www/index.html ファイル。しかしが、初期化の一部として指定する必要がありますこのアプリケーションの編集、 [deviceready](../../cordova/events/events.deviceready.html) から既定で参照されるイベントハンドラーは、 www/js/index.js 。

繰り返しプロジェクトをビルドする、次のコマンドを実行します。

    $ cordova build

これは、プロジェクト内でプラットフォーム固有のコードを生成します platforms サブディレクトリ。必要に応じて、特定のプラットフォームを各ビルドのスコープを制限できます。

    $ cordova build ios

cordova buildコマンドは、この例では、単一のプラットフォームにも対象指定される次の簡略化。

    $ cordova prepare ios
    $ cordova compile ios

この場合、1 回を実行する prepare 、変更およびコルドバ内で生成するプラットフォーム固有のコードをコンパイルする別の方法として Apple の Xcode SDK を使用することができます platforms/ios 。他のプラットフォームの Sdk と同じアプローチを使用できます。

エミュレーターまたはデバイス上のアプリをテストします。

モバイルプラットフォーム用の Sdk はしばしばホーム画面からアプリを起動し、それは多くのプラットフォーム機能と対話する方法を参照してくださいすることができますようにデバイスイメージを実行するエミュレーターにバンドルされています。アプリを再構築し、特定のプラットフォームのエミュレーター内で表示するには、次のようなコマンドを実行します。

    $ cordova emulate android

いくつかのモバイルプラットフォーム既定では、iOS のプロジェクトのため iPhone など、特定のデバイスをエミュレートします。他のプラットフォーム用に最初のデバイスエミュレーターに関連付ける必要があります。 (詳細については、プラットフォームのガイドを参照)。たとえば、あなたが最初の実行、 android 人造人間 SDK を起動し、その既定の動作によると起動する特定のデバイスのイメージを実行するコマンド。

フォローアップで、 cordova emulate コマンドは、ホーム画面から起動できるようになります最新のアプリケーションを表示するエミュレーターイメージを更新します。

代わりに、携帯電話をお使いのコンピューターに差し込み、アプリを直接テストすることができます。

    $ cordova run android

このコマンドを実行する前に必要、テストデバイスを設定するプラットフォームごとに異なる手順に従います。 Android の場合、デバイス上のUSB デバッグオプションを有効にして、おそらく開発環境に応じて USB ドライバーを追加する必要があります。各プラットフォームの要件の詳細については、プラットフォームのガイドを参照してください。

機能を追加します。

ビルド、新しいプロジェクトを表示すると表示される既定のアプリケーションは非常にしません。標準の web テクノロジーを活用する多くの方法でアプリを変更することができますが、デバイスレベルのさまざまな機能と密接に通信するアプリ、コアコルドバ Api へのアクセスを提供するプラグインを追加する必要があります。

プラグインはネイティブコンポーネントへのインタフェースを提供するアドオンコードのビットです。たとえば、ネイティブコンポーネントを持つコルドバの WebView をミックスしたハイブリッドアプリを設計するときの独自のプラグインインターフェイスをデザインできます。 (詳細については埋め込み web 表示とプラグイン開発ガイドを参照してください)。コルドバの基本的なデバイス・レベルの機能の 1 つを有効にするプラグインを追加するより一般的に、< ！ ― ― 『アプリケーション開発ガイド』で説明した外部参照と外部参照--> API リファレンスで詳しく説明します。

cordova plugin addコマンドは、プラグインのコードのリポジトリを指定する必要があります。追加可能性があります機能の例を示します。

基本的なデバイス情報 (デバイス API):
```
$ cordova plugin add org.apache.cordova.device
```

ネットワーク接続とバッテリーのイベント:

$ cordova plugin add org.apache.cordova.network-information
$ cordova plugin add org.apache.cordova.battery-status

加速度計、コンパス、および地理位置情報:

$ cordova plugin add org.apache.cordova.device-motion
$ cordova plugin add org.apache.cordova.device-orientation
$ cordova plugin add org.apache.cordova.geolocation

カメラ、メディアの再生とキャプチャ：

$ cordova plugin add org.apache.cordova.camera
$ cordova plugin add org.apache.cordova.media-capture
$ cordova plugin add org.apache.cordova.media

デバイスまたはネットワーク (File API) 上のアクセスファイル:

$ cordova plugin add org.apache.cordova.file
$ cordova plugin add org.apache.cordova.file-transfer

ダイアログボックスまたは振動による通知:

$ cordova plugin add org.apache.cordova.dialogs
$ cordova plugin add org.apache.cordova.vibration

連絡先：

$ cordova plugin add org.apache.cordova.contacts

グローバル化:

$ cordova plugin add org.apache.cordova.globalization

スプラッシュ・スクリーン:

$ cordova plugin add org.apache.cordova.splashscreen

開いている新しいブラウザーウィンドウ (InAppBrowser):
```
$ cordova plugin add org.apache.cordova.inappbrowser
```

デバッグコンソール：

$ cordova plugin add org.apache.cordova.console

使用 plugin ls (または plugin list 、または plugin 自体によって) 現在を表示するプラグインをインストールします。それぞれの識別子が表示されます。

    $ cordova plugin ls    # or 'plugin list'
    [ 'org.apache.cordova.console' ]

プラグインを削除するには、リストに表示される同じ識別子によってそれを参照してください。たとえば、ここではリリースバージョンからデバッグコンソールのサポートを削除するだろう方法です。

    $ cordova plugin rm org.apache.cordova.console        
    $ cordova plugin remove org.apache.cordova.console    # same

バッチ削除したりコマンドごとに 1 つ以上の引数を指定して、プラグインを追加できます。

各プラットフォームをカスタマイズします。

コルドバは、多くの異なるプラットフォーム用のアプリを簡単に展開することができます、間時々カスタマイズを追加する必要があります。この場合、様々なソースファイルを変更するたくない www 内の最上位レベルのディレクトリ platforms ディレクトリ、彼らしている定期的に置き換えられるので、最上位の www ディレクトリのクロスプラットフォームのソース。

代わりに、最上位 merges ディレクトリの特定のプラットフォームに展開する資産を指定する場所を提供しています。各プラットフォーム固有のサブディレクトリ内で merges のディレクトリ構造をミラー、 www ソースツリーで、オーバーライドまたは必要に応じてファイルを追加することができます。たとえば、使用する可能性がありますどのようにここでは merges Android デバイス用の既定のフォントサイズを後押しします。

編集、 www/index.html 、追加の CSS ファイルへのリンクを追加して、ファイル overrides.css この場合。
```
<link rel="stylesheet" type="text/css" href="css/overrides.css" />
```
必要に応じて作成する空の www/css/overrides.css ファイル、不足しているファイルのエラーを防止する、すべてのアンドロイドビルドに適用されます。
作成、 css 内のサブディレクトリ merges/android 、追加し、対応する overrides.css ファイル。 CSS オーバーライド内で指定された 12 ポイントの既定のフォントサイズを指定する www/css/index.css 、たとえば。
```
body { font-size:14px; }
```

プロジェクトをリビルドするとき他が変わらない間、Android のバージョンカスタムフォントサイズを備えています。

また使用することができます merges 、元のファイルが存在しないを追加する www ディレクトリ。たとえば、アプリ組み込むことができます戻るボタングラフィック iOS インターフェイスに格納されている merges/ios/img/back_button.png 、Android のバージョンをキャプチャすることができます代わりに、 backbutton 、対応するハードウェアボタンからのイベント。

コルドバの更新

インストールした後、 cordova ユーティリティ、常に更新できます、最新のバージョンに次のコマンドを実行します。

    $ sudo npm update -g cordova

特定のバージョンをインストールするには、この構文を使用します。

    $ sudo 故宮をインストール-g cordova@3.1.0

実行 cordova -v を現在実行中のバージョンを参照してください。実行、 npm info をその他の利用可能なバージョン番号と共に現在のバージョンを含む長い一覧のコマンド。

    $ npm info cordova

コルドバ 3.0 は、このセクションで説明されているコマンドラインインターフェイスをサポートするために最初のバージョンです。前述のように、新しいプロジェクトを作成し、古いアプリケーション資産の最上位レベルにコピーする必要があります 3.0 以前のバージョンから更新する場合は www ディレクトリ。該当する場合は、3.0 へのアップグレードに関する詳細はプラットフォームのガイドで利用できます。アップグレードした後、 cordova コマンドラインインターフェイスおよび使用 npm update 現在滞在より時間のかかる手順には、もはや関連。

コマンド ライン インターフェイス