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
Questa guida illustra come utilizzare set di Cordova di piattaforma-centrato shell strumenti per sviluppare applicazioni Android. Questo percorso di sviluppo, discusso nella panoramica, può offrire una maggiore gamma di opzioni di sviluppo che le piattaforme CLI strumento descritto in l‘interfaccia della riga di comando. Ad esempio, è necessario utilizzare strumenti di shell quando si distribuisce un’usanza Cordova WebView accanto alle componenti nativi. Prima di utilizzare qualsiasi percorso di sviluppo, è innanzitutto necessario configurare l'ambiente Android SDK come descritto nella guida alla piattaforma Android.
Per attivare strumenti di shell per Android, scaricare Cordova da cordova.apache.org. Il download contiene archivi separati per ciascuna piattaforma. Espandere ciascuna si desidera fare riferimento, android in questo caso. Gli strumenti pertinenti sono in genere disponibili nel primo livello bin directory, altrimenti consultare il file Leggimi per ulteriori indicazioni.
Questi strumenti consentono di creare, compilare ed eseguire applicazioni Android. Per informazioni sull'interfaccia della riga di comando aggiuntiva che attiva il plugin funzionalità su tutte le piattaforme, vedere utilizzando Plugman per gestire i plugin. Per dettagli su come sviluppare plugin, vedere applicazione plugin.
Eseguire il create comando, specificando il percorso esistente per il progetto, l‘identificatore del pacchetto stile retro-dominio e nome visualizzato dell’app. Ecco la sintassi per Mac/Linux e 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
Questo pulisce poi costruisce un progetto.
Debug, su Windows o Mac/Linux:
$ /path/to/project/cordova/build --debug
C:\>\path\to\project\cordova\build.bat --debug
Rilascio, su Windows o Mac/Linux:
$ /path/to/project/cordova/build --release
C:\>\path\to\project\cordova\build.bat --release
Il run comando accetta i seguenti parametri facoltativi :
Destinazione specifica. Ciò include --emulator , --device , o--target=<targetID>.
Costruire specifiche. Ciò include --debug , --release , o--nobuild.
$ /path/to/project/cordova/run [Target] [Build] C:\>\path\to\project\cordova\run.bat [Target] [Build]
Assicurarsi di creare almeno un Android Virtual Device, altrimenti viene richiesto di farlo con il android comando. Se più di una AVD è disponibile come un bersaglio, viene richiesto di selezionare uno. Per impostazione predefinita il run comando rileva un dispositivo collegato o un emulatore attualmente in esecuzione, se non viene trovato nessun dispositivo.
$ /path/to/project/cordova/log
C:\>\path\to\project\cordova\log.bat
$ /path/to/project/cordova/clean
C:\>\path\to\project\cordova\clean.bat
A partire da cordova-android@4.0.0, progetto costruire utilizzando Gradle. Per istruzioni sull'edificio con ANT, consultare le versioni precedenti della documentazione.
Queste proprietà possono essere impostate per personalizzare la compilazione:
cdvBuildMultipleApks (impostazione predefinita: false)
Se questa proprietà è impostata, allora verranno generati il file APK multipli: uno per ogni piattaforma nativa supportato da progetti libreria (x86, ARM, ecc). Questo può essere importante se il progetto utilizza grandi librerie native, che possono aumentare drasticamente le dimensioni dell'APK generato.
Se non impostato, allora verrà generato un singolo APK che può essere utilizzato su tutti i dispositivi.
cdvVersionCode
Esegue l'override del versionCode nella AndroidManifest
cdvReleaseSigningPropertiesFile (impostazione predefinita: release-signing.properties)
Costruisce il percorso di un file di Properties contenente le informazioni di firma per rilascio. Il file dovrebbe essere simile:
storeFile=relative/path/to/keystore.p12 storePassword=SECRET1 storeType=pkcs12 keyAlias=DebugSigningKey keyPassword=SECRET2
storePassword e keyPassword sono facoltativi e sarà richiesto se omesso.
cdvDebugSigningPropertiesFile (impostazione predefinita: debug-signing.properties)
Come cdvReleaseSigningPropertiesFile, ma per debug Build. Utile quando hai bisogno di condividere una chiave di firma con altri sviluppatori.
cdvMinSdkVersion
Esegue l'override del valore di minSdkVersion nella AndroidManifest. Utile quando si creano più APKs basato sulla versione SDK.
cdvBuildToolsVersion
Eseguire l'override del valore rilevato automaticamente android.buildToolsVersion.
cdvCompileSdkVersion
Eseguire l'override del valore rilevato automaticamente android.compileSdkVersion.
Se avete bisogno di personalizzare build.gradle, piuttosto che modificare direttamente, si dovrebbe creare un file di pari livello denominato build-extras.gradle. Questo file sarà inclusa dai principali build.gradle quando è presente. Ecco un esempio:
# 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'
}
Si noti che plugin può includere anche file di build-extras.gradle via:
<framework src="some.gradle" custom="true" type="gradleReference" />
export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14 cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true