PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Test d'une application Windows Mobile
  • Différences
  • Pourquoi existe-t-il des différences entre la simulation d'une application et l'exécution réelle de l'application ?
  • Les principales différences observées sont les suivantes :
  • Quelles sont les fonctionnalités dont le comportement est différent en test et en exécution réelle ?
  • Différences entre une simulation et une exécution réelle
  • Écran du simulateur
  • Fonctions spécifiant des chemins de fichiers
  • Sélecteur de fichiers (fonction fSélecteur)
  • Fonctions de gestion des chaînes de caractères
  • Fonctions LanceAppli et LanceAppliAssociée
  • Fonctions de gestion de la base de registre
  • Fonctions de gestion du système
  • Fonctions de gestion du clavier ou de la mémoire
  • Fonctions d'impression
  • Fonctions SMS
  • Notes
  • Fonctions de manipulation d'une base de données CEDB
  • Fonction EnModeWindowsMobile
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation

Test d'une application Windows Mobile

WINDEV Mobile propose plusieurs modes de test d'une application Windows Mobile :
  • Test et débogage sur le poste de développement : ce test réalise une simulation d'un Pocket PC sur le poste de développement. Ce test présente les avantages suivants :
    • Rapidité d'exécution
    • Connexion au Pocket PC non obligatoire
  • Test et débogage direct sur le Pocket PC actuellement connecté au poste PC.
  • Test et débogage sur le poste de développement (mode simulateur) : ce test réalise une simulation d'un appareil mobile sur le poste de développement. Ce test présente les avantages suivants :
    • Rapidité d'exécution
    • Connexion à l'appareil mobile non obligatoire
  • Test et débogage direct sur l'appareil mobile actuellement connecté au poste PC.
Dans les deux cas, le débogueur peut être utilisé.
Différences

Pourquoi existe-t-il des différences entre la simulation d'une application et l'exécution réelle de l'application ?

La simulation d'une application et son exécution réelle sont effectuées sur deux postes différents :
  • Le PC pour la simulation (le mode test)
  • Le terminal mobile (Pocket PC par exemple) pour l'exécution réelle.
Ces deux postes utilisant des environnements très différents, le résultat ou le comportement de certaines fonctionnalités ne sont pas identiques sur ces deux postes.
Ces différences ne sont pas dues à WINDEV Mobile.

Les principales différences observées sont les suivantes :

  • Manipulation des données présentes sur le poste en cours.
  • Ecran du terminal mobile
    En mode test, WINDEV propose un écran le plus proche de l'interface pour laquelle l'application est développée.
    Versions 15 et supérieures
    Pour permettre une simulation plus proche de l'environnement d'exécution réel, il est possible de pivoter l'affichage du simulateur pour le placer en mode horizontal. Utilisez pour cela l'icône Icône de rotation sur l'écran du simulateur.
    Nouveauté 15
    Pour permettre une simulation plus proche de l'environnement d'exécution réel, il est possible de pivoter l'affichage du simulateur pour le placer en mode horizontal. Utilisez pour cela l'icône Icône de rotation sur l'écran du simulateur.
    Pour permettre une simulation plus proche de l'environnement d'exécution réel, il est possible de pivoter l'affichage du simulateur pour le placer en mode horizontal. Utilisez pour cela l'icône Icône de rotation sur l'écran du simulateur.
  • Fonctions spécifiant des chemins de fichiers
    Le système de gestion de fichiers des terminaux mobiles et des PC est différent. Ces deux systèmes n'utilisent pas les mêmes chemins.
  • Sélecteur de fichiers :
    Le sélecteur de fichiers Mobile est plus limité.
  • Fonctions de gestion des chaînes de caractères
    Le codage des chaînes de caractères différent sur le PC et sur le terminal mobile (norme ANSI sur le PC et norme UNICODE sur le terminal mobile).
  • Fonctions LanceAppli et LanceAppliAssociée
    Les applications à lancer doivent être présentes sur le PC en mode test et sur le terminal mobile en exécution réelle.
  • Fonctions de gestion de la base de registre :
    La base de registre manipulée correspond à celle du système en cours.
  • Fonctions de gestion du système
    Les caractéristiques renvoyées correspondent aux caractéristiques du système en cours.
  • Fonctions de gestion du clavier ou de la mémoire
    Ces fonctions sont spécifiques au terminal mobile.
  • Fonctions d'impression
    L'impression est spécifique au terminal mobile.
  • Mémoire disponible sur le terminal mobile réduite.
  • Lenteur d'exécution sur le terminal mobile.

