Difference between revisions of "Using Visual Studio"

From Inkscape Wiki
Jump to navigation Jump to search
(→‎Trouble shooting: Added make error sections)
m (→‎Create project in Visual Studio: Added project properties location)
Line 45: Line 45:


'''Note:''' VisualGDB will not copy the source files to the Visual Studio project directory, so you can still use Version Control the usual way.
'''Note:''' VisualGDB will not copy the source files to the Visual Studio project directory, so you can still use Version Control the usual way.
'''Note:''' The project settings can be changed at a later time by going to: Project->VisualGDB Project Properties.


= Enable debugging =
= Enable debugging =

Revision as of 02:57, 7 March 2015

Introduction

Microsoft Visual Studio is a popular development tool used primarily with C, C++, and C#. Visual Studio (community edition) can be downloaded for free but it requires a plugin called VisualGDB or WinGDB. These plugins are not free, but fully functional evaluation versions are available. This wiki focuses on the VisualGDB plugin, but WinGDB settings are also provided.

This page will help you set up Visual Studio for coding, building, and stepping through code in Inkcape.

Installation

  1. Follow all steps of guide Compiling Inkscape on Windows.
  2. Make sure Inkcape compiles correctly using the console first.
  3. Install Visual Studio.
  4. Install VisualGDB.
  5. Set the Environment variables in the Windows System settings as described here: Compiling Inkscape on Windows. Do not use mingwenv.bat to set the environment variables.

Note: It is assumed the required packages are installed in the following directories:

  • c:\mingw
  • c:\devlibs
  • c:\src\inkscape\trunk

Create project in Visual Studio

  1. Open Visual Studio.
  2. Select File->New->Project->Installed->Templates->VisualGDB->MinGW/Cygwin Project Wizard.
  3. For the project location, do not use a path with spaces.

    New-project.png

  4. Give the project a name, and click OK.
  5. At the wizard, select Project Type->Import a project build with command-line tools.

    Import-project.png

  6. Click Next.
  7. Check the path to MinGW is correct.
  8. Click Next.
  9. Set the Inkscape source directory to:
    • c:\src\inkscape\trunk
  10. Select Import preserving directory structure.

    Import-project-settings.png

  11. Click Next.
  12. At Build Command, select Customize.
  13. Set Arguments to:
    • /c "c:\src\inkscape\trunk\btool.exe"
  14. Select OK.
  15. At Clean Command, select Customize.
  16. Set Arguments to:
    • /c "c:\src\inkscape\trunk\btool.exe" clean
  17. Select OK.
  18. At Debug Settings->Executable file to debug, browse to:
    • C:\src\inkscape\trunk\inkscape\inkscape.exe

      Build-settings.png

  19. Click Finish and wait for the project generation to finish.

Note: VisualGDB will not copy the source files to the Visual Studio project directory, so you can still use Version Control the usual way. Note: The project settings can be changed at a later time by going to: Project->VisualGDB Project Properties.

Enable debugging

In Explorer, open build.xml located in:

  • c:\src\inkscape\trunk

Then look for the "T A R G E T : C O M P I L E" section, go to the <flags> section, and change

 -O2

to

 -O0

Also add this flag:

 -g


Flags.png

Then search for this:

 strip="true" symfile="${build}/inkscape.dbg"

And change to this:

 strip="false" symfile="${build}/inkscape.dbg"


Strip.png

Note: these changes will make Inkscape very slow to compile.

Building Inkscape

  1. In Visual Studio, select Build->Clean Solution.
  2. Then select Build->Build Solution.
  3. Come back later. This will take a while.

Note: The compiler will seem to be stuck at this for a while, but that is normal:

 1>  --- compile / cc

Stepping through code

  1. In Visual Studio, go to Solution Explorer->Inkscape->Source Files->src->main.cpp, and set a breakpoint here:

    Breakpoint.png

  2. Select Debug->Start Debugging With GDB.
  3. If you get a "GDB command timeout" window, be patient.
  4. Inkscape will stop at the breakpoint. Happy debugging.

Trouble shooting

Unable to break

In case Visual Studio cannot break at a certain breakpoint (most likely no debugging symbols present), you can diagnose breakpoint problems using the VisualGDB diagnose tool:


Diagnose-breakpoint.png

Make error

If you get the error below, it means the environment variables are not set up correctly. Do not use mingwenv.bat to set up the environment variables, but set them in the Windows System Settings instead as described here: Setting Environment Variables

Error:

 --- i18n / msgfmt
 Make error line 422: executeCommand : could not create process : the system cannot find the file specified.
 Make error line 422: <msgfmt> problem:

WinGDB settings

Wizard settings:

  • File->New->Project->Installed->Templates->WinGDB->WinGDB Standard Projects->Multiplatform Executable->OK
  • MinGW installation directory: C:\MinGW
  • Make executable location: C:\src\inkscape\trunk\btool.exe
  • Source dir: C:\src\inkscape\trunk\src
  • Group imported files in folders = true
  • Build result directory: C:\src\inkscape\trunk\inkscape
  • Build debuggable result: inkscape.exe
  • Build working directory: C:\src\inkscape\trunk
  • Working directory: C:\src\inkscape\trunk
  • Additional source directories: C:\devlibs

Project settings:

  • Right click project->WinGDB->Properties->:
  • Environment->Debugger path: C:\mingw\bin\gdb.exe
  • Environment->Build toolchain paths: C:\MinGW\bin;C:\src\inkscape\trunk
  • Debug->Executable path: C:\src\inkscape\trunk\inkscape\inkscape.exe
  • Directories->Additional source directories: C:\devlibs
  • Project build->Project build command: btool -j 8 (-j 8 is to compile with 8 threads)
  • Project build->Project rebuild command: btool clean; btool -j 8
  • Project build->Project clean command: btool clean
  • Project build->Build working directory: C:\src\inkscape\trunk

Building:

  • WinGDB->Build->Build projectname

Debugging:

  • WinGDB->Start debugging