Difference between revisions of "Viewer 2 Microsoft Windows Builds"

From Second Life Wiki
Jump to navigation Jump to search
m (→‎Set up Fmod: don't modify the original autobuild.xml file, modify the copy)
m (Redirected page to Visual Studio 2013 Viewer Builds)
 
(291 intermediate revisions by 17 users not shown)
Line 1: Line 1:
{{multi-lang}}
#REDIRECT [[Visual Studio 2013 Viewer Builds]]
{{CompileNav}}
 
{{KBwarning|custom=Work in progress|'''These instructions are not yet complete or  debugged''' as of May 31, 2011.}}
 
When finished, we hope this page will constitute a complete recipe for compiling viewer 2 from source on a Windows machine. 
 
Philosophy: to keep it brief, this page should only include steps we KNOW ARE NEEDED, not random hints.  Extra details or open issues can go on the talk page.
 
{{KBnote|Following this recipe will probably take 6 to 12 hours of wall-clock time, and 2 to 6 hours of your time, if you're starting from a fresh Windows XP/Vista/7 system.}}
 
== Establish your programming environment ==
This is needed for compiling any viewer based on the LL open source code, but only needs to be done once.
#Install Visual Studio 2010 (Express is OK)
#:[http://www.microsoft.com/express/download/ Click here to download Visual C++ Express - current version is VS2010]
#* If you installed VS2010 Express also install [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=a7b7a05e-6de6-4d3a-a423-37bf0912db84&displaylang=en Microsoft Visual C++ 2010 Redistributable Package]
#Run [http://www.update.microsoft.com/microsoftupdate/v6 Microsoft Update], and keep running it until no updates are needed. This may take 6~8 iterations on older versions of windows.
#*Note: For windows Vista and Windows 7, you need to select "Get updates from other Microsoft products." to get the updates for Visual Studio.
#*For Windows XP, use the provided link above to go to update.microsoft.com and not update.windows.com that is the default update service for XP.
#Install  [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=35aeda01-421d-4ba5-b44b-543dc8c33a20 Windows SDK for Windows 7 and .NET Framework 4] (ISO) or [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=6B6C21D2-2006-4AFA-9702-529FA782D63B Windows SDK for Windows 7 and .NET Framework 4] (Web Install)
#*Note: You may need to install the .net 4 framework first found on Microsoft Update or here: [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992&displaylang=en Web install] and [http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&FamilyID=0a391abd-25c1-4fc0-919f-b21f31ab88b7 Full install].
#Install  [http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&FamilyID=3021d52b-514e-41d3-ad02-438a3ba730ba DirectX SDK (June 2010)]
#Install other development tools
#*[http://code.google.com/p/unsis/downloads/list Unicode NSIS (Nullsoft Scriptable Install System)]
#*:This is the package installer used to build Setup.exe.
#*[http://www.cmake.org/files/v2.8/ CMake]
#*:This should be version 2.8.4 (or above in the 2.8.x series). Ensure that any older versions aren't in your PATH environment variables.
#*[http://www.cygwin.com/ Cygwin]
#*:When you run the cygwin setup utility make sure you have selected to install unzip (under "Archive"), '''patchutils''', '''flex''', '''bison''' (all located under "devel"), and '''curl''' (under "Web") which are not part of the default install. Do not install Cygwin Python or Mercurial.  You won't need to use the Cygwin shell for anything; just have the binaries accessible to the regular command line via your PATH.
#*Python (either [http://www.python.org/download/ Standard Python] or [http://www.activestate.com/activepython/downloads ActivePython])
#*:Note: Version 2.7.1 has been reported to work with the build scripts.
#*Mercurial (either [http://tortoisehg.bitbucket.org/ TortoiseHg] or [http://mercurial.selenic.com/ Mercurial Hg])
#*[http://gnuwin32.sourceforge.net/downlinks/unzip.php Unzip]
#*''(optional)'' [http://notepadplusplus.org/ Notepad++]
#*:You need to use an editor that conforms to the [[Coding Standard]]. In particular, you must not check in files with DOS line endings except in very limited circumstances; see [[How to avoid DOS line endings in Windows tools]].
 
{{KBnote|If the installer for a particular package does not update your PATH environment setting you will have to do this manually.}}
 
 
* Needed modifications to CMake to correct improper flag usage (until this is corrected by the makers of CMake). These changes will also help keep CMake backwards compatible for those who are still working on older code base viewers (non-VS2010 build). (Added by [[User:WolfPup Lowenhar|WolfPup Lowenhar]] 17:56, 26 May 2011 (PDT))
  Edit Windows-cl.cmake and change the following:
  (this is file is located in 32-bit > C:\Program Files\CMake 2.8\share\cmake-2.8\Modules\Platform
                              64bit> C:\Program Files(x86)\CMake 2.8\share\cmake-2.8\Modules\Platform )
  replace line 156 with:
 
  IF(MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /EHsc /GR")
  ELSEIF(NOT MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /Zm1000 /EHsc /GR")
  ENDIF(MSVC10)
 
  replace line 172 with:
 
  IF(MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /GX /GR")
  ELSEIF(NOT MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /Zm1000 /GX /GR")
  ENDIF(MSVC10)
 
  replce line 184 with :
 
  IF(MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /GX /GR")
  ELSEIF(NOT MSVC10)
    SET(CMAKE_CXX_FLAGS_INIT "/DWIN32 /D_WINDOWS /W3 /Zm1000 /GX /GR")
  ENDIF(MSVC10)
 
== Configure VS2010 ==
Instructions needed here to set up internal paths
 
== Set up your source code tree ==
 
Plan your directory structure ahead of time.  If you are going to be producing changes or patches you will be cloning a copy of an unaltered source code tree for every change or patch you make, so you might want to have all this work stored in it's own directory.
 
To get a copy of the source code tree:
* Open up a DOS/Command window
* Make a directory to contain your build tree (it is strongly suggested to name it <code>viewer-development</code>).  Do not have any spaces in this path.
* Go into that directory
* Do <code>hg init</code>
* Do <code>hg pull <nowiki>http://hg.secondlife.com/viewer-development</nowiki></code>
 
* Example:  ((specific snapshot example TBD))
 
Let's say some time has gone by since you have performed the previous steps and now you want to develop a change or work on a jira.  You will
* Go into <code>viewer-development</code> (or whatever you named the master source tree copy)
* Do <code>hg pull</code>
* Do <code>hg update</code>
* Move up one level from <code>viewer-development</code>
* Do <code>hg clone viewer-development VWR-nnnnn</code> (where <code>nnnnn</code> is the jira number, or clone to a name of your choosing if there is not jira number)
 
== Set up Autobuild ==
* Install [[Autobuild]]
* Modify your path statement to include the autobuild bin directory
 
=== Set up Fmod===
 
Create a directory for the 3p-fmod repository and clone it:
hg clone https://bitbucket.org/lindenlab/3p-fmod
 
CD into the <code>3p-fmod</code> directory you created and build it:
autobuild build --all
 
Package the results:
autobuild package
 
Now update autobuild with the filename and hash just displayed.
 
In the directory where you cloned viewer-development copy <code>autobuild.xml</code> to <code>my_autobuild.xml</code> and modify the copy as follows:
Replace:
          <key>hash</key>
              <string>d9a9a6ad86895353bcd63374a4c1a91d</string>
        <key>url</key>
              <string>http://s3-proxy.lindenlab.com/private-builds-secondlife-com/hg/repo/3p-fmod-private/rev/221852/arch/CYGWIN/installer/fmod-3.75-windows-20110222.tar.bz2</string>
 
With:
          <key>hash</key>
              <string>4219e57263975ebceabdf9eefc1a79b1</string>        [NOTE: Insert your hash value here]
          <key>url</key>
              <string>file:///3p-fmod\fmod-3.75-windows-20110531.tar.bz2</string>      [NOTE: Insert your directory name here; this example assumes 3p-fmod]
{{KBnote|Having to copy and modify <code>autobuild.xml</code> from within a cloned repository is a lot of work for every repository you make, but this is the only way to guarantee you pick up upstream changes to <code>autobuild.xml</code>.}}
 
===  Configuring and compiling the viewer ===
 
If you are compiling with Fmod you will need to do:
set AUTOBUILD_CONFIG_FILE=my_autobuild.xml
 
At the command line in the source tree's root directory (presumably a directory you have cloned from viewer-development, as it is not a good idea to work in viewer-development, unless you are only compiling for youself) e.g. <code>C:\linden\VWR-12345\</code>) run:
autobuild configure -c [CONFIGURATION]
where <code>[CONFIGURATION]</code> is one of those listed at [[Building the Viewer with Autobuild#Build a desired configuration]] (<code>ReleaseOS</code>, <code>RelWithDebInfoOS</code>, <code>DebugOS</code>)
 
Then run:
autobuild build -c [CONFIGURATION] --no-configure
 
There are some useful switches to know about, so your commands may look like this:
set AUTOBUILD_CONFIG_FILE=my_autobuild.xml
autobuild configure -c ReleaseOS -- -DLL_TESTS:BOOL=OFF -DPACKAGE:BOOL=OFF -DFMOD:BOOL=TRUE
autobuild build -c ReleaseOS --no-configure
 
{{KBnote|It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command.  I find it is clearer and saves a bit of time if these steps are done separately.}}
 
== Compiling using the VS C++ Express IDE ==
--[[User:Eamon Mayo|Eamon Mayo]] 17:26, 30 May 2011 (PDT)
 
The autobuild configure step will create the ''build-vc100'' directory at the root of the source tree which contains the ''SecondLife.sln'' solution file.  The solution is fully configured and (almost) ready to be built inside the IDE.  Proceed as follows:
 
#From build-vc100\packages\fmodapi375win\api\inc\, copy fmod.h and fmod_errors.h to build-vc100\packages\include.
#Go to the build-vc100 directory, and open the SecondLife.sln file.  It will take a bit of time preparing itself; wait for this to complete.
#Right-click on Build-All and select Build.  This process will take a while, and will ultimately fail, but several needed directories will be created and populated (almost).
#Copy needed files to the appropriate directories, as follows:
#*From build-vc100\packages\fmodapi375win\api\lib\, copy fmodvc.lib to build-vc100\packages\release\ and build-vc100\packages\debug\, and '''rename fmodvc.lib to fmod.lib''' in each location.
#*From build-vc100\packages\fmodapi375win\api\, copy fmod.dll to build-vc100\packages\release\ and build-vc100\packages\debug\
#*From C:\Windows\System32\, copy msvcr100.dll and msvcp100.dll to build-vc100\sharedlibs\Release\
#*From C:\Windows\System32\, copy msvcr100d.dll and msvcp100d.dll to build-vc100\sharedlibs\Debug\
(No doubt there is a more elegant way to have the msvc* files included directly, but this way is easy, and legal, since Microsoft has made these dlls explicitly redistributable.)
#Now Right-click on Build-All and select Build again.  This time you should only have one error related to SecondLife.sln (an artifact of VS C++ Express that we can safely ignore).
#Now at the top of the VS window, select Release instead of Debug, and rebuild.  You should now have working Debug and Release versions that can be installed anywhere.  These live in build-vc100\newview\Release and build-vc100\newview\Debug.  For example, if you copy the contents of newview\release to another machine, SL will run from that directory, or you can actually install it by running the included Second_Life_2-6-3-0_LindenDeveloper_Setup.exe.
 
== Iteratively fix things until the compile succeeds ==
If you encounter errors during building or configuration, check [[{{TALKPAGENAME}}|the talk page]] and report useful experiences there.
 
== Running your newly built viewer ==
*Make a shortcut for <code>Drive:\your-path\build-vc100\newview\Release\secondlife-bin.exe</code>
 
* Right-click the shortcut, Properties, and set "Start in:" to <code>Drive:\your-path\indra\newview</code>
 
== Common Issues/Bugs/Glitches And Solutions ==
 
*Getting help:
** Subscribe to [[OpenSource-Dev|OpenSource-Dev Mailing List]] ([https://lists.secondlife.com/cgi-bin/mailman/listinfo/opensource-dev subscribe]) and post your question there.
** For faster response, find a free IRC client program and join [irc://irc.freenode.org/opensl #opensl on freenode], the general open source viewer discussion and development channel.  Hopefully a helpful person is online when you ask your question.
 
* Not being able to find objidl.h in the Microsoft Windows SDK, when compiling llwindow: https://lists.secondlife.com/pipermail/opensource-dev/2011-April/006562.html
**: Can be caused by path problems or some installation conflicts with the DirectX SDK.
 
* stdint.h typedef conflicts between Quicktime and VS2010: https://lists.secondlife.com/pipermail/opensource-dev/2011-April/006565.html
**: Can be solved by some small edits to header files to make sure the two don't bash on each other.
 
== References ==
 
* Tip of the hat to Nicky_Perian for [[User:Nicky_Perian/Visual_Studio_10_Autobuild]]
 
[[Category:Compiling viewer]]

Latest revision as of 11:26, 23 April 2015

Redirect to:

Retrieved from "https://wiki.secondlife.com/w/index.php?title=Viewer_2_Microsoft_Windows_Builds&oldid=1196247"