Faire un don

Index


important

Tutoriel en cours de rédaction/relecture. Peut contenir des erreurs.

Framakey sur U3

  • Auteur : Pepeto
  • Licence : CC by-sa
  • Date de mise en ligne : 27/04/2006

1°) Introduction :

Ce tutoriel a pour but de vous aider à installer la Framakey ainsi que des applications portables sur une clef usb U3, disposant déjà de son propre menu. Le tutoriel se décompose en deux parties : la première (sections 2, 3 et 4) vous permet simplement d’installer la Framakey sur votre clef U3, sans trop rentrer dans les détails. Tout les fichiers présentés ici sont fournis, donc, si le code vous fait frémir, vous ne serez pas obligé d’en modifier, on l’aura fait pour vous winking smiley. La deuxième partie (sections 5 et 6) concerne l’installation d’un logiciel sur U3, ainsi que la création de son fichier d’installation.

note :

  • Ce tutoriel est écrit pour les versions 1.5.0.4 des Framakeys ! Le fichier Framakey_U3.u3p ne marche pas pour les versions précédentes ! (voir le forum si vous êtes trop attaché(e) aux anciennes versions )
  • Notez la différence entre les guillemets “…” et « … ». Les seconds sont là pour la mise en forme du texte, mais dans les fichiers de configuration, c’est bien les premiers qu’il faut mettre. (de toute façon, l’éditeur que vous allez utiliser n’emploie que les “ et les lignes à changer sont écrites avec les « bons » guillemets… mais au cas où&hellipwinking smiley.

A corriger

A corriger dans la mise en forme, en ajoutant des @@ texte @@ pour délimiter ces blocs. simonpca? 05 mai 2006 à 00h16

  • Concernant la désactivation des splashs (image se lançant avant une application) voir http://www.framakey.org/Tutoriels/DisableSplash
  • Cette aide est dérivée de l’initiative suivante : http://forum.framasoft.org/viewtopic.php?t=13129&
  • Pour des raisons techniques (voir le lien ce-dessus, quelque part dans la première page ), l’installation est un peu plus compliqué qu’avec une application prévue pour une clef U3 : vous devrez copier des fichiers à la main (pas de panique, le tutoriel est là pour ça), ce qui nous amène à la note suivante.
  • Le fichier « system » présent sur votre clef U3 est un fichier caché. Vous devez activer l’affichage des fichiers cachés dans « Outils »→« Options des dossiers »→« Affichage »→« Afficher les fichiers et dossiers cachés ». Vous pourrez toujours rechanger ce paramètre par la suite.

2°) Installation de la Framakey sur une clef U3 :

Il n’y a aucune considération technique dans ce qui suit. N’importe qui peut réaliser l’installation de sa Framakey sur une clef U3 :

Téléchargez le fichier “Framakey_U3.u3p” ainsi que la version désirée de la Framakey.

  1. A partir du lanceur U3 : Gérer les programmes/Ajouter des programmes/ Installer à partir du Poste de travail et ouvrez le fichier Framakey_U3.u3p. L’installation terminée, cliquez sur Effectué.
  2. Ne lancez pas tout de suite votre Framakey à partir de U3, ça ne marche pas et vous devrez retirer puis réinsérer votre clef pour la suite (mais bon, si vous voulez voir par vous même ce que cela produit, libre à vous winking smiley ).
  3. Décompressez la Framakey dans un dossier (histoire de ne pas tout éparpiller) et supprimez autorun.inf. Lisez la licence. Pour un gain de place sur votre clef, vous pouvez supprimer le dossier src (contient les sources du lanceur Framakey ainsi que de l’installeur). En ce qui concerne le dossier Data, consultez la section 4 avant de continuer.
  4. Il ne vous reste plus qu’à copier tous les dossiers et fichiers restants dans le dossier

system\Apps\FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB\Exec
Et voilà !! (si ça ne marche pas, deconnecter votre clef et réinsérez là, sinon le forum est là.)