Quelles sont les fonctionnalités dont le comportement est différent en test et en exécution réelle ?

L'icône suivante est présente dans les pages d'aide des fonctions WLangage ayant un comportement différent en mode simulateur (mode GO) et en utilisation réelle.
Différences entre une simulation et une exécution réelle

Écran du simulateur

  • L'écran du simulateur propose une icône permettant d'afficher le clavier du terminal mobile . Cette icône n'est pas active en mode simulation.
    Cette icône permet uniquement de visualiser l'écran du terminal mobile en mode WYSIWYG ("What you see is what you get").
  • Les boutons présents sur le simulateur permettent de réduire ou fermer la fenêtre de simulation. Ces boutons ne seront pas présents en exécution réelle.

Fonctions spécifiant des chemins de fichiers

La gestion des répertoires est différente sur un poste PC et sur un terminal mobile (Pocket PC par exemple).
En effet, sur un poste PC, les chemins sont de la forme : "C:\MesDocuments\MonFichier.txt".
Au contraire, sur un terminal mobile, les chemins sont de la forme : "\MesDocuments\MonFichier.txt". Il n'y a pas qu'une seule arborescence et pas de notion de lecteur.
Récapitulatif
Les chemins de la forme "\MesDocuments\MonFichier.txt" :
  • sont valides en exécution réelle.
  • utilisent le disque en cours en mode test.
Les chemins de la forme "C:\MesDocument\MonFichier.txt" :
  • sont valides en mode test.
  • provoquent une erreur WLangage en exécution réelle.
Rappel : Les fichiers et les répertoires manipulés en mode test sont ceux du poste de développement et non ceux du terminal mobile.
Pour tester et exécuter vos applications sans problème, une des deux solutions suivantes peut être mise en place :
  • Solution 1 : Les fichiers manipulés sont tous dans le répertoire de l'application. Utilisez la fonction fRepExe pour construire le chemin des fichiers à manipuler.
  • Solution 2 : Utilisez un préfixe différent pour le chemin des fichiers manipulés selon si l'application est exécutée en mode test ou en réel (fonction EnModeTest).
Exemple :
SI EnModeTest() = Vrai ALORS
        PréfixeFichier = "C:\"
SINON
        PréfixeFichier = "\"
FIN

Sélecteur de fichiers (fonction fSélecteur)

Le fonctionnement et le résultat du sélecteur de fichiers (fonction fSelecteur) sont différents en mode simulation et en exécution réelle.
  • En mode simulation : Le sélecteur de fichier Windows pour PC s'affiche et renvoie un chemin au format PC (voir paragraphe précédent).
  • En exécution réelle : Le sélecteur de fichiers spécifique au terminal mobile s'affiche et renvoie un chemin au format du terminal mobile.
Pour tester et exécuter vos applications sans problème, utilisez la fonction EnModeTest pour savoir si l'application est exécutée en mode test ou en réel.
Exemple :
SI EnModeTest() = Vrai ALORS
// Sélection d'un fichier dans C:\Répertoires
Fichier = fSélecteur("C:\Répertoires", "Fichier.txt", ...
"Sélectionner un fichier", ...
"Fichier Texte (*.TXT)" + TAB + "*.txt" + RC + "Tous" + TAB + "*.*", "txt")
SINON
// Sélection d'un fichier dans "\Mes Documents\Répertoires"
Fichier = fSélecteur("\Répertoires", "Fichier.txt", ...
"Sélectionner un fichier", ...
"Fichier Texte (*.TXT)" + TAB + "*.txt" + RC + "Tous" + TAB + "*.*", "txt")
FIN

Fonctions de gestion des chaînes de caractères

