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

アンドロイドシェルツールガイド

このガイドは、コルドバの一連のプラットフォームを中心としたシェルツールを使用して Android アプリを開発する方法を示します。概要で説明したこの開発パスはコマンドラインインターフェイスで記述されているクロスプラットフォーム CLI ツールよりも開発オプションの大きい範囲を提供するかもしれない。たとえば、ネイティブコンポーネントと一緒にカスタムコルドバ WebView を展開する場合、シェル・ツールを使用する必要があります。開発パスはいずれかを使用する前に Android プラットフォームガイドで説明されているよう、Android SDK 環境を構成すること最初する必要があります。

人造人間のためのシェル・ツールを有効にする、コルドバcordova.apache.orgからダウンロードします。ダウンロードには、プラットフォームごとに別々のアーカイブが含まれています。各ターゲット、たい展開 android この場合。関連するツールは、最上位レベルでふつう利用できる bin ディレクトリ、それ以外の場合より詳細な方向のREADMEファイルを参照してください。

これらのツールを作成、構築、および Android アプリを実行することができます。すべてのプラットフォームのプラグイン機能を有効にする追加のコマンドラインインターフェイスについては、管理プラグインを使用して Plugman を参照してください。プラグインを開発する方法の詳細については、アプリケーション・プラグインを参照してください。

プロジェクトを作成します。

実行、 create プロジェクト、逆ドメインスタイルパッケージ識別子、およびアプリケーションの表示名を既存のパスを指定するコマンドです。ここでは Mac の/Linux と Windows の両方の構文です。

    $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName

    C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName

ビルド

これをきれいにし、プロジェクトをビルドします。

Mac の/Linux または Windows をデバッグします。

    $ /path/to/project/cordova/build --debug

    C:\>\path\to\project\cordova\build.bat --debug

Mac の/Linux または Windows のリリース：

    $ /path/to/project/cordova/build --release

    C:\>\path\to\project\cordova\build.bat --release

アプリを実行します。

runコマンドは、次の省略可能なパラメーターを受け入れます。

ターゲットを指定します。これが含まれています --emulator 、 --device 、または--target=<targetID>.

仕様を作成します。これが含まれています --debug 、 --release 、または--nobuild.

$ /path/to/project/cordova/run [Target] [Build]

C:\>\path\to\project\cordova\run.bat [Target] [Build]

少なくとも 1 つの Android 仮想デバイス、それ以外の場合でそうよう求められますを作成するかどうかを確認、 android コマンド。 AVD 1 つ以上のターゲットとして使用できる場合はいずれかを選択するよう求められます。既定では、 run コマンドデバイスが見つからない場合に接続されているデバイス、または現在実行中のエミュレーターを検出します。

アプリケーションの署名

署名の要件ここで Android アプリを確認することができます： http://developer.android.com/tools/publishing/app-signing.html

アプリケーションを署名するには、次のパラメーターが必要です。

キーストア ( --keystore ): キーのセットを保持できるバイナリファイルへのパス。
キーストアのパスワード ( --storePassword ): キーストアパスワード
エイリアス ( --alias ): 歌うことのために使用する秘密キーを指定する id。
パスワード ( --password ): 指定されたプライベートキーのパスワード。
キーストアのタイプ ( --keystoreType ): pkcs12、jks (デフォルト: 自動検出ファイル拡張子に基づいて)

上記のコマンドライン引数を使用してこれらのパラメーターを指定することができます build または run スクリプト。

また、使用してビルド構成ファイル (build.json) に指定 ( --buildConfig ) の引数。ビルド構成ファイルのサンプルです。

{
     "android": {
         "debug": {
             "keystore": "..\android.keystore",
             "storePassword": "android",
             "alias": "mykey1",
             "password" : "password",
             "keystoreType": ""
         },
         "release": {
             "keystore": "..\android.keystore",
             "storePassword": "",
             "alias": "mykey2",
             "password" : "password",
             "keystoreType": ""
         }
     }
 }

リリース署名、パスワードを除外することができ、ビルドシステムは、パスワードを要求するプロンプトを発行します。

サポートをミックスし、コマンド・ライン引数および build.json ファイルのパラメーターと一致しています。コマンドライン引数から値は優先順位を取得します。これは、コマンドラインでパスワードを指定することができます。

ログ

    $ /path/to/project/cordova/log

    C:\>\path\to\project\cordova\log.bat

クリーニング

    $ /path/to/project/cordova/clean

    C:\>\path\to\project\cordova\clean.bat

Gradle の構築

現在 cordova-android@4.0.0、 Gradleを使用してプロジェクトのビルド。 ANT の構築には、ドキュメントの古いバージョンを参照してください。

Gradle プロパティ

これらのプロパティを設定して、ビルドをカスタマイズできます。

cdvBuildMultipleApks(既定値: false)

これが設定されている場合、複数の APK ファイルが生成されます: ライブラリプロジェクトでサポートされているネイティブなプラットフォームごとに 1 つ (x 86、腕など)。これは、プロジェクトで生成された APK のサイズを大幅に増やすことができます大規模なネイティブライブラリを使用する場合に重要です。

ない場合、設定は、すべてのデバイスで使用できる単一の APK が生成されます。
cdvVersionCode

VersionCode 設定よりも優先されます。AndroidManifest.xml
cdvReleaseSigningPropertiesFile(デフォルト: リリース signing.properties)

リリースの署名情報が含まれる .properties ファイルへのパスを構築します。ファイルは、次のようになります。
```
storeFile=relative/path/to/keystore.p12
storePassword=SECRET1
storeType=pkcs12
keyAlias=DebugSigningKey
keyPassword=SECRET2
```
storePasswordkeyPassword省略可能で、省略した場合を求められます。
cdvDebugSigningPropertiesFile(デフォルト: デバッグ signing.properties)

CdvReleaseSigningPropertiesFile と同じデバッグ、ビルドします。署名キーを他の開発者と共有する場合に便利です。
cdvMinSdkVersion

値を上書き minSdkVersion で AndroidManifest.xml 。複数を作成するときに役に立つ APKs は SDK のバージョンに基づいています。
cdvBuildToolsVersion

自動的に検出をオーバーライドして android.buildToolsVersion の値。
cdvCompileSdkVersion

自動的に検出をオーバーライドして android.compileSdkVersion の値。

拡張 build.gradle

カスタマイズする必要がある場合 build.gradle ではなく、直接編集よりも兄弟ファイルを作成する必要があります build-extras.gradle 。このファイルは、メインの表示 build.gradle 時提示します。以下は例です。

# Example build-extras.gradle
# This file is included at the beginning of `build.gradle`
ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties'
# When set, this function allows code to run at the end of `build.gradle`
ext.postBuildExtras = {
    android.buildTypes.debug.applicationIdSuffix = '.debug'
}

プラグインを含めることも、注意してください build-extras.gradle を介してファイルします。

<framework src="some.gradle" custom="true" type="gradleReference" />

例のビルド

export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true

アンドロイド シェル ツール ガイド