<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/2042/1/7/_/styles/combined.css?spaceKey=TOP&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/TOP/Building+-+Windows+%28WIP%29">Building - Windows (WIP)</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~kpfleming">Kevin P. Fleming</a>
</h4>
<div id="versionComment">
<b>Comment:</b>
updated notes and clarifications<br />
</div>
<br/>
<h4>Changes (24)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.Preface <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">h2. Preface <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" >These instructions explain how to build Asterisk SCF on a clean, updated, basic Windows installation. This process is for building native (unmanaged) <span class="diff-changed-words">C+<span class="diff-added-chars"style="background-color: #dfd;">\</span>+</span> components. <br></td></tr>
<tr><td class="diff-unchanged" > <br>{info} <br></td></tr>
<tr><td class="diff-unchanged" >All Asterisk SCF core components are implemented in C++. For developers who wish to build components in .NET languages, read [Building .NET Components for Asterisk SCF]. <br></td></tr>
<tr><td class="diff-unchanged" >{info} <br> <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words">h2.<span class="diff-added-chars"style="background-color: #dfd;"> </span>Software</span> Requirements <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">* msysgit (Git for Windows) - [http://code.google.com/p/msysgit/] <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">* Git for Windows - [http://code.google.com/p/msysgit/]&nbsp;\- Don't download mSysGit; that is an environment for building Git from source. <br></td></tr>
<tr><td class="diff-unchanged" >* CMake - [http://www.cmake.org/cmake/resources/software.html] <br>* LUA - [http://code.google.com/p/luaforwindows/] <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >* BoostPro Libraries - [http://www.boostpro.com/download/] <br>* Ice Third Party Libraries - [http://www.zeroc.com/download.html] <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">* Visual Studio C++ 2008 Express [http://www.microsoft.com/express/Downloads/] or Visual Studio 2008 Professional <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">* Visual Studio C+\+ 2010 Express \-&nbsp;[http://www.microsoft.com/express/Downloads/] or Visual Studio 2010 Professional <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words">h2.<span class="diff-added-chars"style="background-color: #dfd;"> </span>32-bit</span> Installation <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">* h6.msysgit <br>{info}You must select the option to put *everything* in your system path.{info} <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">* h6. Git for Windows <br>{info}For convenience, enable the 'Windows Explorer integration' option; this will allow you to easily open a bash shell in any folder you can navigate to.&nbsp;\\ <br>Select the 'Run Git from the Windows Command Prompt' option so that Git will be in your PATH.{info} <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>CMake</span> <br></td></tr>
<tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{info}You must select the option to put CMake in your system path.{info} <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">{info}By default, you will be able to run CMake as a GUI application from the Start menu. If you'd also like to be able to run CMake from the command line, select either 'Add CMake to the system PATH for all users' or 'Add CMake to the system PATH for the current user', depending on your preference.{info} <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>LUA</span> <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>DirectX</span> SDK <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>BoostPro</span> Libraries <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">{info} <br>Select 'Visual C++ 10.0 (Visual Studio 2010)' as the compiler and the 'Multithreaded' and 'Multithreaded debug' variants to install. On the 'Components' page, deselect 'Source and Documentation' to save some download time and disk space (the source is not necessary, and the complete documentation is available online). <br>{info} <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>Ice</span> Third Party Libraries <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>Digium's</span> Ice Distribution <br></td></tr>
<tr><td class="diff-unchanged" >{noformat} <br>cd <YOURBUILDDIR> <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >nmake -f Makefile.mak <br>{noformat} <br></td></tr>
<tr><td class="diff-changed-lines" >{info}If you do not have Microsoft's Foundation Class library installed (which is not included in Visual Studio <span class="diff-changed-words">C+<span class="diff-added-chars"style="background-color: #dfd;">\</span>+</span> 2008 Express), you'll get an error at the end of the make process about not being able to build 'HelloClient'. <br></td></tr>
<tr><td class="diff-unchanged" >You can safely disregard this error message and continue with the build instructions.{info} <br>{noformat} <br>nmake -f Makefile.mak install <br>{noformat} <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>Digium's</span> Slice Translator Plugins <br></td></tr>
<tr><td class="diff-unchanged" >{noformat} <br>cd <YOURBUILDDIR> <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >nmake install <br>{noformat} <br></td></tr>
<tr><td class="diff-changed-lines" >* <span class="diff-changed-words">h6.<span class="diff-added-chars"style="background-color: #dfd;"> </span>Asterisk</span> SCF <br></td></tr>
<tr><td class="diff-unchanged" >{noformat} <br>cd <YOURBUILDDIR> <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >Now open Visual Studio and open the "Asterisk SCF" solution file generated by CMake in the 'build' subdirectory of the 'gitall' directory. You may seem some warnings about project files needing upgrading; if you do, let Visual Studio perform the upgrades. Once the solution is open, choose "Build Solutiion" from the "Build" menu, and the entire Asterisk SCF build will proceed. <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words">h2.<span class="diff-added-chars"style="background-color: #dfd;"> </span>64-bit</span> Installation <br></td></tr>
<tr><td class="diff-unchanged" >{info}Forthcoming{info} <br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<h2><a name="Building-Windows%28WIP%29-Preface"></a>Preface</h2>
<p>These instructions explain how to build Asterisk SCF on a clean, updated, basic Windows installation. This process is for building native (unmanaged) C++ components.</p>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>All Asterisk SCF core components are implemented in C++. For developers who wish to build components in .NET languages, read <a href="/wiki/display/TOP/Building+.NET+Components+for+Asterisk+SCF" title="Building .NET Components for Asterisk SCF">Building .NET Components for Asterisk SCF</a>.</td></tr></table></div>
<h2><a name="Building-Windows%28WIP%29-SoftwareRequirements"></a>Software Requirements</h2>
<ul>
<li>Git for Windows - <a href="http://code.google.com/p/msysgit/" class="external-link" rel="nofollow">http://code.google.com/p/msysgit/</a> - Don't download mSysGit; that is an environment for building Git from source.</li>
<li>CMake - <a href="http://www.cmake.org/cmake/resources/software.html" class="external-link" rel="nofollow">http://www.cmake.org/cmake/resources/software.html</a></li>
<li>LUA - <a href="http://code.google.com/p/luaforwindows/" class="external-link" rel="nofollow">http://code.google.com/p/luaforwindows/</a></li>
<li>DirectX SDK - <a href="http://msdn.microsoft.com/en-us/directx/aa937788.aspx" class="external-link" rel="nofollow">http://msdn.microsoft.com/en-us/directx/aa937788.aspx</a></li>
<li>BoostPro Libraries - <a href="http://www.boostpro.com/download/" class="external-link" rel="nofollow">http://www.boostpro.com/download/</a></li>
<li>Ice Third Party Libraries - <a href="http://www.zeroc.com/download.html" class="external-link" rel="nofollow">http://www.zeroc.com/download.html</a></li>
<li>Visual Studio C++ 2010 Express - <a href="http://www.microsoft.com/express/Downloads/" class="external-link" rel="nofollow">http://www.microsoft.com/express/Downloads/</a> or Visual Studio 2010 Professional</li>
</ul>
<h2><a name="Building-Windows%28WIP%29-32bitInstallation"></a>32-bit Installation</h2>
<ul>
<li><h6><a name="Building-Windows%28WIP%29-GitforWindows"></a>Git for Windows</h6>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>For convenience, enable the 'Windows Explorer integration' option; this will allow you to easily open a bash shell in any folder you can navigate to. <br class="atl-forced-newline" />
Select the 'Run Git from the Windows Command Prompt' option so that Git will be in your PATH.</td></tr></table></div></li>
<li><h6><a name="Building-Windows%28WIP%29-CMake"></a>CMake</h6>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>By default, you will be able to run CMake as a GUI application from the Start menu. If you'd also like to be able to run CMake from the command line, select either 'Add CMake to the system PATH for all users' or 'Add CMake to the system PATH for the current user', depending on your preference.</td></tr></table></div></li>
<li><h6><a name="Building-Windows%28WIP%29-LUA"></a>LUA</h6></li>
<li><h6><a name="Building-Windows%28WIP%29-DirectXSDK"></a>DirectX SDK</h6></li>
<li><h6><a name="Building-Windows%28WIP%29-BoostProLibraries"></a>BoostPro Libraries</h6>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>Select 'Visual C++ 10.0 (Visual Studio 2010)' as the compiler and the 'Multithreaded' and 'Multithreaded debug' variants to install. On the 'Components' page, deselect 'Source and Documentation' to save some download time and disk space (the source is not necessary, and the complete documentation is available online).</td></tr></table></div></li>
<li><h6><a name="Building-Windows%28WIP%29-IceThirdPartyLibraries"></a>Ice Third Party Libraries</h6></li>
<li><h6><a name="Building-Windows%28WIP%29-Digium%27sIceDistribution"></a>Digium's Ice Distribution</h6>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cd <YOURBUILDDIR>
git clone git://git.asterisk.org/asterisk-scf/release/ice
set CPP_COMPILER=VC90_EXPRESS (if you are using VS2008 Express)
set CPP_COMPILER=VC90 (if you are using VS Professional)
cd ice\cpp
nmake -f Makefile.mak
</pre>
</div></div>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>If you do not have Microsoft's Foundation Class library installed (which is not included in Visual Studio C++ 2008 Express), you'll get an error at the end of the make process about not being able to build 'HelloClient'.<br/>
You can safely disregard this error message and continue with the build instructions.</td></tr></table></div>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>nmake -f Makefile.mak install
</pre>
</div></div></li>
<li><h6><a name="Building-Windows%28WIP%29-Digium%27sSliceTranslatorPlugins"></a>Digium's Slice Translator Plugins</h6>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cd <YOURBUILDDIR>
git clone git://git.asterisk.org/asterisk-scf/release/slice-plugins
cd slice-plugins
cmake -G "NMake Makefiles" .
nmake
nmake install
</pre>
</div></div></li>
<li><h6><a name="Building-Windows%28WIP%29-AsteriskSCF"></a>Asterisk SCF</h6>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cd <YOURBUILDDIR>
git clone git://git.asterisk.org/asterisk-scf/integration/gitall
cd gitall
bash ./gitall-asterisk-scf.sh
bash ./cmake/init-cmake.sh
</pre>
</div></div>
<p>Now open Visual Studio and open the "Asterisk SCF" solution file generated by CMake in the 'build' subdirectory of the 'gitall' directory. You may seem some warnings about project files needing upgrading; if you do, let Visual Studio perform the upgrades. Once the solution is open, choose "Build Solutiion" from the "Build" menu, and the entire Asterisk SCF build will proceed.</p></li>
</ul>
<h2><a name="Building-Windows%28WIP%29-64bitInstallation"></a>64-bit Installation</h2>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>Forthcoming</td></tr></table></div>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;">
<a href="https://wiki.asterisk.org/wiki/users/viewnotifications.action" class="grey">Change Notification Preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/TOP/Building+-+Windows+%28WIP%29">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=6586426&revisedVersion=29&originalVersion=28">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/TOP/Building+-+Windows+%28WIP%29?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>