license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
このガイドでは、アプリケーションの作成し、を使用してさまざまなネイティブ モバイル プラットフォームに展開する方法を示します、 cordova
コマンド ライン インターフェイス (CLI)。 このツールは、新しいプロジェクトの作成、異なるプラットフォームで構築、またはエミュレーター内で実際のデバイスで実行することができます。 CLI は、「概要」で説明されているプラットフォーム間ワークフローを使用する主なツールです。 それ以外の場合、CLI を使用してさまざまなプラットフォーム Sdk、および継続的な開発のためのシェルのツールに切り替えて、プロジェクト コードを初期化することもできます。
任意のコマンド ライン ツールを実行する前にターゲットにするプラットフォーム用の Sdk をインストールする必要があります。(詳細については、プラットフォームのガイドを参照)。
サポートを追加する任意のプラットフォーム用のプロジェクトをリビルド プラットフォームの SDK をサポートしている同じマシンからコマンド ライン インターフェイスを実行する必要があります。CLI には、次の組み合わせをサポートします。
Mac のコマンドラインですターミナルアプリケーション経由で利用できます。PC 上だアクセサリーの下でコマンド プロンプトとして使用可能.
注: Windows 専用プラットフォームをまだ Mac のハードウェア上で開発仮想マシン環境またはデュアル ブート モードで Windows を実行して行うことができます。 使用可能なオプションは、Windows Phone 8 プラットフォーム ガイドまたは Windows プラットフォーム ガイドを参照してください。
多くの可能性、CLI リモート ソース コード リポジトリでは、ローカルの作業ディレクトリにプルダウンその資産を維持するために理にかなってより多くの異なるマシンからに実行することです。
コルドバのコマンド ライン ツールは、すぐに使用できる形式での npm パッケージとして配布されます。ソースからコンパイルする必要はありません。
インストールする、 cordova
コマンド ライン ツールは、次の手順に従ってください。
ダウンロードしてインストールNode.js。 呼び出すことができる必要がありますインストール直後は、 node
と npm
コマンド ライン。 必要な場合があります必要に応じてツールを使用するような nvm
または nave
Node.js インストールを管理します。
ダウンロードして既に 1 つを持っていない場合、 git クライアントをインストールします。 呼び出すことができる必要がありますインストール直後は、 git
コマンド ライン。 にもかかわらず、あなた won't を使用して git
、手動で、CLI は使用舞台裏を新しいプロジェクトの作成時にいくつかの資産をダウンロードします。
インストール、 cordova
モジュールを使用して npm
Node.js のユーティリティ。cordova
モジュールはによって自動的にダウンロードされます、 npm
ユーティリティ。
OS X と Linux:
$ sudo npm install -g cordova
OS X と Linux では、プレフィックスとして、 npm
コマンドを sudo
必要がありますこの開発をインストールするユーティリティでそれ以外の場合制限されるディレクトリよう /usr/local/share
。 身廊 nvm オプション/ツールを使用しているか、インストール ディレクトリへの書き込みアクセスがある場合は省略することができます、 sudo
プレフィックス。 使用してより多くのヒントがある npm
なし sudo
、それを行うことを望む場合。
windows:
C:\>npm install -g cordova
-g
上記のフラグは、 npm
をインストールする cordova
世界的に。 それ以外の場合にインストールされます、 node_modules
の現在の作業ディレクトリのサブディレクトリ。
追加する必要があります、 npm
ディレクトリを PATH
グローバルにインストールされているを呼び出すために npm
モジュール。 Windows では、 npm
通常で発見することができます C:\Users\username\AppData\Roaming\npm
。 OS X と Linux それすることができます通常にあります。/usr/local/share/npm
.
インストール ログすべてアンインストールされたプラットフォーム Sdk の誤差が生じる可能性があります。
インストール後、実行することができる必要があります cordova
ない引数とコマンド ライン ヘルプ テキストを印刷する必要があります。
ソース コードを維持する、ディレクトリに移動し、次のようなコマンドを実行します。
$ cordova create hello com.example.hello HelloWorld
いくつかの時間がかかるを完了するコマンドがかかります。コマンドを実行して、 -d
オプションは、進行状況に関する情報を表示します。
最初の引数のハロープロジェクトに対して生成されるディレクトリを指定します。 このディレクトリは既に存在する必要があります、コルドバはあなたのために作成されます。 その www
サブディレクトリ、アプリケーションのホーム ページで、下にあるさまざまなリソースと一緒に家 css
、 js
と img
、一般的な web 開発ファイル名前付け規則に従いますが。 これらの資産は、リモートで提供されないデバイスのローカル ファイル システムに格納されます。 config.xml
ファイルには生成し、アプリケーションの配布に必要な重要なメタデータが含まれています。
2 番目の引数 com.example.hello
逆引きドメイン スタイル識別子と、プロジェクトを提供します。 この引数はオプションですが、またので、引数が位置指定に 3 番目の引数を省略する場合にのみです。 この値は編集できます後で、 config.xml
ファイル、しかし、ことはの外で生成されたコードがあるかもしれないことに注意してください config.xml
Java パッケージ名など、この値を使用して。 既定値は io.cordova.hellocordova
が適切な値を選択することをお勧めします。
3 番目の引数 HelloWorld
アプリケーションの表示タイトルを提供します。 この引数は省略可能です。 この値は編集できます後で、 config.xml
ファイル、しかし、ことはの外で生成されたコードがあるかもしれないことに注意してください config.xml
Java クラス名など、この値を使用して。 既定値は HelloCordova
が適切な値を選択することをお勧めします。
すべての後続コマンドは、プロジェクトのディレクトリまたはそのサブディレクトリのスコープ内で実行する必要があります。
$ cd hello
プロジェクトをビルドする前に対象プラットフォームのセットを指定する必要があります。 これらのコマンドを実行する能力にあなたのマシンが各 SDK をサポートしているかどうかに依存し、各 SDK をインストールされて既にがあるかどうか。 Mac からこれらのいずれかを実行します。
$ cordova platform add ios $ cordova platform add amazon-fireos $ cordova platform add android $ cordova platform add blackberry10 $ cordova platform add firefoxos
Wpは Windows Phone オペレーティング システムの異なるバージョンを参照 Windows マシンからこれらのいずれかを実行します。
$ コルドバ プラットフォーム追加 wp8 $ コルドバ プラットフォーム追加 $ コルドバ プラットフォームは、追加の windows アマゾン fireos $ コルドバ プラットフォーム追加 android の $ コルドバ プラットフォームは blackberry10 $、追加コルドバ プラットフォーム firefoxos を追加
現在のプラットフォームのセットを確認するこれを実行します。
$ cordova platforms ls
(注、 platform
と platforms
コマンドは同じ意味です)。
プラットフォームを削除する次の同義のコマンドのいずれかを実行します。
$ cordova platform remove blackberry10 $ cordova platform rm amazon-fireos $ cordova platform rm android
各指定されたプラットフォームがサブディレクトリとして追加またはプラットフォームに影響を与えるプロジェクトのプラットフォームディレクトリの内容を削除するコマンドを実行します。 Wwwソース ディレクトリは再現などに表示されるプラットフォームごとのサブディレクトリ内で platforms/ios/www
または platforms/android/assets/www
。 CLI は常にソースwwwフォルダーからファイルをコピー、ためこれらのファイルではなくプラットフォームサブディレクトリの下にあるもののみ編集してください。 バージョン管理ソフトウェアを使用するマージフォルダーと共にこのソースwwwフォルダーをバージョン管理システムに追加してください。 (マージフォルダーについての詳細は、下記の各プラットフォームのカスタマイズ セクションで発見ことができます)。
警告:ない編集のいずれかのファイルは、CLI を使用して、アプリケーションをビルド、するとき、 /platforms/
のマニュアル場合それ以外の場合あなたが何をやっている知っている限り、またはディレクトリ。 このディレクトリ内のファイルは、日常的に構築するためのアプリケーションを準備するとき、またはプラグインの再インストール時に上書きされます。
この時点でご希望の場合は作成したプロジェクトを開くに日食、Xcode など SDK を使用できます。 資産からの誘導体のセットを開く必要があります、 /platforms/
ディレクトリの SDK を開発します。 これは、SDK の特定のメタデータ ファイルは、適切な内に格納されるため /platform/
サブディレクトリ。 (各 IDE 内でアプリケーションを開発する方法についての情報のプラットフォームのガイドを参照)。あなたが単にしネイティブ作業用の SDK に切り替えるし、CLI を使用してプロジェクトを初期化する場合は、このアプローチを使用します。
記事を読む場合、開発サイクル全体のクロス プラットフォームのワークフロー アプローチ (CLI) を使用したいです。
既定で、 cordova create
スクリプト生成骨格の web ベースのアプリケーションのホーム ページは、プロジェクトの www/index.html
ファイル。 このアプリケーションが、任意の初期化の一部として指定する必要があります編集、 deviceready
から既定で参照されるイベント ハンドラー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 など、特定のデバイスをエミュレートします。他のプラットフォーム用に最初のデバイス エミュレーターに関連付ける必要があります。
注: エミュレーターのサポートは、現在アマゾン火 OS のため利用できません。
(詳細については、プラットフォームのガイドを参照)。たとえば、あなたが最初の実行、 android
人造人間 SDK を起動し、その既定の動作によると起動する特定のデバイスのイメージを実行するコマンド。
フォロー アップで、 cordova emulate
コマンドは、ホーム画面から起動できるようになります最新のアプリケーションを表示するエミュレーター イメージを更新します。
代わりに、携帯電話をお使いのコンピューターに差し込み、アプリを直接テストすることができます。
$ cordova run android
このコマンドを実行する前にする必要があるテストで、デバイスを設定するプラットフォームごとに異なる手順に従います。 人造人間とアマゾン火 OS のデバイス、デバイス上のUSB デバッグオプションを有効にして、おそらく開発環境に応じて USB ドライバーを追加する必要があります。 各プラットフォームの要件の詳細については、プラットフォームのガイドを参照してください。
ビルド、新しいプロジェクトを表示すると表示される既定のアプリケーションは非常にしません。 標準の web テクノロジーを活用する多くの方法でアプリを変更することができますが、デバイス レベルのさまざまな機能と密接に通信するアプリ、コア コルドバ Api へのアクセスを提供するプラグインを追加する必要があります。
プラグインはネイティブ コンポーネントへのインタ フェースを提供するアドオン コードのビットです。 たとえば、ネイティブ コンポーネントを持つコルドバの WebView をミックスしたハイブリッド アプリを設計するときの独自のプラグイン インターフェイスをデザインできます。 (詳細については埋め込み web 表示とプラグイン開発ガイドを参照してください)。一般的に、コルドバの基本的なデバイス レベル機能は、API リファレンスの詳細のいずれかを有効にするプラグインを追加すると思います。
バージョン 3.0 は、コルドバのプロジェクトを作成するときがない任意のプラグインが存在します。これは、新しい既定の動作です。任意のプラグインは、あなたが望むもコアプラグインは明示的に追加する必要があります。
これらのプラグインを含む、コミュニティによって提供される追加のサード パーティのプラグインのリストはplugins.cordova.ioでレジストリで見つかんだことができます。 CLI を使用するには、このレジストリからプラグインを検索します。 たとえば、検索 bar
と code
小文字部分文字列としての両方の条件に一致する 1 つの結果を生成します。
$ cordova plugin search bar code com.phonegap.plugins.barcodescanner - Scans Barcodes
のみをお探しの bar
言葉の利回りと追加の結果。
cordova-plugin-statusbar - Cordova StatusBar Plugin
cordova plugin add
コマンドは、プラグインのコードのリポジトリを指定する必要があります。CLI を使用アプリに機能を追加する方法の例を示します。
基本的なデバイス情報 (デバイス API):
$ cordova plugin add cordova-plugin-device
ネットワーク接続とバッテリーのイベント:
$ cordova plugin add cordova-plugin-network-information $ cordova plugin add cordova-plugin-battery-status
加速度計、コンパス、および地理位置情報:
$ cordova plugin add cordova-plugin-device-motion $ cordova plugin add cordova-plugin-device-orientation $ cordova plugin add cordova-plugin-geolocation
カメラ、メディアの再生とキャプチャ:
$ cordova plugin add cordova-plugin-camera $ cordova plugin add cordova-plugin-media-capture $ cordova plugin add cordova-plugin-media
デバイスまたはネットワーク (File API) 上のアクセス ファイル:
$ cordova plugin add cordova-plugin-file $ cordova plugin add cordova-plugin-file-transfer
ダイアログ ボックスまたは振動による通知:
$ cordova plugin add cordova-plugin-dialogs $ cordova plugin add cordova-plugin-vibration
連絡先:
$ cordova plugin add cordova-plugin-contacts
グローバル化:
$ cordova plugin add cordova-plugin-globalization
スプラッシュ ・ スクリーン:
$ cordova plugin add cordova-plugin-splashscreen
開いている新しいブラウザー ウィンドウ (InAppBrowser):
$ cordova plugin add cordova-plugin-inappbrowser
デバッグ コンソール:
$ cordova plugin add cordova-plugin-console
メモ: CLI プラットフォームごとの適切なプラグインのコードを追加します。 低レベルのシェルのツールやプラットフォーム Sdk の概要で説明されているようで開発する場合は、個別に各プラットフォーム用のプラグインを追加する Plugman ユーティリティを実行する必要があります。 (詳細については、管理プラグインを使用して Plugman を参照してください)。
使用 plugin ls
(または plugin list
、または plugin
自体によって) 現在を表示するプラグインをインストールします。それぞれの識別子が表示されます。
$ cordova plugin ls # or 'plugin list' [ 'cordova-plugin-console' ]
プラグインを削除するには、リストに表示される同じ識別子によってそれを参照してください。たとえば、ここではリリース バージョンからデバッグ コンソールのサポートを削除するだろう方法です。
$ cordova plugin rm cordova-plugin-console $ cordova plugin remove cordova-plugin-console # same
バッチ削除したり、各コマンドの 1 つ以上の引数を指定してプラグインを追加します。
$ cordova plugin add cordova-plugin-console cordova-plugin-device
プラグインを追加するときいくつかのオプション プラグインを取得する場所からを指定することができます。 上記の例をよく知られている使用して registry.cordova.io
レジストリ、およびプラグインで指定の id
:
$ cordova plugin add cordova-plugin-console
id
の後に追加のプラグインのバージョン番号を含めることができます、 @
文字です。latest
のバージョンは最新バージョンの別名です。たとえば。
$ cordova plugin add cordova-plugin-console@latest $ cordova plugin add cordova-plugin-console@0.2.1
プラグインが登録されていない場合 registry.cordova.io
が別の git リポジトリ内にある別の URL を指定することができます。
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git
上記の git の例は、master ブランチの終わりからプラグインをフェッチが後、代替 git ref タグまたは分岐などを追加することができます、 #
文字。
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
場合は、プラグイン (とその plugin.xml
ファイル) は git のレポ内のサブディレクトリでそれを指定することができます、 :
文字。 注意してください、 #
文字が必要であります。
$ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
また、git ref とサブディレクトリの両方を組み合わせることができます。
$ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
またはを含むプラグイン ディレクトリへのローカル パスを指定する、 plugin.xml
ファイル。
$ cordova plugin add ../my_plugin_dir
コルドバは、多くの異なるプラットフォーム用のアプリを簡単に展開することができます、間時々 カスタマイズを追加する必要があります。 この場合、様々 なソース ファイルを変更するたくない www
内の最上位レベルのディレクトリ platforms
ディレクトリ、トップレベルで定期的に取り替えられるため www
ディレクトリのクロスプラット フォームのソース。
代わりに、最上位 merges
ディレクトリの特定のプラットフォームに展開する資産を指定する場所を提供しています。 各プラットフォーム固有のサブディレクトリ内で merges
のディレクトリ構造をミラー、 www
ソース ツリーで、オーバーライドまたは必要に応じてファイルを追加することができます。 たとえば、使用する可能性がありますどのようにここでは merges
Android とアマゾン火 OS デバイスの既定のフォント サイズを後押しします。
編集、 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
、対応するハードウェア ボタンからのイベント。
コルドバ動けなくなるまたは問題が発生する場合に役立つことがあります、グローバルのコマンドのカップルを備えています。help
コマンドは、コルドバのすべての利用可能なコマンドとその構文が表示されます。
$ cordova help $ cordova # same
さらに、特定のコマンドに関するより詳細なヘルプを得ることができます。たとえば。
$ cordova run --help
info
コマンドは、現在インストールされているプラットフォームとプラグイン、各プラットフォーム用の SDK バージョン CLI のバージョンなどの潜在的有用な詳細情報の一覧を生成して node.js
:
$ cordova info
両方の画面に情報を提示し、地元の出力をキャプチャ info.txt
ファイル。
注: 現在、iOS および Android プラットフォームの詳細のみがあります。
インストールした後、 cordova
ユーティリティは、常に更新できますそれを最新バージョンに次のコマンドを実行します。
$ sudo npm update -g cordova
特定のバージョンをインストールするには、この構文を使用します。
$ sudo npm install -g cordova@3.1.0-0.2.0
実行 cordova -v
を現在実行されているどのバージョンを参照してください。 実行、 npm info
をその他の利用可能なバージョン番号と共に現在のバージョンを含む長い一覧のコマンド。
$ npm info cordova
コルドバ 3.0 は、このセクションで説明されているコマンド ライン インターフェイスをサポートするために最初のバージョンです。 前述のように、新しいプロジェクトを作成し、古いアプリケーション資産の最上位レベルにコピーする必要があります 3.0 以前のバージョンから更新する場合は www
ディレクトリ。 該当する場合は、3.0 へのアップグレードに関する詳細はプラットフォームのガイドで利用できます。 アップグレードした後、 cordova
コマンド ライン インターフェイスおよび使用 npm update
現在滞在より時間のかかる手順には、もはや関連。
コルドバ 3.0 + プロジェクト レベルのディレクトリ構造および他の依存関係に対するさまざまな変更必要があります。 実行した後、 npm
コルドバ自体を更新する上記のコマンドで、最新バージョンの要件に準拠して、プロジェクトのリソースを確保する必要があります。 構築している各プラットフォームについては、次のようなコマンドを実行します。
$ cordova platform update android $ cordova platform update ios ...etc.