note :

  • Par défaut, la Framakey se lance automatiquement au démarrage du menu U3. Pour empêcher cela, allez dans Gérer les programmes et décochez

Démarrer à l’introduction.

  • Lors de l’éjection, vous aurez comme message : Fermez tous les programmes U3 et réessayez. Voulez-vous de toute façon éjecter l’appareil ? faites OUI. (N’oubliez pas de quitter le FramaLauncher, dans la barre des tâches).

3°) Désinstaller la Framakey :

Pour désinstaller la Framakey du lanceur U3 : allez dans Gérer les programmes /Retirer le programme avec la Framakey sélectionnée. Puis, supprimez le dossier FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB du répertoire system\Apps de votre clef U3.

4°) Le dossier “Data” et modifications de la Framakey :

  • Soit vous conservez le répertoire Data par défaut de la Framakey (méthode la plus simple, mais pas la plus pratique. Je ne vous recommande pas de faire comme ça.) ; dans ce cas, aucune modification n’est nécessaire. Sachez simplement que le répertoire Documents pointé par les éléments de la Framakey (Framakiosk et Framalauncher) n’est pas le même que celui créé par le système U3 : en effet, celui de la Framakey fait parti de Data (donc copié dans system\……\Exec alors que celui de la clef U3 se trouve à la racine de celle-ci.
  • Soit on se remonte les manches et on modifie un peu de code (les fichiers de configurations sont fournis pour les allergiques au code, voir plus bas) afin d’avoir le même répertoire Documents : ce qui suit est un exemple d’organisation que vous pourrez facilement modifier. Pour rester simple, on copie les éléments de Data dans Document de la clef U3. Au final on aura donc :
Document\	
	documents
	images
	music (qu’on va renommer en Musiques )
	radio-tv

Les deux Documents sont toujours différents mais on va renommer le Documents de la Framakey en Données.(les majuscules ne jouent pas lors de la configuration, et c’est tellement plus beau.) On a :

Document\	
	Données
	Images
	Musiques
	Radio-tv

Retournez à la section 2° pour la fin de l’installation !!

Si vous avez le temps, je vous propose de suivre les étapes suivantes, afin que vous puissiez comprendre les bases de la configuration de Framalauncher. Sinon, téléchargez ce fichier (contient FramaLauncher.ini et viewhomedir.lch, d’après les modifications suivantes ) et remplacez vos fichiers FramaLauncher.ini et viewhomedir.lch
(\System\Apps\FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB\Exec\Framakey\FramaLauncher\ et \System\Apps\FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB\Exec\Framakey\FramaKiosk\FramaKioskPages\lch\ ) par ceux que nous vous fournissons. Dans ce cas, vous n’avez plus rien à faire, à part vous servir de votre clef grinning smiley .

a)Framakiosk :

EÉditez le fichier :
System\Apps\FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB\Exec\Framakey\FramaKiosk\FramaKioskPages\lch\viewhomedir.lch
Modifier

ExecuteParameters=${cwd}\..\..\..\Data
par
ExecuteParameters=${cwd}\..\..\..\..\..\..\..\Documents

C’est tout pour Framakiosk. Pour plus d’info : http://www.framakey.org/Tutoriels/FramaKioskIndex

b)Framalauncher :

Lancez la Framakey, puis faites un clic droit sur l’icône verte avec un « F » qui se trouve dans la barre des tâches et cliquez sur Ouvrir fichier conf avec Scite .


Allez dans la section [variables]
Modifiez la deuxième ligne :

Type: static; Name: Data; Value: "%AeTrayMenuPath%\..\..\Data"; Flags: ispath
par
Type: static; Name: Data; Value: "%AeTrayMenuPath%\..\..\..\..\..\..\Documents"; Flags: ispath

Allez dans la section [Menu.Left]
Vous pouvez renommer les menus :
par exemple, remplacez : Mes Données (Data) par Mes Données.
Ajoutez

