[TUTO]: comment utiliser la technique UC XDA sur l'Eclipse

Bonjour à tous,

J'initie ce TUTO pour que vous puissiez utiliser le support UC XDA dans les ROMs Eclipse de la série 5.x. Je l'enrichirai au fur et à mesure des besoins ou de vos questions.

Ce tuto mériterais peut-être d'être généralisé, j'entends déjà Zepiii ...

Vous trouverez dans ce premier post les généralités qui vous permettront de réaliser vos premières personnalisations, ainsi que les liens utiles. Les posts suivants sont réservés à l'approfondissement de certaines notions avancées.

Un peu d'histoire et de technique.
Depuis leur origine, les ROMs Windows mobile sont équipées du dispositif AutoRun, qui permet, lors de l'installation, de charger des programmes et des paramètres. Ce dispositif est utilisé par les opérateurs et les intégrateurs pour installer certains add-ons désinstallables sans modifier fondamentalement la ROM.
Cette technique est utilisée par l'Eclipse pour installer des programmes tels que CleanRAM ou Co0kieHomeTab afin de ne pas vous rendre dépendant de ceux-ci.
Le principe en est simple : lors de la phase finale de l'installation, des directives contenues dans un ou plusieurs fichiers de configuration sont analysées et exécutées.

Sleuth255@XDA étend ce principe de fonctionnement à un fichier SDConfig.txt situé à la racine de la carte SD. Dés lors, il est possible à tous de personnaliser sa ROM Windows Mobile.

L'Eclipse 5.1 utilise ce procédé.

Champ d'application.
UC XDA est un procédé qui permet, lors de la phase finale de l'installation d'une ROM, de charger ses propres programmes, d'effectuer des opérations sur la base de registre, ou sur les fichiers, de définir des comptes e-mails, des favoris explorateur Internet, ...
Le champ des possibles n'est limité que par la spécification de Microsoft sur le "Provisioning". Vous trouverez toutes les explications sur cette technique directement sur le site MSDN WinCE Provisioning
Le chargement est déclenché lors de la phase finale de l'installation d'une ROM ou lors d'un Hard Reset. Il devient alors aisé de recharger une configuration personnalisée en cas de besoin et c'est là l'utilité pratique de la méthode.
La spécification étant partagée par toutes les ROMs qui implémentent cette technique, ceci signifie que vous pouvez passer d'une ROM à une autre en rechargeant vos propres configurations automatiquement.

Je pense que vous commencez à comprendre l'intérêt de la chose.

Avertissment.
Dans ce qui suivra, certaines techniques "avancées" mal maitrisées peuvent bloquer votre appareil. Il n'y a en règle générale rien d'irrémédiable, il suffira d'enlever la carte SD et de refaire un Hard Reset.

Ce qui va être décrit n'est pas complexe en soi, cependant il n'admet aucune erreur de syntaxe. Vous êtes prévenus.

Chapitre I. Généralités, installation de programmes.
Pour installer des programmes automatiquement, il suffit de créer à la racine de votre carte SD, un fichier nommé SDConfig.txt et d'inscrire dedans des lignes qui ont la forme suivante :

Vous pouvez mettre autant de programmes que vous le souhaitez. Voici ci-dessous le contenu typique de mon fichier SDConfig.txt

Cette configuration est rechargée à chaque installation de ROM ou à chaque Hard Reset. L'installation est automatique et s'effectue habituellement sans interaction avec l'utilisateur.

Le choix de l'emplacement d'installation est la mémoire principale de l'appareil. Il n'y a aucune possibilité d'installer des programmes sur la carte mémoire à l'aide de ce procédé.

La syntaxe est précise:
- les directives (CAB: , LOCK:, RST: ...) doivent être impérativement en MAJUSCULES et sur 5 caractères, l'espace après CAB: n'est pas optionnel.
- le fichier SDConfig.txt doit être au format texte ANSI, NE PAS UTILISER UNICODE.
Dans l'exemple ci-dessus, j'ai regroupé tous les cabs à charger dans le répertoire \Setup\cabs de ma carte mémoire.

ATTENTION : il est impératif de marquer les fichiers cab, xml, ... utilisés par votre SDConfig.txt en lecture seule. Dans le cas contraire, le processus d'installation efface ceux-ci après installation

La directive LOCK: permet de d'interdire (Enabled) ou de permettre (Disabled) toute saisie utilisateur pendant l'installation (y compris boutons hardware).
Il peut être utile de donner la main à l'utilisateur, pour la saisie d'un numéro de licence par exemple. Ceci peut se faire en insérant les directives suivantes dans le fichier de configuration :

