<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/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/Windows">Windows</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~dsessions">Darren Sessions</a>
</h4>
<br/>
<h4>Changes (0)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-snipped" >...<br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<h2><a name="Windows-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="Windows-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> - Note that version 1.44.0 is the most recent version tested wtih Asterisk SCF, and there is at least one known problem with the version 1.46.1 installer.</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>
        <li>OpenSSL 0.9.8r - <a href="http://www.slproweb.com/products/Win32OpenSSL.html" class="external-link" rel="nofollow">http://www.slproweb.com/products/Win32OpenSSL.html</a>
        <ul>
                <li>Install the full version. The Light version recommended on the page above does not include development libraries and headers.</li>
        </ul>
        </li>
</ul>
<style type="text/css">
@media all {
.expand-content { margin-left: 20px; }
.expand-control-icon { display: inline-block; width: 20px; }
.expand-control-text { vertical-align: top; text-decoration:none; }
.expand-control-image { vertical-align: middle; text-decoration:none; }
}
@media screen {
.expand-hidden { display: none; }
.expand-control { cursor: pointer; text-decoration: none; }
}
@media print {
/* show expander text in print */
.expand-content { display: block !important; }
}
</style>
<div id="expander-861414065" class="expand-control" tabindex="0"><span class="expand-control-icon"><img class="expand-control-image" src="/wiki/images/icons/arrow_down.png"></span><span class="expand-control-text">Java support (optional)</span></div>
<div class="expand-content"><ul>
        <li>Oracle's <a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" class="external-link" rel="nofollow">Java Development Kit</a>, Java SE 6</li>
        <li><a href="http://ant.apache.org" class="external-link" rel="nofollow">Apache Ant</a></li>
</ul>
</div>
<h2><a name="Windows-32bitInstallation"></a>32-bit Installation</h2>
<ul>
        <li><h6><a name="Windows-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' and 'Context menu entries' options; they 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 and included Unix tools from the Windows Command Prompt' option so that Git and bash will be in your PATH.</td></tr></table></div></li>
        <li><h6><a name="Windows-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="Windows-LUA"></a>LUA</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>You can deselect all the optional packages in the installer except for 'Lua Module Development files'.</td></tr></table></div></li>
        <li><h6><a name="Windows-DirectXSDK"></a>DirectX SDK</h6></li>
        <li><h6><a name="Windows-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 DLL' and 'Multithreaded Debug DLL' 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="Windows-IceThirdPartyLibraries"></a>Ice Third Party 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>After the installation, you will need to add 'C:\Program Files\ZeroC\Ice-3.4.2-ThirdParty\bin\vc100' to your system's PATH.</td></tr></table></div></li>
        <li><h6><a name="Windows-Digium%27sIceDistribution%28fromaVisualStudio2010CommandPrompt%29"></a>Digium's Ice Distribution (from a Visual Studio 2010 Command Prompt)</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=VC100_EXPRESS (if you are using VS2010 Express)
set CPP_COMPILER=VC100 (if you are using VS2010 Professional)
cd ice\cpp\src
nmake -f Makefile.mak
cd ..
nmake -f Makefile.mak install
</pre>
</div></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>By default, the Ice build produces 'debug' libraries and binaries. This means that you will only be able to produce 'debug' components during the Asterisk SCF build process, as the library type (release or debug) must match. If you wish to be able to produce 'release' components of Asterisk SCF, then you'll also need to produce a 'release' build of Ice; you can do that by editing the ice\cpp\config\Make.rules.mak file and uncommenting the line that disables optimization ("OPTIMIZE = yes").</td></tr></table></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>If you are using Visual Studio Express, not Visual Studio Professional, and you try build <b>all</b> of the Ice C++ mapping (including demos and self tests), you will receive an error when the system attempts to build the "MFC" demos for Ice. This occurs because Visual Studio Express does not include MFC. Unless you need to use this specific demo for some purpose, though, you can ignore this error and complete the Ice installation.</td></tr></table></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>After the installation, you will need to add 'C:\Ice-3.4.2\bin' to your system's PATH.</td></tr></table></div></li>
        <li><h6><a name="Windows-Digium%27sSliceTranslatorPlugins%28fromaVisualStudio2010CommandPrompt%29"></a>Digium's Slice Translator Plugins (from a Visual Studio 2010 Command Prompt)</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="Windows-AsteriskSCF%28fromaVisualStudio2010CommandPrompt%29"></a>Asterisk SCF (from a Visual Studio 2010 Command Prompt)</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