Type: item; Caption:  "Mes Documents (U3)"; Action: run; FileName: "Explorer.exe"; Parameters: "%Data%\"; Glyph: 4
après la ligne
Type: separator; Caption: "Documents"
Et Ajoutez la ligne :
type: item; Caption: "Framakey"; Action: run; FileName: "Explorer.exe"; Parameters: "%AeTrayMenuPath%\..\..\"; Glyph: 4
entre
Type: item; Caption: "Mes Documents"; Action: run; FileName: "Explorer.exe"; Parameters: "%Mes Documents%"; Glyph: 4
et
Type: separator; Caption: "Tâches"
Ceci permettra par la suite d’accéder plus facilement au répertoire de la Framakey, à partir de Framlauncher, sans changer les options d’affichages, ni se balader dans “\system\…\Exec\”.

Allez dans la section [Donnees]

  • Première ligne : remplacez Documents par Données et
"%Data%\documents"
par
"%Data%\données"
Troisième ligne : rempacez
"%Data%\music"
par
"%Data%\musiques"
et rajoutez un « s » à « Musique » winking smiley.

Allez dans la section [MultimediaTasks]

  • Première ligne : remplacez
"%Data%\music\default.m3u"
par
"%Data%\musiques\default.m3u"
  • 2eme ligne : un bug peut-être corrigé, il se peut que vous n’ayez pas à changer cela.

Remplacez :

"%Data%\tv\tnt.m3u"
par
"%Data%\radios-tv\tnt.m3u"

Voilà ! C’est fini avec Framalauncher ! Pour plus d’infos :
http://www.framakey.org/Tutoriels/FramaLauncher

Les tutoriels en général :
http://www.framakey.org/Tutoriels/Index

Votre clef est maintenant entièrement fonctionnelle.
Vous pouvez continuer ce tutoriel pour apprendre à créer un fichier d’installation, et ainsi à combiner vos applications portables favorites avec le menu U3 de votre clef.

5°) Au début, il y avait les programmes U3…

note :

  • Le code de vos fichiers (des fichiers textes) doit IMPERATIVEMENT être en UTF-8 avec signature, pas en ASCII.
  • Si vous n’êtes pas sûr de vos logiciels, procurez-vous Notepad2. Vous pouvez changer l’encodage du texte avec ce logiciel en allant dans Fichiers/Code.
  • Vous pouvez vous procurer 7zip.

A vrai dire, le fichier *.u3p que nous vous proposons pour la Framakey est un petit peu bricolé, tout comme le mode d’installation. Pour tenter de comprendre comment cela fonctionne, étudions la structure des fichiers *.u3p normaux (je me base sur Firefox et Skype, fournis sur le site de U3).

Les fichiers *.u3p ne sont en fait que des fichiers *.zip renommés. Ils peuvent donc être créés avec 7zip ou n’importe quel autre logiciel permettant l’écriture des fichiers *.zip. Dans son processus de fonctionnement, la clef U3 décompresse le fichier *.u3p dans \Documents and Settings\nom\Application Data\U3\une ligne barbare -c’est le numéro d’identification du logiciel-\Exec.

Ce numéro d’identification est un identifiant unique , créé en fonction du moment où le programme générant ce numéro est lancé. Dans notre cas, et ce afin de différencier plus facilement la Framakey des autres programmes installés sur votre clef U3 (voir le dossier caché system\Apps), j’ai simplement remplacé le début de ce numéro par FRAMAKEY (donc à priori, pas unique puisqu’il n’a pas été généré avec l’algorithme prévu… mais bon, les chances de tomber sur un logiciel avec le même est infime winking smiley ).

note : Le numéro d’identification obéit à certaines normes. Pour éviter les problèmes, ne modifiez que la première partie, qui fait 8 caractères de long (avant le tiret). FRAMAKEY fait pile 8 lettres! Fantastique, non?