La directive HIDE: permet de cacher (Enabled) ou de montrer (Disabled), l'écran de progression de l'installation.
Enfin, la directive RST: Reset n'est requise que si certaines opérations demandent, pour être prise en compte, le redémarrage de la configuration.

Ce sont les bases. Les chapitres suivants traiteront :
- de l'utilisation des autres directives du fichier SDConfig.txt,
- du provisioning XML, sous ses aspects fichiers, registre, mail, favoris internet et VOIP. La mise en oeuvre pratique de la VOIP passe en effet par un provisioning.

N'hésitez pas à consulter les sites de référence et le topic de Sleuth255 sur XDA. Je répondrai dans la mesure du possible à vos questions.

A+

Dernière édition par ficus93 le Mer 21 Avr 2010 - 14:43, édité 4 fois

Chapitre II. SDConfig.txt, directives avancées.

II.1. La directive XML
La directive XML: du fichier de configuration SDConfig.txt permet d'exécuter un fichier XML contenant des éléments de configuration pour votre téléphone. C'est ce que l'on appelle le "provisioning". Cette technique est utilisée notamment dans les installations de fichiers .cab.

Le fichier XML de configuration doit respecter la syntaxe générique suivante :

Entre ces 2 balises, vous allez pouvoir programmer des clés de registre (registry), des opérations sur les fichiers (fileoperation), sur les comptes emails (EMAIL2), sur les favoris Internet (BrowserFavorites), ...
Reportez-vous aux posts suivants pour avoir plus de détails sur ces opérations. N'hésitez pas à consulter le site MSDN Microsoft qui contient la documentation complète sur ce sujet.

Dernière édition par ficus93 le Mer 21 Avr 2010 - 14:40, édité 1 fois

Chapitre III. Provisioning, opérations sur le Registre.

Cette section de provisioning vous permet de contrôler le registre système, de la même façon qu'aver PHM RegEdit. Elle est encadrée par les ordres :

Voici ci-dessous un exemple de programmation du registre. Bien évidemment ceci requiert une bonne connaissance du registre, des clés et des valeurs qui le composent :

Chaque clé de registre est comprise dans un bloc <characteristic type="nom_de_la_clé"> ... </characteristic>
. Les sections du registre sont nommées de la façon suivante :
- HKCL (HKEY_CLASSES_ROOT)
- HKCU (HKEY_CURRENT_USER)
- HKLM (HKEY_LOCAL_MACHINE)

Les valeurs de clé sont exprimées par un tag <parm name="nom_de_la_valeur" value="valeur" datatype="type"/>. Le tag doit impérativement se terminer par />.

- Les valeurs de datatype "integer" sont exprimées en valeurs entières décimales (et non en hexadécimal), faire attention à ce point, l'analyseur XML est très "sensible".
- Les valeurs de type "string" parlent d'elle-même.
- Les valeur de type "binary" doivent être codées en texte base-64 (attention, ça devient un peu compliqué à partir de maintenant) donc, pour coder ceci dans l'exemple ci-dessus :

On commence par exprimer 6h30 en minutes depuis 0h soit 6 x 60 + 30 = 390 ou 0x186 hexadécimal (prendre la calculatrice).
Avec un éditeur hexadécimal type Hex Editor Neo (freeware), créer un nouveau fichier et entrer cette valeur en inversant les digits 2 à 2 (soit 86 01), puis sauvegarder le fichier.
Allez ensuite à l'adresse http://www.motobit.com/util/base64-decoder-encoder.asp. Dans la page affichée, appuyez sur le bouton Parcourir et sélectionnez votre fichier. Cochez les cases encode et output to a text box, enfin, cliquez sur le bouton Convert the source data.
Dans la boite texte qui apparait, récupérez l'expression texte en base64 du contenu de votre fichier, soit hgE= et collez-la dans la valeur. Terminé.

N'hésitez pas à me poser vos questions.

Dernière édition par ficus93 le Mer 21 Avr 2010 - 16:02, édité 3 fois

Chapitre IV. Provisioning, opérations sur les fichiers.

-réservé-

Chapitre V. Provisioning, création de comptes e-mails.

Cette partie du provisioning XML permet de configurer des comptes e-mail. Pour faire simple dans cette première approche, je me cantonne aux serveurs de type POP3 (entrants) et SMTP (sortants).
J'aborderai un peu plus tard la configuration des comptes Exchange, la différence réelle n'étant que de quelques paramètres supplémentaires.

Le code ci-dessous permet de créer un compte e-mail :

