Necesware.info

Traduction de la page de Elite News:

J'avais besoin d'une nouvelle clé USB parce que celle que j'utilise n'a que 64 MO et ne me permet pas d'installer tous les programmes que je veux, alors j'ai acheté une clé Sandisk Cruzer 2 GO. Ce que je ne savais pas quand je l'ai achetée, c'est qu'elle est livrée avec un joli menu U3 qui vous permet de lancer vos programmes facilement et rapidement.

J'ai ensuite copié par drag n drop le contenu de ma vieille clé USB sur la nouvelle. Puis j'ai pensé que ce serait cool d'avoir mes programmes dans le menu U3. J'ai vite réalisé que le seul moyen d'ajouter des programmes était d'ajouter uniquement ceux qui sont supportés (http://software.u3.com/) ou bien d'ajouter un package u3p. Au début j'ai pensé que le menu U3 était sans intérêt car mes programmes n'existaient pas en package u3p, mais je savais qu'il devait exister un moyen de rajouter mes programmes dans ce menu U3.

Guide simple pour ajouter un programme

Une clé U3 est une clé avec une petite partition reconnue comme un CD-Rom virtuel. Ce CD-Rom virtuel permet de lancer le menu U3 lorsqu'on insère la clé sur un ordinateur. Le menu permet un accès facile à vos programmes. Pour plus d'info sur les clés U3 visiter
(http://www.everythingusb.com/u3.html)

Ceci est un guide simple pour ajouter un icone dans votre liste de programmes. Je vais utiliser PortableVLC pour cet exemple [PortableVLC]

1. Installer l'application portable n'importe où sur la clé.
(ex: G:\program files\PortableVLC\)

2. Ouvrir le dossier caché System à la racine de la clé et aller dans la dossier Apps. Créer un dossier avec n'importe quel nom, choisir le nom du programme rend les choses plus simples. Cela deviendra le uuid, alors souvenez vous en!
(ex: j'ai créé G:\System\Apps\vlc\)

3. Dans ce nouveau dossier, créer un autre dossier nommé Manifest. Dans ce dernier dossier, créer un nouveau fichier texte. Renommer ce fichier Manifest.u3i. Manifest.u3i est en réalité un fichier XML déguisé qui est utilisé par le menu U3 pour décrire votre programme. C'est vital pour le menu.
(ex: j'ai créé G:\System\Apps\vlc\Manifest\Manifest.u3i)

4. Créer ou trouver un icone. Normalement je trouve le fichier .ico officiel quelque part dans le dossier où il est installé ou bien je vais chipper le favicon.ico sur le site de l'éditeur (ex: pour vlc j'ai trouvé l'icone dans G:\program files\PortableVLC\PortableVLCCode\ mais on peut aussi trouver une version allégée à http://videolan.org/favicon.ico). Mettre le fichier .ico dans le dossier Manifest à côté du fichier Manifest.u3i.

5. Editer Manifest.u3i avec le Bloc-note (ou TextPad, etc)

<?xml version="1.0" encoding="UTF-8"?>
<u3manifest version="1.0">
<application uuid="vlc" version="0.8.4a">
<icon>vlc.ico</icon>
<name>VLC</name>
<vendor url="http://portableapps.com/apps/audio_video/media_players/portable_vlc">Portable VLC</vendor>
<description>VLC media player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, XviD, WMV, mp3, ogg, ...) as well as DVDs, VCDs, and various streaming protocols. It can also be used as a server to stream in unicast or multicast in IPv4 or IPv6 on a high-bandwidth network.</description>
<options>
<minFreeSpace>16</minFreeSpace>
<upgrade appData="overwrite" deviceExec="overwrite"/>
</options>
</application>
<actions>
<appStart workingdir="%U3_DEVICE_PATH%\program files\PortableVLC" cmd="%U3_DEVICE_PATH%\program files\PortableVLC\PortableVLC.exe">start</appStart>
<appStop workingdir="%U3_DEVICE_PATH%\program files\PortableVLC" cmd="%U3_DEVICE_PATH%\program files\PortableVLC\PortableVLC.exe">stop</appStop>
</actions>
</u3manifest>

Donner à application uuid le même nom que le dossier que vous avez créé dans le dossier Apps (ex: vlc dans mon cas). C'est l'identifiant de l'application, et vous allez l'utiliser plus loin.
version est simplement la version de votre programme, c'est arbitraire, mais saisissez la bien si vous voulez que le menu affiche la bonne.
icon est le nom de l'icone que vous voulez voir dans le menu. On va y revenir à l'étape suivante.
name = le nom à afficher.
vendor url et description = l'adresse du site web de l'éditeur et la description du programme affichée dans "Paramètres des Programmes U3."
minFreeSpace = taille en MO utilisée par le programme sur la clé, arrondi au MO supérieur.
appStart et appStop, il y a quelques autres paramètres optionels comme clean up, mais ces deux sont les seuls obligatoires. Ce sont les paramètres à passer au lancement et à l'arrêt du programme.
workingdir = le répertoire dans lequel s'exécute le programme. Mettre le dossier dans lequel est installé votre programme, n'oubliez pas d'utiliser %U3_DEVICE_PATH% au lieu de l'unité de la clé (ex: G:).
cmd = l'exécutable à lancer.
Sauver le fichier Manifest.u3i.

6. Zipper le dossier Manifest et lui donner le même nom que le uuid précédent. Le contenu du fichier zip DOIT respecter la structure des dossiers.
Suivre mon exemple:
Dans vlc.zip il y a un dossier avec le nom Manifest
Dans le dossier Manifest il y a les fichiers Manifest.u3i et vlc.ico
vlc.zip => Manifest\Manifest.u3i et Manifest\vlc.ico

Maintenant renommer le fichier uuid.zip en uuid.u3p (ex: vlc.zip -> vlc.u3p) et le laisser dans le dossier uuid (ex: maintenant j'ai un G:\System\Apps\vlc\vlc.u3p)

7. Revenir dans le dossier Apps (ex: G:\System\Apps), trouver et éditer le fichier LPDB.xml
Ajouter à fin avant la balise </LPDB>,

<APPLICATION guid="vlc" launchOnStart="N" lastUsed="5/4/2006 10:03:12 AM">\vlc.u3p</APPLICATION>

Donner à guid la valeur de votre uuid et donner le chemin correct.

8. Ejecter la clé USB et la re connecter.

Quand le menu U3 se lance, si vous avez été bon, vous avez votre programme dans la liste.
Si vous avez laissé une coquille dans le code, il vous dira que le u3p n'a pas pu se charger et si vous voulez supprimer le programme associé (non!).
A vous!

Exemple final:

Pour mieux comprendre comment ça marche, voici quelques définitions:

file.u3p - de type zip. C'est un package U3 qui contient le programme pour l'installation. Contient les dossiers: Data, Device, Host, et Manifest.
file.u3i - de type xml. Contient les données affichées dans le Program Manager du menu U3.
Dossier Data (dans u3p) - Le contenu de ce dossier est transféré depuis le package u3p vers le dossier Data. C'est un peu comme "Application Data" de Windows.
Dossier Device - Le contenu de ce dossier est transféré depuis le package u3p vers le dossier Exec. C'est normalement l'application.
Dossier Host - Reste dans le package. Contient chaque lanceur d'application.
Dossier Manifest - Contient l'information donnée au menu U3. Contient les fichiers Manifest.u3i et *.ico.

Dossier Data (hors u3p) - Copié automatiquement depuis le dossier Data du fichier u3p.
Dossier Exec - Copié automatiquement depuis le dossier Exec du fichier u3p.

LPDB.xml - Liste des Programmes du menu U3.
LPGDB.xml - Liste des Programmes créée automatiquement à partir des programmes installés. Inclut aussi l'ordre et la dernière utilisation.

uuid/guid - Identifiant de l'Application.
appStart - paramètres de démarrage.
appStop - paramètres de sortie, souvent les mêmes que appStart.
hostCleanUp - je pense que c'est l'action à faire en cas d'arrêt.
hostInstall - action à lancer à l'installation.
hostConfigure - action à lancer pour configurer.

Note de Neces :

J'ai suivi toutes les indications et ça a marché du premier coup!

Sauf :

• j'avais laissé start entre les deux inférieur supérieur de appStart

c'est un paramètre mis dans la ligne de commande au lancement. J'ai enlevé ça (le mot start pas la commande appStart) et puis c'était bon!