1. INTRODUCTION Wine est un programme qui permet d'exécuter les logiciels écrits pour Microsoft Windows (comprenant les exécutables DOS, Windows 3.x et Win32) sur un Unix. Il est composé d'un chargeur qui charge et exécute un binaire Microsoft Windows, ainsi que d'une bibliothèque (appelée Winelib) qui implémente les appels de l'API de Windows par leur équivalent Unix ou X11. Cette bibliothèque peut également être utilisée pour porter du code Win32 vers un exécutable Unix natif. Wine est un logiciel libre, distribué sous GNU LGPL ; lisez le fichier LICENSE pour plus de détails. 2. DÉMARRAGE RAPIDE Quand vous compilez à partir des sources, il est recommandé d'utiliser l'installeur de Wine pour construire et installer Wine. À partir du répertoire racine des sources de Wine, exécutez : ./tools/wineinstall Pour exécuter un programme, tapez « wine [options] programme ». Pour des informations complémentaires et la résolutions de problèmes, lisez le reste de ce fichier, les pages de manuel de Wine, et surtout les nombreuses informations que vous trouverez sur http://www.winehq.org. 3. CONFIGURATION NÉCESSAIRE Pour compiler et exécuter Wine, vous devez disposer d'un des systèmes d'exploitation suivants : Linux version 2.0.36 ou ultérieur FreeBSD 6.3 ou ultérieur Solaris x86 9 ou ultérieur NetBSD-current Mac OS X 10.4 ou ultérieur Étant donné que Wine nécessite une implémentation des « threads » (processus légers) au niveau du noyau, seuls les systèmes d'exploitation mentionnés ci-haut sont supportés. D'autres systèmes d'exploitation implémentant les threads noyau peuvent être pris en charge dans le futur. Informations Linux : Bien que Linux 2.2.x doive encore fonctionner et que Linux 2.0.x puisse encore marcher (les versions les plus anciennes de 2.0.x avaient des plantages dus aux threads), il est préférable d'utiliser un noyau récent tel que 2.4.x ou 2.6.x. Informations FreeBSD : Wine ne fonctionnera généralement pas bien avec les versions FreeBSD antérieures à 6.3 ou 7.0 (certains patches additionnels sont disponibles pour FreeBSD 6.3). Voyez pour plus d'informations. Informations Solaris : Il est plus que probable que vous deviez construire Wine avec la chaîne d'outils GNU (gcc, gas, etc.). Attention : installer gas n'assure pas qu'il sera utilisé par gcc. Recompiler gcc après l'installation de gas ou créer un lien symbolique de cc, as et ld vers les outils GNU correspondants semble nécessaire. Informations NetBSD : Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM et SYSVMSG activées dans votre noyau. Informations Mac OS X : Xcode 2.4 ou ultérieur est nécessaire pour compiler Wine sous x86. Systèmes de fichiers pris en charge : Wine devrait fonctionner sur la plupart des systèmes de fichiers. Certains problèmes de compatibilité ont été rapportés lors de l'utilisation de fichiers accédés via Samba. De plus, NTFS ne fournit pas toutes les fonctionnalités de système de fichiers nécessaires pour certains applications. L'utilisation d'un système de fichiers Linux natif comme ext3 est recommandée. Configuration de base requise : Les fichiers « include » de X11 (appelés xlib6g-dev sous Debian et XFree86-devel sous RedHat) doivent être installés. Bien entendu, vous aurez besoin du programme « make » (très probablement GNU make). Flex 2.5 ou ultérieur, ainsi que bison, sont également requis. Bibliothèques optionnelles : « configure » affiche des messages quand des bibliothèques optionnelles ne sont pas détectées sur votre système. Consultez http://wiki.winehq.org/Recommended_Packages (en anglais) pour des indications sur les paquets logiciels que vous devriez installer. Sur les plates-formes 64 bits, vous devez installer les versions 32 bits de ces bibliothèques. Voyez http://wiki.winehq.org/WineOn64bit (en anglais) pour les détails. 4. COMPILATION Au cas où vous choisiriez de ne pas utiliser wineinstall, exécutez les commandes suivantes pour construire Wine : ./configure make depend make Cela va construire le programme « wine », ainsi que nombreux binaires/bibliothèques de support. Le programme « wine » charge et exécute les exécutables Windows. La bibliothèque « libwine » (alias « Winelib ») peut être utilisée pour compiler et lier du code source Windows sous Unix. Pour voir les options de compilation, tapez « ./configure --help ». Pour mettre à jour vers une nouvelle version en utilisant les fichiers de mise à niveau, allez tout d'abord dans le répertoire de plus haut niveau de la version actuelle (le parent de celui qui contient ce fichier README.fr). Faites ensuite un « make clean », et mettez à jour la version avec : bunzip2 -c fichier-patch | patch -p1 où « fichier-patch » est le nom du fichier de mise à niveau (quelque chose du genre wine-1.0.x.diff.bz2). Vous pouvez alors réexécuter « ./configure », et ensuite taper « make depend && make ». 5. INSTALLATION Une fois Wine construit correctement, « make install » installe l'exécutable wine, les pages de manuel de Wine et quelques autres fichiers nécessaires. N'oubliez pas de désinstaller toutes les installations précédentes : essayez « dpkg -r wine », « rpm -e wine » ou « make uninstall » avant d'installer une nouvelle version. Une fois l'installation terminée, vous pouvez naviguer dans la section Support sur http://www.winehq.org/ pour obtenir des astuces de configuration. 6. EXÉCUTER DES PROGRAMMES Lorsque l'on invoque Wine, vous pouvez spécifier le chemin entier vers l'exécutable ou seulement le nom de fichier. Pour exécuter le bloc-notes par exemple : wine notepad (en utilisant le chemin d'accès spécifié wine notepad.exe dans le fichier de configuration pour localiser le fichier) wine c:\\windows\\notepad.exe (en utilisant la syntaxe de fichiers DOS) wine ~/.wine/drive_c/windows/notepad.exe (en utilisant la syntaxe Unix) wine notepad.exe /paramètre1 -paramètre2 paramètre3 (en appelant le programme avec des paramètres) Wine n'est pas encore terminé ; ainsi quelques programmes peuvent planter. Quand cela se produit, un débogueur est démarré à l'endroit du plantage pour que vous puissiez essayer de résoudre le problème. Pour plus d'informations sur la manière de faire, veuillez lire la section « débogage » du Guide du développeur Wine (Wine Developer's Guide). 7. INFORMATIONS COMPLÉMENTAIRES WWW Beaucoup d'informations à propos de Wine sont disponibles sur WineHQ à http://www.winehq.org : divers guides, base de données d'applications, suivi de bogues. C'est probablement le meilleur point de départ. FAQ La Foire aux Questions de Wine se trouve sur http://www.winehq.org/FAQ Usenet Vous pouvez parler des problèmes relatifs à Wine ou obtenir de l'aide sur comp.emulators.ms-windows.wine. Bogues Rapportez les bogues sur le Bugzilla Wine sur http://bugs.winehq.org Merci de vérifier au préalable dans la base de données de bugzilla que le problème n'a pas déjà été découvert. Vous pouvez aussi rapporter des bogues sur le forum de discussion comp.emulators.ms-windows.wine. Veuillez également lire le fichier documentation/bugs.sgml pour connaître les informations indispensables à fournir. IRC L'aide en ligne est disponible sur le canal #WineHQ sur irc.freenode.net. Git L'arbre de développement actuel de Wine est disponible via Git. Voyez http://www.winehq.org/site/git pour plus d'informations. Listes de diffusion Il existe plusieurs listes de diffusion pour les développeurs Wine ; voyez http://www.winehq.org/forums pour de plus amples informations. Wiki Le wiki Wine est situé sur http://wiki.winehq.org Si vous ajoutez quelque chose ou corrigez un bogue, merci d'envoyer un correctif (dans le format « diff -u » ) à la liste de diffusion wine-patches@winehq.org pour que cela puisse être inclus dans la version suivante. -- Alexandre Julliard julliard@winehq.org