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
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.
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
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
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.
$ /path/to/project/cordova/log C:\>\path\to\project\cordova\log.bat
$ /path/to/project/cordova/clean C:\>\path\to\project\cordova\clean.bat
Ab cordova-android@4.0.0 Projekterstellung mithilfe von Gradle. Anweisungen zum Gebäude mit ANT finden Sie zu älteren Versionen der Dokumentation.
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ützten Plattformen (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, dann einen einzigen APK generiert werden, 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 erstellt. Die Datei sollte wie aussehen:
storeFile=relative/path/to/keystore.p12 storePassword=SECRET1 storeType=pkcs12 keyAlias=DebugSigningKey keyPassword=SECRET2
StorePassword
und KeyPassword
sind optional und werden aufgefordert für fehlt.
cdvDebugSigningPropertiesFile (Standard: debug-signing.properties)
Wie CdvReleaseSigningPropertiesFile, jedoch für Debug erstellt. Nützlich, wenn Sie mit anderen Entwicklern einen Signaturschlüssel freigeben müssen.
cdvMinSdkVersion
Setzt den Wert von MinSdkVersion
in der AndroidManifest.xml
festgelegt. Nützlich, wenn mehrere erstellen APKs Grundlage SDK Version.
cdvBuildToolsVersion
Überschreiben Sie den automatisch erkannten android.buildToolsVersion
Wert.
cdvCompileSdkVersion
Überschreiben Sie den automatisch erkannten android.compileSdkVersion
Wert.
Benötigen Sie build.gradle
anpassen, anstatt direkt bearbeiten, 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" />
export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14 cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true