Certains paramètres parlent d'eux-même, d'autres sont plus délicats à manipuler, j'en détaille quelques-uns :
- type="{86FFC998-90FA-4374-AA75-8BC3B2B1DB72}" : cette valeur doit être unique c'est ce que l'on appelle un GUID, pour en obtenir un, je vous recommande d'utiliser cette adresse internet : http://www.famkruithof.net/uuid/uuidgen. Une fois la page affichée, récupérez la valeur en gras et collez-la entre les accolades.
- NAME : vous pouvez mettre ici vos noms et prénoms, les espaces
sont admis.
- SERVICENAME : le nom que vous mettez ici apparait en tant que nom du compte, dans l'onglet mail de Sense et dans Outlook.
- INSERVER et OUTSERVER : ce sont respectivement les noms des serveurs POP et SMTP pour la réception et l'envoi de courrier.
- AUTHNAME : il s'agit de votre compte email complet tel que votre FAI vous le fournit,
- AUTHSECRET : le mot de passe de votre compte, en clair

et maintenant quelques paramètres intéressants :
- DWNDAY : spécifie le nombre de jours à télécharger avant la date du jour. Par exemple spécifier 3 téléchargera les messages des 3 derniers jours. -1 signifie télécharger tout.
- LINGER : ce paramètre détermine l'intervalle entre 2 synchronisations automatiques, en minutes. Si vous mettez 60, une connexion aura lieu toutes les heures. Si vous effacez ce paramètre, une synchronisation automatique aura lieu par défaut toutes les 15 minutes. 0 permet de ne pas se connecter automatiquement.
- KEEPMAX : spécifie la taille maximale de pièces jointes à télécharger par message, en Ko. La valeur 0 signifie : ne pas télécharger les jointes. La valeur -1 signifie : tout télécharger.
- RETRIEVE : spécifie la taille maximale à télécharger d'un message, en caractères. Par exemple 2048 télécharge 2Ko, si le message est plus long il est tronqué. La valeur 0 signifie : ne télécharger que les entêtes. La valeur -1 signifie : télécharger tout le message.
- AUTHREQUIRED : spécifie si le serveur sortant requiert (1) ou non (0), une authentification.
- SMTPALTENABLED : demande à Outlook d'utiliser (1) ou non (0) une adresse mail miroir en cas de défaillance de l'adresse principale. Si vous entrez la valeur 1, il faut remplir les propriétés SMTPALTAUTHNAME, SMTPALTPASSWORD et SMTPALTDOMAIN (voir plus haut).

Vous pouvez entrer dans le fichier XML de provisioning autant de spécifications EMAIL2 que vous avez de comptes, vous n'êtes limités que par la capacité d'affichage de Sense et la mémoire de votre téléphone.

Pour plus d'informations, vous pouvez aussi consulter le site MSDN à l'adresse suivante http://msdn.microsoft.com/en-us/library/bb737579.aspx

N'hésitez pas le cas échéant, à me poser vos questions.

Dernière édition par ficus93 le Jeu 22 Avr 2010 - 19:06, édité 1 fois

Chapitre VI. Provisioning, opérations sur les favoris Internet.

Ce chapitre du provisioning traite des favoris Internet, selon un double aspect : les opérations de création, modification ou suppression d'un favori Internet (au sens Windows Mobile), et la création d'un raccourci sur la page Internet de Sense.

Les opérations de création, modification ou suppression de favoris Internet s'effectuent via le fichier de provisioning XML dont la structure globale est décrite au chapitre II de ce tuto. Le bloc qui contient les ordres sur ces opérations doit être écrit ainsi :

A l'intérieur de ce bloc, chaque opération de création doit être libellée ainsi
Ici, nous créons un raccourci vers la version mobile du journal "Le Monde". type contient le nom qui apparaitra en nom de favori, URL est le paramètre du lien, Order est le paramètre qui détermine le rang du favori dans la liste.

Pour supprimer un favori, entrer cet ordre à l'intérieur du bloc BrowserFavorite :

Pour modifier un favori existant, il suffit donc de la supprimer puis de le recréer :
A l'intérieur du bloc BrowserFavorite, vous pouvez faire autant d'opérations que vous souhaitez.

Le second aspect est la création de raccourcis sur la page Internet de Sense. Cet aspect n'a aucun lien avec les opérations sur les favoris internet ci-dessus, il est donc possible de créer un raccourci sans avoir de favori correspondant.