Pour des raisons techniques (voir le sujet du forum indiqué au début de ce tutoriel), seul le fichier permettant l’installation sera zippé et installé ainsi sur l’U3, les autres fichiers (et donc les programmes portables) étant directement mis dans le répertoire Exec sur la clef U3 (les programmes s’exécuteront directement à partir de votre clef U3 et non à partir du disque dur, comme le processus normal le ferait)

Par exemple, SkypeSetup-U3.u3p contient :
Un dossier manifest (le seul que vous trouverez dans Framakey_U3.u3p). Il contient l’icône ainsi que le fichier nécessaire à l’installation du logiciel : manifest.u3i (format *.txt, codé en UTF-8 avec signature).
Le dossier host qui contient les programmes.
Et Data, qui contient des donnés (ici, des images).

Firefox.u3p contient :

  • manifest
  • host qui contient deux programmes.
  • device contenant Firefox.
  • data est vide.

host contient les programmes qui seront copiés sur le disque dur.
device contient les programmes qui seront exécutés à partir de la clef. On aurait pu mettre la Framakey dans device, mais la place prise aurait été trop grande : les programmes auraient été présents en deux exemplaires : l’un compressé dans le manifeste qui reste stocké sur la clef, et l’autre, décompressé, dans le dossier Exec).

Dans les manifestes, vous noterez la présence de :

  • : pointe vers le dossier Exec créé sur votre disque dur.
  • : Exec de votre clef usb.
  • : Data. Il s’agit **à priori** du dossier Data de la clef. Cela permet de conserver des données (mais par exemple, skype ne retiens pas les options, d’où le “à priori”).

Passons à l’étude des manifestes : (les commentaires sont en verts et les * sont des suppositions)

Celui de Firefox :

  1. <u3manifest version="1.0"> //*version du manifeste
  2.         <application uuid="EEBD498B-06AB-4e51-A706-5C4C78DA3956"  version="1.5.0.2"> // Identifiant unique du programme et la version du programme, affichée lors de l'installation.
  3.                 <icon>firefox_0.ico</icon> // nom de l'icône placée dans « manifest ».
  4.                 <name>Firefox</name> // le nom du programme
  5.                 <vendor url="http://home.yourbrainz.com">YourBrainz</vendor> //adresse du créateur du paquetage U3 ou du programme
  6.                 <description>Mozilla Firefox 1.5.0.2 for U3 packaged and supported by YourBrainz</description> // description lors de l'installation
  7.                 <options> //début des options
  8.                         <!--
  9.                         <autorun/> // démarrage automatique (voir le menu gestion des programmes), ici entre commentaires. Voir le manifeste de la Framakey.
  10.                         -->
  11.                         <minFreeSpace>40</minFreeSpace> //*l'espace minimum pour installation, en Mo (peu importe pour l'installation de la Framakey, puisque c'est vous qui copiez les programmes)
  12.                 </options> //fin des options
  13.                 <i18n/>
  14.         </application>
  15.         <actions> //actions à réaliser
  16.                 <appStop cmd="%U3_HOST_EXEC_PATH%\Stealth\Stealth\Update.exe">-px xyzzy</appStop> //*action à effectuer à la fermeture de l'application.
  17.                 <appStart cmd="%U3_DEVICE_EXEC_PATH%\FireFox.exe"></appStart> // action à effectuer pour démarrer l'application
  18.                 <hostCleanUp cmd="%U3_HOST_EXEC_PATH%\Stealth\Stealth\null.exe"></hostCleanUp> //action de nettoyage à effectuer à la fermeture de U3
  19.                 </actions>
  20. </u3manifest>

