WebKitSite/building/debug.html

   1 <?php
   2     $title = "Debugging WebKit";
   3     include("../header.inc");
   4 ?>
   5
   6 <h2>Debugging WebKit</h2>
   7 <ol>
   8 <li><p>Open a project</p>
   9 <p>Each WebKit component -- JavaScriptCore, WebCore, and WebKit -- contains its own Xcode project. Open the project belonging to the component you want to debug.</p>
  10 </li>
  11 <li><p>Set the project's build products location</p>
  12 <p>To find the WebKit you built, Xcode needs to know the build products location that <tt>build-webkit</tt> used. You can set the build products location from the project's Info window.</p>
  13 <img src="info-tab.png">
  14 </li>
  15 <li><p>Set the project's active build configuration</p>
  16 <p>Xcode also needs to know the build configuration you used. You can set the active build configuration from the project's Build window.</p>
  17 <img src="build-window.png">
  18 </li>
  19 <li><p>Add a custom executable to the project</p>
  20 <p>Choose any WebKit application you want to use for debugging. To use Safari, select /Applications/Safari.app.</p>
  21 <img src="custom-executable.png">
  22 </li>
  23 <li><p>Set the project's active executable</p>
  24 <p>You can set the active executable from the project's Build window. Choose the executable you just added.</p>
  25 </li>
  26 <li><p>Close and re-open the project</p>
  27 <p>This will force Xcode to discover generated source files, which output to your build products location, allowing you to set breakpoints in them.</p>
  28 </li>
  29 <li><p>Launch the debugger</p>
  30 <p>In the Debugger window, click the "Debug" button.</p>
  31 <img src="debug.png">
  32 </li>
  33 </ol>
  34
  35 <?php
  36     include("../footer.inc");
  37 ?>