💥 NE PAS METTRE A JOUR LES BIBLIOTHEQUES JS ou PREVOIR DU TEMPS POUR UNE REVISION GLOBALE DU CODE ( par exemple : https://marionettejs.com/docs/master/upgrade-v3-v4.html )

Les dépendances JavaScript (bibliothèques, ...) sont satisfaites par npm.

Le code Javascript est organisé en modules selon la syntaxe CommonJS. Il doit donc être compilé avec Browserify afin d'être exploitable par le navigateur.

Cette compilation des fichiers est automatisée avec Grunt. Grunt automatise aussi diverses autres tâches.

Puisqu'il s'agit d'un projet mobile basé sur Cordova, cette tâche grunt a été attachée au hook before-prepare de Cordova. Ainsi, pour tester l'application sur un terminal, vous n'avez rien de plus à faire que :

cordova run <platform>

Pendant le développement, pour plus de facilité, vous pouvez tester l'application dans le navigateur :

grunt dev

Note : la tâche dev ouvre l'appli dans votre navigateur avec watch + livereload.

Merci de documenter brièvement ici les outils que vous ajouterez au fur et à mesure du développement.

Créer une copie locale de la base de code :

git clone <depot> .

Installer les diverses dépendances du projet :

npm install -g cordova grunt-cli
npm install
cordova plugin restore --experimental

Installer Cordova 7.1 dans le dossier courant :

npm install --save [email protected]

Utiliser les commandes Cordova pour la version locale. Cette version de Cordova se trouve dans le dossier des nodes_modules :

• Pour Mac OS, par exemple :

  node_modules/cordova/bin/cordova build android
  

Copier le fichier :

cp www/modules/main/config.js.tpl www/modules/main/config.js

Puis éditer ce fichier, pour ajouter l'url vers l'application serevur et l'api

Ajout de la plateforme (android ou ios) :

cordova platform add android

Génération d'un APK de type debugue :

cordova build android

Merci d'ajouter les plugins au config.xml pour qu'ils puissent être installé par les autres développeurs de manière facile et cohérente.

Pour cela, utilisez la CLI :

cordova plugin add [email protected]
cordova plugin save --experimental

La seconde ligne ajoute une référence à ce plugin dans congig.xml. Les autres développeurs pourront se mettre à jour en tapant simplement :

cordova plugin restore --experimental
Référence: http://stackoverflow.com/a/25105731

Note : pour éviter les mauvaises surprises, il est important de fixer les versions des plugins. On n'installe pas le plugin foobar, jamais. On peut en revanche installer le plugin [email protected], pas de problème.

Utiliser npm pour inclure dans le projet des dépendances Javascript. Merci de différencier les dépendances de développement et globales :

npm install jquery --save

ou :

npm install grunt --save-dev

Note : Comme pour les plugins et pour les mêmes raisons, il est important de fixer les versions des dépendances Javascript. Avec l'option --save, npm fixe automatiquement le numéro de version.