Celui de Skype :

  1. <u3manifest version="1.0">
  2.    <application uuid="0DE4F643-C398-46ec-9339-2362F2311932" version="1.4.14.84"> // comme avant ;)
  3.                 <icon>skype.ico</icon>
  4.                 <name>Skype</name>
  5.                 <vendor url="http://www.skype.com/">Skype Limited</vendor>
  6.                 <description>The whole world can talk for free.</description>
  7.                 <options>
  8.                         <upgrade appData="add" deviceExec="add"/> //* mise à jour de "data" ??
  9.                         <minFreeSpace>9</minFreeSpace>
  10.                         <autorun/> //démarre avec U3
  11.                 </options>
  12.                 <i18n> //indique les localisations, traductions.
  13.                 .
  14.                 .//ICI, PLEIN DE LOCALISATIONS
  15.                 .
  16.                 </i18n>
  17.                 </application>
  18.         <actions> //actions à réaliser
  19.                 <appStart
  20. workingdir="%U3_APP_DATA_PATH%"
  21. cmd="%U3_HOST_EXEC_PATH%\skype.exe">/removable /datapath:"%U3_APP_DATA_PATH%"</appStart>
  22.                 <appStop cmd="%U3_HOST_EXEC_PATH%\skypeshutdown.exe">
  23. /datapath:"%U3_APP_DATA_PATH%"</appStop>
  24.                 <hostCleanUp cmd="%U3_HOST_EXEC_PATH%\hostClnUpNoOp.exe"></hostCleanUp>
  25.         </actions>
  26. </u3manifest>

note :

  • En aucun cas vous ne devez inclure les commentaires // (&hellipwinking smiley dans vos manifestes, car ils ne prennent pas la même forme !! ( ici : @@<!-- commentaires -->@@, évidemment, puisque c'est du XML ;-) ).
  • <appStart>..</appStart> comme les deux autres commandes sont écrites sur une seul ligne (ici, c’est à cause de la mise en page qu’il y’a des sauts de ligne !).

Voici le manifeste de la Framakey :

  1. <u3manifest version="1.0">
  2.         <application uuid="FRAMAKEY-31FB-4dec-B6C8-CE972EE2EFFB" version="1.5.0.4">
  3.                 <icon>framakey.ico</icon>
  4.                 <name>Framakey_U3</name>
  5.                 <vendor url="http://www.framakey.org">FramaKey</vendor>
  6.                 <description>The Framakey is a package of ready-to-use Open-source Software on a USB key which makes the life of the nomad users much easier.</description>
  7.                 <options>
  8.                         <autorun/>
  9.                 </options>
  10.                 <i18n>
  11.                         <!-- Français -->
  12.                         <location lcid="1036"> //localisation française
  13.                                 <name>Framakey_U3</name>
  14.                                 <vendor url="http://www.framakey.org">FramaKey</vendor>
  15.                                 <description>La FramaKey est une compilation de Logiciels Libres prêts à l’emploi sur clef USB qui facilite la vie des
  16. utilisateurs nomades.</description>
  17.                         </location>
  18.                 </i18n>
  19.         </application>
  20.         <actions>
  21.                 <appStart cmd="%U3_DEVICE_EXEC_PATH%\start.exe"></appStart>
  22.                 <appStop cmd=""></appStop>
  23.                 <hostCleanUp cmd=""></hostCleanUp>
  24.         </actions>
  25. </u3manifest>

Comme vous pouvez le constater, le manifeste n’a pas de programme de nettoyage contrairement aux deux autres applications, d’où le message d’erreur lorsqu’on veut retirer la clef. Rien de grave donc.

Tout les programmes sont lancés à partir de , c’est à dire à partir du dossier dans lequel vous avez placé le contenu de la Framakey

Pour des raisons pratiques, nous feront de même avec les applications portables. En effet, les applications écrivent des fichiers de configurations. Si ces fichiers sont écrits sur le disque dur, cela n’a aucun intérêt puisque vous devrez reconfigurer vos logiciels à chaque lancement, les fichiers U3 du
disques étant effacés à chaque éjection de la clef(les applications ne sont pas prévus pour utiliser le fichier data). Et en bonus, vos applications s’ouvre plus vite (pas de décompression vers le disque dur).


« | Index | »

Fil RSS