mirror of
git://source.winehq.org/git/wine.git
synced 2024-09-02 11:53:38 +00:00
265 lines
11 KiB
Plaintext
265 lines
11 KiB
Plaintext
![]() |
1. INTRODUCTION
|
|||
|
|
|||
|
Wine est un programme qui permet d'ex<65>cuter les logiciels <20>crits
|
|||
|
pour Microsoft Windows (comprenant les ex<65>cutables DOS, Windows 3.x
|
|||
|
et Win32) sur un Unix. Il est compos<6F> d'un chargeur qui charge et
|
|||
|
ex<EFBFBD>cute un binaire Microsoft Windows, ainsi que d'une librairie (appel<65>e
|
|||
|
Winelib) qui impl<70>mente les appels de l'API de Windows par leur
|
|||
|
<EFBFBD>quivalent Unix ou X11. Cette librairie peut <20>galement <20>tre utilis<69>e
|
|||
|
pour porter du code Win32 vers un ex<65>cutable Unix natifs.
|
|||
|
|
|||
|
Wine est un logiciel libre, distribu<62> sous GNU LGPL; lisez le fichier
|
|||
|
LICENCE pour les d<>tails.
|
|||
|
|
|||
|
2. D<>MARRAGE RAPIDE
|
|||
|
|
|||
|
M<EFBFBD>me si vous compilez <20> partir des sources, il est recommand<6E> d'utiliser
|
|||
|
l'Installateur de Wine pour construire et installer Wine. <20> partir du
|
|||
|
r<EFBFBD>pertoire le plus <20>lev<65> des sources de Wine (qui contient ce fichier),
|
|||
|
ex<EFBFBD>cutez :
|
|||
|
|
|||
|
./tools/wineinstall
|
|||
|
|
|||
|
Pour ex<65>cuter les programmes, tapez "wine [options] programme". Pour des
|
|||
|
informationS compl<70>mentaires et des r<>solutions de probl<62>mes, lisez le
|
|||
|
reste de ce fichier, les pages "man" de Wine, les fichiers dans le
|
|||
|
r<EFBFBD>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<65>cuter Wine, vous devez avoir un des syst<73>mes
|
|||
|
d'exploitation qui suit :
|
|||
|
|
|||
|
Linux version 2.0.36 ou sup<75>rieur
|
|||
|
FreeBSD 4.x or FreeBSD 5-CURRENT
|
|||
|
Solaris x86 2.5 ou sup<75>rieur
|
|||
|
NetBSD-current
|
|||
|
|
|||
|
Information Linux :
|
|||
|
Bien que les versions Linux 2.0.x fonctionneront en g<>n<EFBFBD>ral, certaines
|
|||
|
caract<63>ristiques (surtout le partage LDT) n<>cessaires pour faire
|
|||
|
fonctionner les "threads" Win32 n'<27>taient impl<70>ment<6E>s avant les kernels 2.2.
|
|||
|
Si vous avez constamment des plantages d<> aux "threads", vous devriez
|
|||
|
consid<69>rer de vous mettre <20> jour au noyau 2.2. Aussi certains bogues ont <20>t<EFBFBD>
|
|||
|
fix<69>s et de nouvelles fonctionnalit<69>s ont <20>t<EFBFBD> ajout<75>es aux derni<6E>res versions
|
|||
|
du noyau 2.0.x, ainsi si vous avez un noyau Linux tr<74>s ancien, mettez-le <20>
|
|||
|
jour au moins au dernier 2.0.x.
|
|||
|
|
|||
|
Information FreeBSD :
|
|||
|
Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
|
|||
|
enclanch<63>es dans votre noyau.
|
|||
|
Plus d'informations invoquant les patches pour la branche 4-STABLE dans
|
|||
|
l'arbre de ports :
|
|||
|
ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/ports/emulators/wine/files/
|
|||
|
|
|||
|
Information Solaris :
|
|||
|
Il est plus que probable que vous devrez construire Wine avec la cha<68>ne
|
|||
|
d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
|
|||
|
qu'il sera utilis<69> par gcc. Recompliler gcc apr<70>s l'installation de gas
|
|||
|
ou cr<63>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<63>es dans votre noyau.
|
|||
|
|
|||
|
Information des syst<73>me de fichier :
|
|||
|
Wine devrait fonctionner sur la plupart des syst<73>mes de fichier. Cependant
|
|||
|
Wine s'arr<72>tera au d<>marrage si umsdos est utilis<69> pour le r<>pertoire /tmp.
|
|||
|
Quelques probl<62>mes de compatibilit<69> ont aussi <20>t<EFBFBD> rapport<72>s sur
|
|||
|
l'utilisation des fichiers acc<63>d<EFBFBD>s au travers de Samba. Egalement, puisque
|
|||
|
NTFS ne peut <20>tre utilis<69> en s<>curit<69> qu'avec un acc<63>s en lecture seul pour
|
|||
|
le moment, nous recommandons de ne pas utiliser NTFS, parce que les
|
|||
|
programmes Windows on besoin des acc<63>s en <20>criture presque partout. Si vous
|
|||
|
avez des fichier NTFS, copiez les vers une localisation accessible en
|
|||
|
<20>criture.
|
|||
|
|
|||
|
Wine a besoin de "threads" du niveau noyau. Actuellement, seul Linux version
|
|||
|
2.0 ou sup<75>rieur, FreeBSD-current ou FreeBSD 3.0 ou sup<75>rieur, Solaris x86
|
|||
|
version 2.5 ou sup<75>rieur et NetBSD-current sont support<72>s. D'autres syst<73>mes
|
|||
|
d'exploitations qui impl<70>mentent les "threads" noyau peuvent <20>tre support<72>s dans
|
|||
|
le futur.
|
|||
|
|
|||
|
Vous avez besoin d'avoir les fichiers "include" de X11 install<6C>s
|
|||
|
(appel<65>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 <20>tre r<>entrantes, ce qui est probalblement la
|
|||
|
configuration par d<>faut <20> l'heure actuelle. Si vous poss<73>dez libc6 (glibc2)
|
|||
|
ou que vous compilez les librairies X vous-m<>me, elles ont probablement <20>t<EFBFBD>
|
|||
|
compil<EFBFBD>es avec l'option r<>entrant enclanch<63>e.
|
|||
|
|
|||
|
Sur les syst<73>me x86, gcc >= 2.7.2 est n<>cessaire. Les versions inf<6E>rieures <20>
|
|||
|
la 2.7.2.3 peuvent cr<63>er des ennuis losrque certains fichiers sont compil<69>s
|
|||
|
avec l'optimisation, souvent d<> <20> des probl<62>mes de gestion d'en-t<>te de fichier.
|
|||
|
pgcc ne fonctionne pas actuellement avec Wine. La cause de ce probl<62>me est
|
|||
|
inconnue.
|
|||
|
|
|||
|
Vous aurez <20>galement besoin de flex version 2.5 ou sup<75>rieure et yacc.
|
|||
|
Bison fonctionnera en replacement de yacc. Si vous utilisez RedHat ou Debian,
|
|||
|
installez les paquets flex et bison.
|
|||
|
|
|||
|
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<65>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<65>cutera les ex<65>cutables Windows.
|
|||
|
La librairie "libwine" ("Winelib") peut <20>tre utilis<69>e pour compiler et lier
|
|||
|
le code source Windows sous Unix.
|
|||
|
|
|||
|
Pour voir les options de compilation, tapez ./configure --help.
|
|||
|
|
|||
|
Pour mettre <20> 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 <20> Wine-yymmdd.diff.gz). Vous pouvez r<>ex<65>cuter "./configure", et
|
|||
|
ensuite taper "make depend && make".
|
|||
|
|
|||
|
5. SETUP
|
|||
|
|
|||
|
Un fois que Wine a <20>t<EFBFBD> construit correctement, vous pouvez tapez "make install";
|
|||
|
cela installera l'ex<65>cutable wine, les pages man Wine et quelques autres fichiers
|
|||
|
n<EFBFBD>cessaires.
|
|||
|
|
|||
|
N'oubliez pas de d<>sinsatller toutes les installations pr<70>c<EFBFBD>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<6D> "config" dans votre r<>pertoire
|
|||
|
~/.wine. Le format de ce fichier est expliqu<71> 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 <20>tre adapt<70> et copi<70> vers la localisation mentionn<6E>e
|
|||
|
ci-dessus.
|
|||
|
|
|||
|
N'oubliez pas d'ajouter des entr<74>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 <20> /etc/ld.so.conf et ex<65>cuter ldconfig en tant que root.
|
|||
|
|
|||
|
Pour pouvoir v<>rifier l'exactitude de l'environnement dont vous avez besoin pour
|
|||
|
que Wine s'ex<65>cute correctement, vous pouvez ex<65>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 <20>tre utile dans
|
|||
|
une premi<6D>re v<>rification.
|
|||
|
|
|||
|
Lisez les page man de wine.conf pour savoir comment basculer en un mode texte
|
|||
|
uniquement.
|
|||
|
|
|||
|
6. EX<45>CUTER DES PROGRAMMES
|
|||
|
|
|||
|
Lorsque l'on invoque Wine, vous pouvez sp<73>cifier le chemin entier vers
|
|||
|
l'ex<65>cutable ou seulement le nom de fichier.
|
|||
|
|
|||
|
Pour ex<65>cuter Solitaire par exemple :
|
|||
|
|
|||
|
wine sol (en utilisant le chemin d'acc<63>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 <20>galement additionn<6E> au chemin par d<>faut
|
|||
|
lorsque le nom entier est <20>crit sur la ligne de commande.
|
|||
|
|
|||
|
Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
|
|||
|
que vous avez install<6C> correctement winedbg d'apr<70>s documentation/debugger.sgml,
|
|||
|
vous entrerez dans le d<>bogueur vous permettant d'enqu<71>ter et de r<>soudre le
|
|||
|
probl<EFBFBD>me. Pour plus d'information sur la mani<6E>re de le faire, veuillez lire
|
|||
|
le fichier documentation/debugging.sgml.
|
|||
|
|
|||
|
Vous devriez sauvegarder tous vos fichier important auquels vous donnez acc<63>s
|
|||
|
<EFBFBD> Wine ou utiliser une copie sp<73>ciale pour Wine, puisque dans certain cas des
|
|||
|
utilisateurs ont rapport<72> des corruptions de fichiers. Ne PAS
|
|||
|
<EFBFBD>x<EFBFBD>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<EFBFBD>res telle (!$!$!$!$.pfr) peut du moins <20>tre partiellement
|
|||
|
fix<EFBFBD>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 <20>tre trouv<75>es dans
|
|||
|
le r<>pertoire documentation/ (<28> part ceux disponibles <20>galement sur WineHQ)
|
|||
|
|
|||
|
Si vou voulez construire les fichier SGML ici, vous pouvez ex<65>cuter la
|
|||
|
commande "make" dans le r<>pertoire documentation/.
|
|||
|
Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
|
|||
|
db2ps, db2pdf) nomm<6D>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 <20> propos de Wine sont disponibles sur WineHQ <20>
|
|||
|
http://www.winehq.com/ : divers Guides Wine, base de donn<6E>e
|
|||
|
d'applications, suivit de bogues. C'est probablement le meilleur point
|
|||
|
de d<>part.
|
|||
|
|
|||
|
FAQ: La Foire Aux Questions de Wine est localis<69>e <20> :
|
|||
|
http://www.winehq.com/FAQ
|
|||
|
|
|||
|
Usenet: Vous pouvez parler des probl<62>mes ou r<>solutions en relation avec Wine
|
|||
|
ou optenir de l'aide sur comp.emulators.ms-windows.wine.
|
|||
|
|
|||
|
Bugs: Rapportez les bogues <20> Wine Bugzilla <20> http://bugs.winehq.com/.
|
|||
|
SVP cherchez tout d'abord dans la base de donn<6E>e de bugzilla
|
|||
|
pour contr<74>ler que le probl<62>me n'est pas d<>j<EFBFBD> d<>couvert avant
|
|||
|
de poster un rapport de bogue. Vous pouvez <20>galement rapporter
|
|||
|
des rapports de bogue <20> comp.emulators.ms-windows.wine.
|
|||
|
SVP lisez le fichier documentation/bugs.sgml pour conna<6E>tre les
|
|||
|
informations n<>cessaires.
|
|||
|
|
|||
|
HOWTO: Le Wine HOWTO (hors date !) est disponible <20>
|
|||
|
http://www.westfalen.de/witch/wine-HOWTO.txt .
|
|||
|
|
|||
|
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 <20> 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' ) <20> la liste de diffusion wine-patches@winehq.com pour son
|
|||
|
inclusion dans la prochaine version.
|
|||
|
|
|||
|
--
|
|||
|
Alexandre Julliard
|
|||
|
julliard@winehq.com
|