Difference between revisions of "Microsoft Visual Studio"

From Second Life Wiki
Jump to navigation Jump to search
(Merging with Microsoft Windows Builds)
Line 1: Line 1:
{{CompileNav}}
#REDIRECT [[Microsoft Windows Builds]]
= Setting up the Microsoft Visual Studio =
 
This page describes installation and configuration properties for Microsoft Visual Studio (MSVS) as it relates to a development environment for Second Life.
 
Recognized MSVS versions include:
 
* Visual Studio .NET 2003 Professional
* Visual Studio 2005 Professional
* Visual C++ 2005 Express
* (Visual Studio/C++ 2008 is not covered yet.)
 
== Download Express (optional) ==
 
If you do not already own one of the above recognized version, then you may download Microsoft's free IDE and compiler editions.
 
[http://www.microsoft.com/express/2005/ Click here to download Visual C++ 2005 Express]
 
Make sure to apply the [http://www.microsoft.com/downloads/details.aspx?FamilyID=7b0b0339-613a-46e6-ab4d-080d4d4a8c4e  Service Pack 1] for the newly downloaded Visual C++ 2005 Express, since the one available through the above link seems a pre-SP1 installer.  If you are using Windows Vista for development, you will need [http://www.microsoft.com/downloads/details.aspx?FamilyID=90e2942d-3ad1-4873-a2ee-4acc0aace5b6  Visual Studio 2005 Service Pack 1 Update for Windows Vista], too.
 
Note that, although the latest version of Visual C++ Express Edition is 2008, it is recommended to use 2005 version for the purpose of Second Life development for the moment.  This page will be updated when we get enough experiences on VC++ 2008.
 
== Install Microsoft Platform & DirectX SDKs ==
 
Download and install:
* [http://www.microsoft.com/downloads/details.aspx?familyid=0BAF2B35-C656-4969-ACE8-E4C0C0716ADB&displaylang=en Microsoft Platform SDK]
* [http://download.microsoft.com/download/5/1/f/51ff8357-0af3-418b-9d0b-e9a5cdc39759/dxsdk_dec2006.EXE DirectX 9.0 SDK (December 2006)]
 
If you have previously installed an older version of the DirectX 9.0 SDK, remove it first (from Control Panel -> Add or Remove Programs) before installing this version.  Installing the new SDK "on top" of an older version may cause problems. Upon installing DirectX, it is sufficient to install only the '''Headers and Libs''' part.  Other DX development tools are not necessary.
 
'''NOTE:''' Default installation of both Platform SDK and DirectX SDK can be found in
* '''C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2''' and
* '''C:\Program Files\Microsoft DirectX SDK (December 2006)''', respectively.
 
== Setup the project globals ==
* Start Visual Studio
* Go to Tools > Options > Projects > VC++ Directories
* Make sure that the '''includes''' and '''libraries''' paths ("Include files" and "Library files" in the "show directories for" dropdown) exist, and add them if they don't, in the following order: (see screenshots below)
*# Platform SDK paths
*# DirectX SDK paths
*# Visual C++ paths
**'''NOTE:''' The newest DirectX SDK ("December 2006") lib folder has two sub-folders, x64 and x86.  Make sure your path goes to one of them (select '''lib/x86''', not just '''lib'''), or you will get a Link error.  For the Windows Platform SDK, there is ''not'' a subfolder for x86 (even though there are subfolders for AMD64, IA64, etc.), so do ''not'' select a subfolder for the Windows Platform SDK.
* Also, make sure that your cygwin (default C:\cygwin\bin) and ActivePython (default C:\Python25) directories are under the "Executable files" dirs and moved to the bottom of the list.  (Even if you update your PATH environment variable, those changes will NOT be reflected inside Visual Studio!)
 
== Compiling the Second Life viewer ==
 
Refer to these topics on how to compile the viewer with Microsoft Visual Studio:
 
* [[Compiling the viewer (MSVS2003)|Microsoft Windows - Visual Studio .NET 2003]] (recommended, Linden Lab uses VS2003)
** see also: [[Compiling the viewer libraries (MSVS 2003)]]
* [[Compiling the viewer (MSVS2005)|Microsoft Windows - Visual Studio 2005 & Visual C++ 2005 Express]]
 
Following alternative methods are also available for experienced developers:
 
* [[User:Dzonatas Sol/Compiling The Viewer|Building with SCons]] (can build without project files, based on python)
* [[CMake|Building with CMake]] (generates project files to build -- experimental)
 
== Screenshots ==
 
* Example screenshot of Tools > Options > Projects > VC++ Directories > Includes files
[[Image:MSVS2005 Global Project Options Include Files.JPG|center]]
<br/>
 
* Example screenshot of Tools > Options > Projects > VC++ Directories > Libraries files
[[Image:MSVS2005 Global Project Options Library Files.JPG|center]]
 
[[Category:Compiling viewer]]

Revision as of 17:51, 28 October 2008