| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
|---|
| 2 | <html>
|
|---|
| 3 | <head>
|
|---|
| 4 | <meta HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">
|
|---|
| 5 | <meta name="keywords" content="Virtual Screen, Open Source, Software" />
|
|---|
| 6 | <meta name="description" content="Mouse and Keyboard Sharing" />
|
|---|
| 7 | <link rel="stylesheet" type="text/css" href="synergy.css" media="screen" />
|
|---|
| 8 | <title>Building and Installing Synergy</title>
|
|---|
| 9 | </head>
|
|---|
| 10 | <body class="main">
|
|---|
| 11 | <p>
|
|---|
| 12 | </p><h3>Prerequisites for building</h3><p>
|
|---|
| 13 | </p><p>
|
|---|
| 14 | To build synergy from the sources you'll need the following:
|
|---|
| 15 | <ul>
|
|---|
| 16 | <li>Windows
|
|---|
| 17 | <ul>
|
|---|
| 18 | <li>VC++ 6.0 or up
|
|---|
| 19 | </ul>
|
|---|
| 20 | </p><p>
|
|---|
| 21 | <li>Unix
|
|---|
| 22 | <ul>
|
|---|
| 23 | <li>gcc 2.95 or up
|
|---|
| 24 | <li>X11R4 or up headers and libraries
|
|---|
| 25 | </ul>
|
|---|
| 26 | </p><p>
|
|---|
| 27 | <li>Mac OS X
|
|---|
| 28 | <ul>
|
|---|
| 29 | <li>XCode; or gcc 2.95 or up
|
|---|
| 30 | <li>Carbon development headers and libraries
|
|---|
| 31 | </ul>
|
|---|
| 32 | </ul>
|
|---|
| 33 | </p><p>
|
|---|
| 34 | </p><h3>Configuring the build</h3><p>
|
|---|
| 35 | </p><p>
|
|---|
| 36 | This step is not necessary when using VC++ or XCode.
|
|---|
| 37 | </p><p>
|
|---|
| 38 | To configure the build for your platform use the configure script:
|
|---|
| 39 | <pre>
|
|---|
| 40 | ./configure
|
|---|
| 41 | </pre>
|
|---|
| 42 | For a list of options to configure use:
|
|---|
| 43 | <pre>
|
|---|
| 44 | ./configure --help
|
|---|
| 45 | </pre>
|
|---|
| 46 | On Solaris you may need to use:
|
|---|
| 47 | <pre>
|
|---|
| 48 | <nobr>./configure --x-includes=/usr/openwin/include --x-libraries=/usr/openwin/lib</nobr>
|
|---|
| 49 | </pre>
|
|---|
| 50 | so synergy can find the X11 includes and libraries.
|
|---|
| 51 | </p><p>
|
|---|
| 52 | </p><h3>Building</h3><p>
|
|---|
| 53 | <ul>
|
|---|
| 54 | <li>Windows
|
|---|
| 55 | </p><p>
|
|---|
| 56 | Start VC++ and open <span class="code">synergy.dsw</span>. Set the
|
|---|
| 57 | active configuration (Build > Set Active Configuration) to
|
|---|
| 58 | <span class="code">All - Debug</span> or <span class="code">All -
|
|---|
| 59 | Release</span> then build. Binaries are built into
|
|---|
| 60 | <span class="code">./debug</span> or <span class="code">./build</span>.
|
|---|
| 61 | </p><p>
|
|---|
| 62 | <li>Unix or Mac OS X without XCode
|
|---|
| 63 | </p><p>
|
|---|
| 64 | Simply enter:
|
|---|
| 65 | <pre>
|
|---|
| 66 | make
|
|---|
| 67 | </pre>
|
|---|
| 68 | This will build the client and server and leave them in their
|
|---|
| 69 | respective source directories.
|
|---|
| 70 | </p><p>
|
|---|
| 71 | <li>Mac OS X with XCode
|
|---|
| 72 | </p><p>
|
|---|
| 73 | Start XCode and open the <span class="code">synergy.xcode</span>
|
|---|
| 74 | project. Build the <span class="code">all</span> project using
|
|---|
| 75 | the <span class="code">Deployment</span> flavor.
|
|---|
| 76 | </p><p>
|
|---|
| 77 | </ul>
|
|---|
| 78 | </p><p>
|
|---|
| 79 | </p><h3>Installing</h3><p>
|
|---|
| 80 | <ul>
|
|---|
| 81 | <li>Windows
|
|---|
| 82 | </p><p>
|
|---|
| 83 | You'll need <a target="_top" href="http://nsis.sourceforge.net/">NSIS</a>, the
|
|---|
| 84 | Nullsoft Scriptable Install System. Build <span class="code">All -
|
|---|
| 85 | Release</span> then build <span class="code">Installer - Release</span>.
|
|---|
| 86 | This creates <span class="code">SynergyInstaller.exe</span> in the
|
|---|
| 87 | <span class="code">build</span> directory. Run this to install synergy.
|
|---|
| 88 | </p><p>
|
|---|
| 89 | Alternatively, you can simply copy the following files from the
|
|---|
| 90 | <span class="code">debug</span> or <span class="code">build</span>
|
|---|
| 91 | directory to a directory you choose (perhaps under the
|
|---|
| 92 | <span class="code">Program Files</span> directory):
|
|---|
| 93 | <ul class="code">
|
|---|
| 94 | <li>synergy.exe
|
|---|
| 95 | <li>synergyc.exe
|
|---|
| 96 | <li>synergys.exe
|
|---|
| 97 | <li>synrgyhk.dll
|
|---|
| 98 | </ul>
|
|---|
| 99 | </p><p>
|
|---|
| 100 | <li>Unix or Mac OS X without XCode
|
|---|
| 101 | </p><p>
|
|---|
| 102 | <pre>
|
|---|
| 103 | make install
|
|---|
| 104 | </pre>
|
|---|
| 105 | will install the client and server into
|
|---|
| 106 | <span class="code">/usr/local/bin</span> unless you
|
|---|
| 107 | specified a different directory when you ran configure.
|
|---|
| 108 | </p><p>
|
|---|
| 109 | <li>Mac OS X with XCode
|
|---|
| 110 | </p><p>
|
|---|
| 111 | Copy the following files from ./build to a convenient location:
|
|---|
| 112 | </p><p>
|
|---|
| 113 | <ul class="code">
|
|---|
| 114 | <li>synergyc
|
|---|
| 115 | <li>synergys
|
|---|
| 116 | </ul>
|
|---|
| 117 | </p>
|
|---|
| 118 | </body>
|
|---|
| 119 |
|
|---|
| 120 | </html>
|
|---|
