mirror of
git://source.winehq.org/git/wine.git
synced 2024-08-31 09:54:07 +00:00
266 lines
11 KiB
Plaintext
266 lines
11 KiB
Plaintext
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 librairie (appelée
|
|
Winelib) qui implémente les appels de l'API de Windows par leur
|
|
équivalent Unix ou X11. Cette librairie peut également être utilisée
|
|
pour porter du code Win32 vers un exécutable Unix natifs.
|
|
|
|
Wine est un logiciel libre, distribué sous GNU LGPL; lisez le fichier
|
|
LICENCE pour les détails.
|
|
|
|
2. DÉMARRAGE RAPIDE
|
|
|
|
Même si vous compilez à partir des sources, il est recommandé d'utiliser
|
|
l'Installateur de Wine pour construire et installer Wine. À partir du
|
|
répertoire le plus élevé des sources de Wine (qui contient ce fichier),
|
|
exécutez :
|
|
|
|
./tools/wineinstall
|
|
|
|
Pour exécuter les programmes, tapez "wine [options] programme". Pour des
|
|
informationS complémentaires et des résolutions de problèmes, lisez le
|
|
reste de ce fichier, les pages "man" de Wine, les fichiers dans le
|
|
répertoire de documentation des sources de Wine (voir "DOCUMENTATION"),
|
|
et surtout les nombreuses informations que vous trouverez sur
|
|
http://www.winehq.com.
|
|
|
|
3. CONFIGURATION NÉCESSAIRE
|
|
|
|
Pour compiler et exécuter Wine, vous devez avoir un des systèmes
|
|
d'exploitation qui suit :
|
|
|
|
Linux version 2.0.36 ou supérieur
|
|
FreeBSD 4.x or FreeBSD 5-CURRENT
|
|
Solaris x86 2.5 ou supérieur
|
|
NetBSD-current
|
|
|
|
Information Linux :
|
|
Bien que les versions Linux 2.0.x fonctionneront en général, certaines
|
|
caractéristiques (surtout le partage LDT) nécessaires pour faire
|
|
fonctionner les "threads" Win32 n'étaient implémentés avant les kernels 2.2.
|
|
Si vous avez constamment des plantages dû aux "threads", vous devriez
|
|
considérer de vous mettre à jour au noyau 2.2. Aussi certains bogues ont été
|
|
fixés et de nouvelles fonctionnalités ont été ajoutées aux dernières versions
|
|
du noyau 2.0.x, ainsi si vous avez un noyau Linux très ancien, mettez-le à
|
|
jour au moins au dernier 2.0.x.
|
|
|
|
Information FreeBSD :
|
|
Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
|
|
enclanchées dans votre noyau.
|
|
Plus d'information est située dans l'arbre de ports :
|
|
ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
|
|
|
|
Information Solaris :
|
|
Il est plus que probable que vous devrez construire Wine avec la chaîne
|
|
d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
|
|
qu'il sera utilisé par gcc. Recompliler gcc après l'installation de gas
|
|
ou créer un lien symbolique de cc, as et ld vers les outils GNU semble
|
|
nécessaire.
|
|
|
|
Information NetBSD :
|
|
Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
|
|
enclanchées dans votre noyau.
|
|
|
|
Information des système de fichier :
|
|
Wine devrait fonctionner sur la plupart des systèmes de fichier. Cependant
|
|
Wine s'arrêtera au démarrage si umsdos est utilisé pour le répertoire /tmp.
|
|
Quelques problèmes de compatibilité ont aussi été rapportés sur
|
|
l'utilisation des fichiers accédés au travers de Samba. Egalement, puisque
|
|
NTFS ne peut être utilisé en sécurité qu'avec un accès en lecture seul pour
|
|
le moment, nous recommandons de ne pas utiliser NTFS, parce que les
|
|
programmes Windows on besoin des accès en écriture presque partout. Si vous
|
|
avez des fichier NTFS, copiez les vers une localisation accessible en
|
|
écriture.
|
|
|
|
Wine a besoin de "threads" du niveau noyau. Actuellement, seul Linux version
|
|
2.0 ou supérieur, FreeBSD 4.x ou supérieur, Solaris x86 version 2.5 ou supérieur
|
|
et NetBSD-current sont supportés. D'autres systèmes d'exploitations qui
|
|
implémentent les "threads" noyau peuvent être supportés dans le futur.
|
|
|
|
Vous avez besoin d'avoir les fichiers "include" de X11 installés
|
|
(appelés xlib6g-dev pour Debian et XFree86-devel pour RedHat).
|
|
Pour utiliser le support de Wine pour des applications multi-threads
|
|
vos librairies X doivent être réentrantes, ce qui est probalblement la
|
|
configuration par défaut à l'heure actuelle. Si vous possédez libc6 (glibc2)
|
|
ou que vous compilez les librairies X vous-même, elles ont probablement été
|
|
compilées avec l'option réentrant enclanchée.
|
|
|
|
Sur les système x86, gcc >= 2.7.2 est nécessaire. Les versions inférieures à
|
|
la 2.7.2.3 peuvent créer des ennuis losrque certains fichiers sont compilés
|
|
avec l'optimisation, souvent dû à des problèmes de gestion d'en-tête de fichier.
|
|
pgcc ne fonctionne pas actuellement avec Wine. La cause de ce problème est
|
|
inconnue.
|
|
|
|
Évidemment, vous aurez besoin de "make" (très probablement GNU make).
|
|
|
|
Vous aurez également besoin de flex version 2.5 ou supérieure et yacc.
|
|
Bison fonctionnera en replacement de yacc. Si vous utilisez RedHat ou Debian,
|
|
installez les paquets flex et bison.
|
|
|
|
Pour le traitement automatique des scripts de la série de tests, vous aurez
|
|
également besoin des en-têtes de développement de libperl (package libperl-dev
|
|
sous Debian).
|
|
|
|
Pour la configuration nécessaire si vous avez l'intention de construire la
|
|
documentation vous-même voyez la section "DOCUMENTATION".
|
|
|
|
4. COMPILATION
|
|
|
|
Au cas où vous choisissez de ne pas utiliser wineinstall, exécuter les com-
|
|
mandes suivantes pour construire Wine :
|
|
|
|
./configure
|
|
make depend
|
|
make
|
|
|
|
Cela va constuire le programme "wine" et de nombreux binaires/librairies de
|
|
support.
|
|
Le programme "wine" chargera et exécutera les exécutables Windows.
|
|
La librairie "libwine" ("Winelib") peut être utilisée pour compiler et lier
|
|
le code source Windows sous Unix.
|
|
|
|
Pour voir les options de compilation, tapez ./configure --help.
|
|
|
|
Pour mettre à jour une nouvelle version en utilisant les fichiers patch, tout
|
|
d'abord aller dans le répertoire de plus haut niveau de la version actuelle
|
|
(celui qui contient ce fichier README.fr). Ensuite faire un "make clean", et
|
|
patcher la version avec :
|
|
|
|
gunzip -c patch-file | patch -p1
|
|
|
|
Avec "patch-file" qui est le nom du fichier de patche (quelque chose de
|
|
similaire à Wine-yymmdd.diff.gz). Vous pouvez réexécuter "./configure", et
|
|
ensuite taper "make depend && make".
|
|
|
|
5. SETUP
|
|
|
|
Un fois que Wine a été construit correctement, vous pouvez tapez "make install";
|
|
cela installera l'exécutable wine, les pages man Wine et quelques autres fichiers
|
|
nécessaires.
|
|
|
|
N'oubliez pas de désinsatller toutes les installations précédantes de wine.
|
|
Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
|
|
d'installer.
|
|
|
|
Si vou désirez lire la documentation fournie avec les sources de Wine, voyez la
|
|
section "DOCUMENTATION".
|
|
|
|
Wine a besoin d'un fichier de configuration nommé "config" dans votre répertoire
|
|
~/.wine. Le format de ce fichier est expliqué dans la page man du fichier de
|
|
configuration (documentation/wine.conf.man).
|
|
Le fichier documentation/samples/config contient un exemple de fichier de
|
|
configuration qui doit être adapté et copié vers la localisation mentionnée
|
|
ci-dessus.
|
|
|
|
N'oubliez pas d'ajouter des entrées de registre virtuelle en applicant
|
|
winedefault.reg avec programs/regapi/. Voyez le répertoire documentation/ pour
|
|
les détails.
|
|
|
|
Naviguez sur http://www.winehq.com/support/ pour plus d'astuce de configuration.
|
|
|
|
En cas d'erreur de chargement de librairie (par exemple
|
|
"Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter
|
|
le chemin des librairies à /etc/ld.so.conf et exécuter ldconfig en tant que root.
|
|
|
|
Pour pouvoir vérifier l'exactitude de l'environnement dont vous avez besoin pour
|
|
que Wine s'exécute correctement, vous pouvez exécuter "./tools/winecheck | less".
|
|
Vous aurez un score en pourcentage indiquant "l'exactitude de la configuration
|
|
de Wine". Ce programme est encore en développement alpha, il n'effectue pas
|
|
encore un véritable test en profondeur, il devrait cependant être utile dans
|
|
une première vérification.
|
|
|
|
Lisez les page man de wine.conf pour savoir comment basculer en un mode texte
|
|
uniquement.
|
|
|
|
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 Solitaire par exemple :
|
|
|
|
wine sol (en utilisant le chemin d'accès pour
|
|
localiser le fichier)
|
|
wine sol.exe
|
|
|
|
wine c:\\windows\\sol.exe (en utilisant un nom de fichier DOS)
|
|
|
|
wine /usr/windows/sol.exe (en utilisant un nom de fichier Unix)
|
|
|
|
Note: le chemin du fichier sera également additionné au chemin par défaut
|
|
lorsque le nom entier est écrit sur la ligne de commande.
|
|
|
|
Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
|
|
que vous avez installé correctement winedbg d'après documentation/debugger.sgml,
|
|
vous entrerez dans le débogueur vous permettant d'enquêter et de résoudre le
|
|
problème. Pour plus d'information sur la manière de le faire, veuillez lire
|
|
le fichier documentation/debugging.sgml.
|
|
|
|
Vous devriez sauvegarder tous vos fichier important auquels vous donnez accès
|
|
à Wine ou utiliser une copie spéciale pour Wine, puisque dans certain cas des
|
|
utilisateurs ont rapporté des corruptions de fichiers. Ne PAS
|
|
éxécuter l'Explorateur, par exemple, si vous n'avez pas une copie propre,
|
|
puisque il renomme/corrompt parfois plusieurs répertoires. Même certaines
|
|
application MS telle Messenger par exemple ne sont pas sûres puisqu'elle
|
|
peuvent lancer l'Explorateur dans certains cas. Certaines corruptions
|
|
particulières telle (!$!$!$!$.pfr) peut du moins être partiellement
|
|
fixée en utilisant la méthode décrite par
|
|
http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
|
|
|
|
7. DOCUMENTATION
|
|
|
|
Certaines documentations (divers Guides Wine etc) peuvent être trouvées dans
|
|
le répertoire documentation/ (à part ceux disponibles également sur WineHQ)
|
|
|
|
Si vou voulez construire les fichier SGML ici, vous pouvez exécuter la
|
|
commande "make doc" dans le répertoire documentation/.
|
|
Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
|
|
db2ps, db2pdf) nommés :
|
|
Debian: docbook-utils
|
|
Mandrake: sgml-tools-A.B.C-DDmdk
|
|
SuSE: docbktls-A.BB.C-DD
|
|
|
|
8. OPTENIR PLUS D'INFORMATIONS
|
|
|
|
WWW: Baucoup d'informations à propos de Wine sont disponibles sur WineHQ à
|
|
http://www.winehq.com/ : divers Guides Wine, base de donnée
|
|
d'applications, suivit de bogues. C'est probablement le meilleur point
|
|
de départ.
|
|
|
|
FAQ: La Foire Aux Questions de Wine est localisée à :
|
|
http://www.winehq.com/FAQ
|
|
|
|
Usenet: Vous pouvez parler des problèmes ou résolutions en relation avec Wine
|
|
ou optenir de l'aide sur comp.emulators.ms-windows.wine.
|
|
|
|
Bugs: Rapportez les bogues à Wine Bugzilla à http://bugs.winehq.com/.
|
|
SVP cherchez tout d'abord dans la base de donnée de bugzilla
|
|
pour contrôler que le problème n'est pas déjà découvert avant
|
|
de poster un rapport de bogue. Vous pouvez également rapporter
|
|
des rapports de bogue à comp.emulators.ms-windows.wine.
|
|
SVP lisez le fichier documentation/bugs.sgml pour connaître les
|
|
informations nécessaires.
|
|
|
|
IRC: L'aide en ligne est disponible sur le cannal #WineHQ sur
|
|
irc.openprojects.net.
|
|
|
|
CVS: L'arbre de développement actuel de Wine est disponible au travers
|
|
de CVS.
|
|
Allez sur http://www.winehq.com/development/ pour plus d'informations
|
|
|
|
Mailing lists:
|
|
Il existe de multiples mailing lists pour les développeurs de Wine;
|
|
repportez-vous à http://www.winehq.com/development/#ml pour de plus
|
|
amples informations.
|
|
|
|
Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le
|
|
format 'diff -u' ) à la liste de diffusion wine-patches@winehq.com pour son
|
|
inclusion dans la prochaine version.
|
|
|
|
--
|
|
Alexandre Julliard
|
|
julliard@winehq.com
|