Second Life Wiki - User contributions [en]

Compiling the viewer libraries (MSVS 2003)

2008-05-05T16:33:14Z

Zoltan Freundlich: /* Apache Portable Runtime */

{{CompileNav}}

This page supplements [[Compiling the viewer (MSVS2003)]].

In the source directory, there are several empty placeholder folders for libraries which the Second Life viewer relies upon. This section describes how to acquire the code, and how to install it. It is a good idea to install in order, as some libraries will rely on previous installs (ie, libcurl needs openssl and zlib).

= Boost =
* Download & extract [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041 Boost] source for win32.
* Copy the "boost_X_XX_X\boost" folder to "libraries\include\".
NOTE: the Boost Wiki says to use the Visual Studio command prompt instead of the regular command prompt.
* Run "boost_X_XX_X\tools\jam\build_dist.bat".
* Copy "boost_X_XX_X\tools\jam\src\bin.ntx86\bjam.exe" to "boost_X_XX_X\". [NOTE: found in stage directory, not src, in Boost 1.35.0]
* Using the command prompt, build the static libraries:
** cd boost_X_XX_X
** set PYTHON_ROOT=C:\Python23
** set PYTHON_VERSION=2.3
** bjam --toolset=msvc-7.1 stage
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt-gd.lib" to "\libraries\i686-win32\lib_debug\libboost_python-vc71-mt.lib"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-s.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-sgd.lib" to "\libraries\i686-win32\lib_debug\libboost_regex-vc71-mt-s.lib"

