Fixed DevStudio 2005 build.
[opal.git] / samples / openphone / ReadMe.txt
blob76e4fd2ffc238c57605838805f6f4b3ed738f568
1 Building OpenPhone
2 ==================
4 Last updated, 11 August 2006
7 OpenPhone is based onw wxWidgets so as well as all the usual PWLib and
8 OPAL stuff, you also have to get wxWidgets installed and compiled before
9 you can get OpenPhone built.
11 You can get wxWidgets from http://www.wxwidgets.org
14 Before we start, the assumption is (since you are reading this) that you
15 already have PWLib and OPAL installed, AND BUILT.
18 For Windows:
19 ------------
20   1.  Download the installer for wxWidgets, eg wxMSW-2.6.3-Setup-1.exe or
21       wxMSW-2.8.3-Setup.exe
23   2.  Run the installer.
25   3.  Set the environment variable WXDIR to the directory that you installed
26       wxWidgets into in step 2. Also set WXVER to 26 or 28 depending on the
27       version of wxWidgets you installed. Be sure to restart DevStudio.
29   4.  Open the DevStudio workspace %WXDIR%\build\msw\wx.dsw
30       If you are using Visual Studio .NET 2003 or Visual C++ Express 2005, you
31       will be asked whether to convert project files. Let it do the conversion
32       and use the converted projects.
34   5.  Build the Release and Debug versions of everything. The safest way is to
35       simply select "Debug", go "Build Solution", then select "Release" and go
36       "Build Solution" again.
38   6.  Open the DevStudio workspace %WXDIR%\utils\wxrc\wxrc.dsw, let it convert
39       the projects as before.
41   7.  Build the release version. Note: when using VC Express 2005, you may get
42       a large number of undefined symbols when linking. To fix this, add the
43       following libraries to the linker command line:
45                  user32.lib ole32.lib advapi32.lib shell32.lib
47   8.  Copy the %WXDIR%\utils\wxrc\vc_msw\wxrc.exe file to %WXDIR%\bin\wxrc.exe
49   9.  wxWidgets is now ready to use.
51 You should now be able to open %OPALDIR%/opal_samples.sln and build OpenPhone. 
55 For Linux:
56 ----------
57   1.  Download the tar file, eg wxGTK-2.6.3.tar.gz
59   2.  Unpack it somewhere, you don't need to be root (yet)
61   3.  cd wxGTK-2.6.3
63   4.  Build wxWidgets. You can read the instructions in README-GTX.txt,
64       or, if you are too lazy and feel lucky, follow the salient bits
65       below (taken fromREADME-GTX.txt) which worked for me:
67   5.  mkdir build_gtk
69   6.  cd build_gtk
71   7.  ../configure --with-gtk=2
73   8.  make
75   9.  "su" and enter root password>
77   11. make install
79   12. ldconfig
81   13. wxWidgets is now ready to use.
83 You should now be able to go to $OPALDIR/samples/openphone and do "make opt".