1 1. INTRODUCTION
2
3 Wine est un programme qui permet d'exécuter les logiciels écrits
4 pour Microsoft Windows (comprenant les exécutables DOS, Windows 3.x
5 et Win32) sur un Unix. Il est composé d'un chargeur qui charge et
6 exécute un binaire Microsoft Windows, ainsi que d'une bibliothèque (appelée
7 Winelib) qui implémente les appels de l'API de Windows par leur
8 équivalent Unix ou X11. Cette bibliothèque peut également être utilisée
9 pour porter du code Win32 vers un exécutable Unix natif.
10
11 Wine est un logiciel libre, distribué sous GNU LGPL; lisez le fichier
12 LICENSE pour les détails.
13
14 2. DÉMARRAGE RAPIDE
15
16 Quand vous compilez à partir des sources, il est recommandé d'utiliser
17 l'Installateur de Wine pour construire et installer Wine. À partir du
18 répertoire racine des sources de Wine (qui contient ce fichier),
19 exécutez :
20
21 ./tools/wineinstall
22
23 Pour exécuter un programme, tapez "wine [options] programme". Pour des
24 informations complémentaires et des résolutions de problèmes, lisez le
25 reste de ce fichier, les pages "man" de Wine, et surtout les nombreuses
26 informations que vous trouverez sur http://www.winehq.org.
27
28 3. CONFIGURATION NÉCESSAIRE
29
30 Pour compiler et exécuter Wine, vous devez avoir un des systèmes
31 d'exploitation qui suit :
32
33 Linux version 2.0.36 ou ultérieur
34 FreeBSD 6.3 ou ultérieur
35 Solaris x86 9 ou ultérieur
36 NetBSD-current
37 Mac OS X 10.4 ou ultérieur
38
39 Étant donné que Wine nécessite une implémentation des "threads" (processus
40 légers) au niveau du noyau, seuls les systèmes d'exploitation mentionnés
41 ci-haut sont supportés. D'autres systèmes d'exploitation implémentant les
42 threads noyau peuvent être pris en charge dans le futur.
43
44 Information Linux :
45 Bien que Linux 2.2.x devrait encore fonctionner et que Linux 2.0.x pourrait
46 encore marcher (des versions plus anciennes de 2.0.x avaient des plantages
47 dus aux threads), il est préférable d'avoir un noyau récent tel que 2.4.x
48 ou 2.6.x.
49
50 Information FreeBSD :
51 Wine ne fonctionnera généralement pas bien pour les versions FreeBSD
52 antérieures à 6.3 ou 7.0 (certains patches additionnels sont disponibles pour
53 FreeBSD 6.3). Voyez <http://wiki.freebsd.org/Wine> pour plus d'informations.
54
55 Information Solaris :
56 Il est plus que probable que vous devrez construire Wine avec la chaîne
57 d'outils GNU (gcc, gas, etc.). Attention : installer gas n'assure pas
58 qu'il sera utilisé par gcc. Recompiler gcc après l'installation de gas
59 ou créer un lien symbolique de cc, as et ld vers les outils GNU semble
60 nécessaire.
61
62 Information NetBSD :
63 Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM et SYSVMSG
64 activées dans votre noyau.
65
66 Information Mac OS X :
67 Xcode 2.4 ou ultérieur est nécessaire pour compiler Wine sous x86.
68
69
70 Systèmes de fichiers pris en charge :
71 Wine devrait fonctionner sur la plupart des systèmes de fichiers. Certains
72 problèmes de compatibilité ont été rapportés lors de l'utilisation de fichiers
73 accédés via Samba. De plus, NTFS ne fournit pas toutes les fonctionnalités de
74 système de fichiers nécessaires pour certains applications. L'utilisation d'un
75 système de fichiers Linux natif comme ext3 est recommandée.
76
77 Configuration requise de base :
78 Les fichiers "include" de X11 (appelés xlib6g-dev sous Debian et XFree86-devel
79 sous RedHat) doivent être installés.
80
81 Bien entendu, vous aurez besoin du programme "make" (très probablement GNU
82 make).
83
84 Flex 2.5 ou ultérieur, ainsi que bison, sont également requis.
85
86 Bibliothèques optionnelles :
87 "Configure" affichera des messages quand des bibliothèques optionnelles ne
88 sont pas détectées sur votre système. Consultez
89 http://wiki.winehq.org/Recommended_Packages (en anglais) pour des indications
90 sur les paquets logiciels que vous devriez installer.
91
92 Sur les plates-formes 64 bits, vous devez installer les versions 32 bits de
93 ces bibliothèques. Voyez http://wiki.winehq.org/WineOn64bit (en anglais) pour
94 les détails.
95
96 4. COMPILATION
97
98 Au cas où vous choisiriez de ne pas utiliser wineinstall, exécutez les commandes
99 suivantes pour construire Wine :
100
101 ./configure
102 make depend
103 make
104
105 Cela va construire le programme "wine" et de nombreux binaires/bibliothèques de
106 support.
107 Le programme "wine" chargera et exécutera les exécutables Windows.
108 La bibliothèque "libwine" ("Winelib") peut être utilisée pour compiler et lier
109 du code source Windows sous Unix.
110
111 Pour voir les options de compilation, tapez ./configure --help.
112
113 Pour mettre à jour vers une nouvelle version en utilisant les fichiers de mise à
114 niveau, tout d'abord aller dans le répertoire de plus haut niveau de la version
115 actuelle (celui qui contient ce fichier README.fr). Ensuite faire un "make
116 clean", et mettre à jour la version avec :
117
118 bunzip2 -c fichier-patch | patch -p1
119
120 où "fichier-patch" est le nom du fichier de mise à niveau (quelque chose du
121 genre wine-1.0.x.diff.bz2). Vous pouvez ensuite réexécuter "./configure", et
122 taper ensuite "make depend && make".
123
124 5. INSTALLATION
125
126 Une fois Wine a été construit correctement, vous pouvez tapez "make install" :
127 cela installera l'exécutable wine, les pages man Wine et quelques autres
128 fichiers nécessaires.
129
130 N'oubliez pas de désinstaller toutes les installations précédentes de wine.
131 Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
132 d'installer une nouvelle version.
133
134 Une fois l'installation terminée, vous pouvez naviguer dans la section Support à
135 http://www.winehq.org/ pour obtenir des astuces de configuration.
136
137
138 6. EXÉCUTER DES PROGRAMMES
139
140 Lorsque l'on invoque Wine, vous pouvez spécifier le chemin entier vers
141 l'exécutable ou seulement le nom de fichier.
142
143 Pour exécuter le bloc-notes par exemple :
144
145 wine notepad (en utilisant le chemin d'accès spécifié
146 wine notepad.exe dans le fichier "config" pour localiser
147 le fichier)
148
149 wine c:\\windows\\notepad.exe (en utilisant la syntaxe de fichiers DOS)
150
151 wine ~/.wine/drive_c/windows/notepad.exe (en utilisant la syntaxe Unix)
152
153 wine notepad.exe /paramètre1 -paramètre2 paramètre3
154 (en appelant le programme avec des paramètres)
155
156 Wine n'est pas encore terminé ; ainsi quelques programmes peuvent planter. Quand
157 cela se produit, un débogueur est démarré à l'endroit du plantage pour que vous
158 puissiez essayer de résoudre le problème. Pour plus d'informations sur la
159 manière de faire, veuillez lire la section "déboguage" du Guide du développeur
160 Wine (Wine Developer's Guide).
161
162
163 7. INFORMATIONS COMPLÉMENTAIRES
164
165 WWW Beaucoup d'informations à propos de Wine sont disponibles sur WineHQ à
166 http://www.winehq.org/ : divers guides Wine, base de données
167 d'applications, suivi de bogues. C'est probablement le meilleur point
168 de départ.
169
170 FAQ La Foire Aux Questions de Wine se trouve sur http://www.winehq.org/FAQ
171
172 Usenet Vous pouvez parler des problèmes en relation avec Wine
173 ou obtenir de l'aide sur comp.emulators.ms-windows.wine.
174
175 Bogues Rapportez les bogues à Wine Bugzilla à http://bugs.winehq.org
176 SVP cherchez tout d'abord dans la base de données de bugzilla
177 pour contrôler que le problème n'est pas déjà découvert avant
178 de soumettre un rapport de bogue. Vous pouvez également rapporter
179 des rapports de bogue à comp.emulators.ms-windows.wine.
180 SVP lisez le fichier documentation/bugs.sgml pour connaître les
181 informations nécessaires.
182
183 IRC L'aide en ligne est disponible sur le canal #WineHQ sur
184 irc.freenode.net.
185
186 GIT L'arbre de développement actuel de Wine est disponible au travers de
187 GIT. Voyez http://www.winehq.org/site/git pour plus d'informations.
188
189 Listes de diffusion
190 Il existe de multiples listes de diffusion pour les développeurs Wine ;
191 voyez http://www.winehq.org/forums pour de plus amples informations.
192
193 Wiki Le wiki Wine est situé sur http://wiki.winehq.org
194
195
196 Si vous ajoutez quelque chose ou corrigez un bogue, envoyez un correctif (dans le
197 format 'diff -u' ) à la liste de diffusion wine-patches@winehq.org pour qu'il
198 soit inclus dans la prochaine version.
199
200 --
201 Alexandre Julliard
202 julliard@winehq.org
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.