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
Ce guide montre comment utiliser ensemble de Cordova d‘outils axés sur la plate-forme de shell pour développer des applications Android. Cette voie de développement, discutée dans l’aperçu, vous offrent un plus grand choix de développement que l‘outil CLI multiplate-forme décrit dans l’Interface de ligne de commande. Par exemple, vous devez utiliser les outils de shell lorsque vous déployez une coutume Cordova WebView aux côtés de composants natifs. Avant d‘utiliser ou l’autre voie de développement, vous devez d‘abord configurer l’environnement Android SDK comme décrit dans le Guide de la plate-forme Android.
Pour activer les outils de la coquille pour Android, Télécharger Cordova de cordova.apache.org. Le téléchargement contient les archives distincts pour chaque plate-forme. Développez chacun vous souhaitez cibler, android dans ce cas. Les outils pertinents sont généralement disponibles dans le niveau supérieur bin répertoire, sinon, consultez le fichier README pour en savoir plus.
Ces outils vous permettent de créer, générer et exécuter des applications Android. Pour plus d‘informations sur l’interface de ligne de commande supplémentaire qui active les fonctionnalités de plugin sur toutes les plateformes, voir Plugman à l‘aide à gérer les Plugins. Voir Application Plugins pour plus d’informations sur la façon de développer des plugins.
Exécutez le create commande, en spécifiant le chemin d‘accès existant au projet, l’identificateur de package inverse-domaine-style et nom complet de l'application. Voici la syntaxe pour Mac/Linux et 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
Cela nettoie puis génère un projet.
Debug, sur Mac/Linux ou Windows :
$ /path/to/project/cordova/build --debug
C:\>\path\to\project\cordova\build.bat --debug
Date de sortie, sous Mac/Linux ou Windows :
$ /path/to/project/cordova/build --release
C:\>\path\to\project\cordova\build.bat --release
Le run commande accepte les paramètres optionnels suivants :
Spécification de la cible. Cela inclut --emulator , --device , ou--target=<targetID>.
Construire la spécification. Cela inclut --debug , --release , ou--nobuild.
$ /path/to/project/cordova/run [Target] [Build] C:\>\path\to\project\cordova\run.bat [Target] [Build]
Assurez-vous que vous créez au moins un Android Virtual Device, autrement vous êtes invité à le faire avec la android commande. Si plusieurs AVD est disponible en tant que cible, vous êtes invité à sélectionner un. Par défaut la run commande détecte un appareil ou un émulateur en cours d‘exécution si aucun périphérique n’est trouvé.
$ /path/to/project/cordova/log
C:\>\path\to\project\cordova\log.bat
$ /path/to/project/cordova/clean
C:\>\path\to\project\cordova\clean.bat
À partir de cordova-android@4.0.0, la génération de projet à l'aide de Gradle. Pour obtenir des instructions sur le bâtiment avec ANT, se référer aux anciennes versions de la documentation.
Ces Propriétés peuvent être définies pour personnaliser la génération :
cdvBuildMultipleApks (par défaut : false)
Si la valeur est, plusieurs fichiers APK seront générés : une par plate-forme native soutenue par des projets de bibliothèque (x 86, ARM, etc.). Cela peut être important si votre projet utilise des grandes bibliothèques natives, qui peuvent augmenter considérablement la taille de l'APK généré.
Si ce n'est pas défini, alors un APK unique qui peut être utilisé sur tous les périphériques sera généré.
cdvVersionCode
Substitue le versionCode situé dans AndroidManifest.xml
cdvReleaseSigningPropertiesFile (par défaut : libération-signing.properties)
Chemin vers un fichier .properties qui contient les informations de signature pour diffusion immédiate s'appuie. Le fichier devrait ressembler à :
storeFile=relative/path/to/keystore.p12 storePassword=SECRET1 storeType=pkcs12 keyAlias=DebugSigningKey keyPassword=SECRET2
storePassword keyPassword sont optionnelle et sera demandé en cas d'omission.
cdvDebugSigningPropertiesFile (par défaut : debug-signing.properties)
Même cdvReleaseSigningPropertiesFile, mais pour le débogage s‘appuie. Utile lorsque vous avez besoin de partager une clé de signature avec d’autres développeurs.
cdvMinSdkVersion
Remplace la valeur de minSdkVersion dans AndroidManifest.xml. Utile lorsque vous créez plusieurs APKs s'inspire de la version SDK.
cdvBuildToolsVersion
Remplacer la valeur automatiquement détecté android.buildToolsVersion.
cdvCompileSdkVersion
Remplacer la valeur automatiquement détecté android.compileSdkVersion.
Si vous devez personnaliser build.gradle, plutôt que de modifier directement, vous devez créer un fichier de frère nommé build-extras.gradle. Ce fichier sera inclus par le principal build.gradle lorsqu'il est présent. Voici un exemple :
# 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'
}
Remarquez que les plugins peut inclure également construire-extras.gradle fichiers via :
<framework src="some.gradle" custom="true" type="gradleReference" />
export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14 cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true