La gestion des chaînes de caractères diffère entre le système du poste de développement (chaînes de caractères au format ANSI) et le système des terminaux mobiles (chaînes de caractères au format UNICODE).
  • En mode simulation, les résultats des fonctions de manipulation des chaînes seront au format ANSI (format des chaînes de caractères sur le poste de développement).
  • En exécution réelle, les résultats des fonctions de manipulation des chaînes seront au format UNICODE (format des chaînes de caractères sur le terminal mobile).
Les principales fonctions pouvant renvoyer un résultat différent sont les suivantes : Asc, Droite, Gauche, Milieu, Taille.
Important : WINDEV Mobile gère automatiquement le format ANSI ou UNICODE en fonction de la plateforme d'exécution de l'application. Aucun code spécifique n'est nécessaire.

Fonctions LanceAppli et LanceAppliAssociée

Les fonctions LanceAppli et LanceAppliAssociée exécutent une application spécifique.
  • En mode simulation : L'application exécutée doit être présente sur le poste de développement.
  • En exécution réelle : L'application exécutée doit être présente sur le terminal mobile.

Fonctions de gestion de la base de registre

Si votre application manipule la base de registre avec les fonctions RegistreXXX :
  • En mode simulation, ces fonctions manipuleront la base de registre du poste de développement.
  • En exécution réelle, ces fonctions manipuleront la base de registre du terminal mobile.
Pour tester et exécuter vos applications sans problème, utilisez la fonction EnModeTest pour savoir si l'application est exécutée en mode test ou en réel et utilisez les fonctions ceRegistreXXX lors de l'exécution réelle.
Exemple :
SI EnModeTest() = Vrai ALORS
       // Création de la clé "HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli"
        ResCréeClé = RegistreCréeClé("HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli")
SINON
       // Création de la clé "HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli"
        ResCréeClé= ceRegistreCréeClé("HKEY_LOCAL_MACHINE\SYSTEM\SOFTWARE\MonAppli")
FIN

Fonctions de gestion du système

Si votre application utilise des fonctions systèmes (Fonctions SysXXXX) :
  • En mode simulation, ces fonctions renverront les caractéristiques du poste de développement. Ainsi la fonction SysFenTitre renverra le nom du simulateur et non le nom de la fenêtre en cours d'exécution.
  • En exécution réelle, ces fonctions renverront les caractéristiques du terminal mobile.

Fonctions de gestion du clavier ou de la mémoire

  • En mode simulation, les fonctions de gestion du clavier (fonctions ClavierXXX) et les fonctions de gestion de la mémoire (fonctions SIMXXX) renvoient une erreur WLangage.
  • En exécution réelle, ces fonctions permettent de manipuler le clavier et la mémoire du terminal mobile.

Fonctions d'impression

  • En mode simulation :
    • la fonction iDestination renvoie une erreur WLangage.
    • les fonctions iConfigure et iParamètre ouvrent la fenêtre standard de sélection d'une imprimante (sélection d'une imprimante sur le poste de développement et non sur le terminal mobile).
  • En exécution réelle, l'impression est effectuée sur l'imprimante spécifiée sur le terminal mobile.

Fonctions SMS

  • En mode simulation, les fonctions SMS renvoient une erreur WLangage car ces fonctions ne sont disponibles que sur les Smartphones ou sur les terminaux mobile avec téléphone.
  • En exécution réelle, l'envoi de SMS est disponible sur les Smartphones ou les terminaux mobile avec téléphone.
Notes

Fonctions de manipulation d'une base de données CEDB

Votre application accède à une base de données du terminal mobile (fonctions cdbxxx). Le fonctionnement du mode test est le suivant :
  • Si un terminal mobile est connecté au poste de développement, les fonctions de manipulation d'une base de données CEDB manipuleront la base de données du terminal mobile connecté.
  • Si aucun terminal mobile n'est connecté au poste en cours lors de la simulation, une erreur WLangage sera affichée.

Fonction EnModeWindowsMobile

Lors d'un test en mode simulateur, la fonction EnModeWindowsMobile renvoie toujours Vrai.
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire