Debugging on Mac OS X

To debug from within Xcode, you can use the WebKit workspace. Ensure that the Products and Intermediates locations for the workspace match those used by build-webkit 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’t need to do this.

Debugging UIProcess

Follow the instructions on the debugging UIProcess page.

Debugging WebProcess

Debugging on Windows

  1. Open Source/WebKit/WebKit.vcxproj/WebKit.sln

    You can open it in either Visual Studio 2010, or Visual C++ Express 2010. If you get errors about not being able to find .props files, run update-webkit, then close and relaunch Cygwin and Visual Studio or Visual C++ Express.

  2. Set WinLauncher as the solution's StartUp project

    Select the WinLauncher project in the Solution Explorer, then choose Project > Set as StartUp Project. This will cause the project to turn bold in the Solution Explorer.

  3. Launch the debugger

    Choose Debug > Start Debugging.

  4. Alternatively, you can debug layout tests with DumpRenderTree

    Set DumpRenderTreeLauncher as your startup project, set the layout test as a command argument, and launch the debugger.

    In DumpRenderTreeLauncher's properties, go to Configuration Properties->Debugging and set the Command Arguments field to the full path of the layout test you want to debug, see below: