View source for Building with an older Version of Visual Studio

Visual Studio 2008 and 2010 are the currently supported version for R6 development. The information for older version is kept here but has not been updated for R6.

If a development environment is already setup, please jump directly to the build instructions by clicking the appropriate link below:

[[#Visual Studio 6.0]]

[[#Visual Studio .NET 2002]]

[[#Visual Studio .NET 2003]]

[[#Visual Studio 2005/2008 Express]]

[[#Visual Studio 2005 SP1]]


====Important notes regarding Express & Starter editions====
* You must also download and install the Windows SDK [http://download.microsoft.com/download/f/e/6/fe6eb291-e187-4b06-ad78-bb45d066c30f/6.0.6001.18000.367-KRMSDK_EN.iso (iso)] [http://download.microsoft.com/download/2/3/f/23f86204-39ee-4cd7-9a51-db19c9a8f8c4/Setup.exe (web-install)] and DX9 SDK [http://www.microsoft.com/downloads/details.aspx?FamilyID=b66e14b8-8505-4b17-bf80-edb2df5abad4&displaylang=en (web-install)]
* In your Express/Starter edition of Visual studio, you have to add the SDK files to your VC++ Directories options manually:
** Tools->Options...
*** Expand (+) Projects and Solutions->VC++ Directories
**** Select ''Executable files'' then add your Windows & DirectX SDK \bin paths, Select ''Include files'', add your Win & DX SDK \include paths and lastly select ''Library files'' then add your SDK & DX's \lib paths.  For your DX SDK lib path be sure to append ''x86'' to the end. (i.e. G:\DX9\Lib\x86) Pay close attention to these directories, the DX SDK ones especially! {{ScaledDown|Visual_Studio_2008_Express_Solution_Setup.jpg}}
* ATL/MFC is no longer available in the current Windows SDK, [[#Fatal_error_C1083|expect errors]], '''you won't be able to build the AllSrv, AllSrvUI or AGC projects'''.
** You can download an [http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdk-full.htm old Windows SDK] and copy the include files from ...\include\Win64\mfc and ...\include\Win64\atl into your current Windows SDK include folder. (you can then build everything except AllServUI targeting x86)

* Solution folders are not supported, expect errors immediately when you load, they are mostly harmless.

{{Note|'''For 2005 Express Users Only:'''

In this file (vs install location):
: <tt>\VC\VCProjectDefaults\corewin_express.vsprops</tt>
replace this line:
: <tt>AdditionalDependencies{{=}}"kernel32.lib" /></tt>
with this line:
: <tt>AdditionalDependencies{{=}}"kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib" /></tt>
}}

===Visual Studio 6.0===
{{Warn|This development environment is no longer maintained by the FAZ Development team.}}
The ''FAZ_R4'' tag in SVN contains solution files suitable for building with the VS98 IDE, your millage may vary.  Available also to you is the ''makefile'' build method.  The root makefile reads ONE environment variable necessary for a successful build, '''%FEDROOT%'''.
*Set this variable from a command prompt, it will be cleared out when Windows reboots. 
**Set it from My Computer as a System variable to get it to "stick", C:\>set '''FEDROOT=C:\alleg_src'''.  
*You need your entire environment's SDK's within the FEDROOT path in a folder named '''extern'''.
{{Note|If you set your FEDROOT as the path in the above example (C:\alleg_src) you should make a directory 'extern' in C:\alleg_src}}
*Verify your extern directory contains the following structure: 
<pre>		- DirectX SDK (Make file defaults to dx7)
dx7\
    include\
    lib\

		- DirectX SDK (optional)
dx9\
    include\
    lib\

		- The ICQ API
icqapi\

		- Site Builder Network SDK
		(MSXML includes and UUID.lib go here if not in vc\)
sbn\
    include\
    lib\
        nt50\

		- Your MS Visual Studio\Common\MSDev98\Bin files (or equivalent)
SharedIDE\
	Bin\
		IDE\

		- Your MS Visual C++ headers and libraries (or equivalent)
vc\
    atl\
       inc\
    bin\
    inc\
        sys\
    lib\
    MFC\
    	Include\
    	Lib\
    	SRC\
</pre>
*Open a command prompt and navigate to the root of the src directory
**Like this Start->Run... fill the input line with cmd and press return key or click OK.
<pre> C:\> cd folder_of_source
      C:\folder_of_source> cd src
      C:\folder_of_source\src> nmake 
</pre>
*Nmake.exe can be sent a number of optional arguments/targets to build different types of the binaries:
<pre>            full - specifies the default target (all) and deletes all the Objs for a complete rebuild

            debug= - on by default, makes binaries with debugging/trace information

            retail= - builds smallest fastest binaries possible

            VERBOSE= - Shows commands (breaks MC)

            ALLEGIANCE_DEV=1 - recommended you set this for any tests builds

            HTTP=1 - define this to enable the auth implementation

            USEASGS=1 - uses the ASGS auth stuff (Only if HTTP is defined)

            USEAUTH=1 - use the Zone auth stuff (Legacy)

            DXn=1 - Use DirectX n SDK instead of default (7)
</pre>
*Examples from a Command shell
<pre>C:\alleg_src\src>nmake retail=</pre>
The above example will build most of everything in alleg_src. Your executables will use the Allegiance/1.1 [[#Registry keys]], find them in the /objs folder, '''you're done!'''.

These solution and make files are removed in R5.
===Visual Studio .NET 2002===
{{Warn|This development environment is no longer maintained by the FAZ Development team.}}
{{sec-stub}}
These solution files are removed in R5.

===Visual Studio .NET 2003===
{{Warn|This development environment is no longer maintained by the FAZ Development team.}}
{{sec-stub}}
These solution files are removed in R5.

===Visual Studio 2005/2008 Express===
{{Note|Download and install Service Pack 1 (2008) [http://download.microsoft.com/download/a/5/4/a54badb6-9c3f-478d-8657-93b3fc9fe62d/vcsetup.exe (exe)] 
It's very important to keep your development environment up to date.}}
* Double click on the VS200''n''\Allegiance.sln in your checkout folder.
* Find the drop down box in the toolbar near the top menu bar, make sure it says {{Verbatim|FZDebug}}
** The FZRetail build flavor should only be used for releases.
* From the {{verbatim|Build}} menu click {{verbatim|Build Solution}} (or press F7).
* Your executables will use the Allegiance/1.1 [[#Registry keys]], find them in the \objs9 folder for VS2008 or \objs for VS2005, '''you're done!'''.

===Visual Studio 2005 SP1===
{{Warn|This development environment is being deprecated in R6.}}
{{Note|Download and install Service Pack 1 [http://download.microsoft.com/download/6/3/c/63c69e5d-74c9-48ea-b905-30ac3831f288/VS80sp1-KB926601-X86-ENU.exe (exe)] 
It's very important to keep your development environment up to date.}}
* Double click on the VS2005\Allegiance.sln in your checkout folder.
* Just like in [[#Important notes regarding Express & Starter editions]], add your [http://download.microsoft.com/download/3/A/5/3A53CE87-F5C9-4CE5-92E1-5E2AF4841741/DXSDK_Mar09.exe DirectX SDK] lib\''ARCH'' and \include.
** '''Important:''' ''ARCH'' is either x86 or x64, you can use the $(PlatformShortName) macro, for example <tt>G:\DX9\lib\$(PlatformShortName)</tt>
* Find the drop down box in the toolbar near the top menu bar, if it says {{Verbatim|Debug}},change this to {{Verbatim|FZDebug}}
** The FZRetail build flavor should only be used for releases.
* From the {{verbatim|Build}} menu click {{verbatim|Build Solution}} (or press F7).
* Your executables will use the Allegiance/1.1 [[#Registry keys]], find them in the \objs folder, '''you're done!'''.