</pre>
</div></div>
<p>Now you can decide between which method you want to use to build Asterisk SCF itself.</p>
        <ul>
                <li>Build using the Visual Studio IDE or msbuild (from a Visual Studio 2010 Command Prompt)
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>bash cmake\init-cmake.sh
</pre>
</div></div>
                <ul>
                        <li>To build from within the Visual Studio IDE, 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 to be upgraded; if you do, let Visual Studio perform the upgrades. Once the solution is open, choose "Build Solution" from the "Build" menu, and the entire Asterisk SCF build will proceed.</li>
                        <li>To build using msbuild:
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cmake --build ./build
</pre>
</div></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>At this time there are some unresolved dependency problems in the project files generated by CMake, and when the build completes, you may see CMake report some errors. If this occurs, just run the CMake build command above a second time, and the remaining parts of the projects will be built properly.</td></tr></table></div></li>
                </ul>
                </li>
                <li>Build from the command line (from a Visual Studio 2010 Command Prompt)
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>bash cmake\init-cmake.sh --nmake
cmake --build ./build
</pre>
</div></div></li>
        </ul>
        </li>
</ul>
<style type="text/css">
@media all {
.expand-content { margin-left: 20px; }
.expand-control-icon { display: inline-block; width: 20px; }
.expand-control-text { vertical-align: top; text-decoration:none; }
.expand-control-image { vertical-align: middle; text-decoration:none; }
}
@media screen {
.expand-hidden { display: none; }
.expand-control { cursor: pointer; text-decoration: none; }
}
@media print {
/* show expander text in print */
.expand-content { display: block !important; }
}
</style>
<div id="expander-1162362021" class="expand-control" tabindex="0"><span class="expand-control-icon"><img class="expand-control-image" src="/wiki/images/icons/arrow_down.png"></span><span class="expand-control-text">Java support (optional)</span></div>
<div class="expand-content"><ul>
        <li><h6><a name="Windows-ApacheAnt"></a>Apache Ant</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>Extract the <tt>apache-ant-VERSION.zip</tt> file to wherever you wish. Set the environment variable <tt>ANT_HOME</tt> to the extracted copy of Ant, and add <tt>%ANT_HOME%\bin</tt> to your path. Also set the environment variable <tt>JAVA_HOME</tt> to point to your JDK installation.</td></tr></table></div></li>
        <li><h6><a name="Windows-IceforJava%28fromaVisualStudio2010CommandPrompt%29"></a>Ice for Java (from a Visual Studio 2010 Command Prompt)</h6>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cd <YOURBUILDDIR>\ice\java
nmake -f Makefile.mak all install
</pre>
</div></div></li>
        <li><h6><a name="Windows-BuildJavabindingsseeBuildingJavacomponents"></a>Build Java bindings - see <a href="/wiki/display/TOP/Building+Java+components" title="Building Java components">Building Java components</a></h6></li>
</ul>
</div>
<h2><a name="Windows-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>
<h2><a name="Windows-RunningUnitTests"></a>Running Unit Tests</h2>
<p>The unit tests can be run via CMake's CTest tool, or from within the Visual Studio IDE.</p>
<ul>
        <li>To run tests within Visual Studio, right-click the RUN_TESTS project of the AsteriskSCF solution, and select 'Build'.</li>
        <li>To run the tests from the command line, run 'ctest' specifying the type of build (Debug, Release, etc.) that you performed:
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>cd <YOURBUILDDIR>
cd gitall\build
ctest -C Debug
</pre>
</div></div></li>
</ul>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=TOP">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/TOP/Windows">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=6586426&revisedVersion=57&originalVersion=56">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/TOP/Windows?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>