Développement Mobile

Version du 6 janvier 2014 à 11:00

Introduction

Les applications mobiles considérées ici sont des applications de type WebApp.

Ce sont donc des Applications Web spécialement conçues pour fonctionner sur des dispositifs mobiles.

La ligne 1000 n'impose pas de framework client pour développer ces applications, néanmoins nous conseillons d'utiliser le framework JQuery et JQuery Mobile et nous fournissons des plugins pour ces frameworks qui simplifient la mise en oeuvre.

Nous conseillons de suivre les bonnes pratiques suivantes :

• Centrez le développement de vos application sur un rôle d'un utilisateur.
• Utilisez JQuery et JQuery Mobile, ceci simplifie grandement le développement.
• Optimisez le fonctionnement de vos application pour limiter le nombre d'aller retour avec le serveur.
• Optimisez le code serveur pour obtenir le maximum de performance.
• Utilisez l'API JSON coté client et coté serveur.
• Gérez le mode déconnecté.
• Utilisez systématiquement https

Architecture

Flux

Artefacts

Les éléments constituants une Application Mobile sont les suivants :

• Un objet du référentiel contenant les artefacts html de l'application.

Cet objet content une archive zip du contenu du répertoire de l'application mobile.

• Un paquet métier de type Paquet de service locale contenant le code des opérations appelées par l'application mobile.

Typiquement ce paquet ne contient qu'une classe support et des opérations

• Un paquet métier associé à l'application mobile.

Ce paquet ne sert qu'à associer l'Application Mobile avec une Application Métier, il est utilisé comme critère de filtrage lors du déploiement des Applications Mobiles.

Déploiement

Une application mobile correspond à un sous répertoire du répertoire "mobiles" du site.

Il est recommandé d'appeler la page racine de l'application "home.html".

Installation

Lors du démarrage du service les Applications Mobiles associées à un paquet de l'Application du service sont déployées.

Déployer une Application Mobile consiste à :

• Décompresser l'archive de l'application dans le répertoire /mobiles/ du site du service.
• Installer et enregistrer dans le framework le paquet métier associé à l'application.

URL d'une application

Les Applications Mobiles déployées sur un service sont accessibles à partir de l'Url du service :

  https://host/mobiles/myapp/home.html

Galerie

Le service 1000 détecte un client Mobile par la présence du mot "mobile" dans le UserAgent de la requête HTTP.

Sur une requête mobile sur la racine du service il construit une galerie des applications disponibles.

Donc un agent mobile effectuant une requête sur

  https://host

recevra en réponse une galerie des applications mobiles disponibles.

Développement

Le développement d'une Application Mobile peut être réalisé dans le concepteur de modèle de l'application Desktop.

Créer une nouvelle application

Pour créer une nouvelle Application Mobile utilisez l'assistant accessible dans le menu Actions du concepteur de modèle. Cet assistant créer une nouvelle application en dupliquant une application existante.

Gérer les interactions

Une fois l'application créer vous pouvez commencer à coder les interactions de votre application.

Typiquement une Application Mobile interagit avec un serveur Web par le biais d'appel Ajax.

Coté client vous exécutez un appel Ajax, par exemple :

$.post("serverpath/method", json_object, function( data ) {
   // do something with the response
},"json");

et coté serveur vous devez implémenter une méthode "method" répondant à cet appel :

procedure method(req:TJSon; var resp:TObject);
begin
  json := TJson.Create('');
  // create json response
  resp := json;
end;

Le service 1000 accepte les appels de méthode JSON sur les URLs SData simplifiées :

 https://host/sdata/package/method

donc si votre Application Mobile s'appelle "myapp" et utilise le paquet de service "myappPackage" vous utiliserez :

$.post("sdata/myapppackage/method", json_object, function( data ) {
   // do something with the response
},"json");

et coté serveur :

unit myappPackage;
type
  myappSupport = class
    procedure method(req:TJSon; var resp:TObject);
  end; 
 
procedure myappSupport.method(req:TJSon; var resp:TObject);
begin
  json := TJson.Create('');
  // create json response
  resp := json;
end;

Notez que la classe myAppSupport est la classe support des méthodes de service et est implicitement utilisée, elle n'apparait pas dans les urls d'appel des méthodes.

Le plugin JQuery jq1000 contient une variable $.l1000._api_ utilisé pour définir le chemin des appels Ajax :

$(document).ready( function() {
 
    // updated by mobile wizard.
    $.l1000._api_ = "sdata/mobilesuitefi";
 
}

Une fois cette variable définie les appels Ajax deviennent :

$.post($.l1000._api_+"/method", json_object, function( data ) {
   // do something with the response
},"json");

Mise au point

Vous pouvez utilisez le serveur HTTP intégré au concepteur de modèle pour mettre au point vos Applications Mobiles.

Lors du paramétrage du serveur :

• Renseigner le répertoire du site.
• Paramétrer le service en https

Notez que ce serveur HTTP intégré ne gère pas l'authentification, les exécutions de méthodes sont donc réalisées dans le contexte de l'utilisateur de l'application Desktop.

Suivant votre paramétrage du serveur HTTP, l'url de l'Application Mobile peut être légèrement différente, par exemple

  https://host:8081/l1000/mobiles/myapp/home.html

mais cela n'influence pas le fonctionnement.

API JSON

Licences