Documentation - lynxify.com, générateur d'applications mobiles.

Trouvez ici les instructions nécessaires pour exploiter le générateur,
ainsi que la technologie exclusive de lynxify.com


1/ Démarrage
2/ Fonctionnalités
3/ Fonctionnement
4/ Installation
5/ Options
6/ Annexes, documents




-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------








1/ Démarrage
------------------------

Bienvenue sur lynxify.Com.

Ce générateur d'applications mobiles s'appuie sur son propre moteur en java, qui fournit une interface simplifiée entre vos applications
(en javascript notamment) et l'appareil mobile.

Cette interface offre l'accès aux fonctionnalités avancées des appareils mobiles (sms, contacts, vibreur, wifi, fichiers, géolocalisation,
capteurs...) depuis javascript, ce qui offre plusieurs avantages importants :

- Il n'est plus nécessaire de programmer en java, une simple librairie en javascript suffit
  désormais pour exploiter les fonctionnalités de l'appareil mobile cible (android 2.2 mini)

- Vos applications web standard peuvent être utilisées (pour peu que l'affichage sur un mobile soit géré),
  et l'intégration des fonctionnalités mobiles dans votre structure existante est simplifiée.

- Et bien d'autres à découvrir ! (mises à jour en temps réel sans recompilation, etc...)

Il est donc possible d'écrire des applications mobiles de grande simplicité tout comme vous développez vos sites web, voire de connecter l'appli
mobile aux plateformes existantes (ou d'en générer une), ce qui fait évidemment économiser grandement sur les coûts de développement
d'applications mobiles, tout en rendant désormais cette plateforme accessibles aux développeurs web, sans qu'ils aient à changer leur méthode
habituelle de développement pour autant.

Contrairement à la technologie apache, aucun code javascript ou php n'est compilé avec l'application, et il reste disponible pour modification
à tout moment depuis votre serveur. (si ce n'est la partie client/offline evidemment) La mise a jour d'applications ne concerne donc plus que le
moteur java, et non votre code spécifique. Vos clients profitent donc immédiatement de vos dernières améliorations, sans avoir besoin de remettre
à jour l'application ou a télécharger quoi que ce soit.






2/ Fonctionnalités
------------------------

L'api de lynxify est indépendant, et ne fait pas appel a apache cordova. Pour le moment, lynxify ne fonctionne que sur android, version 2.2
minimum. Nous sommes actuellement a l'étude afin d'offrir un support vers les plateformes apple, microsoft etc... (à suivre).


Voici les différentes fonctions actuellement implémentées et commentées :


- api.switchMode(mode); // mode online/offline [true|false]
Switch entre deux modes de fonctionnement (java/js ou java/php)
pour utiliser ou non l'accès au serveur par l'application mobile.

- api.getContacts(); // recuperation des contacts depuis les sms
Analyse les SMS reçus, pour fournir une liste de contacts

- api.getSms(thId, start,npp); // recuperation des sms pour un contact [thread_id|0|50]
Récupère une tranche de conversation SMS avec un thread_id fourni, ainsi qu'un
numéro de départ (de 100 en 100 ex: 0, 100, 200 etc...), et nombre par page

- api.getWifi(); // effectue un scan wifi
Effectue un scan wifi sur la machine, et renvoie les résultats

- api.getPosition(); // recupere la position par gps ou reseaux
Récupère la position courante et renvoie le résultat

- api.getVibrator(duration); // fait vibrer l'appareil mobile [800]
Envoie un signal au vibreur de l'appareil mobile (d'une durée de x ms)

- api.getCamera(); // prend une photo
Prend une photo (et l'envoie au serveur en mode online)

- api.getSensors(); // liste les capteurs installes
Liste les capteurs installés sur l'appareil mobile

- api.getSensorData(type); // affiche les donnees du capteur
Recupere et envoie les donnees du capteur specifie par son type

- api.fileRead(hdd,file); // lit un fichier dans la mémoire interne
Lit un fichier sur l'appareil mobile

- api.fileWrite(hdd,file, data); // ecrit dans un fichier de la mémoire interne
Ecrit dans un fichier sur l'appareil mobile

- api.fileEmpty(hdd,file); // vide un fichier de la mémoire interne
Vide un fichier de son contenu sur l'appareil mobile

- api.alert(alerte); // equivalent java du alert() javascript [message]
Affiche une alerte a l'utilisateur

- api.appUninstall(); // desinstalle l'application
Envoie au menu de désinstallation de l'application

- api.appExit(); // quitte l'application
Ferme l'application

- api.setSessId(sid); // initialise une session php serveur
Initialise la session sur le serveur, pour l'authentification des données postées

- api.appJsEval(str); // evalue une chaine javascript
Evalue une chaine javascript


Comme vous pouvez le constater, l'utilisation de l'api est extrêmement simple, des fonctions de haut niveau étant deja intégrées. L'accès aux
fonctionnalités est donc des plus aisé. Une petite librairie php/js est également fournie pour permettre l'intégration en quelques clics, sur
toute plateforme serveur existante.

Un énorme avantage de cette technologie, est qu'excepté la partie java, toutes vos applications peuvent être mises à jour en temps réel et sans
rien modifier chez le client.








3/ Fonctionnement
------------------------

En plus de générer l'application mobile signée, avec vos paramètres particuliers, notre générateur fourni à votre serveur web ou code html/js/php,
un api permettant l'appel direct aux fonctionnalités disponibles sur l'appareil cible.

Cet api contient les fonctions listées ci-dessus, qui peuvent être appelées à tout moment par votre page web en javascript :

- onclick="api.getContact();"
- window.onload=function(){getSensors();}

Les fonctions qui attendent une réponse et des données en sortie, génèrent une chaine json, qui est alors envoyée au serveur, puis à javascript
en mode online, ou renvoyée directement à javascript en mode offline.

En mode online, le serveur reçoit également la chaine et peut renvoyer un callback (optionnel).

En interprétant cette chaine json coté serveur ou client, on peut alors analyser les données fournies par les fonctions, et ainsi offrir différents
services. L'exemple fourni affiche simplement les données, et permet de tester chaque fonction.

Tous ces appels de fonctions et communications sont synchrones y compris avec le serveur.

Les librairies contiennent également une fonction d'appel ajax (donc asynchrone) au serveur, permettant de le consulter directement
sans passer par l'api java de l'application. Cette fonction n'est pas utilisée par l'api.





4/ Installation
------------------------

Configuration

Via le formulaire, vous paramétrez les différents éléments de l'application (nom, package, icônes...).
Vous choisissez l'api cible (le plus bas assure la compatibilité la plus importante), et si vous voulez (ou non) afficher les erreurs à l'utilisateur.

Configurez ensuite les permissions de l'application (sans quoi le programme n'aura pas la possibilité d'accéder aux données).

Le formulaire demande ensuite, un certificat pour signer votre application (et ainsi la rendre disponible sur play store). Vous pouvez en générer
un (que vous pourrez télécharger en fin de compilation) ou fournir le vôtre. Attention, chaque certificat (keystore) fourni doit être le même
pour pouvoir mettre à jour l'application ou la réinstaller.

Dans les paramètres du serveur web, entrez l'url désirée comme destination de l'application mobile (ou laissez l'url par défaut, pour héberger
votre application sur le serveur lynxify). Si vous disposez d'un CMS (Wordpress par exemple) doté d'un template mobile, vous pouvez faire
pointer l'application sur cette URL.

Pour créer une application offline (simple consultation de fichier, etc) vous pouvez décocher cette fonctionnalité.

Générez un script serveur, si vous désirez pouvoir accéder aux données du téléphone et de l'api, depuis votre site mobile. Les librairies
d'intégration simplifiée seront alors générées et disponibles pour modification et/ou intégration.

Le script client, permet de configurer la partie offline de l'application. Elle n'est pas indispensable pour une application connectée.
Par défaut, le script client demandera a l'utilisateur de se connecter.

En options, vous pouvez utiliser votre propre serveur MySQL (si vous êtes hébergés chez nous), ainsi qu'une installation par ftp à distance.

Compilation

Suite à cette configuration, vous pouvez compiler l'application. Une fois le fichier disponible, vous téléchargez votre application depuis le QRCode,
ou un simple lien. Pour les applications offline, vous pouvez fournir ou éditer un code javascript/html/css, afin d'offrir à l'utilisateur une
interface offline permettant tout de même l'accès aux fonctionnalités.

Il est même possible d'offrir une fonctionnalité de serveur local au client, afin de fournir des fonctionnalités avancées même hors ligne
(base de données, php, etc) (Note : a venir dans une version ultérieure)

Installation

Pour les applications online (la majorité des cas), un code standard d'intégration ainsi que les librairies sont fournies pour démarrer. Une petite
application d'exemple montre les fonctionnalités simplement. Vous pouvez alors le modifier à souhait, ou l'intégrer dans un applicatif existant a
destination des appareils mobiles. (Wordpress, Magento, Drupal, Joomla, avec template mobile par exemple)








5/ Options, annexes
------------------------








6/ Annexes et documents
------------------------

Note : l'option cryptage est actuellement en modification, et est donc indisponible
pour le moment.