Il s'agit d'une "banale" mise à jour de clés dans le registre, l'ordre générique étant le suivant :
Vous pouvez copier le bloc ci-dessus, les seuls valeurs à modifier sont les suivantes :
HKLM\Software\HTC\Manila\InternetPush\Enabled\000 : entrer dans la valeur numérique un numéro de raccourci : ils apparaissent de droite à gauche et de haut en bas dans la page Internet de Sense.
Name : le nom qui apparaitra dans le cartouche du lien
URL : le lien
Les autres valeurs peuvent être reprises telles quelles, elles n'ont de signification que pour le push Internet, qui n'est pas activé.
Attention : enregistrer un raccourci ne charge pas le contenu de la page.

Dernière édition par ficus93 le Mar 4 Mai 2010 - 9:02, édité 1 fois

Chapitre VII. Provisioning, configuration VOIP.

-réservé-

Bonjour, je ne sais pas si je peux me permettre de poser ma question directement sur le tuto ? si ce n'est pas le cas, vous pouvez le déplacer dans le post de l'Eclipse.

Voila, je viens de mettre les dernieres Eclipse SP1

je voulais en profiter pour utiliser l'UC

voici mon fichier de config :



Dans cette config là, j'ai un message qui me dit que le 1er cab n'est pas trouvé
si je déplace le 1er pavé des installations à la fin, j'ai plus d'erreur mais il n'a rien fait, ni les config mail et favoris, ni les installations.
J'ai essayé de mettre moins de répertoire, dictement UC à la racine de la carte mais cela ne change rien
il doit y avoir un prb qqpart

qqun peut m'aider ?

merci

@antoineklein

Tu dois créer 2 fichiers:
-SDConfig avec tes cabs
-un ou plusieurs fichiers xml pour les comptes et la configuration

En fait tu fais appel à tes fichiers xml dans ton fichier SDConfig avec l'instruction XML:


Allez, tu y es presque

OK, je suis un peu long à la détente, ca semble logique, je test de suite

merci

EDIT : ca marche pas

il bloque sur ce cab, il y en a 2 autres avant, s'il les prends dans l'ordre ca ne rale pas
erreur code 0x80004005 ne
install failed sur le nuedynamicclock.cab (1er de ma liste)

je vais essayé en mettant les xml avant et ca cab et son xml en dernier

J'ai le meme pb que toi concernant nuedynamicclock (cf mon post sur le thread de la ROM).

Le seul moyen d'y remédier est de virer nuedynamicclock de ton installation automatique (en attendant le retour de ficus).

++

Votre cab "nuedynamicclock" s'installe correctement sans action de votre part en temps normal?
ou vous demande t'il de valider quelque chose? S'il vous demande une interaction, il faut le sortir du "LOCK" ....

Mickael a écrit:

Votre cab "nuedynamicclock" s'installe correctement sans action de votre part en temps normal?
ou vous demande t'il de valider quelque chose? S'il vous demande une interaction, il faut le sortir du "LOCK" ....

j'avais meme pas pensé a faire ce test :-(

et en effet le .exe, que l'on m'avait dit de renomer en .cab de la 1.3 ne fonctionne pas tout simplement... je suis con c'est marqué dans le message !

j'ai essayé avec une 1.2, dont le cab fonctionne, je refait un test de l'UC de suite

ca semblerais mieux marcher mais maintenant le cab demande un reboot et ca met la grouille, je vais essayer de le sortir du LOCK

bon il a fallut ajouter la balise wap pour les xml

je vais y arriver...

qqun aurait un cab de nuedynamicclock qui va bien ?

maintenant il plante sur ce wml

Je viens d'essayer en elevant la 2eme partie : raccourcis mais ca marche pas mieux

help :-)

même avec le nueynamicclack.cab qui fonctionne, hors du LOCK, il m'affiche une erreur
imeout code:0x99999

en mettant le nuedynamicclock.cab juste avant le reset ca passe

j'ai plus qu'un xml récalcitrant

Tout fonctionne bien maintenant

pour le nuedynamicclock, faut le mettre en bas, juste avant le reset.

et pour l'erreur dans le code XML des favoris, il manquait simplement un " sur une des ligne.


merci à tous

PS : penser à enlever le configSD.txt ou à le laisser en lecture écriture pour qu'il soit supprimé à la fin (en ayant une copie au chaud bien sur) sinon ca mettra la grouille au prochain SR.

Bonjour,

quelqu'un a réussi à paramétrer un compte mail hotmail et son wifi avec un provxml en passant par l'UC? Si oui, pouvez-vous partager vos xml en masquant vos infos perso?

Merci.

C'est bon, j'ai réussi à paramétrer mon compte hotmail dans l'UC. J'avais du encoder le texte en UTF8 alors qu'il faut que ce soit en "ANSI"....

Pour le wifi, je verrai si c'est bien passé en rentrant chez moi ce soir.....