= Expat =
* Download and run [http://sourceforge.net/project/showfiles.php?group_id=10127 Expat Win32 Binary]
* copy "Expat-X.X.X\Source\lib\expat.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_release\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_debug\".

= ZLib =
* Download & extract [http://www.zlib.net/ Zlib]
* copy "zlibXXX\zlib.h" to "libraries\include\zlib\".
* copy "zlibXXX\zconf.h" to "libraries\include\zlib\".
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f win32/Makefile.msc
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_release\".
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_debug\".

= Apache Portable Runtime =
* Take out XML dependancies, move expat headers!!!!
* Download & extract [http://apr.apache.org/download.cgi apr, apr-util, and apr-iconv].
* For simplicity place all three in a parallel directory structure, and rename the directories: (NOTE: if you don't rename from apr-X.X.X to simply apr, you won't be able to open the aprutil.dsw solution.)
** C:\work\apr\
** C:\work\apr-iconv\
** C:\work\apr-util\
* Open the "\apr-util\aprutil.dsw" project in VS2003.
* For the apr, apr-util & apr-iconv projects, change the Runtime Library from Multi-threaded DLL to Multi-threaded:
** Right click each project in the Solution Explorer, choose properties.
** In the C/C++ folder, choose Code Generation.
** Change the Runtime Library to Muli-threaded.
** Repeat for both debug and release.
* Remove the apr-util's dependency on xml:
** Right click the apr-util project, and choose dependencies.
** Uncheck xml.
** Right click the xml project in the Solution Explorer.
** Choose Remove.
* copy "Expat-X.X.X\Source\lib\expat.h" to "apr\apr-util\xml".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "apr\apr-util\xml\".
* Build Solution for Debug, and build solution for release.
* copy "\apr-util\LibR\aprutil-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibR\aprutil_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibD\aprutil-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr-util\LibD\aprutil_src.pdb" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr_src.pdb" to "libraries\i686-win32\lib_debug".
* copy header files:
** copy the contents of "apr\include" to "libraries\i686-win32\include\apr-1".
** in "libraries\i686-win32\include\apr-1\arch\" only the "win32" dir and "apr_private_common.h" are required.
** copy the contents of "apr-util\include" to "libraries\i686-win32\include\apr-1".

= Freetype =
* Download and run [http://gnuwin32.sourceforge.net/packages/freetype.htm FreeType for Windows].
* copy the contents of "GnuWin32\include\freetype2\freetype" into "\libraries\include\freetype"
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_release".
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_debug".
* copy "GnuWin32\include\ft2build.h" to "libraries\include".

= OpenSSL =
* Download and extract: http://www.openssl.org/source/
* Using the command prompt, build the static libraries:
** cd %PATH%
** perl Configure VC-WIN32
** ms\do_masm
* Edit openssl-X.X.Xy\ms\nt.mak
** Change /MD to /MT in CFLAGS
* back in the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** nmake -f ms\nt.mak
** copy all the ".lib" files from "openssl-X.X.Xy\out32" to "libraries\i686-win32\lib_release"

= cURL =
* Download & extract the [http://curl.haxx.se/download.html curl source].
* Edit "curl-X.XX.X\lib\Makefile.vc6"
** Change OPENSSL_PATH to ../../../openssl-<version>
** Change the ZLIB_PATH to ../../../zlib-<version>/src
** Change RTLIB to /MT
** Change RTLIBD to /MTd
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %PATH%\lib\
** nmake /f Makefile.vc6 CFG=release-ssl-zlib
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_debug"
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_release"
** Copy all the header files in "curl-X.XX.X\include\curl" to "libraries\include\curl"

= XMLRPC-epi =

**Download and Extract [http://xmlrpc-epi.sourceforge.net/ xmlrpc-epi].
**Get the patch 1 & 3 from [[Patch_xmlrpc-epi]]
*Using cygwin:
$ tar xvzf xmlrpc-epi-0.51
$ cd xmlrpc-epi-0.51
$ patch -p1 < ../remove_iconv.patch
$ patch -p1 < ../excise_expat.patch
$ rm -rf expat
$ mkdir expat
$ cp $FOO expat
Where $FOO is either
/tmp/expat/include/* -- if you built expat recently
or ../../expat-1.95.8/src/lib/expat*.h -- if you haven't
in this later case you'll need to have CVS gotten the expat
lib, and expanded it's src.tar.gz file there
*Copy over the Visual Studio files:
$ cp ../src/xmlrpcepi.* .
*Open the xmlrpcepi.sln file and build

= Vorbis & Ogg =
* Download & extract [http://www.xiph.org/downloads/ libvorbis].
* Download & extract [http://www.xiph.org/downloads/ libogg].
* Build & copy libogg first:
** Open "libogg-X.X.X\win32\ogg_static.dsp" in visual studio.
** Build both debug and release solutions.
** Copy "libogg-X.X.X\include\ogg" into "libvorbis-X.X.X\include"
** Copy "libogg-X.X.X\include\ogg\ogg.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\include\ogg\os_types.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\win32\Static_Release\ogg_static.lib" to "libraries\i686-win32\lib_release"
** Copy "libogg-X.X.X\win32\Static_Debug\ogg_static_d.lib" to "libraries\i686-win32\lib_debug\ogg_static.lib"
* Build & copy libvorbis:
** Build release & debug "libvorbis-X.X.X\win32\vorbis_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisfile_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisenc_static.dsp"
** copy "libvorbis-X.X.X\include\vorbis\codec.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisfile.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisenc.h" to "libraries\include\vorbis"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Release\vorbis_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Release\vorbisenc_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Release\vorbisfile_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Debug\vorbis_static_d.lib" to "libraries\i686-win32\lib_debug\vorbis_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Debug\vorbisenc_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisenc_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Debug\vorbisfile_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisfile_static.lib"

= JPEGlib =
* Download & extract [http://www.ijg.org/ jpeglib] - download the file 'jpegsrc.v6b.tar.gz'.
* Copy "jpegsr6\jpeg-6b\makefile.vc" to the file "jpegsr6\jpeg-6b\Makefile"
* Copy "jpegsr6\jpeg-6b\jconfig.vc" to "jpegsr6\jpeg-6b\jconfig.h"
* At the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f Makefile
* copy "jconfig.h", "jerror.h", "jmorecfg.h", "jpeglib.h", and "jinclude.h" from * to "libraries\include\jpeglib"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_release"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_debug"
* [[Patch jpeglib]]

= OpenJPEG =
* Download and extract [http://www.openjpeg.org/index.php?menu=download openjpeg for win32].
* Copy "openjpeg10_win32\openjpeg.h" to ""\libraries\include\openjpeg"
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_release".
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_debug".

= TUT =
* Download and extract [http://tut-framework.sourceforge.net/download/ tut]
* [[Patch TUT]] to add test skipping.
* Copy "tut.h", "tut_reporter.h", and "tut_restartable.h" to "libraries\include\tut"

= LLMozLib =
These instructions describe how to build the Windows version of LLMozLib for use within the Second Life client. They have been tested using Microsoft Visual Studio 7.1 - apparently, things do work with other versions of the Microsoft compiler but they have not been tried or tested.

LLMozLib currently uses code from the 1.8.0 branch of the Mozilla codebase - similar to what is used in Firefox 1.5. At some point in the future we will switch to the 1.8.1 branch - the one used to build Firefox 2.0.

Get our snapshot llmozlib from the [[source downloads]] page.

The steps required to generate LLMozLib and associated run-time files are:

* Set up your environment for building the Mozilla source code. (these instructions are specific to the Mozilla branch we are using - building the trunk is different)

http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites_on_the_1.7_and_1.8_Branches

* Checkout the Mozilla source code from their CVS repository. Let's assume you are using the <code>c:\mozilla</code> directory to build in.
c:
cd \
export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
cvs login (the password is 'anonymous')
cvs checkout -r FIREFOX_1_5_0_9_RELEASE mozilla/client.mk
cd c:\mozilla
make -f client.mk checkout MOZ_CO_PROJECT=xulrunner

:; Note : the CVS tag will change as Mozilla release updates. Version 1.5.0.9 is current as of writing.

* Apply a patch which enables certain features that are required for the Second Life client.

:The patch can be found in the llmozlib <code>build_mozilla</code> directory.

:Copy the patch into the directory where you are building Mozilla and apply the patch:

patch -p0 < linden_updates.patch

* Build optimized (release) and debug versions of a XULRunner configuration of the Mozilla codebase.

:The <code>build_mozilla</code> directory contains 2 Mozilla configuration files - one for a debug build and one for an optimized build.

:Copy both files into the directory where you are building Mozilla and then:

copy .mozconfig.debug .mozconfig
make -f client.mk build

copy .mozconfig.optimized .mozconfig
make -f client.mk build

* Copy a subset of the header files and libraries you built into the LLMozLib tree

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Mozilla source directory is different.

copy_products_windows.bat

* Build LLMozLib using Microsoft Visual Studio 7.1

:Open the LLMozLib solution file <code>llmozlib.sln</code>.

:Build the Debug and Release configurations in the normal fashion.

* Copy the LLMozLib files to the Second Life client branch

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Second Life client directory is different.

copy_llmozlib_to_branch.bat

* That completes the LLMozLib build - the files that are copied (relative to the Second Life client directory) are:

Header file (llmozlib.h) in libraries\include\

Static library (llmozlib.lib) (debug) in libraries\i686-win32\lib_debug\
Static library (llmozlib.lib) (release) in libraries\i686-win32\lib_release\

Runtime DLLs (debug) in libraries\i686-win32\lib_debug\
Runtime DLLs (release) in libraries\i686-win32\lib_release\

Runtime misc files (debug) in indra\newview\app_settings\mozilla_debug\
Runtime misc files (release) in indra\newview\app_settings\mozilla_release\

Compiling the viewer libraries (MSVS 2003)

2008-05-05T15:49:24Z

Zoltan Freundlich: /* Boost */

{{CompileNav}}

This page supplements [[Compiling the viewer (MSVS2003)]].

In the source directory, there are several empty placeholder folders for libraries which the Second Life viewer relies upon. This section describes how to acquire the code, and how to install it. It is a good idea to install in order, as some libraries will rely on previous installs (ie, libcurl needs openssl and zlib).

= Boost =
* Download & extract [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041 Boost] source for win32.
* Copy the "boost_X_XX_X\boost" folder to "libraries\include\".
NOTE: the Boost Wiki says to use the Visual Studio command prompt instead of the regular command prompt.
* Run "boost_X_XX_X\tools\jam\build_dist.bat".
* Copy "boost_X_XX_X\tools\jam\src\bin.ntx86\bjam.exe" to "boost_X_XX_X\". [NOTE: found in stage directory, not src, in Boost 1.35.0]
* Using the command prompt, build the static libraries:
** cd boost_X_XX_X
** set PYTHON_ROOT=C:\Python23
** set PYTHON_VERSION=2.3
** bjam --toolset=msvc-7.1 stage
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt-gd.lib" to "\libraries\i686-win32\lib_debug\libboost_python-vc71-mt.lib"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-s.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-sgd.lib" to "\libraries\i686-win32\lib_debug\libboost_regex-vc71-mt-s.lib"

= Expat =
* Download and run [http://sourceforge.net/project/showfiles.php?group_id=10127 Expat Win32 Binary]
* copy "Expat-X.X.X\Source\lib\expat.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_release\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_debug\".

= ZLib =
* Download & extract [http://www.zlib.net/ Zlib]
* copy "zlibXXX\zlib.h" to "libraries\include\zlib\".
* copy "zlibXXX\zconf.h" to "libraries\include\zlib\".
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f win32/Makefile.msc
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_release\".
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_debug\".

= Apache Portable Runtime =
* Take out XML dependancies, move expat headers!!!!
* Download & extract [http://apr.apache.org/download.cgi apr, apr-util, and apr-iconv].
* For simplicity place all three in a parallel directory structure, and rename the directories:
** C:\work\apr\
** C:\work\apr-iconv\
** C:\work\apr-util\
* Open the "\apr-util\aprutil.dsw" project in VS2003.
* For the apr, apr-util & apr-iconv projects, change the Runtime Library from Multi-threaded DLL to Multi-threaded:
** Right click each project in the Solution Explorer, choose properties.
** In the C/C++ folder, choose Code Generation.
** Change the Runtime Library to Muli-threaded.
** Repeat for both debug and release.
* Remove the apr-util's dependency on xml:
** Right click the apr-util project, and choose dependencies.
** Uncheck xml.
** Right click the xml project in the Solution Explorer.
** Choose Remove.
* copy "Expat-X.X.X\Source\lib\expat.h" to "apr\apr-util\xml".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "apr\apr-util\xml\".
* Build Solution for Debug, and build solution for release.
* copy "\apr-util\LibR\aprutil-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibR\aprutil_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibD\aprutil-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr-util\LibD\aprutil_src.pdb" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr_src.pdb" to "libraries\i686-win32\lib_debug".
* copy header files:
** copy the contents of "apr\include" to "libraries\i686-win32\include\apr-1".
** in "libraries\i686-win32\include\apr-1\arch\" only the "win32" dir and "apr_private_common.h" are required.
** copy the contents of "apr-util\include" to "libraries\i686-win32\include\apr-1".

= Freetype =
* Download and run [http://gnuwin32.sourceforge.net/packages/freetype.htm FreeType for Windows].
* copy the contents of "GnuWin32\include\freetype2\freetype" into "\libraries\include\freetype"
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_release".
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_debug".
* copy "GnuWin32\include\ft2build.h" to "libraries\include".

= OpenSSL =
* Download and extract: http://www.openssl.org/source/
* Using the command prompt, build the static libraries:
** cd %PATH%
** perl Configure VC-WIN32
** ms\do_masm
* Edit openssl-X.X.Xy\ms\nt.mak
** Change /MD to /MT in CFLAGS
* back in the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** nmake -f ms\nt.mak
** copy all the ".lib" files from "openssl-X.X.Xy\out32" to "libraries\i686-win32\lib_release"

= cURL =
* Download & extract the [http://curl.haxx.se/download.html curl source].
* Edit "curl-X.XX.X\lib\Makefile.vc6"
** Change OPENSSL_PATH to ../../../openssl-<version>
** Change the ZLIB_PATH to ../../../zlib-<version>/src
** Change RTLIB to /MT
** Change RTLIBD to /MTd
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %PATH%\lib\
** nmake /f Makefile.vc6 CFG=release-ssl-zlib
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_debug"
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_release"
** Copy all the header files in "curl-X.XX.X\include\curl" to "libraries\include\curl"

= XMLRPC-epi =

**Download and Extract [http://xmlrpc-epi.sourceforge.net/ xmlrpc-epi].
**Get the patch 1 & 3 from [[Patch_xmlrpc-epi]]
*Using cygwin:
$ tar xvzf xmlrpc-epi-0.51
$ cd xmlrpc-epi-0.51
$ patch -p1 < ../remove_iconv.patch
$ patch -p1 < ../excise_expat.patch
$ rm -rf expat
$ mkdir expat
$ cp $FOO expat
Where $FOO is either
/tmp/expat/include/* -- if you built expat recently
or ../../expat-1.95.8/src/lib/expat*.h -- if you haven't
in this later case you'll need to have CVS gotten the expat
lib, and expanded it's src.tar.gz file there
*Copy over the Visual Studio files:
$ cp ../src/xmlrpcepi.* .
*Open the xmlrpcepi.sln file and build

= Vorbis & Ogg =
* Download & extract [http://www.xiph.org/downloads/ libvorbis].
* Download & extract [http://www.xiph.org/downloads/ libogg].
* Build & copy libogg first:
** Open "libogg-X.X.X\win32\ogg_static.dsp" in visual studio.
** Build both debug and release solutions.
** Copy "libogg-X.X.X\include\ogg" into "libvorbis-X.X.X\include"
** Copy "libogg-X.X.X\include\ogg\ogg.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\include\ogg\os_types.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\win32\Static_Release\ogg_static.lib" to "libraries\i686-win32\lib_release"
** Copy "libogg-X.X.X\win32\Static_Debug\ogg_static_d.lib" to "libraries\i686-win32\lib_debug\ogg_static.lib"
* Build & copy libvorbis:
** Build release & debug "libvorbis-X.X.X\win32\vorbis_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisfile_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisenc_static.dsp"
** copy "libvorbis-X.X.X\include\vorbis\codec.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisfile.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisenc.h" to "libraries\include\vorbis"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Release\vorbis_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Release\vorbisenc_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Release\vorbisfile_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Debug\vorbis_static_d.lib" to "libraries\i686-win32\lib_debug\vorbis_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Debug\vorbisenc_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisenc_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Debug\vorbisfile_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisfile_static.lib"

= JPEGlib =
* Download & extract [http://www.ijg.org/ jpeglib] - download the file 'jpegsrc.v6b.tar.gz'.
* Copy "jpegsr6\jpeg-6b\makefile.vc" to the file "jpegsr6\jpeg-6b\Makefile"
* Copy "jpegsr6\jpeg-6b\jconfig.vc" to "jpegsr6\jpeg-6b\jconfig.h"
* At the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f Makefile
* copy "jconfig.h", "jerror.h", "jmorecfg.h", "jpeglib.h", and "jinclude.h" from * to "libraries\include\jpeglib"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_release"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_debug"
* [[Patch jpeglib]]

= OpenJPEG =
* Download and extract [http://www.openjpeg.org/index.php?menu=download openjpeg for win32].
* Copy "openjpeg10_win32\openjpeg.h" to ""\libraries\include\openjpeg"
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_release".
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_debug".

= TUT =
* Download and extract [http://tut-framework.sourceforge.net/download/ tut]
* [[Patch TUT]] to add test skipping.
* Copy "tut.h", "tut_reporter.h", and "tut_restartable.h" to "libraries\include\tut"

= LLMozLib =
These instructions describe how to build the Windows version of LLMozLib for use within the Second Life client. They have been tested using Microsoft Visual Studio 7.1 - apparently, things do work with other versions of the Microsoft compiler but they have not been tried or tested.

LLMozLib currently uses code from the 1.8.0 branch of the Mozilla codebase - similar to what is used in Firefox 1.5. At some point in the future we will switch to the 1.8.1 branch - the one used to build Firefox 2.0.

Get our snapshot llmozlib from the [[source downloads]] page.

The steps required to generate LLMozLib and associated run-time files are:

* Set up your environment for building the Mozilla source code. (these instructions are specific to the Mozilla branch we are using - building the trunk is different)

http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites_on_the_1.7_and_1.8_Branches

* Checkout the Mozilla source code from their CVS repository. Let's assume you are using the <code>c:\mozilla</code> directory to build in.
c:
cd \
export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
cvs login (the password is 'anonymous')
cvs checkout -r FIREFOX_1_5_0_9_RELEASE mozilla/client.mk
cd c:\mozilla
make -f client.mk checkout MOZ_CO_PROJECT=xulrunner

:; Note : the CVS tag will change as Mozilla release updates. Version 1.5.0.9 is current as of writing.

* Apply a patch which enables certain features that are required for the Second Life client.

:The patch can be found in the llmozlib <code>build_mozilla</code> directory.

:Copy the patch into the directory where you are building Mozilla and apply the patch:

patch -p0 < linden_updates.patch

* Build optimized (release) and debug versions of a XULRunner configuration of the Mozilla codebase.

:The <code>build_mozilla</code> directory contains 2 Mozilla configuration files - one for a debug build and one for an optimized build.

:Copy both files into the directory where you are building Mozilla and then:

copy .mozconfig.debug .mozconfig
make -f client.mk build

copy .mozconfig.optimized .mozconfig
make -f client.mk build

* Copy a subset of the header files and libraries you built into the LLMozLib tree

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Mozilla source directory is different.

copy_products_windows.bat

* Build LLMozLib using Microsoft Visual Studio 7.1

:Open the LLMozLib solution file <code>llmozlib.sln</code>.

:Build the Debug and Release configurations in the normal fashion.

* Copy the LLMozLib files to the Second Life client branch

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Second Life client directory is different.

copy_llmozlib_to_branch.bat

* That completes the LLMozLib build - the files that are copied (relative to the Second Life client directory) are:

Header file (llmozlib.h) in libraries\include\

Static library (llmozlib.lib) (debug) in libraries\i686-win32\lib_debug\
Static library (llmozlib.lib) (release) in libraries\i686-win32\lib_release\

Runtime DLLs (debug) in libraries\i686-win32\lib_debug\
Runtime DLLs (release) in libraries\i686-win32\lib_release\

Runtime misc files (debug) in indra\newview\app_settings\mozilla_debug\
Runtime misc files (release) in indra\newview\app_settings\mozilla_release\

Compiling the viewer libraries (MSVS 2003)

2008-05-05T15:40:47Z

Zoltan Freundlich: /* Boost */

{{CompileNav}}

This page supplements [[Compiling the viewer (MSVS2003)]].

In the source directory, there are several empty placeholder folders for libraries which the Second Life viewer relies upon. This section describes how to acquire the code, and how to install it. It is a good idea to install in order, as some libraries will rely on previous installs (ie, libcurl needs openssl and zlib).

= Boost =
* Download & extract [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041 Boost] source for win32.
* Copy the "boost_X_XX_X\boost" folder to "libraries\include\".
* Run "Run "boost_X_XX_X\tools\jam\build_dist.bat".
* Copy "boost_X_XX_X\tools\jam\src\bin.ntx86\bjam.exe" to "boost_X_XX_X\". [NOTE: found in stage directory, not src, in Boost 1.35.0]
* Using the command prompt, build the static libraries:
** cd boost_X_XX_X
** set PYTHON_ROOT=C:\Python23
** set PYTHON_VERSION=2.3
** bjam --toolset=msvc-7.1 stage
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_python-vc71-mt-gd.lib" to "\libraries\i686-win32\lib_debug\libboost_python-vc71-mt.lib"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-s.lib" to "\libraries\i686-win32\lib_release\"
* copy "boost_X_XX_X\stage\lib\libboost_regex-vc71-mt-sgd.lib" to "\libraries\i686-win32\lib_debug\libboost_regex-vc71-mt-s.lib"

= Expat =
* Download and run [http://sourceforge.net/project/showfiles.php?group_id=10127 Expat Win32 Binary]
* copy "Expat-X.X.X\Source\lib\expat.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "libraries\include\expat\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_release\".
* copy "Expat-X.X.X\StaticLibs\libexpatMT.lib" to "libraries\i686-win32\lib_debug\".

= ZLib =
* Download & extract [http://www.zlib.net/ Zlib]
* copy "zlibXXX\zlib.h" to "libraries\include\zlib\".
* copy "zlibXXX\zconf.h" to "libraries\include\zlib\".
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f win32/Makefile.msc
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_release\".
* copy "zlibXXX\zlib.lib" to "libraries\i686-win32\lib_debug\".

= Apache Portable Runtime =
* Take out XML dependancies, move expat headers!!!!
* Download & extract [http://apr.apache.org/download.cgi apr, apr-util, and apr-iconv].
* For simplicity place all three in a parallel directory structure, and rename the directories:
** C:\work\apr\
** C:\work\apr-iconv\
** C:\work\apr-util\
* Open the "\apr-util\aprutil.dsw" project in VS2003.
* For the apr, apr-util & apr-iconv projects, change the Runtime Library from Multi-threaded DLL to Multi-threaded:
** Right click each project in the Solution Explorer, choose properties.
** In the C/C++ folder, choose Code Generation.
** Change the Runtime Library to Muli-threaded.
** Repeat for both debug and release.
* Remove the apr-util's dependency on xml:
** Right click the apr-util project, and choose dependencies.
** Uncheck xml.
** Right click the xml project in the Solution Explorer.
** Choose Remove.
* copy "Expat-X.X.X\Source\lib\expat.h" to "apr\apr-util\xml".
* copy "Expat-X.X.X\Source\lib\expat_external.h" to "apr\apr-util\xml\".
* Build Solution for Debug, and build solution for release.
* copy "\apr-util\LibR\aprutil-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibR\aprutil_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr-1.lib" to "libraries\i686-win32\lib_release".
* copy "\apr\LibR\apr_src.pdb" to "libraries\i686-win32\lib_release".
* copy "\apr-util\LibD\aprutil-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr-util\LibD\aprutil_src.pdb" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr-1.lib" to "libraries\i686-win32\lib_debug".
* copy "\apr\LibD\apr_src.pdb" to "libraries\i686-win32\lib_debug".
* copy header files:
** copy the contents of "apr\include" to "libraries\i686-win32\include\apr-1".
** in "libraries\i686-win32\include\apr-1\arch\" only the "win32" dir and "apr_private_common.h" are required.
** copy the contents of "apr-util\include" to "libraries\i686-win32\include\apr-1".

= Freetype =
* Download and run [http://gnuwin32.sourceforge.net/packages/freetype.htm FreeType for Windows].
* copy the contents of "GnuWin32\include\freetype2\freetype" into "\libraries\include\freetype"
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_release".
* copy "GnuWin32\lib\freetype.lib" to "libraries\i686-win32\lib_debug".
* copy "GnuWin32\include\ft2build.h" to "libraries\include".

= OpenSSL =
* Download and extract: http://www.openssl.org/source/
* Using the command prompt, build the static libraries:
** cd %PATH%
** perl Configure VC-WIN32
** ms\do_masm
* Edit openssl-X.X.Xy\ms\nt.mak
** Change /MD to /MT in CFLAGS
* back in the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** nmake -f ms\nt.mak
** copy all the ".lib" files from "openssl-X.X.Xy\out32" to "libraries\i686-win32\lib_release"

= cURL =
* Download & extract the [http://curl.haxx.se/download.html curl source].
* Edit "curl-X.XX.X\lib\Makefile.vc6"
** Change OPENSSL_PATH to ../../../openssl-<version>
** Change the ZLIB_PATH to ../../../zlib-<version>/src
** Change RTLIB to /MT
** Change RTLIBD to /MTd
* Using the command prompt, build the static libraries:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %PATH%\lib\
** nmake /f Makefile.vc6 CFG=release-ssl-zlib
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_debug"
** Copy "curl-X.XX.X\lib\release-ssl-zlib\libcurl.lib" to "libraries\i686-win32\lib_release"
** Copy all the header files in "curl-X.XX.X\include\curl" to "libraries\include\curl"

= XMLRPC-epi =

**Download and Extract [http://xmlrpc-epi.sourceforge.net/ xmlrpc-epi].
**Get the patch 1 & 3 from [[Patch_xmlrpc-epi]]
*Using cygwin:
$ tar xvzf xmlrpc-epi-0.51
$ cd xmlrpc-epi-0.51
$ patch -p1 < ../remove_iconv.patch
$ patch -p1 < ../excise_expat.patch
$ rm -rf expat
$ mkdir expat
$ cp $FOO expat
Where $FOO is either
/tmp/expat/include/* -- if you built expat recently
or ../../expat-1.95.8/src/lib/expat*.h -- if you haven't
in this later case you'll need to have CVS gotten the expat
lib, and expanded it's src.tar.gz file there
*Copy over the Visual Studio files:
$ cp ../src/xmlrpcepi.* .
*Open the xmlrpcepi.sln file and build

= Vorbis & Ogg =
* Download & extract [http://www.xiph.org/downloads/ libvorbis].
* Download & extract [http://www.xiph.org/downloads/ libogg].
* Build & copy libogg first:
** Open "libogg-X.X.X\win32\ogg_static.dsp" in visual studio.
** Build both debug and release solutions.
** Copy "libogg-X.X.X\include\ogg" into "libvorbis-X.X.X\include"
** Copy "libogg-X.X.X\include\ogg\ogg.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\include\ogg\os_types.h" to "libraries\include\ogg"
** Copy "libogg-X.X.X\win32\Static_Release\ogg_static.lib" to "libraries\i686-win32\lib_release"
** Copy "libogg-X.X.X\win32\Static_Debug\ogg_static_d.lib" to "libraries\i686-win32\lib_debug\ogg_static.lib"
* Build & copy libvorbis:
** Build release & debug "libvorbis-X.X.X\win32\vorbis_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisfile_static.dsp"
** Build release & debug "libvorbis-X.X.X\win32\vorbisenc_static.dsp"
** copy "libvorbis-X.X.X\include\vorbis\codec.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisfile.h" to "libraries\include\vorbis"
** copy "libvorbis-X.X.X\include\vorbis\vorbisenc.h" to "libraries\include\vorbis"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Release\vorbis_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Release\vorbisenc_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Release\vorbisfile_static.lib" to "libraries\i686-win32\lib_release"
** copy "libvorbis-1.1.2\win32\Vorbis_Static_Debug\vorbis_static_d.lib" to "libraries\i686-win32\lib_debug\vorbis_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisEnc_Static_Debug\vorbisenc_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisenc_static.lib"
** copy "libvorbis-1.1.2\win32\VorbisFile_Static_Debug\vorbisfile_static_d.lib" to "libraries\i686-win32\lib_debug\vorbisfile_static.lib"

= JPEGlib =
* Download & extract [http://www.ijg.org/ jpeglib] - download the file 'jpegsrc.v6b.tar.gz'.
* Copy "jpegsr6\jpeg-6b\makefile.vc" to the file "jpegsr6\jpeg-6b\Makefile"
* Copy "jpegsr6\jpeg-6b\jconfig.vc" to "jpegsr6\jpeg-6b\jconfig.h"
* At the command prompt:
** "C:\Program Files\Microsoft Visual Studio .net 2003\Common7\Tools\vsvars32.bat"
** cd %ZLIB_FOLDER%
** nmake -f Makefile
* copy "jconfig.h", "jerror.h", "jmorecfg.h", "jpeglib.h", and "jinclude.h" from * to "libraries\include\jpeglib"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_release"
* copy "jpegsr6\jpeg-6b\libjpeg.lib" to "libraries\i686-win32\lib_debug"
* [[Patch jpeglib]]

= OpenJPEG =
* Download and extract [http://www.openjpeg.org/index.php?menu=download openjpeg for win32].
* Copy "openjpeg10_win32\openjpeg.h" to ""\libraries\include\openjpeg"
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_release".
* Copy "openjpeg10_win32\LibOpenJPEG.lib" to "\libraries\i686-win32\lib_debug".

= TUT =
* Download and extract [http://tut-framework.sourceforge.net/download/ tut]
* [[Patch TUT]] to add test skipping.
* Copy "tut.h", "tut_reporter.h", and "tut_restartable.h" to "libraries\include\tut"

= LLMozLib =
These instructions describe how to build the Windows version of LLMozLib for use within the Second Life client. They have been tested using Microsoft Visual Studio 7.1 - apparently, things do work with other versions of the Microsoft compiler but they have not been tried or tested.

LLMozLib currently uses code from the 1.8.0 branch of the Mozilla codebase - similar to what is used in Firefox 1.5. At some point in the future we will switch to the 1.8.1 branch - the one used to build Firefox 2.0.

Get our snapshot llmozlib from the [[source downloads]] page.

The steps required to generate LLMozLib and associated run-time files are:

* Set up your environment for building the Mozilla source code. (these instructions are specific to the Mozilla branch we are using - building the trunk is different)

http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites_on_the_1.7_and_1.8_Branches

* Checkout the Mozilla source code from their CVS repository. Let's assume you are using the <code>c:\mozilla</code> directory to build in.
c:
cd \
export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
cvs login (the password is 'anonymous')
cvs checkout -r FIREFOX_1_5_0_9_RELEASE mozilla/client.mk
cd c:\mozilla
make -f client.mk checkout MOZ_CO_PROJECT=xulrunner

:; Note : the CVS tag will change as Mozilla release updates. Version 1.5.0.9 is current as of writing.

* Apply a patch which enables certain features that are required for the Second Life client.

:The patch can be found in the llmozlib <code>build_mozilla</code> directory.

:Copy the patch into the directory where you are building Mozilla and apply the patch:

patch -p0 < linden_updates.patch

* Build optimized (release) and debug versions of a XULRunner configuration of the Mozilla codebase.

:The <code>build_mozilla</code> directory contains 2 Mozilla configuration files - one for a debug build and one for an optimized build.

:Copy both files into the directory where you are building Mozilla and then:

copy .mozconfig.debug .mozconfig
make -f client.mk build

copy .mozconfig.optimized .mozconfig
make -f client.mk build

* Copy a subset of the header files and libraries you built into the LLMozLib tree

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Mozilla source directory is different.

copy_products_windows.bat

* Build LLMozLib using Microsoft Visual Studio 7.1

:Open the LLMozLib solution file <code>llmozlib.sln</code>.

:Build the Debug and Release configurations in the normal fashion.

* Copy the LLMozLib files to the Second Life client branch

:There is a batch file in the LLMozLib directory to help you.

:You may need to edit the paths at the top if your Second Life client directory is different.

copy_llmozlib_to_branch.bat

* That completes the LLMozLib build - the files that are copied (relative to the Second Life client directory) are:

Header file (llmozlib.h) in libraries\include\

Static library (llmozlib.lib) (debug) in libraries\i686-win32\lib_debug\
Static library (llmozlib.lib) (release) in libraries\i686-win32\lib_release\

Runtime DLLs (debug) in libraries\i686-win32\lib_debug\
Runtime DLLs (release) in libraries\i686-win32\lib_release\

Runtime misc files (debug) in indra\newview\app_settings\mozilla_debug\
Runtime misc files (release) in indra\newview\app_settings\mozilla_release\

Common compilation problems

2008-05-04T16:08:48Z

Zoltan Freundlich: /* Cannot open include file: 'windows.h' */

{{CompileNav}}

= General Problems =

* Make sure you download not only the source, but the artwork zipfile, and the appropriate zipfile/tarball of libraries for your platform

= Windows =

== Unresolved external symbol _CLSID_DxDiagProvider/_IID_IDxDiagProvider ==
* ''newview error LNK2001: unresolved external symbol _CLSID_DxDiagProvider''
* ''newview error LNK2001: unresolved external symbol _IID_IDxDiagProvider''

These errors reportedly occur with MSVC 2003 and certain versions of the DirectX SDK. To workaround, edit lldxhardware.cpp and replace the following (line 35):

#include <dxdiag.h>
with...
#define INITGUID
#include <dxdiag.h>
#undef INITGUID

== Cannot open input file 'dxguid.lib' ==
* ''fatal error LNK1181: cannot open input file 'dxguid.lib' in ...''

If you are using a fairly recent DirectX SDK ("December 2006" or newer), your VC++ Libraries Directory may be wrong because the SDK's lib folder now has 2 sub-folders for x64 and x86. Try changing the path from ''C:\Program Files\Microsoft DirectX SDK (December 2006)\Lib'' to ''C:\Program Files\Microsoft DirectX SDK (December 2006)\'' '''Lib\x86'''
 
 
== Cannot open input file 'dxerr8.lib' ==
* ''fatal error LNK1104: cannot open file 'dxerr8.lib'''

If you are using the most recent DirectX SDK ("November 2007"), the file dxerr8.lib does no longer exist. To fix this, you'll need to change the newview project to include 'dxerr9.lib' instead. To do this, right-lick newview > Configuration Properties > Linker > Input, click Additional Dependencies on the right to show a button labeled "..." on it at the very right on the line, then click the ... button. Scroll down the list to find 'dxerr8.lib'. Rewrite it to 'dxerr9.lib'. Remember to do this for both the ReleaseForDownload and the ReleaseNoOpt Configurations.
 
 

== A tool returned an error code from "Building ytab.cpp" ==
* ''lscript_compile_fb error PRJ0019: A tool returned an error code from "Building ytab.cpp" ''

One possible reason for this is that Visual Studio does not know where cygwin/bin is, especially if this is accompanied by an error relating to bison.exe being an invalid command. Even if the directory for cygwin is in the environment variable PATH, Visual Studio maintains its own separate copy which does not seem to be automatically synchronized after the initial installation.

For Visual Studio .NET 2003, go to Tools > Options > Projects > VC++ Directories. In the "show directories for" dropdown, choose "Executable files". Make sure that your cygwin (default C:\cygwin\bin) and ActivePython (default C:\Python25) directories are listed.

== Cannot open include file: 'ytab.h': No such file or directory ==
* ''indra.l (20) : fatal error C1083: Cannot open include file: 'ytab.h': No such file or directory.''
Workaround: Manually copy "linden\indra\lscript\lscript_compile\ytab.hpp" to "linden\indra\lscript\lscript_compile\ytab.h" and build again.

Note: The underlying issue is that in indra.y there is a postbuild step which should do this automatically, but which is missing in some configurations (e.g. in Debug builds).
 
 
== Cannot open include file: 'png.h': No such file or directory ==
* ''imagepng.cpp : fatal error C1083: Cannot open include file: 'libpng12/png.h': No such file or directory.''
There are a couple of files missing since the 1.17. distribution. You can either get the missing files from the internet (from the libpng and zlib projects) or download a set with just the missing files from [http://www.blueflash.cc/users/nicholaz/~libs here] (see the readme.txt inside the png archive there).
 
 
== Cannot open include file: 'glh/glh_linear.h' or 'glh/glh_convenience.h' ==
These files are currently missing from Linden Windlight distributions. See [https://jira.secondlife.com/browse/VWR-3415 JIRA VWR-3415] or grab a copy from [http://www.blueflash.cc/users/nicholaz/~libs here] and put the files into a folder named linden/libraries/include/glh.
 
[[LearCale]] -- as of 1.19, these appear to need to be in linden/libraries/include/GL .
 
 

== Errors relating to "template_verifier.py" ==
With version 1.18 a template verifier script written in Python is used to ensure the message template is correct. In some distributions the file was missing. You will also get an error if you have skipped the Python install. In both cases it is safe to hack the prebuild.bat file in the newview folder as described on the JIRA [http://jira.secondlife.com/browse/VWR-1267 VWR-1267]
 
 

== Missing resources ==
* ''.\res\newViewRes.rc(64) : error RC2135 : file not found: ll_icon.ico''
Some releases have missing files, which were reported to be last seen in the '''1.14.0.1''' release.
* Go to the [[source downloads]] page and grab the [[http://secondlife.com/developers/opensource/downloads/2007/04/slviewer-src-1.14.0.1.zip '''1.14.0.1''' viewer]] sources.
* Explore the archive to "linden/indra/newview/res" folder and extract content to your "linden/indra/newview/res" folder into current revision.
Missing folder in recent release, "'''1.17.0.12'''" which causes the SecondLife to hang while loading into the world.
* Go to the previous source and copy the missing folder, "Character" and place it into the "newview" folder
 
== Error code from "Copying message template" ==
* ''newview error PRJ0019: A tool returned an error code from "Copying message template"''
This is caused by the script trying to do a copy command, but the source path isn't in quotes. Open up newview.vcproj in notepad, and near the bottom there are 4 line that say:
CommandLine="copy $(InputPath) .\app_settings\message_template.msg
replace them with
CommandLine="copy &quot;$(InputPath)&quot; .\app_settings\message_template.msg
The source and destination paths on line 158 may also require wrapping in quotes. In which case:
CommandLine="copy $(TargetDir)\$(TargetFileName) $(ProjectDir)
should become:
CommandLine="copy &quot;$(TargetDir)\$(TargetFileName)&quot; &quot;$(ProjectDir)&quot;
 
== Can not find library ll*.lib ==
If you get a compile error for missing libraries with names of the projects (lscript_compile.lib, llaudio.lib, llcharacter.lib, etc.) go to newview > Properties > Linker > Input and remove these from the list of input libraries (they will be linked through the dependencies and should not be in the list).
 
 
== Cannot open include file: 'windows.h' ==
If you run into this problem:
..\..\..\boost/regex/v4/fileiter.hpp(44) : fatal error C1083: Cannot open include file: 'windows.h': No such file or directory
Fix it with this: (thanks Fairlight!)
set INCLUDE=C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include;%INCLUDE%
set LIB=C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Lib;%LIB%
You might need to edit the above path to refer to your particular platform SDK. If you don't have the Microsoft Windows Platform SDK installed, then you can download it for free from Microsoft. It is version specific and can be tricky to find on their website.

If you're having problems with windows.h in Visual Studio Express 2005, check out this forum post:
[http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=1995837&SiteID=1 MSDN Forum Post]

 

== Unresolved external symbol "int __cdecl lscript_compile" (VS2005) ==
* ''llcompilequeue.obj : error LNK2019: unresolved external symbol "int __cdecl lscript_compile(char const *,char const *,char const *,int)" (?lscript_compile@@YAHPBD00H@Z) referenced in function "protected: void __thiscall LLFloaterCompileQueue::compile(char const *,class LLUUID const &)" (?compile@LLFloaterCompileQueue@@IAEXPBDABVLLUUID@@@Z)''
* ''llpreviewscript.obj : error LNK2001: unresolved external symbol "int __cdecl lscript_compile(char const *,char const *,char const *,int)" (?lscript_compile@@YAHPBD00H@Z)''

This is not entirely clear, but there seems to be a problem with VS2005 if projects are unloaded while being in the dependency tree. I have seen this error while I had win_crash_logger and win_updater unloaded from the project tree and the problem went away when I loaded them back and excluded them from the newview dependency first.

Also make sure that in newview, properties, linker, input, input libraries, no libraries named ll*.lib and lscript_compile.lib are listed there (remove them if you find them).
 
 

== Unresolved external symbol __invalid_parameter_noinfo (VS2005) ==
* ''llmozlib-vc80.lib(llembeddedbrowserwindow.obj) : error LNK2019: unresolved external symbol __invalid_parameter_noinfo referenced''

You are most likely trying a debug build under VS2005. For debug builds, see the compile instruction section on [[finding_leaks]]
 
 

== Cannot open include file: 'ares.h' ==
download src from http://daniel.haxx.se/projects/c-ares/

compile c-ares-1.4.0/vc/areslib

copy c-ares-1.4.0/vc/areslib/Release/areslib.lib to linden/libraries/i686-win32/lib_release and to lib_debug

copy c-ares-1.4.0/*.h to linden/libraries/i686-win32/include/ares
 
 

== Other (older) notes ==
* Mozilla is not compatible with visual studio 2005, so we have not migrated the codebase, so we do not know if it works.

* Added my errors at [[User:Adam_Zaius/MSVS2005 Errors]] [[User:Adam Zaius|Adam Zaius]] 09:40, 8 January 2007 (PST)

* To minimize the number of warnings for now: in C/C++-Preprocessor add ';_CRT_SECURE_NO_DEPRECATE' to the Preprocessor Definitions, that will supress deprecation warnings --[[User:Artm Udal|Artm Udal]] 12:42, 8 January 2007 (PST)

 

= Mac OS X =

Getting:

*/linden/indra/newview/../llwindow/llglheaders.h:377:31: error: GL/glh_extensions.h: No such file or directory
** This means you didn't [[Compiling the viewer (Mac OS X)#Viewer Source, Libraries, and Artwork|merge the libraries]] right.

 

= Linux =

==== Packaging errors ====

The final packaging step may fail with errors about the manifest if you are not using the slviewer-linux-libs bundle; in this case, if you still wish to end up with an end-user viewer package incorporating your own libraries, you can edit the manifest file found at indra/newview/viewer_manifest.py

==== Various Compilation problems ====
* g++-3.4 -o linux_crash_logger/linux-crash-logger-i686-bin-globalsyms --no-keep-memory --reduce-memory-overheads /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/llcrashlogger/llcrashlogger.o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/linux_crash_logger/linux_crash_logger.o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/linux_crash_logger/llcrashloggerlinux.o -Llib_release_client/i686-linux -L/home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client -lllui -lllxml -lllmessage -lllvfs -lllmath -lllcommon -lcurl -lssl -lcrypto -laprutil-1 -lapr-1 -lcares -lexpat -ldb-4.2 -lgtk-x11-2.0
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcurl.a when searching for -lcurl
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libssl.so when searching for -lssl
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcrypto.so when searching for -lcrypto
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libaprutil-1.so when searching for -laprutil-1
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libapr-1.so when searching for -lapr-1
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcares.a when searching for -lcares
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libexpat.so when searching for -lexpat
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libdb-4.2.so when searching for -ldb-4.2
/usr/bin/ld: cannot find -ldb-4.2
collect2: ld returned 1 exit status

[paul@myhost secondlife]$ pacman -Q db
db 4.6.21-2

[paul@myhost secondlife]$ uname -a
Linux myhost 2.6.23-ARCH #1 SMP PREEMPT Tue Jan 15 07:17:51 CET 2008 x86_64 Intel(R) Celeron(R) CPU 2.66GHz GenuineIntel GNU/Linux

And using:
source=('secondlife.desktop' 'secondlife.install' 'secondlife.launcher' \
"http://secondlife.com/developers/opensource/downloads/2008/01/slviewer-src-RC-${pkgver}.tar.gz" \
'http://secondlife.com/developers/opensource/downloads/2007/12/slviewer-artwork-RC-1.18.6.2.zip' \
'http://secondlife.com/developers/opensource/downloads/2007/12/slviewer-linux-libs-RC-1.18.6.2.tar.gz' \
'http://www.fmod.org/index.php/release/version/fmodapi375linux.tar.gz' \
'http://secondlife.com/developers/opensource/downloads/2007/12/llmozlib-src-20071221.tar.gz')

Hum ok, I was trying to use:
scons DISTCC=no BTARGET=client BUILD=release MOZLIB=yes

I'll retry with:
scons BUILD=release ARCH=x86_64 BTARGET=client DISTCC=no MOZLIB=yes FMOD=yes GSTREAMER=yes STANDALONE=yes
(Sconstruct says that with STANDALONE=yes -db-4.2 will not be used)

But at the beginning I get:
scons: Reading SConscript files ...
Building client 1.18.6.2 on x86_64-linux (release)
No CCACHE_DIR set.

scons: warning: Two different environments were specified for target /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llcrashlogger/llcrashlogger.o,
but they appear to have the same action: $CXX -o $TARGET -c $CXXFLAGS $_CCCOMCOM $SOURCES
File "/home/paul/builds/secondlife/src/linden/indra/SConstruct", line 568, in create_executable
scons: done reading SConscript files.
scons: Building targets ...

well, the new scons line give different problem:
g++ -o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.o -c -g -pipe -Wall -Wno-reorder -Wno-trigraphs -Wno-sign-compare -Werror -fexceptions -pthread -D_REENTRANT -fno-math-errno -fsigned-char -fno-strict-aliasing -falign-loops=16 -ffast-math -O2 -D_FORTIFY_SOURCE=2 -DLL_STANDALONE -DLL_MESA_HEADLESS=0 -DLL_MESA=0 -DLL_LINUX=1 -DAPPID=secondlife -DLL_SDL=1 -DLL_FMOD=0 -DLL_X11=1 -DLL_GTK=1 -DLL_LIBXUL_ENABLED=1 -DLL_GSTREAMER_ENABLED=1 -DNDEBUG -DLL_RELEASE=1 -Illcommon -Illmath -Illwindow -Illaudio -Illcharacter -Illcrashlogger -Illdatabase -Illhavok -Illimage -Illinventory -Illmedia -Illmessage -Illprimitive -Illrender -Illscene -Illui -Illvfs -Illwindow -Illxml -Ilscript -Ilscript/lscript_compile -I/home/paul/builds/secondlife/src/linden/libraries/include -I/home/paul/builds/secondlife/src/linden/libraries/include/havok -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include -I/usr/include/atk-1.0 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/cairo -I/usr/include/freetype2 -I/usr/include/libpng12 -I/usr/include/gtk-2.0 -I/usr/lib/gtk-2.0/include -I/usr/include/pango-1.0 -I/usr/include/SDL -I/usr/include/apr-1 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gstreamer-0.10 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/libxml2 /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp
cc1plus: warnings being treated as errors
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp: In function 'const char* OrderToString(LLQuaternion::Order)':
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:701: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:704: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:707: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:710: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:713: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:716: warning: deprecated conversion from string constant to 'char*'
scons: *** [/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.o] Error 1
scons: building terminated because of errors.

Well, STANDALONE=yes make it use g++ rather than g++-3.4, so I decided to remove it, keeping
ARCH=X86_64 and others, but I get:
ranlib lib_release_client/x86_64-linux/libllprimitive.a
g++-3.4 -o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.o -c -g -pipe -Wall -Wno-reorder -Wno-trigraphs -Wno-sign-compare -Werror -fexceptions -pthread -D_REENTRANT -fno-math-errno -fsigned-char -fno-strict-aliasing -falign-loops=16 -ffast-math -O2 -D_FORTIFY_SOURCE=2 -DLL_MESA_HEADLESS=0 -DLL_MESA=0 -DLL_LINUX=1 -DAPPID=secondlife -DLL_SDL=1 -DLL_FMOD=0 -DLL_X11=1 -DLL_GTK=1 -DLL_LIBXUL_ENABLED=1 -DLL_GSTREAMER_ENABLED=1 -DNDEBUG -DLL_RELEASE=1 -Illcommon -Illmath -Illwindow -Illaudio -Illcharacter -Illcrashlogger -Illdatabase -Illhavok -Illimage -Illinventory -Illmedia -Illmessage -Illprimitive -Illrender -Illscene -Illui -Illvfs -Illwindow -Illxml -Ilscript -Ilscript/lscript_compile -I/home/paul/builds/secondlife/src/linden/libraries/include -I/home/paul/builds/secondlife/src/linden/libraries/include/havok -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/ELFIO -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/atk-1.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gtk-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/llfreetype2 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/pango-1.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gstreamer-0.10 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/libxml2 /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:41:44: llfreetype2/freetype/ft2build.h: No such file or directory
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:56: error: `FT_Render_Mode' does not name a type
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:60: error: `FT_Library' does not name a type
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp: In constructor `LLFontManager::LLFontManager()':
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:78: error: `gFTLibrary' was not declared in this scope
... [many more errors]

oh well, SConstruct says I need: cairo glib-2.0 atk gmobile-2.0 gdk-2.0 gdk-pixbuf-2.0 pango pangoft2 pangox pangoxft gtk+-2.0 sdl vorbis vorbisenc vorbisfile

Maybe this is pangoft2 that is missing.

* "Unable to initialize communications"
** If the viewer just displays the error message " Unable to initialize communications" and exits, it can't find message_template.msg. You did remember to copy it over, right?

* Blino's SL build/linking patches for '''gcc4''': http://svn.mandriva.com/cgi-bin/viewvc.cgi/packages/cooker/secondlife/current/
* objcopy: 'newview/linux_tools/exposed-symbols.txt': No such file
** Tofu says... 'This is an omission from our manifest which I'll fix. Meanwhile it's a safe fix to create an empty file with that name.'

* Something like: /usr/bin/ld: cannot find -lz
** Nadia says: Install the zlib development headers. (Ubuntu package zlib1g-dev, Red Hat zlib-devel.)

* Something like: indra.y.cpp:17: error: previous declaration of `int yyparse()'
** Tofu says... 'This appears to be a problem with some versions of flex/bison. A resident reports success when comment out the #ifdef __cplusplus lines in lscript/lscript_compile/indra.y'
** Nadia says: install the zlib development headers first and try recompiling. Commenting out those lines results in a error indra.l:666: undefined
* Linking failures ("script not found") due to spaces in the LINKFLAGS variable?
** I saw a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4665538 report], and modified the SConstruct file to drop the trailing arguments (and spaces) in LINKFLAGS.

* Building [https://lists.secondlife.com/pipermail/sldev/2007-January/000091.html 20070112a] using ''BUILD=releasefordownload'' I get many ''[: 89: ==: unexpected operator'' errors; ''cp: target `SecondLife_i686_1_13_1_7/app_settings/*’ is not a directory'' error, and same thing for character, fonts, help, skins, res-sdl; ''[: 111: ==: unexpected operator, [: 120: SecondLife_i686_1_13_1_7.tar.bz2: unexpected operator''. I can succesfully run the client from the source tree.
** i think this has been fixed --[[User:Signore Iredell|Signore Iredell]] 06:09, 9 June 2007 (PDT)

* scons: *** While building `['.../linden/indra/i686-linux-client-release/lscript/lscript_compile/indra.l.cpp']': Don't know how to build a file with suffix `.l'.
** You probably don't have all the dependencies installed (I had the same problem). Check that you have flex and bison. --[[User:Random73 Janus|Random73 Janus]] 07:43, 16 May 2007 (PDT)

* Something like: linden/indra/i686-linux-client-release/llrender/llimagegl.cpp:122: error: `glActiveTextureARB' was not declared in this scope
** Tofu says... 'You'll need to install OpenGL headers if you don't already have them: gl.h, glext.h, glu.h (The ones from 'mesa' should work)
** two residents report good luck on Gentoo after doing 'eselect opengl set xorg-x11' (but note!! You must know what you're doing; this may change your default system OpenGL drivers, and you will probably want to change them back again after the compile, e.g. 'eselect opengl set nvidia')'

*Building Shared Library ELFIO [[Compiling_the_viewer_%28Linux%29]] on AMD64 ubuntu 6.10
g++-3.4 -shared *.o -o libelfio.so
/usr/bin/ld: ELFIDynamic.o: relocation R_X86_64_32 against `a local symbol' can
not be used when making a shared object; recompile with -fPIC
ELFIDynamic.o: could not read symbols: Bad value'''

* Building Client on Ubuntu 7.04 AMD64
/usr/bin/ld: skipping incompatible /home/dereck/Desktop/SLdev/linden/libraries/i686-linux/lib_release_client/libopenjpeg.a when searching for -lopenjpeg
/usr/bin/ld: cannot find -lopenjpeg
collect2: ld returned 1 exit status
** I went to the OpenJPEG website, downloaded the source, compiled for my system, installed it. The VWR compile was happy after that. Although it's not done yet and I'm still fixing another error, that I assume is unrelated.

==== scons got wild ====

* AttributeError: SConsEnvironment instance has no attribute 'CFile'
: This probably means you have no bison, flex, or equivalent tools installed on the standard locations on your system.
:* When your system has no bison installed, the above message will be supplemented as:
env.CFile(target=build_dir+'/lscript/lscript_compile/indra.y.c', source='lscript/lscript_compile/indra.y')
:* When your system has no flex installed, the above message will be supplemented as:
env.CFile(target=build_dir+'/lscript/lscript_compile/indra.l.cpp', source='lscript/lscript_compile/indra.l')
: Installing the appropriate package should solve this issue.

Common compilation problems

2008-05-03T17:58:22Z

Zoltan Freundlich: /* Cannot open include file: 'windows.h' */

{{CompileNav}}

= General Problems =

* Make sure you download not only the source, but the artwork zipfile, and the appropriate zipfile/tarball of libraries for your platform

= Windows =

== Unresolved external symbol _CLSID_DxDiagProvider/_IID_IDxDiagProvider ==
* ''newview error LNK2001: unresolved external symbol _CLSID_DxDiagProvider''
* ''newview error LNK2001: unresolved external symbol _IID_IDxDiagProvider''

These errors reportedly occur with MSVC 2003 and certain versions of the DirectX SDK. To workaround, edit lldxhardware.cpp and replace the following (line 35):

#include <dxdiag.h>
with...
#define INITGUID
#include <dxdiag.h>
#undef INITGUID

== Cannot open input file 'dxguid.lib' ==
* ''fatal error LNK1181: cannot open input file 'dxguid.lib' in ...''

If you are using a fairly recent DirectX SDK ("December 2006" or newer), your VC++ Libraries Directory may be wrong because the SDK's lib folder now has 2 sub-folders for x64 and x86. Try changing the path from ''C:\Program Files\Microsoft DirectX SDK (December 2006)\Lib'' to ''C:\Program Files\Microsoft DirectX SDK (December 2006)\'' '''Lib\x86'''
 
 
== Cannot open input file 'dxerr8.lib' ==
* ''fatal error LNK1104: cannot open file 'dxerr8.lib'''

If you are using the most recent DirectX SDK ("November 2007"), the file dxerr8.lib does no longer exist. To fix this, you'll need to change the newview project to include 'dxerr9.lib' instead. To do this, right-lick newview > Configuration Properties > Linker > Input, click Additional Dependencies on the right to show a button labeled "..." on it at the very right on the line, then click the ... button. Scroll down the list to find 'dxerr8.lib'. Rewrite it to 'dxerr9.lib'. Remember to do this for both the ReleaseForDownload and the ReleaseNoOpt Configurations.
 
 

== A tool returned an error code from "Building ytab.cpp" ==
* ''lscript_compile_fb error PRJ0019: A tool returned an error code from "Building ytab.cpp" ''

One possible reason for this is that Visual Studio does not know where cygwin/bin is, especially if this is accompanied by an error relating to bison.exe being an invalid command. Even if the directory for cygwin is in the environment variable PATH, Visual Studio maintains its own separate copy which does not seem to be automatically synchronized after the initial installation.

For Visual Studio .NET 2003, go to Tools > Options > Projects > VC++ Directories. In the "show directories for" dropdown, choose "Executable files". Make sure that your cygwin (default C:\cygwin\bin) and ActivePython (default C:\Python25) directories are listed.

== Cannot open include file: 'ytab.h': No such file or directory ==
* ''indra.l (20) : fatal error C1083: Cannot open include file: 'ytab.h': No such file or directory.''
Workaround: Manually copy "linden\indra\lscript\lscript_compile\ytab.hpp" to "linden\indra\lscript\lscript_compile\ytab.h" and build again.

Note: The underlying issue is that in indra.y there is a postbuild step which should do this automatically, but which is missing in some configurations (e.g. in Debug builds).
 
 
== Cannot open include file: 'png.h': No such file or directory ==
* ''imagepng.cpp : fatal error C1083: Cannot open include file: 'libpng12/png.h': No such file or directory.''
There are a couple of files missing since the 1.17. distribution. You can either get the missing files from the internet (from the libpng and zlib projects) or download a set with just the missing files from [http://www.blueflash.cc/users/nicholaz/~libs here] (see the readme.txt inside the png archive there).
 
 
== Cannot open include file: 'glh/glh_linear.h' or 'glh/glh_convenience.h' ==
These files are currently missing from Linden Windlight distributions. See [https://jira.secondlife.com/browse/VWR-3415 JIRA VWR-3415] or grab a copy from [http://www.blueflash.cc/users/nicholaz/~libs here] and put the files into a folder named linden/libraries/include/glh.
 
[[LearCale]] -- as of 1.19, these appear to need to be in linden/libraries/include/GL .
 
 

== Errors relating to "template_verifier.py" ==
With version 1.18 a template verifier script written in Python is used to ensure the message template is correct. In some distributions the file was missing. You will also get an error if you have skipped the Python install. In both cases it is safe to hack the prebuild.bat file in the newview folder as described on the JIRA [http://jira.secondlife.com/browse/VWR-1267 VWR-1267]
 
 

== Missing resources ==
* ''.\res\newViewRes.rc(64) : error RC2135 : file not found: ll_icon.ico''
Some releases have missing files, which were reported to be last seen in the '''1.14.0.1''' release.
* Go to the [[source downloads]] page and grab the [[http://secondlife.com/developers/opensource/downloads/2007/04/slviewer-src-1.14.0.1.zip '''1.14.0.1''' viewer]] sources.
* Explore the archive to "linden/indra/newview/res" folder and extract content to your "linden/indra/newview/res" folder into current revision.
Missing folder in recent release, "'''1.17.0.12'''" which causes the SecondLife to hang while loading into the world.
* Go to the previous source and copy the missing folder, "Character" and place it into the "newview" folder
 
== Error code from "Copying message template" ==
* ''newview error PRJ0019: A tool returned an error code from "Copying message template"''
This is caused by the script trying to do a copy command, but the source path isn't in quotes. Open up newview.vcproj in notepad, and near the bottom there are 4 line that say:
CommandLine="copy $(InputPath) .\app_settings\message_template.msg
replace them with
CommandLine="copy &quot;$(InputPath)&quot; .\app_settings\message_template.msg
The source and destination paths on line 158 may also require wrapping in quotes. In which case:
CommandLine="copy $(TargetDir)\$(TargetFileName) $(ProjectDir)
should become:
CommandLine="copy &quot;$(TargetDir)\$(TargetFileName)&quot; &quot;$(ProjectDir)&quot;
 
== Can not find library ll*.lib ==
If you get a compile error for missing libraries with names of the projects (lscript_compile.lib, llaudio.lib, llcharacter.lib, etc.) go to newview > Properties > Linker > Input and remove these from the list of input libraries (they will be linked through the dependencies and should not be in the list).
 
 
== Cannot open include file: 'windows.h' ==
If you run into this problem:
..\..\..\boost/regex/v4/fileiter.hpp(44) : fatal error C1083: Cannot open include file: 'windows.h': No such file or directory
Fix it with this: (thanks Fairlight!)
set INCLUDE=C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include;%INCLUDE%
set LIB=C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Lib;%LIB%
(You might need to edit the above path to refer to your particular platform SDK. If you don't have the Microsoft Windows Platform SDK installed, then you can download it for free from Microsoft. It is version specific and can be tricky to find on their website.)

 

== Unresolved external symbol "int __cdecl lscript_compile" (VS2005) ==
* ''llcompilequeue.obj : error LNK2019: unresolved external symbol "int __cdecl lscript_compile(char const *,char const *,char const *,int)" (?lscript_compile@@YAHPBD00H@Z) referenced in function "protected: void __thiscall LLFloaterCompileQueue::compile(char const *,class LLUUID const &)" (?compile@LLFloaterCompileQueue@@IAEXPBDABVLLUUID@@@Z)''
* ''llpreviewscript.obj : error LNK2001: unresolved external symbol "int __cdecl lscript_compile(char const *,char const *,char const *,int)" (?lscript_compile@@YAHPBD00H@Z)''

This is not entirely clear, but there seems to be a problem with VS2005 if projects are unloaded while being in the dependency tree. I have seen this error while I had win_crash_logger and win_updater unloaded from the project tree and the problem went away when I loaded them back and excluded them from the newview dependency first.

Also make sure that in newview, properties, linker, input, input libraries, no libraries named ll*.lib and lscript_compile.lib are listed there (remove them if you find them).
 
 

== Unresolved external symbol __invalid_parameter_noinfo (VS2005) ==
* ''llmozlib-vc80.lib(llembeddedbrowserwindow.obj) : error LNK2019: unresolved external symbol __invalid_parameter_noinfo referenced''

You are most likely trying a debug build under VS2005. For debug builds, see the compile instruction section on [[finding_leaks]]
 
 

== Cannot open include file: 'ares.h' ==
download src from http://daniel.haxx.se/projects/c-ares/

compile c-ares-1.4.0/vc/areslib

copy c-ares-1.4.0/vc/areslib/Release/areslib.lib to linden/libraries/i686-win32/lib_release and to lib_debug

copy c-ares-1.4.0/*.h to linden/libraries/i686-win32/include/ares
 
 

== Other (older) notes ==
* Mozilla is not compatible with visual studio 2005, so we have not migrated the codebase, so we do not know if it works.

* Added my errors at [[User:Adam_Zaius/MSVS2005 Errors]] [[User:Adam Zaius|Adam Zaius]] 09:40, 8 January 2007 (PST)

* To minimize the number of warnings for now: in C/C++-Preprocessor add ';_CRT_SECURE_NO_DEPRECATE' to the Preprocessor Definitions, that will supress deprecation warnings --[[User:Artm Udal|Artm Udal]] 12:42, 8 January 2007 (PST)

 

= Mac OS X =

Getting:

*/linden/indra/newview/../llwindow/llglheaders.h:377:31: error: GL/glh_extensions.h: No such file or directory
** This means you didn't [[Compiling the viewer (Mac OS X)#Viewer Source, Libraries, and Artwork|merge the libraries]] right.

 

= Linux =

==== Packaging errors ====

The final packaging step may fail with errors about the manifest if you are not using the slviewer-linux-libs bundle; in this case, if you still wish to end up with an end-user viewer package incorporating your own libraries, you can edit the manifest file found at indra/newview/viewer_manifest.py

==== Various Compilation problems ====
* g++-3.4 -o linux_crash_logger/linux-crash-logger-i686-bin-globalsyms --no-keep-memory --reduce-memory-overheads /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/llcrashlogger/llcrashlogger.o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/linux_crash_logger/linux_crash_logger.o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/i686-linux-client-release/linux_crash_logger/llcrashloggerlinux.o -Llib_release_client/i686-linux -L/home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client -lllui -lllxml -lllmessage -lllvfs -lllmath -lllcommon -lcurl -lssl -lcrypto -laprutil-1 -lapr-1 -lcares -lexpat -ldb-4.2 -lgtk-x11-2.0
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcurl.a when searching for -lcurl
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libssl.so when searching for -lssl
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcrypto.so when searching for -lcrypto
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libaprutil-1.so when searching for -laprutil-1
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libapr-1.so when searching for -lapr-1
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libcares.a when searching for -lcares
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libexpat.so when searching for -lexpat
/usr/bin/ld: skipping incompatible /home/paul/builds/secondlife/src/linden/libraries/i686-linux/lib_release_client/libdb-4.2.so when searching for -ldb-4.2
/usr/bin/ld: cannot find -ldb-4.2
collect2: ld returned 1 exit status

[paul@myhost secondlife]$ pacman -Q db
db 4.6.21-2

[paul@myhost secondlife]$ uname -a
Linux myhost 2.6.23-ARCH #1 SMP PREEMPT Tue Jan 15 07:17:51 CET 2008 x86_64 Intel(R) Celeron(R) CPU 2.66GHz GenuineIntel GNU/Linux

And using:
source=('secondlife.desktop' 'secondlife.install' 'secondlife.launcher' \
"http://secondlife.com/developers/opensource/downloads/2008/01/slviewer-src-RC-${pkgver}.tar.gz" \
'http://secondlife.com/developers/opensource/downloads/2007/12/slviewer-artwork-RC-1.18.6.2.zip' \
'http://secondlife.com/developers/opensource/downloads/2007/12/slviewer-linux-libs-RC-1.18.6.2.tar.gz' \
'http://www.fmod.org/index.php/release/version/fmodapi375linux.tar.gz' \
'http://secondlife.com/developers/opensource/downloads/2007/12/llmozlib-src-20071221.tar.gz')

Hum ok, I was trying to use:
scons DISTCC=no BTARGET=client BUILD=release MOZLIB=yes

I'll retry with:
scons BUILD=release ARCH=x86_64 BTARGET=client DISTCC=no MOZLIB=yes FMOD=yes GSTREAMER=yes STANDALONE=yes
(Sconstruct says that with STANDALONE=yes -db-4.2 will not be used)

But at the beginning I get:
scons: Reading SConscript files ...
Building client 1.18.6.2 on x86_64-linux (release)
No CCACHE_DIR set.

scons: warning: Two different environments were specified for target /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llcrashlogger/llcrashlogger.o,
but they appear to have the same action: $CXX -o $TARGET -c $CXXFLAGS $_CCCOMCOM $SOURCES
File "/home/paul/builds/secondlife/src/linden/indra/SConstruct", line 568, in create_executable
scons: done reading SConscript files.
scons: Building targets ...

well, the new scons line give different problem:
g++ -o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.o -c -g -pipe -Wall -Wno-reorder -Wno-trigraphs -Wno-sign-compare -Werror -fexceptions -pthread -D_REENTRANT -fno-math-errno -fsigned-char -fno-strict-aliasing -falign-loops=16 -ffast-math -O2 -D_FORTIFY_SOURCE=2 -DLL_STANDALONE -DLL_MESA_HEADLESS=0 -DLL_MESA=0 -DLL_LINUX=1 -DAPPID=secondlife -DLL_SDL=1 -DLL_FMOD=0 -DLL_X11=1 -DLL_GTK=1 -DLL_LIBXUL_ENABLED=1 -DLL_GSTREAMER_ENABLED=1 -DNDEBUG -DLL_RELEASE=1 -Illcommon -Illmath -Illwindow -Illaudio -Illcharacter -Illcrashlogger -Illdatabase -Illhavok -Illimage -Illinventory -Illmedia -Illmessage -Illprimitive -Illrender -Illscene -Illui -Illvfs -Illwindow -Illxml -Ilscript -Ilscript/lscript_compile -I/home/paul/builds/secondlife/src/linden/libraries/include -I/home/paul/builds/secondlife/src/linden/libraries/include/havok -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include -I/usr/include/atk-1.0 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/cairo -I/usr/include/freetype2 -I/usr/include/libpng12 -I/usr/include/gtk-2.0 -I/usr/lib/gtk-2.0/include -I/usr/include/pango-1.0 -I/usr/include/SDL -I/usr/include/apr-1 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gstreamer-0.10 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/libxml2 /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp
cc1plus: warnings being treated as errors
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp: In function 'const char* OrderToString(LLQuaternion::Order)':
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:701: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:704: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:707: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:710: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:713: warning: deprecated conversion from string constant to 'char*'
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.cpp:716: warning: deprecated conversion from string constant to 'char*'
scons: *** [/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llmath/llquaternion.o] Error 1
scons: building terminated because of errors.

Well, STANDALONE=yes make it use g++ rather than g++-3.4, so I decided to remove it, keeping
ARCH=X86_64 and others, but I get:
ranlib lib_release_client/x86_64-linux/libllprimitive.a
g++-3.4 -o /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.o -c -g -pipe -Wall -Wno-reorder -Wno-trigraphs -Wno-sign-compare -Werror -fexceptions -pthread -D_REENTRANT -fno-math-errno -fsigned-char -fno-strict-aliasing -falign-loops=16 -ffast-math -O2 -D_FORTIFY_SOURCE=2 -DLL_MESA_HEADLESS=0 -DLL_MESA=0 -DLL_LINUX=1 -DAPPID=secondlife -DLL_SDL=1 -DLL_FMOD=0 -DLL_X11=1 -DLL_GTK=1 -DLL_LIBXUL_ENABLED=1 -DLL_GSTREAMER_ENABLED=1 -DNDEBUG -DLL_RELEASE=1 -Illcommon -Illmath -Illwindow -Illaudio -Illcharacter -Illcrashlogger -Illdatabase -Illhavok -Illimage -Illinventory -Illmedia -Illmessage -Illprimitive -Illrender -Illscene -Illui -Illvfs -Illwindow -Illxml -Ilscript -Ilscript/lscript_compile -I/home/paul/builds/secondlife/src/linden/libraries/include -I/home/paul/builds/secondlife/src/linden/libraries/include/havok -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/ELFIO -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/atk-1.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gtk-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/llfreetype2 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/pango-1.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/gstreamer-0.10 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0 -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/glib-2.0/include -I/home/paul/builds/secondlife/src/linden/libraries/x86_64-linux/include/libxml2 /tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:41:44: llfreetype2/freetype/ft2build.h: No such file or directory
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:56: error: `FT_Render_Mode' does not name a type
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:60: error: `FT_Library' does not name a type
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp: In constructor `LLFontManager::LLFontManager()':
/tmp/paul/home/paul/builds/secondlife/src/linden/indra/x86_64-linux-client-release/llrender/llfont.cpp:78: error: `gFTLibrary' was not declared in this scope
... [many more errors]

oh well, SConstruct says I need: cairo glib-2.0 atk gmobile-2.0 gdk-2.0 gdk-pixbuf-2.0 pango pangoft2 pangox pangoxft gtk+-2.0 sdl vorbis vorbisenc vorbisfile

Maybe this is pangoft2 that is missing.

* "Unable to initialize communications"
** If the viewer just displays the error message " Unable to initialize communications" and exits, it can't find message_template.msg. You did remember to copy it over, right?

* Blino's SL build/linking patches for '''gcc4''': http://svn.mandriva.com/cgi-bin/viewvc.cgi/packages/cooker/secondlife/current/
* objcopy: 'newview/linux_tools/exposed-symbols.txt': No such file
** Tofu says... 'This is an omission from our manifest which I'll fix. Meanwhile it's a safe fix to create an empty file with that name.'

* Something like: /usr/bin/ld: cannot find -lz
** Nadia says: Install the zlib development headers. (Ubuntu package zlib1g-dev, Red Hat zlib-devel.)

* Something like: indra.y.cpp:17: error: previous declaration of `int yyparse()'
** Tofu says... 'This appears to be a problem with some versions of flex/bison. A resident reports success when comment out the #ifdef __cplusplus lines in lscript/lscript_compile/indra.y'
** Nadia says: install the zlib development headers first and try recompiling. Commenting out those lines results in a error indra.l:666: undefined
* Linking failures ("script not found") due to spaces in the LINKFLAGS variable?
** I saw a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4665538 report], and modified the SConstruct file to drop the trailing arguments (and spaces) in LINKFLAGS.

* Building [https://lists.secondlife.com/pipermail/sldev/2007-January/000091.html 20070112a] using ''BUILD=releasefordownload'' I get many ''[: 89: ==: unexpected operator'' errors; ''cp: target `SecondLife_i686_1_13_1_7/app_settings/*’ is not a directory'' error, and same thing for character, fonts, help, skins, res-sdl; ''[: 111: ==: unexpected operator, [: 120: SecondLife_i686_1_13_1_7.tar.bz2: unexpected operator''. I can succesfully run the client from the source tree.
** i think this has been fixed --[[User:Signore Iredell|Signore Iredell]] 06:09, 9 June 2007 (PDT)

* scons: *** While building `['.../linden/indra/i686-linux-client-release/lscript/lscript_compile/indra.l.cpp']': Don't know how to build a file with suffix `.l'.
** You probably don't have all the dependencies installed (I had the same problem). Check that you have flex and bison. --[[User:Random73 Janus|Random73 Janus]] 07:43, 16 May 2007 (PDT)

* Something like: linden/indra/i686-linux-client-release/llrender/llimagegl.cpp:122: error: `glActiveTextureARB' was not declared in this scope
** Tofu says... 'You'll need to install OpenGL headers if you don't already have them: gl.h, glext.h, glu.h (The ones from 'mesa' should work)
** two residents report good luck on Gentoo after doing 'eselect opengl set xorg-x11' (but note!! You must know what you're doing; this may change your default system OpenGL drivers, and you will probably want to change them back again after the compile, e.g. 'eselect opengl set nvidia')'

*Building Shared Library ELFIO [[Compiling_the_viewer_%28Linux%29]] on AMD64 ubuntu 6.10
g++-3.4 -shared *.o -o libelfio.so
/usr/bin/ld: ELFIDynamic.o: relocation R_X86_64_32 against `a local symbol' can
not be used when making a shared object; recompile with -fPIC
ELFIDynamic.o: could not read symbols: Bad value'''

* Building Client on Ubuntu 7.04 AMD64
/usr/bin/ld: skipping incompatible /home/dereck/Desktop/SLdev/linden/libraries/i686-linux/lib_release_client/libopenjpeg.a when searching for -lopenjpeg
/usr/bin/ld: cannot find -lopenjpeg
collect2: ld returned 1 exit status
** I went to the OpenJPEG website, downloaded the source, compiled for my system, installed it. The VWR compile was happy after that. Although it's not done yet and I'm still fixing another error, that I assume is unrelated.

==== scons got wild ====

* AttributeError: SConsEnvironment instance has no attribute 'CFile'
: This probably means you have no bison, flex, or equivalent tools installed on the standard locations on your system.
:* When your system has no bison installed, the above message will be supplemented as:
env.CFile(target=build_dir+'/lscript/lscript_compile/indra.y.c', source='lscript/lscript_compile/indra.y')
:* When your system has no flex installed, the above message will be supplemented as:
env.CFile(target=build_dir+'/lscript/lscript_compile/indra.l.cpp', source='lscript/lscript_compile/indra.l')
: Installing the appropriate package should solve this issue.

Compiling the viewer (MSVS2005)

2008-05-03T15:33:23Z

Zoltan Freundlich: /* Getting other Development Tools */

{{Languages}}
{{CompileNav}}

This page explains how you can compile the viewer on Microsoft Windows using Visual Studio 2005 or Visual C++ Express 2005. Note that Lindens are using VS2003 and the whole setup is a bit easier there, so if you have Visual Studio 2003 available, you should read the list of [[Microsoft Visual Studio|supported Visual studio editions]] and you will get less trouble with it than with VS2005.

Currently, only 32 bit binary is tested. There seems to be several trials to produce 64 bit Windows .EXE of the viewer. If you did, please write your experience on this wiki (regardless it was successful or not!)

The following explanation is adjusted for Viewer releases 1.16.0.5 or later. See an [http://wiki.secondlife.com/w/index.php?title=Compiling_the_viewer_%28MSVS2005%29&oldid=22294 older version of this page] for the Viewer releases 1.15 or before.

= Preparing the Development Environment =

== Installing/Configuring VS2005 ==

You need to setup the compiler and Microsoft Development tools as follows:
* Setup [[Microsoft Visual Studio]]

== Getting other Development Tools ==
You will also need some open source development tools.
* [http://www.cygwin.com/ Cygwin]
** When you run the cygwin setup utility make sure you have selected to install '''patchutils''', '''flex''', and '''bison''' (all located under "devel") which are not part of the default install. (If you missed one of these, the easiest thing to do is to re-run the entire installation.) Older releases (< r79209) had several hardcoded references that expect Cygwin to be installed at '''C:\cygwin''' in the project files, however current releases rely on the build environment configuration instead.
* [http://www.activestate.com/Products/ActivePython/?mp=1 ActivePython 2.3x or later] - Latest Version is 2.5.1.1
** It is required but can be avoided if you are compiling 1.18 or later viewers. Either download and install or hack the prebuild.bat files as described in [http://jira.secondlife.com/browse/VWR-1267 VWR-1267].
* ActivePerl was recommended for previous versions on this Wiki, but it currently appears, that it is not strictly necessary unless you are planning to build your own version of all libraries (which most likely you don't want to do). So for a start it may be safe to skip it.
*: [http://www.activestate.com/Products/ActivePerl/?mp=1 ActivePerl]

 
 
 

= Downloading Source Code =

You can download the Viewer source codes on the [[source downloads]] page. You can also use a [[version control repository]].

At a minimum, grab the source package and the artwork package, but for a start, also grab the library archive. Many of the libraries can either be compiled from source or downloaded from other sites (see below), but this will take hours and thus it is easiest to also get the package with libraries compiled by the Lindens.

'''WARNING:'''
* If the directory path you keep the SL source in has a space in it, the batch file that copies message_template.msg will fail. So, if you unzip or checkout the source tree into, e.g., "C:\Projects\Dir with space in name\Etc\linden", it won't work!
* You should also avoid using non-ASCII (national) characters in the paths, although some localized versions of the tool puts some as a default...
* Unzip or checkout your source tree into a directory that has as short full pathname as possible, since long paths cause some unexpected trouble during the build.

In other words, the easiest way to get this working is to get ''source'', ''artwork'' and ''libraries'' from the [[source downloads]] page and unpack them all into the same directory/folder, which ideally would be a folder in (or near) the root directory with a short name like ''sl_1_16_0_5''.
 
 
 
 

= Installing Libraries =

SL Viewer depends on some third party libraries. Some of them are open source, some others are not.

== Open Source Libraries ==

You can download the pre-build open source libraries from LL. They are available on [[source downloads]] page. Unzip them into your SL viewer source code directory, maintaining the same directory structure.

'''Note: The VS2003 libraries provided in the [[source downloads]] do not fully work with VS2005 compiled binaries. They will compile with the viewer under VS2005, but the VS2003 libraries are not fully STL compliant. The differences of [http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclang/html/vclrfnonstandardbehavior.asp non-standard behavior in MSVS] are the known cause.'''

Alternatively, it may be possible to get the source files for the libraries and build by yourself. See [[Compiling the viewer libraries (MSVS 2003)|the instruction for VS2003 users]] if you try it. Please note, however, it is not known that VS2005 can successfully compile the libraries. '''You have been warned.''' (If you can make it, please write the info on this wiki...)
 
 

== Proprietary Libraries ==

Lindens does not inlcude the following proprietary libraries. You will need to follow the instructions to acquire below and copy them to the source path.

However, it probably is a good idea to build an empty directory tree for the files below and first copy the files there and once completed, copy the whole tree to the actual source folder (like ''XCOPY OLIB SL_1_16_0_5 /S''). The reason is, that these steps are cumbersome and will have to be repeated for each new release (at least if you keep the source for each release in it's own folder). If you do not want to do this, of course you can just copy the files directly into the linden source paths.

rem OLIBS.CMD to build a folder tree for 3rd party libraries and includes
md olibs
md olibs\linden\
md olibs\linden\libraries
md olibs\linden\libraries\include
md olibs\linden\libraries\i686-win32
md olibs\linden\libraries\i686-win32\lib_release
md olibs\linden\libraries\i686-win32\lib_debug
md olibs\linden\libraries\i686-win32\include
md olibs\linden\libraries\i686-win32\include\GL
md olibs\linden\libraries\i686-win32\include\quicktime
md olibs\linden\indra
md olibs\linden\indra\newview
 
=== Fmod ===
* Download & extract [http://www.fmod.org/index.php/download fmod 3.75 api for win32] (later versions, like FMOD Ex, are incompatible).
* Copy "fmodapi375win\api\inc\fmod.h" to "linden\libraries\include"
* Copy "fmodapi375win\api\inc\fmod_errors.h" to "linden\libraries\include"
* Copy "fmodapi375win\api\lib\fmodvc.lib" to "linden\libraries\i686-win32\lib_release" and to "linden\libraries\i686-win32\lib_debug"
* Copy "fmodapi375win\api\fmod.dll" to "linden\indra\newview"
 

=== OpenGL ===
* Download [http://oss.sgi.com/projects/ogl-sample/sdk.html glext.h, glxext.h, and wglext.h]
* Copy them to "linden\libraries\i686-win32\include\GL"
* You don't need any additional *.lib or *.dll for OpenGL.
 

=== ares (viewer 1.18.4 ... for later releases first check if the ares.h and .lib files are in the Linden library package) ===
* download c-ares 1.4 from [http://daniel.haxx.se/projects/c-ares/ here] and unpack it somewhere
* open vc.dsw from the c-ares/vc folder
* remove the adig and ahost projects from the vc workspace
* add ares_getnameinfo.c to the areslib project
* for areslib right-click, properties, Code Generation and set Runtime Library to /MT (release) and /MTd (debug)
* compile debug and release
* copy all c-ares\*.h files to linden\libraries\include\ares\*.h
* copy vc\areslib\Debug\*lib to linden\libraries\i686-win32\lib_debug
* copy vc\areslib\Release\*lib to linden\libraries\i686-win32\lib_release
 

=== openjpeg (viewer 1.18.4 ... for later releases first check if the openjpeg.lib files are in the Linden library package) ===
* download the latest OpenJPEG from [http://www.openjpeg.org/ here]
* open the libopenjpeg.dsw, let it convert and compile it (you'll need the files from the dllopenjpeg sub-project)
* copy debug\openjpeg.lib to linden\libraries\i686-win32\lib_debug
* copy release\openjpeg.lib to linden\libraries\i686-win32\lib_release
* copy release\openjpeg.dll to linden\indra\newview
 

=== Quicktime ''(optional)'' ===
'''Note:''' This download requires a registration at the Apple Quicktime website and take a bit of time. You can avoid using QuickTime if you want, see [[#QuickTime removal|below]] for details. Remember that your viewer '''can't play in-world movies''' if you do so.
* Download & install the [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/203/wa/getSoftware?fileID=20525&code=y&source=x&wosid=4h16WcyMtVfd2P1EffGafkoxFcr Quicktime SDK for Windows]
* Copy "QuicktimeSDK\Libraries\QTMLClient.lib" to "linden\libraries\i686-win32\lib_release" and to "linden\libraries\i686-win32\lib_debug".
* Copy the contents of "QuicktimeSDK\CIncludes" into "linden\libraries\i686-win32\include\quicktime".
 
 
 

= Configuring for VS2005 =

Lindens use VS2003 to develop the viewer.

You either need to convert ''solution file'' and ''project files'' from VS2003 format to VS2005 format or obtain files compatible with VS2005. You may also need to modify source files to work around the incompatibility between VS2003 and VS2005.

'''Note''': linden\indra\indra_complete_vs8.sln is a solution file already included in the source archive and intended for the Visual Studio 2005, but it '''does not work''' (at least between 1.14.0 and 1.17.0.9 distribution). This may change in a future release, if Lindens include an updated versions of the '''_vc8''' files.

 
 
== Using pre-built solution/project files ==

Currently there is a ZIP file with solution/project files available on the [https://jira.secondlife.com/browse/VWR-1151 JIRA bug tracker issue VWR-1151].

If you are building 1.16 or later, the easiest way towards compiling SL on MS2005 will be to use the zip file mentioned above. The details is as follows:
* Download the appropriate ZIP archive from JIRA.
* Unpack it and copy it onto your linden source tree (allow to overwrite files that have '''_vc8''' in the name).
* Start Visual Studio 2005 (or VC++ Express).
* Use "File > Open > Project/Solution" to open the linden\indra\indra_complete\indra_complete'''_vc8'''.sln (Note: If you plan to work with multiple versions over time, you will find it useful to rename '''indra_complete_vc8.sln''' to something which contains the version number, e.g. '''indra_1_17_0_11_vc8.sln''' before opening.)
* Right click '''newview''' in the frame Solution Explorer and click "Set as StartUp Project".
* Proceed with applying the '''Workarounds''' below (skip '''Manual conversion''').

'''Note:''' The solution/project files depends on the viewer release version. If you are compiling some specific version of the viewer, and the {{JIRA|VWR-1151}} doesn't list the zip file for you version, you can try using the most close one. If, while compiling, you later encounter errors or problems regarding the projects, you may have to do the manual conversion instead.

 

== Manual conversion of the solution/projects ==

If you can not find a set of project files (see above), there are instructions available how to manually do it: [[Converting_project_files_for_MSVS2005]] (this step will take about 5-15 minutes, depending on how proficient you are using VS2005).

 
 
 

== Workarounds ==

There are more compatibility problems between VS2003 and VS2005. You need the following code edits.
 
=== test project/crash_logger/updater ===

For whatever reason, the '''test''' project doesn't work under VS2005. Workaround is to disable it as follows: Right click on the '''test''' and choose '''Unload Project'''.

If you do not plan to create a full download build, you can exclude the '''win_crash_logger''' and '''win_updater''' from newview's project dependencies and unload them also. But be careful with unloading these projects without removing them from the dependencies, because I have seen VS2005 act highly erratic while linking then project when I tried this.
 
=== QuickTime removal ===

If you don't want to get Apple QuickTime SDK, you can disable it as follows:
*linden\indra\llcommon\llpreprocessor.h - near line 58 (the line below '''#elif LL_WINDOWS''')
--50: #define LL_QUICKTIME_ENABLED 1
++50: #define LL_QUICKTIME_ENABLED '''''0'''''

[[LearCale]]: this appears to be in linden\indra\llmedia\llmediabase.h as of client 1.20

* Pick '''ReleaseNoOpt''' in the Solution Configurations drop-down box beside the green arrow under the tool bar, and do the followings on the Solution Explorer frame:
*Click '''newview''' to select it alone.
**Choose Properties.
**Under Configuration Properties > Linker > Input, click '''Additional Dependencies''' on the right to show a button labeled "'''...'''" on it at the very right on the line, then click the '''...''' button.
**Scroll down the list to find '''qtmlclient.lib'''. Delete this single line.
**Click '''OK''' to close the "Additional Dependencies" dialog, then click OK again to close the "newview Property Pages" dialog box.
* Pick '''ReleaseForDownload''' in the Solution Configurations drop-down box. Click '''newview''' to select it alone and do the same thing again.
 
 
 

= Ready, Set, Build! =

== Building ==
* Build either '''ReleaseNoOpt''' (for debugging) or '''ReleaseForDownload''' (for production code).
* To do this, pick either in the Solution Configurations drop-down box beside the green arrow under the tool bar.
* Make sure '''newview''' is set as the startup project (otherwise set from newview's right-click menu).
* Select Build-Menu > Build Solution or press F7.
* newview_noopt.exe will be built in linden\indra\newview\ReleaseNoOpt or SecondLife.exe will be linden\indra\newview\ReleaseForDownload.
 

== Common compile errors ==
* See [[common compilation problems]] if you run into other errors while building.
 
== Running ==
* You can run the viewer by '''Debug > Start Debugging''' or '''Debug > Start Without Debugging''' in Visual Studio.
* To run it outside VS, create a shortcut to SecondLife.exe, and change the start location to linden\indra\newview\ (All the .dll will be found there.)
* Alternately copy the exe (possibly rename it) to your "c:\program files\secondlife" folder.
 
== Debugging Info/Configurations ==
* Usually you will either use '''ReleaseNoOpt''' or the '''ReleaseForDownload''' configuration.
* '''ReleaseNoOpt''' (not optimized) compiles faster and has more debugging information, but this comes at a runtime penalty of about 50% of your FPS in busy areas, compared to ReleaseForDownload build.
* '''ReleaseForDownload''' also has debugging information and runs fine in the debugger (although at times you may miss access to some local variables).
* '''ReleaseNoOpt''' comes with a seperate debugging console window opens and stays open for the duration of your session, but you can access the same information also by pressing Shift+Ctrl+4 in the viewer (all builds).
* The debug console log can also be redirected to a file if you add "2>secondlife.log" to the command line (Newview, Properties, Debugging, Command line arguments).
* If you want to build a '''Debug''' configuration, see the specific section with compile instructions on [[finding leaks]]
 

== Problems Running? ==
* '''Inventory errors''': If you're getting errors while trying to load your inventory, try [[Help:Stuck logging in|clearing your cache and deleting other temporary files]].
* '''Missing smime3 DLL''': Those are parts of the integrated web browser. Copy 'smime3.dll', 'nss3.dll', 'softokn3.dll', and 'ssl3.dll' files from your official client's main folder to "linden\indra\newview".
* '''Can't connect''': In the debug builds there is a selection box on the login screen to select the server to connect to. '''Agni''' is the production grid, '''aditi''' is the beta grid. (There seems to be a bug in this part of the code, you may have to make your selection, close the viewer and repoen it, before you can connect to the selected grid).
 
 
= Submit Patches =
This is probably faaar down the road, but if you make changes to the source and want to submit them, see the page about [[submitting patches]].