Source/WebKit/WebKit.vcxproj/WebKit.slnusing Visual Studio 2013 or Visual Studio Express (Desktop) 2013 or later.
If you get errors about not being able to find
.props files, run
Tools/Scripts/update-webkit, then close and relaunch Cygwin and Visual Studio or Visual Studio Express.
WinLauncheras the solution's
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.
- Launch the debugger
Debug > Start Debugging.
DumpRenderTreeLauncheras your startup project.
- Configure the arguments and environment variables for the test runner.
In the DumpRenderTree project in the Solution Explorer window, right-click and select
- In the
Command Argumentssection, enter the absolute paths for the tests you want to run, separated by spaces.
- In the
PATH=$(ProgramFiles)\Common Files\Apple\Apple Application Support;$(PATH)
Click OK to close the Project Properties window.
- Launch the debugger.
Right-click on the DumpRenderTree project, and choose
Debug > Start New Instance.
(Ed. note: These instructions were written for VS2005 and are likely outdated)
- Make sure the Use WebKit2 for New Tabs option is enabled in Safari’s Debug menu
- Right after you tell Visual Studio to Run the version of Safari that you just built, hold down the Shift-Control-Alt keys
- A dialog should pop up to notify that you can now attach a debugger to the
WebProcess— (Do not click OK yet!)
- In Visual Studio select Attach to Process… in the Debug Menu.
- In the window that comes up, select the
WebKit2WebProcesswith the title "WebKit2WebProcess has launched", and Attach
- Go back to the dialog from Step 3 and click OK
You’re now debugging both the
UIProcess and the
WebProcess. Your breakpoints in either should work accordingly.
Alternatively, you can add a VS Toolbar Item to attach to the
Using the Microsoft and Safari Symbol Servers
Follow the instructions for using the Microsoft and Safari symbol servers so that Visual Studio can show you backtraces that involve closed-source components.
Using Watch Window
You can open any of the Watch windows using the
Debug > Windows > Watch submenu.
MSDN Magazine published a very useful article about Watch window pseudo-variables and format specifiers. Those of particular interest to WebKit developers are mentioned explicitly below, but the whole article is worth a read.
$err,hrto the Watch Window will show you what
::GetLastError()would return at this moment, and will show you both the numerical error value and the error string associated with it.
When debugging code that uses CF types, you can invoke the CFShow function in the Immediate window (
Debug > Windows > Immediate or
Ctrl+Alt+I) to print a debug description of a CF object to the Output window like so:
Note that you usually won't be able to pass a variable name as the parameter to
CFShow, as the Immediate window will get confused and think you're specifying a symbol in
CoreFoundation.dll rather than whatever code you're debugging. It's usually easiest just to pass the address of the object directly as above.
Debugging Multiple Processes
You can attach a single debugger to more than one process. To do this, launch or attach to the first process, then use
Tools > Attach to Process… or
Ctrl+Alt+P to attach to the second process. Your breakpoints will apply to both processes.
There are two ways to see which process the debugger is currently operating on, and to switch the current process: the Processes window and the Debug Location toolbar. You can open the Processes window using
Debug > Windows > Processes or
Ctrl+Shift+Alt+P. You can show the Debug Location toolbar using
View > Toolbars > Debug Location.
Visual Studio will always pause all processes (i.e., you can't pause just one process). Similarly, Visual Studio will always step all processes when using the Step In/Over/Out commands.
Inspecting WebKit2 API types
You can inspect WebKit2 API types in Visual Studio by casting them to their underlying WebKit2 implementation type. For example, say you have a
WKMutableDictionaryRef that points to address
0x12345678 and want to see what it contains. You can view its contents using the following watch expression (in either the Watch Window or Quick Watch Window):
The same technique will work for other WebKit2 API types as long as you substitute the appropriate type for