Dveloppement Android - Principes
Dvelopper une application pour terminal
Android grce WINDEVMobile
Depuis la version 15, WINDEV Mobile
permet de dvelopper des applica-
tions pour le systme dexploitation
de Google: Android.
Android ne fonctionne pas tout fait
comme Windows Mobile: certains
fonctionnements sont diffrents.
Cet article prsente les diffrentes
spcificits lies au dveloppement
dapplications Android.
Ces conseils de dveloppement
sappliquent aussi bien la cration
de nouveaux projets Android qu
ladaptation dun projet existant
en Android.
54-TDF TECH 2010 - www.pcsoft.fr
1 Installer le SDK
Android sur le
poste de
dveloppement
Pour dvelopper pour Android, il faut dans
un premier temps installer le SDK Android
sur le poste de dveloppement.
Ce SDK est disponible sur Internet et il est
diffus gratuitement.
Le SDK Android peut tre tlcharg cette
adresse: http://developer.android.com/
intl/fr/sdk/index.html.
Laide de WINDEV Mobile comporte une page
qui explique o trouver les diffrents l-
ments et comment les installer: il suffit de
cliquer sur le lien O trouver le SDK? qui se
trouve dans lassistant de cration de projet
Android et dans lassistant de gnration
dapplication Android
Notre conseil
Ne perdez pas de temps configurer lmula-
teur via loutil fourni. WINDEV Mobile permet
de crer simplement le ou les mulateurs
Android que vous souhaitez.
2
Un gabarit
unique:
ActivAndroid
Une des particularits des projets Android
rside dans le fait quil existe un seul
et unique gabarit disponible: le gabarit
ActivAndroid.
En effet, le look Android ne peut pas tre
chang puisquil est appliqu par le sys-
tme.
Notre conseil
Lorsque vous crez un champ, vitez de
rduire la taille par dfaut dfini par le
gabarit, notamment la hauteur des champs.
En effet, les tailles par dfaut sont calcu-
les pour que les libells soient lisibles en
excution.
3 Une base de
donnes
spcifique: SQLite
Les bases de donnes des applications Android
sont par dfaut au format SQLite. WINDEV
Mobile inclut en standard un accs natif
SQLite pour Android.
Pour passer une application existante (qui
utilise donc une base HyperFileSQL) en
Android, il nest pas ncessaire de modifier
la description des fichiers existants ou de
crer de nouveaux fichiers. Il suffit de:
dcrire une connexion SQLite laide de
la fonction HDcritConnexion.
// Dcrit la connexion utilise
HDcritConnexion(
ConnexionAndroid,
, ,
AndroidGestionDeCommandes,
, hAccsSQLiteAndroid,
hOLectureEcriture)
dappliquer cette connexion aux
fichiers de lanalyse, via la fonction
HChangeConnexion.
// Change la connexion des fichiers
// de lapplication
HChangeConnexion(*,
ConnexionAndroid)
Remarque:
En mode simulation (Go via le simulateur
WINDEV Mobile), les donnes utilises sont
au format HyperFileSQL. La connexion au
fichier doit donc tre diffrente selon la
plateforme dexcution.
La fonction WLangage EnModeAndroid
permet de savoir si lexcution seffectue
sur un priphrique Android (mulateur ou
terminal) ou non.
SQLite possde certaines spcificits:
il est fortement conseill davoir un iden-
tifiant automatique pour chaque fichier
utilis sous SQLite.
SQLite ne prend pas en charge le systme
de mot de passe sur un fichier. Les fonctions
HPasse et HCration avec mot de passe ne
sont donc pas disponibles.

