Apache Cordova
Introduction
Apache Cordova est un framework open-source permettant de créer des applications mobiles multi-plateformes en HTML, CSS et Javascript. Ce framework était à l'origine Apache Callback ou plus connu, Adobe PhoneGap.
Pour plus de détails, vous pouvez consulter la documentation officielle: Documentation
Installer Cordova
A l'inverse de PhoneGap qui bénéficie d'un assistant de conception, Cordova nécessite de passer par des lignes de commande qui s'exécute dans Node.js. Il est donc nécessaire d'avoir certaine connaissance en Node.js.
Pour installer Cordova, il faut taper la commande NPM suivante:
npm install -g cordova
Créer un projet
Pour créer un projet vierge vous devez commencer par vous rendre dans le dossier où vous souhaitez créer votre projet. Pour cela, utilisé les commandes de navigation:
cd = pour vous déplacer ls = pour lister le contenu d'un dossier
Une fois dans le répertoire cible, utilisé la commande suivante:
cordova create AppName (AppName fait référence au nom de votre application)
Si vous désirez de l'aide vis à vis de la commande create, vous pouvez utiliser la commande:
cordova help create
Ajouter une plateforme
Une fois le projet créer, vous devez indiquer à votre applicaton la ou les plateformes cibles.
Commencez par vous rendre dans le dossier de votre application. cd AppName.
Puis, utilisez la commande suivante:
cordova platform add <plateformName>
Voici la liste des différentes plateformes disponibles:
- ios = Apple IOS
- amazon-fireos = Amazon Fire OS
- android = Google Android
- blackberry10 = Blackberry OS
- firefoxos = Firefox OS
Lancer l'application
Une fois que votre application est prête à être lancée, utilisez la ligne de commande suivante:
cordova run <nom plateform>
Ajouter des plugins
Cordova propose une grande liste de plugin pour permettre à votre application d'avoir accès aux fonctionnalités natives du téléphone. Ces plugins sont organisés dans différentes catégories:
- Battery Status
- Camera
- Device
- Dialogs
- File
- Geolocation
- Inappbrowser
- Media
- Media Capture
- Network Information
- Screen Orientation
- Splashscreen
- Statusbar
- Vibration
- Whitelist
Les plugins sont disponible via NPM et une simple commande de recherche va vous permettre de trouver le plugin que vous recherchez. Vous pouvez également aller directement chercher cette information dans la documentation technique.
Pour effectuer une recherche sur NPM, utilisez la commande suivante:
cordova plugin search nomPlugin
Il faudra ensuite ajouter les informations du plugin dans votre fichier config.xml ainsi que package.json. Voici un exemple avec le plugin de la camera:
cordova plugin add cordova-plugin-camera
Il est également possible d'installer un plugin depuis un dossier ou un espace Git.
Personnaliser les icones de l'application
Vous pouvez personnaliser l'icône de votre application. Si vous ne le faites pas, l'icône de Cordova sera affichée.
Pour modifier l'icone, vous devez vous utiliser l’élément icône dans le fichier config.xml.
Voici la ligne de code à utilsier:
<icon src="res/ios/icon.png" platform="ios" width="57" height="57" density="mdpi" />
Cette ligne de code modifiera l'icône uniquement pour IOS.
<icon src="res/icon.png" />
Voici une ligne de code plus généraliste qui fonctionnera de base pour toutes les plateformes. Utilisez la première version si vous désirez personnaliser l'icône plus en détails en fonction des plateformes.
Notez que seul le paramètre src="" est indispensable. Tout le reste est optionnel.