Revision as of 12:15, 15 December 2014

Want to setup an IDE to debug / develop synfig ?

Here, we will not discuss of witch IDE is better or if real hacker do all with vi/emacs

Anjuta from gnu/linux

What Anjuta is?

First build !

This will generate all needed makefile

• Open "autobuild/synfigstudio-linux-build.sh" and change "DEBUG=0" to "DEBUG=1" (line 74)
• Build from "autobuild/synfigstudio-linux-build.sh"
• During this time install "anjuta" from synaptic or whatever ... (from xubuntu 14.10 you must install Anjuta 3.14 from this ppa for example : see here why)

when anjuta installed and synfig builded....

Import synfig (etl / core / studio) projects in Anjuta

• Open Anjuta, in "Action" choose "Import a project" and choose your code location (synfig/ETL , synfig/synfig-core or synfig/synfig-studio)
• Select a project name and Import
• At the project backend choice, select "Autotools" and go for it (if you kept the default project name, replace the existing project with the new one)
• Wait a minute ... project loaded !

Repeat for each synfig project

Your now able to build from Anjuta.

Want to debug maybe ?

• From Anjuta "<Menu> → <Execute> → <Program Paramter> → Program" : select synfig-studio binary "/home/user/synfig/bin" (i also setup the working directory)
• Now you need to clean the project and build it again (but this time from anjuta)
• Anjuta "<Menu> → <Build> → Clean"
• Anjuta "<Menu> → <Build> → Build"

you (shouldbe) are ready to debug / improve / patch and share !

Extra note

As Anjuta projects are saved in git examined folders, you could have sort of behavior when you git your code ... personally i have made a little script to backup/restore my own project to keep the folder safe of undesired change (.gitignore is also git surveyed !)

Eclipse from gnu/linux

What Eclipse is?

First build !

This will generate all needed makefile

• Open "autobuild/synfigstudio-linux-build.sh" and change "DEBUG=0" to "DEBUG=1" (line 74)
• Build from "autobuild/synfigstudio-linux-build.sh"
• During this time install "eclipse" & "eclispe-cdt" packages from synaptic or whatever ...

when eclipse installed and synfig builded....

Import synfig (etl / core / studio) projects in Eclipse

Open Eclipse, choose your desired place for the workspace (i recommend not in ./synfig folder if you want to commit, better just above)

For each synfig component (etl / core / studio ...)

1. Eclipse / Menu / Makefile project with existing code
2. Choose your project name (etl / core / studio ...)
3. Select code location (synfig/ETL , synfig/synfig-core or synfig/synfig-studio)
4. Select your toolchain ... and click Finish ... and Wait a little ...

Your now able to build from Eclipse.

Want to debug maybe ?

• From "Project Explorer" panel, select your project properties (alt+enter / menu-project or right clicking)
• In "C/C++ Build" Uncheck "Use default build command" and put a "make -j2 install" (-jXX at your connivance ...)
• In "Run/Debug Setting" click "New" or "Edit..." , in C/C++ Application , browse and select the synfig-studio binary from "/home/user/synfig/bin"

Stop on Startup, what the heck ?

• Make sure you are in the c++ perspective, then go to menu Run -> Debug Configurations. Make sure your application is chosen in the left pane, press the Debugger tab, and uncheck Stop on startup at: checkbox. How to stop GDB from executing “break main” by default in Eclipse?

you (shouldbe) are ready to debug / improve / patch and share !

Have a functional environment

Add Includes paths to Code Analysis

• From "Project Explorer" panel, select your project properties (alt+enter / menu-project or right clicking)
• In C/C++ General / Paths and Symbols / Includes , add all the paths you need (ETL / Synfig-core / Cairo / Gtkmm ....)