WireLess Mobile Downloader
Web Downloader.doc
|
20040802 Version 1.0_fr |
|
WireLess Mobile Downloader
Résumé.
Une nouvelle version du Client WireLess Mobile pour Pocket PC 2002 est
disponible (1.1.0). Il inclut un nouveau système pour l’établissement des
préférences. Le système précédent (c’est à dire, la configuration est
actualisée à travers d’options de menu dans le Mode Administrateur) est
toujours disponible, mais un autre a été ajouté, qui permet de lire une partie
de la configuration à partir d’un fichier, et la stocker dans le registre. Ce
fichier peut être généré hors l’application et mis sur l’appareil avec Active
Sync ou à travers le nouveau composant appelé WireLess Mobile Downloader.
WireLess Mobile Downloader
travaille sur HTTP, et il est capable de télécharger un groupe de fichiers.
L’un d’entre eux est _dnlce.cfg, il contient les noms
des fichiers à télécharger, ainsi que le chemin de l’application à la quelle
retourner quand le downloader a termniné.
Un des fichiers qui peut être inclus dans _dnlce.cfg est _wirelessmobile.cfg. Si ce fichier est téléchargé vers la racine de
l’appareil, le Client Wireless Mobile charge toutes les entrées en base de
registre, et puis supprime le fichier.
Vu que le Client WireLess Mobile sort quand il appel l’application WireLess
Mobile Downloader, il est possible d’actualiser la version du Client WireLess
Mobile en indiquant le fichier exécutable comme un des fichiers à télécharger.
Structure de _dnlce.cfg
La première ligne est toujours la même. La seconde indique le numéro de
version. Pour chaque ligne, la double barre “//” indique que tout ce qui suit
est un commentaire, et est ignoré par le chargeur. Il y a deux sections, dont
le nom est indiqué entre crochets. Toutes les lignes qui sont entre deux noms
de section, ou celles qui sont au-delà du dernier nom de section, appartiennent
à la section qui correspond au nom immédiatement antérieur.
Les lignes d’une section partagent la syntaxe suivante:
Key=Value
L’une des sections doit être [DOWNLOADS].
Cette section contient une clé “Number” dont la valeur est le nombre de fichiers à
télécharger. Des clés de la forme “FileXX” suivent,
où XX (2 digits) vaut de 01 jusqu’au nombre spécifié
par la clé “Number”. La structure de la clé “FileXX” est:
File<XX>=[relative_url]source_file[,[absolute_path]destination_file]
relative_url
est relative à la page de téléchargement à la quelle Web Downloader est
connecté. Si relative_url n’est pas inclus,
Downloader suppose que c’est la page principal à la quelle il est connecté.
source_file
(obligatoire): est le nom du fichier à télécharger.
absolute_path:
est le chemin où sera téléchargé le fichier. Par défaut , Web Downloader
suppose que c’est la racine (\) de l’appareil.
destination_file: le nom que Web Downloader utilise pour enregistrer le fichier téléchargé.
S’il n’est pas inclus, on utilise le nom original.
La section optionnelle [RETURN] peut
être inclue. Elle ne compte qu’une clé “To” qui
contient le chemin absolu de l’exécutable qui sera appelé lors de la sortie du
downloader. Si cette section est vide, le downloader retournera au Client
WireLess Mobile par défaut.
Exemple:
%%FILE=_dnlce.cfg%%
//
V100
//
dnlce associated files for download
[DOWNLOADS]
Number=4
File01=
_wirelessmobile.cfg
File02=
AOBE.cd_ , WM\AOBE.cdb
File03=
WM/wm-app.ex_ , \WM\wm-app.exe
File04=
WM/zip.dll_ , \zip.dll
File05=
WM/unzip.dll_ , unzip.dll
[RETURN]
To=
\Windows\WM\wm-app.exe
Si _dnlce.cfg est logé et accessible dans http://my_site/dnl, et Web Downloader est configuré pour se
connecter à cette url, il téléchargera les fichiers suivants:
http://my_site/dnl/_wirelessmobile.cfg
à \_wirelessmobile.cfg
http://my_site/dnl/AOBE.cd_
à \WM\AOBE.cdb
http://my_site/dnl/WM/wm-app.ex_
à \WM\wm-app.exe
http://my_site/dnl/WM/zip.dll_
à \zip.dll
http://my_site/dnl/WM/unzip.dll_
à \unzip.dll
et il retourne à la version téléchargée (actualisée) de wm-app.exe.
Structure de _wirelessmobile.cfg
Ce fichier a pour but de fixer toutes les préférences de configuration de
l’appareil. La première ligne est toujours la même. La seconde indique le
numéro de version. Pour chaque ligne, le double caractère “%%” indique que tout
ce qui suit est un commentaire, et est ignoré par le client. Toutes les lignes
d’une section ont la même syntaxe :
Key = Value
Avant le traitement des clés et valeurs, les caractères blancs sont
supprimés, de manière qu’il n’importe pas si des espaces ou tabulateurs sont
utilisés pour arranger les données en colonnes. Les valeurs peuvent être NULL,
indiquant que la valeur est vide.
Il y a plusieurs sections, dont le nom est indiqué entre crochets. Toutes
les lignes qui sont entre deux noms de section, ou celles qui sont au-delà du
dernier nom de section, appartiennent à la section qui correspond au nom
immédiatement antérieur. Toutes les entrées au dessus de la première section
n’appartiennent à aucune section. La structure des sections et clé-valeurs peut
être considéré comme une relation un-à-un avec le registre. Toutes les sections
qui ne sont pas dans le registre sont ajoutées. Cela fonctionnera avec la
version actuelle du client, ainsi qu’avec des futures versions. Alors,
éventuellement, Web Downloader gérera des entrées additionnelles utilisées par
les clients.
On montre ici un exemple qui contient les préférences utilisées par les
clients actuellement.
%%FILE=_wirelessmobile.cfg%%
%%
V100
%%
Null Section Root of the tree. It will be stored into
%%
HKEY_CURREN_USER\Software\<Corp_Id>\
%%
12 entries
Password = %%
Commentary
OldInstallDir =
MsgDll = ResAobeUs.dll
BackgroundTimer = 300
AppName = WM Intranet
CabTitle = WireLess Mobile
CreatorId = WMWM
EmptyDb = empty.cdb
CacheSize = 128
OutGoingDataLocation = \Windows\WM
HomepageLogo = LogoWM.gif
Homepage = WM.html
[LoginDlg]
%%
5 entries
TitleLbl = WM
PasswdLbl = Password
LogoFilename = SOFTOGO.gif
LoginLbl = Login
AutoChangeUser
= off
[Servers]
%%
4 entries
DeviceType = ppc02
ConnectionName
= WMCon
AutoDial = off
ConnectionType
= ras
[Servers\srvWM]
%% 3 entries
URL =
http://10.10.10.15/wm_fr/PalmSynchro/PalmSynchSrv.asp
PWD = 41de8b
UID
= marcela