Android Shell Tool Guide
Diese Anleitung zeigt wie Cordovas Satz von Plattform-zentrierte Shell Tools verwenden, um Android apps zu entwickeln. Dieser Entwicklungspfad, diskutiert in der Übersicht, möglicherweise einen größeren Bereich von Entwicklungsoptionen als das Cross-Plattform-CLI-Tool beschrieben in The Command-Line Interface anbieten. Beispielsweise müssen Sie Shell-Hilfsmittel zu verwenden, wenn Sie eine benutzerdefinierte Cordova WebView neben systemeigenen Komponenten bereitstellen. Vor der Verwendung von entweder Entwicklungsweg, müssen Sie zuerst die Android SDK-Umgebung konfigurieren, wie in der Android-Plattform-Handbuch beschrieben.
Zum Aktivieren der Shell-Hilfsmittel für Android download Cordova von cordova.apache.org. Der Download enthält separate Archiv für jede Plattform. Erweitern Sie jedes Ziel, soll android
in diesem Fall. Die entsprechenden Tools stehen in der Regel in den übergeordneten bin
Verzeichnis, sonst finden Sie in der README -Datei für detailliertere Wegbeschreibung.
Diese Tools können Sie erstellen, erstellen und Ausführen von Android apps. Informationen über die zusätzliche Befehlszeilenschnittstelle, die Plugin-Features für alle Plattformen aktiviert, finden Sie unter Using Plugman zu Plugins verwalten. Details zum Entwickeln von Plugins finden Sie in der Anwendung-Plugins.
Erstellen Sie ein Projekt
Führen Sie den create
Befehl, der vorhandenen Pfad für das Projekt, die Reverse-Domäne-Style Paket-ID und die app-Anzeigenamen angeben. Hier ist die Syntax für Mac/Linux und 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
Build
Dies reinigt dann ein Projekt erstellt.
Debug auf Mac/Linux oder Windows:
$ /path/to/project/cordova/build --debug
C:\>\path\to\project\cordova\build.bat --debug
Version auf Mac/Linux oder Windows:
$ /path/to/project/cordova/build --release
C:\>\path\to\project\cordova\build.bat --release
Führen Sie die Anwendung
Der run
Befehl akzeptiert die folgenden optionalen Parameter:
Lastenheft. Dazu gehören
--emulator
,--device
, oder--target=<targetID>
.Spezifikation zu bauen. Dazu gehören
--debug
,--release
, oder--nobuild
.$ /path/to/project/cordova/run [Target] [Build] C:\>\path\to\project\cordova\run.bat [Target] [Build]
Vergewissern Sie sich, erstellen Sie mindestens ein Android virtuelles Gerät, sonst Sie werden aufgefordert zu tun mit dem android
Befehl. Wenn mehr als eine AVD als Ziel verfügbar ist, werden Sie aufgefordert, einen auswählen. In der Standardeinstellung der run
Befehl erkennt ein angeschlossenes Gerät oder einen laufenden Emulator, wenn kein Gerät gefunden wird.
Unterzeichnung der App
Sie können überprüfen, dass Android app Signaturanforderungen hier: http://developer.android.com/tools/publishing/app-signing.html
Um eine app zu signieren, benötigen Sie die folgenden Parameter:
Keystore (
--keystore
): Pfad in eine Binärdatei, die eine Reihe von Schlüsseln aufnehmen können.Schlüsselspeicher-Kennwort (
--storePassword
): Kennwort zum SchlüsselspeicherAlias (
--alias
): die Id angeben des privaten Schlüssels für Gesang.Passwort (
--password
): Kennwort für den privaten Schlüssel angegeben.Typ des Schlüsselspeichers (
--keystoreType
): pkcs12, Jks (Default: automatische Erkennung anhand der Dateierweiterung)
Diese Parameter können mithilfe der Befehlszeilenargumente oben zu build
oder run
von Skripts angegeben werden.
Alternativ könnten Sie sie in ein Build Startkonfigurationsdatei (build.json) mit angeben ( --buildConfig
) Argument. Hier ist ein Beispiel für eine Konfigurationsdatei erstellen:
{
"android": {
"debug": {
"keystore": "..\android.keystore",
"storePassword": "android",
"alias": "mykey1",
"password" : "password",
"keystoreType": ""
},
"release": {
"keystore": "..\android.keystore",
"storePassword": "",
"alias": "mykey2",
"password" : "password",
"keystoreType": ""
}
}
}
Für eine Veröffentlichung Signierung wird Kennwörter ausgeschlossen werden können und das Buildsystem nach dem Passwort gefragt.
Es gibt auch Unterstützung zu kombinieren, Kommandozeilen-Parameter und Parameter in der Datei build.json. Werte aus der Befehlszeilenargumente erhalten Vorrang. Dies ist hilfreich für Kennwörter in der Befehlszeile angeben.
Protokollierung
$ /path/to/project/cordova/log
C:\>\path\to\project\cordova\log.bat
Reinigung
$ /path/to/project/cordova/clean
C:\>\path\to\project\cordova\clean.bat
Gebäude mit Gradle
Stand: cordova-android@4.0.0, Projektbuilds mit Gradle. Finden Sie Anweisungen zum Gebäude mit ANT ältere Versionen der Dokumentation.
Gradle-Eigenschaften
Diese Eigenschaften können festgelegt werden, um den Build anzupassen:
cdvBuildMultipleApks (Standard: false)
Wenn dies festgelegt ist, mehrere APK-Dateien erzeugt werden: eine pro native von Bibliotheksprojekten unterstützte Plattform (X 86, ARM, etc.). Dies kann wichtig sein, wenn das Projekt große native Bibliotheken verwendet, die die generierten APK drastisch vergrößern können.
Wenn nicht gesetzt, dann einen einzigen APK generiert wird, die auf allen Geräten verwendet werden können.
cdvVersionCode
Überschreibt die VersionCode inmitten
AndroidManifest.xml
cdvReleaseSigningPropertiesFile (Standard: release-signing.properties)
Pfad zu einer .properties-Datei, die Signaturinformationen für Release enthält baut. Die Datei sollte wie aussehen:
storeFile=relative/path/to/keystore.p12 storePassword=SECRET1 storeType=pkcs12 keyAlias=DebugSigningKey keyPassword=SECRET2
storePassword
undkeyPassword
sind optional und werden aufgefordert für fehlt.cdvDebugSigningPropertiesFile (Standard: debug-signing.properties)
Wie CdvReleaseSigningPropertiesFile, jedoch für Debug baut. Nützlich, wenn Sie mit anderen Entwicklern einen Signaturschlüssel freigeben müssen.
cdvMinSdkVersion
Setzt den Wert von
minSdkVersion
in derAndroidManifest.xml
festgelegt. Nützlich beim Erstellen mehrerer APKs Grundlage SDK Version.cdvBuildToolsVersion
Überschreiben Sie den automatisch erkannten
android.buildToolsVersion
Wert.cdvCompileSdkVersion
Überschreiben Sie den automatisch erkannten
android.compileSdkVersion
Wert.
Verlängerung build.gradle
Wenn Sie build.gradle
anpassen, anstatt direkt bearbeiten müssen, sollten Sie eine Geschwister-Datei mit dem Namen Build-extras.gradle
erstellen. Diese Datei wird von den wichtigsten build.gradle
wenn vorhanden enthalten sein. Hier ist ein Beispiel:
# 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'
}
Beachten Sie, dass Plugins auch build-extras.gradle
Dateien über enthalten kann:
<framework src="some.gradle" custom="true" type="gradleReference" />
Beispiel-Build
export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true