build.html 2.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. <?php
  2. $title = "Building WebKit";
  3. include("../header.inc");
  4. ?>
  5. <h2>Building WebKit</h2>
  6. Building WebKit requires that you have the proper <a href="tools.html">developer tools
  7. installed</a> and that you have a copy of the <a href="checkout.html">WebKit source tree</a>.
  8. <div class="windows-instructions">
  9. <h4>Windows</h4>
  10. <ol>
  11. <li><p>Open a Cygwin Shell (if not already open from checking out sources)</p>
  12. <p>Double-click the Cygwin icon on your Desktop to launch a new shell.
  13. </ol>
  14. </div>
  15. <ol>
  16. <li><p>Run the <code>build-webkit</code> <a href="/coding/scripts.html">script</a>
  17. to build WebKit.</p>
  18. <p>Use the <code>--debug</code> option for a debug build, which includes
  19. debugging symbols and assertions:</p>
  20. <p class="code">build-webkit --debug</p>
  21. </li>
  22. </ol>
  23. <p>By default, <code>build-webkit</code> places build products in <code>WebKitBuild</code>. You can specify a different build
  24. location on Mac in your Xcode preferences. On other platforms, the <code>WEBKIT_OUTPUTDIR</code> environment variable can be used to
  25. set a different build products location. If you have set up a custom build location, then <code>build-webkit</code> will
  26. place the build products there.</p>
  27. <div class="windows-instructions">
  28. <h4>Windows</h4>
  29. <p>A common source of build errors on Windows is Visual C++ Express forgetting the Platform SDK paths. If you have trouble building WebKit,
  30. double check that the paths you set during <a href="http://msdn.microsoft.com/en-us/library/ms235626(VS.80).aspx">step 2 of the Platform SDK Installation</a>
  31. are still there and add them again if necessary.</p>
  32. <p>Building on Windows requires a few more steps, you should look at: http://trac.webkit.org/wiki/BuildingOnWindows</p>
  33. <p>Don't forget that if you have any questions or problems building WebKit, feel free to <a href="/contact.html">get in touch!</a></p>
  34. </div>
  35. <p>Once your build has finished, you can <a href="run.html">run it inside
  36. Safari.</a></p>
  37. <h2>Building WebKit from Xcode</h2>
  38. <p>To build from within Xcode, you can use the WebKit workspace. Ensure that the Products and Intermediates locations for the workspace match those used by <code>build-webkit</code> by choosing File > Workspace Settings and clicking the Advanced button, selecting Custom, Relative to Workspace, and entering WebKitBuild both for Products and for Intermediates. Note that if you have specified a custom build location in Xcode preferences, then you don&rsquo;t need to do this.</p>
  39. <h2>Setting a Default Configuration</h2>
  40. <ol>
  41. <li><p>To set a default build configuration for <code>build-webkit</code> and
  42. other <a href="/coding/scripts.html">scripts</a>, use the
  43. <code>set-webkit-configuration</code> script:</p>
  44. <p class="code">set-webkit-configuration --debug</p>
  45. <p class="code">set-webkit-configuration --release</p>
  46. </li>
  47. </ol>
  48. <?php
  49. include("../footer.inc");
  50. ?>