4
Point de table,
mais des zones
rptes
Pour afficher une liste complexe dlments
sous Android, seul le champ zone rpte est
disponible. En effet, le champ table nest
pas disponible sur cette plateforme.
De plus, la notion de slection sur une
ligne de zone rpte na pas de sens sous
Android: aucun bandeau de slection nest
affich, la slection nest pas visuelle.
Cette particularit ncessite un dveloppe-
ment particulier par rapport une application
sous Windows mobile.
Dans le cas dune zone rpte qui prsente
une liste de clients et qui permet dajouter,
modifier et supprimer des clients, le compor-
tement dune application Windows Mobile et
dune application Android est diffrente.
En Windows Mobile
La fentre de type liste propose gnrale-
ment une zone rpte ainsi que 3 boutons
(ou options de menu):
Ajouter: ce bouton ouvre la fiche en
mode cration.
Modifier: ce bouton ouvre la fiche du
client slectionn dans la zone rpte.
Supprimer: ce bouton supprime lenre-
gistrement client slectionn dans la zone
rpte.
La fentre fiche propose 2 boutons:
Valider: ce bouton valide lajout ou la
modification (selon le mode douverture).
Annuler: ce bouton fermer simplement
la fentre (annulation des modifications
ventuellement saisies).
En Android
La solution la plus simple et intuitive pour
une application Android est la suivante.
La fentre de listing propose uniquement le
bouton (ou loption de menu) Ajouter.
La slection dune ligne de la zone rp-
te ouvre directement la fentre fiche en
mode Modification: la slection est donc
lquivalent du bouton Modifier.
La fentre fiche dispose dun 3me bouton
Supprimer, qui permet de supprimer la
fiche en cours de consultation.
Une autre solution consiste positionner le
bouton Supprimer directement sur chaque
ligne de la zone rpte au lieu de le posi-
tionner dans la fentre fiche.
Linconvnient de cette mthode est la place
occupe par le bouton, qui rduit dautant
le nombre de lignes visibles dans la zone
rpte.
5
Android, Windows
Mobile: soyez
coopratifs!
Lenvironnement coopratif est une nou-
veaut des versions 15.
Cette fonctionnalit est trs utile lorsquun lexcutable sur un terminal mobile et de
projet est destin une plateforme spci-
fique (Android, Java, PHP) ou est multipla-
teforme.
Lditeur restreint en effet certaines fonc-
tionnalits non disponibles pour la plateforme
courante.
Par exemple, dans un projet mobile en gn-
ration Android, la barre doutils de cration
de champs ne propose que les champs dis-
ponibles pour Android: le bouton champs
table est gris. Ainsi, aucun risque duti-
liser une fonctionnalit non disponible en
excution!
Dans le cas dun projet multiplateforme,
lditeur informe des fonctionnalits qui
ne sont pas disponibles pour au moins une
des plateformes. Il est donc plus simple
de sadapter au mieux chaque configu-
ration.
Plus de dtails sur lenvironnement coopratif
sont disponibles dans larticle ddi JAVA
de ce support de cours.
Notre conseil
Utilisez des fonctionnalits disponibles pour
toutes les plateformes de dveloppement
associes votre projet.
Cela vite un doublement des fentres, codes
et la maintenance en est simplifie.
6
Portrait ou
Paysage? Vos
fentres
sadaptent!
La plupart des matriels Android permettent
de permuter le mode daffichage: portrait
ou paysage.
Mais sous lditeur, les fentres sont dfinies
et les champs positionns pour un affichage
en mode Portrait.
Comment faire pour configurer laffichage
en mode Paysage?
Rien de plus simple avec WINDEV Mobile:
il suffit de dfinir pour chaque champ un
ancrage adquat.
TDF TECH 2010 - www.pcsoft.fr-55
Mobilit - Android
Rappel:
Les ancrages permettent de dfinir
le comportement dun champ lors du
redimensionnement de la fentre ou, dans
notre cas, du changement du mode daffi-
chage: le champ doit-il rester au centre?
droite? en bas? Le champ doit-il stirer en
largeur? en hauteur? etc.
Notre astuce
Pour tester ces ancrages, inutile de copier
tester lexcutable dessus. Les simulateurs
WINDEV Mobile disposent, en version 15,
dun bouton qui permet de permuter les 2
modes daffichage.
7
Optimisez la
place disponible
dans vos fentres
Comme pour tout appareil mobile, la capacit
daffichage est rduite:
la taille des fentres est restreinte par
lcran du terminal,
les diffrents champs doivent tre suffisam-
ment importants pour pouvoir cliquer dessus
facilement, via un stylet ou le doigt.
Pour optimiser loccupation des fentres,
plusieurs astuces sont disponibles.
Le style Libell interne du gabarit
ActivAndroid permet davoir le libell au-
dessus du champ de saisie. Cela permet de
gagner une place non ngligeable en largeur.
La place en hauteur est moins problmati-
que dans la mesure o le dfilement tactile
permet de parcourir rapidement toute la
hauteur dune fentre.
Pour gagner de la place en hauteur et en
largeur, il suffit de remplacer le libell du
champ de saisie par un texte dindication.
Le texte dindication est un libell affich
directement dans le champ de saisie lors-
que celui-ci est vide. Il permet en gnral
dajouter une prcision sur linformation
attendue dans le champ.
Notre conseil
Si la fentre comporte peu de champs de
saisie ou des champs de saisie qui nont
pas de lien entre eux (par exemple, diff-
rents paramtres pour lapplication), il est
conseill dutiliser le style Libell interne
combin au texte dindication.
Si la fentre comporte un nombre important
de champs qui ont un contexte commun (par
exemple, les champs dune fentre fiche
client), le texte dindication seul suffit.
Dveloppement Android - Principes (SUITE)
Dvelopper une application pour terminal
Android grce WINDEVMobile (SUITE)
Le titre de la fentre permet aussi dafficher
des informations importantes. Par exemple,
il est possible dafficher le mode douverture
dune fiche (Cration, Modification). le sigle WL du bandeau: le sigle changera
Les options de menu permettent de rempla-
cer avantageusement les boutons. Le menu
est en effet affich la demande (clic sur le
bouton Menu du priphrique) et noccupe
donc pas de place dans la fentre.
Notre conseil
Il est ncessaire de trouver un quilibre entre
lutilisation des boutons et des options de
menu. En effet, pour excuter une option de
menu, il est ncessaire deffectuer au moins
2 clics: un clic pour ouvrir le menu (bouton
Menu du priphrique) et un (ou plusieurs)
clic pour choisir loption de menu, selon le
nombre doptions proposes par le menu. Un
bouton ne demande quun seul clic.
Nous conseillons donc dutiliser:
des boutons pour les actions qui seront
utiliss trs souvent,
des options de menu pour les actions uti-
lises plus rarement. Si le menu comporte
de nombreuses options, placer les options
les plus utiles en dbut de menu permet dy
accder plus rapidement.
8
Do you speak
Java?
Avec WINDEV Mobile, le dveloppement
Android se fait simplement en WLangage.
Certaines fonctions WLangage ne sont cepen-
dant pas disponibles pour un dveloppe-
ment Androidparce que ces fonctions nont
pas de sens pour un priphrique Android
(ListeSelectPlus par exemple),
Lors de lutilisation de ces fonctions dans
lditeur de code, une erreur apparat: La
fonction <NomFonction> na pas dquivalent
dans le framework WL/Android.
Pour utiliser des fonctions spcifiques du
SDK Android qui ne seraient pas disponibles
en WLangage, il est tout fait possible de
dvelopper ... en Java!
56-TDF TECH 2010 - www.pcsoft.fr
Rappel:
Pour dvelopper en Java, il suffit, dans le
code dune procdure globale, de cliquer sur
ZoneRpteAffiche(ZR_Client,
en JAVA et le bandeau deviendra violet,
indiquant que le code attendu pour cette
procdure est du code Java.
9
Ssame,
OuvreFille toi!
Sous Android, la fonction WLangage Ouvre na
pas dexistence. Seule la fonction OuvreFille
peut tre utilise. Cette fonction a un fonc-
tionnement particulier.
En effet, la fonction OuvreFille permet
douvrir une fentre, mais continue excu-
ter le code de la fentre mre: louverture code de fermeture de la fentre. Il suffit
de la fentre nest pas bloquant.
Pour tre prvenu lors de la fermeture de la
fentre fille et effectuer une action spcifi-
que dans la fentre appelante, il est nces-
saire dutiliser une procdure callback.
Lors de la fermeture de la fentre fille,
une procdure de la fentre mre va tre
excute pour prvenir que la fentre fille
est ferme.
Par exemple, il est ncessaire de savoir
quand une fentre de type Fiche client est
ferme pour pourvoir ractualiser si besoin
la zone rpte de tous les clients.
Diffrents traitements doivent donc tre
mis en place, sur la fentre mre et sur la
fentre fille.
Ct fentre mre
Dclarer une procdure callback dans la
fentre mre. Cette procdure attend en
gnral un paramtre qui correspond la
valeur renvoye par la fentre fille: dans Notre astuce
le cas dune fentre de type fiche, il sagit Utiliser lvnement Fermeture de la fen-
dun boolen (Vrai si la fentre est valide,
Faux dans le cas contraire). Mais il est tout
fait possible de renvoyer une valeur dun
autre type (une chane par exemple).
PROCEDURE FermetureFiche(bValide)
// Si la fentre fiche est valide
SI bValide ALORS
// Mise jour de la zone rpte
taCourantBandeau)
FIN
Ajouter cette procdure en paramtre de
lappel OuvreFille. Attention, le nom de la
procdure doit tre mis entre guillemets.
// Ouverture de la fiche Client
OuvreFille(FEN_Fiche_Client,
FermetureFiche)
Ct fentre fille
Spcifier que la fentre attend un para-
mtre. Ce paramtre correspond donc au
nom de la procdure callback dfinie dans
la fentre mre.
PROCEDURE FEN_Fiche_Client(
gsCallBackFermeture)
Appeler la procdure callback dans le
de passer la valeur de retour de la fentre
en paramtre la procdure.
// Excute la procdure callback en
// passant en paramtre la valeur
// de retour de la fentre
ExcuteTraitement(
gsCallBackFermeture, trtProcdure,
MaFentre..ValeurRenvoye)
Indiquer une valeur de retour par dfaut
dans le code dinitialisation de la fentre.
La valeur de retour dune fentre peut tre
indique via la proprit ValeurRenvoye
de la fentre.
// Valeur de retour par dfaut
MaFentre..ValeurRenvoye = Faux
Indiquer la valeur de retour dans les bou-
tons, options et traitements ncessaires.
Par exemple, lors dun clic sur le bouton
Valider de la fentre FEN_Fiche_Client,
la fentre doit renvoyer Vrai.
// La fiche est valide
MaFentre..ValeurRenvoye = Vrai
tre et la valeur de retour de la fentre
prsente un avantage certain: quelle que soit
la faon dont lutilisateur ferme la fentre
(mme via le bouton Back du tlphone), la
procdure sera excute.

