アンドロイド シェル ツール ガイド
このガイドは、コルドバの一連のプラットフォームを中心としたシェル ツールを使用して 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
storePassword
keyPassword
省略可能で、省略した場合を求められます。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