WireLess Mobile Downloader
Web Downloader.doc
|
20040802 Version 1.0 |
|
WireLess Mobile Downloader
Abstract.
A new version of WireLess Mobile Client for Pocket Pc 2002 is available (1.1.0). It includes a new paradigm for the process of setting preferences. The previous paradigm (i.e.: configuration is updated through menu options in Administrator Mode) is still available, but a new one was added, which includes the possibility of reading part of the configuration from a file, and load it into the registry. This file can be generated externally and be placed on the device via Active Sync or via a new component called WireLess Mobile Downloader.
WireLess Mobile Downloader works on HTTP, and is capable of downloading a set of files. One of them is the one called _dnlce.cfg, containing the names of the files to be downloaded, as well as the path to the application to return to, when the downloader exits.
One of the files whose name could be placed into _dnlce.cfg is _wirelessmobile.cfg. If this file was downloaded into the root folder of the device, Wireless Mobile Client would load all the entries in this file into the registry, and afterwards delete the file.
Due to the fact that WireLess Mobile Client exits when it calls WireLess Mobile Downloader application, it is also possible to upgrade the version of WireLess Mobile Client, stating the executable file as one of the files to download.
Structure of _dnlce.cfg
The first line is always the same. The second one indicates the version number. For each line, the double slash “//” indicates that all of the following is a commentary, and is avoided by the downloader. There are two sections. The name of the section is placed between square brackets. All the lines between two section names, or the ones beyond the last section name, are considered as part of the section that corresponds to the immediate previous section name statement.
All of the lines of a section share the same syntax:
Key=Value
One of the sections must be [DOWNLOADS]. This section contains a Key “Number” whose value is the number of files to download. Keys of the form “FileXX” must follow it, where XX (2 digits) goes from 01 to the number specified by the key “Number”. The structure of the “FileXX” key is:
File<XX>=[relative_url]source_file[,[absolute_path]destination_file]
relative_url is relative to the download page at which Web Downloader is connected to. If relative_url is absent, Downloader assumes it is the main page at which it is connected to.
source_file (mandatory): is the name of the file to be downloaded.
absolute_path: is the path the file is downloaded to. If absent, Web Downloader assumes it is the root folder (\) on the device.
destination_file: the name that Web Downloader will use to store the downloaded file. If absent, the original name will be used.
An optional section called [RETURN] can be placed. It consists only of one key “To” with the absolute path of the executable, which will be called on return. Wireless Mobile Client sets itself as the application to return to, from Downloader. So, if this file doesn’t contain this section, downloader will return to WireLess Mobile Client by default.
Example:
%%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
If _dnlce.cfg is hosted and accessible through http://my_site/dnl, and Web Downloader is configured to connect to this url, it will download the next files:
http://my_site/dnl/_wirelessmobile.cfg
to \_wirelessmobile.cfg
http://my_site/dnl/AOBE.cd_
to \WM\AOBE.cdb
http://my_site/dnl/WM/wm-app.ex_
to \WM\wm-app.exe
http://my_site/dnl/WM/zip.dll_
to \zip.dll
http://my_site/dnl/WM/unzip.dll_
to \unzip.dll
and it will return to the downloaded (upgraded) version of wm-app.exe.
Structure of _wirelessmobile.cfg
This file is intended to configure all of the settings likely of being configured in the device. The first line is always the same. The second one indicates the version number. For each line, the double character “%%” indicates that all of the following is a commentary, and is avoided by the client. All the lines of a section share the same syntax:
Key
= Value
Before processing keys and values, blank characters are removed, so it doesn’t matter if leading and trailing spaces and tabs are used for arranging data in columns. Values can be NULL, indicating that the value will be empty.
There are several sections. The name of the section is placed between square brackets. All the lines between two section names, or the ones beyond the last section name, are considered as part of the section that corresponds to the immediate previous section name statement. All the entries above the first section are considered as having no section. The structure of sections and key-values can be considered as a one-to-one relationship with that in the registry. All sections that are not in the registry will be added. This is intended to work for both, the actual version of the client and for future ones. So eventually, web downloader will handle additional entries used by clients.
An example containing the settings used by the clients up to date is shown below.
%%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