A
Simulateur,
Emulateur: faites
le bon choix
WINDEV Mobile propose diffrentes mthodes
(modes Go) pour tester une application
Android: minimale que devra possder le priphri-
Le test de lapplication dans le simulateur
de WINDEV Mobile, qui permet de tester
rapidement lapplication.
Le test de lapplication dans lmulateur
fourni avec le SDK Android. Lmulateur
fonctionne comme un terminal Android: il
est donc ncessaire de crer lapplication
pour la dployer ensuite sur le priphrique.
Ce type de Go nest donc pas instantan,
puisque lexcutable gnr doit tre copi
sur le priphrique. De plus, le lancement de
lmulateur peut prendre un certain (surtout
le premier lancement): conserver lmula-
teur actif lors des phases de tests vite une
attente inutile.
Le test de lapplication directement sur
le terminal Android, qui permet davoir un
rendu rel de lapplication.
Notre conseil
Pour tester vos applications Android, privi-
lgiez au maximum le simulateur WINDEV
Mobile: il est beaucoup plus rapide, vous
donne un aperu rel du rendu de lap-
plication et, point non ngligeable, vous
bnficiez du dbogueur
Toutefois, nhsitez pas utiliser lmulateur
Android rgulirement pour tre sr que
votre application sexcute correctement
dans un environnement Android.
gatoirement tre compos de deux textes
minimum spars par un point (.). Par
exemple, masocit.MonApplication.
Signature de lapplication
Les applications Android doivent tre signes
pour tre dployes sur les terminaux mobi-
les.
En effet une application non signe ne sins-
tallera pas sur le terminal mobile!
La signature de lapplication sert authen-
tifier le fournisseur de lapplication.
Il existe deux types de signature:
la signature gnrique: cette signature
est fournie par le SDK dAndroid et permet
de pouvoir tester lapplication sur le ter-
minal mobile. Une application qui utilise
dune application Android dans ce support
une signature gnrique ne pourra pas tre
dploye sur dautres terminaux!
la signature normale: cette signature est
gnre partir dun fichier de cl spci-
fique lapplication. Par dfaut, WINDEV
Mobile gnre un fichier de cl spcifique
lapplication.
Permissions supplmentaires
Lassistant de cration dexcutables permet
dinclure des permissions supplmentaires.
Ces permissions dpendent de lapplication et
de ces fonctionnalits: gestion des caches,
Mobilit - Android
du bluetooth, etc.
Toutes les permissions ncessaires lex-
cution du code WLangage sont automatique-
ment ajoutes.
Plateformes Android
Il est possible de slectionner la plateforme
que pour pouvoir excuter lapplication:
une version basse permettra lapplication
dtre utilise par plus de terminaux mobiles
Android.
Une fois lapplication gnre, il est possible
de la distribuer. Une solution pour distribuer
simplement une application Android est la
plateforme Android Market.
Retrouvez plus de dtails sur le dploiement
de cours.
Exemples
WINDEV Mobile 15 est livr en standard
avec diffrents exemples dvelopps pour
Android: Android Gestion de Commandes,
Android Inscrits, Android Explorer et Android
MotDePasse.
Le DVD de ce support de cours contient ga-
lement un exemple dvelopp pour lAcer
one: Android Gestion Devis.

B Dployez
simplement vos
applications
Android
Lors de la gnration de lexcutable Android,
diffrentes informations doivent tre fournies
dans lassistant.

Package
Le nom du package permet didentifier lap-
plication. En effet, sur Android, toutes les
applications sont installes dans un seul et
mme rpertoire.
Pour diffrencier deux applications de mme
nom, Android utilise donc le nom du package.
Il est conseill dindiquer le nom de la socit
dans le nom du package.
Attention: le nom du package doit obli-

TDF TECH 2010 - www.pcsoft.fr-57