...

====== *** ATTOM : *** ======

Généralités

Conçue par l'Université d'Artois dans le cadre de l'UNR Nord Pas-de-Calais, dons dans un esprit de mutualisation

Application cross-platform hybride (cordova)

Compatible Android et iOS (prévu pour WindowsPhone)

Application récente, encore un peu verte ...

La particularité de cette application est de proposer des notifications local push (sans serveur tiers) utilisant le protocole de websocket. L'inconvénient, l'application ne doit pas être fermée si l'on veut recevoir les notifications.

pré-requis :

dernière version nodejs
Eclipse

Installation

Partie Serveur :

• Assurez-vous d’avoir installé la dernière version de node.js (http://nodejs.org/).
• Positionnez-vous sur le répertoire dans lequel vous souhaitez récupérer les sources de la partie server.
• Dans le répertoire ou récupérer les sources : svn co http://svn.univ-artois.fr/svn/attom/trunk/server/
• A la racine des sources ainsi récupérés, maj les modules : npm update
• Configurez le fichier config/config.js avec vos informations : database (mySQL), ports (http, webService) et le paramétrage de votre LDAP ...
• Le serveur est déployé, lancez-le :DEBUG=socket.io* nodemon start.js

Vous pourrez ensuite accéder au backOffice via <url du server node.js> :<port renseigné dans la propriété express de config.js>/

Partie Client:

Installation de Cordova

Assurez-vous d’avoir installé la dernière version de node.js (http://nodejs
* Eclipse

.org/).

Dans la console ou  Terminal, configurer le proxy :

Npm config set proxy http://wwwcache.univ-lr.fr:3128

Npm config set https-proxy http://wwwcache.univ-lr.fr:3128

installer le package cordova npm install –g cordova

Création du projet Cordova

-          Dans la console cmd ou dans un Terminal, positionnez-vous sur le répertoire dans lequel vous souhaitez créer votre projet Cordova.

-          Tapez cordova create attom fr.<nom_de_votre_université>.attom attom

-          Déplacez-vous dans le dossier attom nouvellement créé (cd attom).

-          Tapez cordova platform add android ou cordova platform add ios selon l’environnement sur lequel cette installation porte.

Création du projet sur l’IDE Eclipse (uniquement pour le developpement sur Android)

-          Créez un nouveau projet via File => New Project => Android => Android Project from Existing Code.

-          Dans Root Directory, choisissez le dossier attom nouvellement créé et cliquez sur Finish.

Deux dossiers sont créés dans votre workspace suite à l'import du projet :

• attom : sources de l'application.
• attom-CordovaLib : librairies nécessaires au bon fonctionnement de l'application

-          Afin d’éviter les éventuelles erreurs présentes à la création :

• Faites un clic droit => Properties sur le projet attom
• Allez dans Ressource => Ressource Filters
• Faites un remove sur tous les filtres Exclude présents.

(si des erreurs sont toujours présentes, faites un Project => Clean… => Clean all projects via l’interface d’Eclipse)

-          Vous pouvez désormais tester votre projet sur un appareil mobile connecté à votre machine:

• Placez-vous sur le dossier attom et cliquez sur l’icône Run
• Dans la fenêtre qui apparait alors, choisissez le device sur lequel vous souhaitez déployer l’application et cliquez sur OK.

Si tout s’est bien passé, l'application Blank créée s'ouvre sur le mobile avec l'icône Apache Cordova ainsi qu’un message device is ready.

4)       Ajout des sources d’Attom à votre projet cordova nouvellement créé

-          Créez un répertoire dans lequel vous allez récupérer les sources d’Attom et positionnez-vous dessus dans votre console cmd ou votre Terminal.

-          Tapez svn co http://svn.univ-artois.fr/svn/attom/trunk/client/www/

-          Un mot de passe vous est alors demandé, ignorez-le en appuyant sur entrée afin que vous soit demandé à la place votre nom d’utilisateur. Saisissez maintenant les logins/mdp qui vous ont été fournis via mail.

Si tout se passe bien, les sources d’attom sont récupérées dans un dossier www/

-          Dans votre projet attom précédemment créé, supprimez le répertoire attom/platforms/android/assets/www/ et remplacez-le par le dossier www/ que vous venez de récupérer via svn.

-          Copiez à la racine de ce répertoire nouvellement créé le fichier cordova.js situé dans attom/platform_www/.

5)       Ajouter les plugins nécessaires au bon fonctionnement de l’appli

-          Placé à la racine de votre projet attom :

• Ajoutez le plugin qui donne les informations sur le device :

cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git

• Ajoutez le plugin qui donne les informations sur la connexion internet :

cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git

• Ajoutez le plugin qui permet de logger dans la console :

cordova plugin add org.apache.cordova.console

• Ajoutez le plugin qui permet la notification :

cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git

6)       Configurer l’application

-          Dans le dossier attom/assets/www/js/, renommez le fichier config-example.js en config.js et complétez-le avec vos informations.

Vous pouvez maintenant Run l’application attom sur votre device de la même façon qu’à la dernière étape du 2).

Distribution

version iOS, Android et WindowsPhone (derniere moins finalisée < Beta)

...

Distribution :
* SVN
* Stores (en-cours)

Partie client :
* Liste à puceConfiguration puce Configuration dans attom/assets/www/js/config.js (host, port ...)

Partie serveur :
* Liste à puceConfiguration puce Configuration dans attom/server/config/config.js (bdd MySql, ldap, ports express/http/webService)

...