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
このガイドは、コルドバの一連のプラットフォームを中心としたシェル ツールを使用して 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
コマンド デバイスが見つからない場合に接続されているデバイス、または現在実行中のエミュレーターを検出します。
$ /path/to/project/cordova/log C:\>\path\to\project\cordova\log.bat
$ /path/to/project/cordova/clean C:\>\path\to\project\cordova\clean.bat
Cordova-android@4.0.0、現在プロジェクトは Gradle を使用してビルドされます。ANT の建物には古いバージョンのドキュメントを参照してください。
これらの プロパティ は、ビルドのカスタマイズを設定できます。
cdvBuildMultipleApks(デフォルト: false)
これが設定されている場合は複数の APK ファイルが生成されます: ライブラリ プロジェクトでサポートされているネイティブ プラットフォームごとに 1 つ (x 86、腕、等)。 これは、プロジェクトで生成された APK のサイズを大幅に増やすことができます大規模なのネイティブ ライブラリを使用する場合に重要なことができます。
設定しない場合、[すべてのデバイスで使用できる単一の APK が生成されます。
cdvVersionCode
VersionCode AndroidManifest.xml
で設定よりも優先されます。
cdvReleaseSigningPropertiesFile(デフォルト: release-signing.properties)
リリースの署名情報を含む .properties ファイルへのパスを構築します。ファイルはようになります。
storeFile=relative/path/to/keystore.p12 storePassword=SECRET1 storeType=pkcs12 keyAlias=DebugSigningKey keyPassword=SECRET2
storePassword
および keyPassword
は省略可能、促されるを省略した場合。
cdvDebugSigningPropertiesFile(デフォルト: debug-signing.properties)
同じです cdvReleaseSigningPropertiesFile がデバッグをビルドします。署名キーを他の開発者と共有する必要がある場合に役立ちます。
cdvMinSdkVersion
MinSdkVersion
与えます
で設定の値をオーバーライドします。複数を作成するときに便利です APKs SDK バージョンをに基づいてください。
cdvBuildToolsVersion
自動検出された android.buildToolsVersion
値をオーバーライドします。
cdvCompileSdkVersion
自動検出された android.compileSdkVersion
値をオーバーライドします。
build.gradle
、カスタマイズするのではなく、直接編集する必要がある場合 ビルド 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' }
プラグインは ビルド extras.gradle
経由でのファイルも含めることができます注意してください。
<framework src="some.gradle" custom="true" type="gradleReference" />
export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14 cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true