Using Eclipse To Debug - Revision history

Mortimer at 22:17, 24 February 2010

2010-02-24T22:17:09Z

← Older revision		Revision as of 22:17, 24 February 2010
Line 4:		Line 4:
	* Select the added Update Site and install Clonk Development Tools		* Select the added Update Site and install Clonk Development Tools
	* After restarting Eclipse as recommended you can open the Clonk perspective by adding the Add Perspective Button at the top-right of the window		* After restarting Eclipse as recommended you can open the Clonk perspective by adding the Add Perspective Button at the top-right of the window
			[[File:Eclipse_Debug_Other_Persp.png‎]]
			[[File:Eclipse_Debug_Open_persp.png]]
	* Right-click into the Project Explorer and open the New Clonk Project wizard		* Right-click into the Project Explorer and open the New Clonk Project wizard
			[[File:New_clonk_proj.png]]
	* In the wizard, uncheck Use default location and supply the path of the planet folder in the OC repository. Set the project name to OpenClonk (name doesn't really matter)		* In the wizard, uncheck Use default location and supply the path of the planet folder in the OC repository. Set the project name to OpenClonk (name doesn't really matter)
	* Set Open Clonk as engine		* Set Open Clonk as engine
			[[File:New_clonk_proj_wizard.png]]
	* After finishing the wizard you should see the contents of the planet folder		* After finishing the wizard you should see the contents of the planet folder
			[[File:Select_scen.png]]
	* In Window->Preferences->Clonk some files need to be supplied for scenario launching to work properly. Set the game path to the path of the planet folder. C4group and engine paths should then be filled out automatically		* In Window->Preferences->Clonk some files need to be supplied for scenario launching to work properly. Set the game path to the path of the planet folder. C4group and engine paths should then be filled out automatically
			[[File:Eclipse_Debug_Prefsmenu.png]]
			[[File:Eclipse_Debug_Prefs.png]]
	* Now select any scenario and press the small black arrow next to the Debug button. Debug As -> Clonk scenario		* Now select any scenario and press the small black arrow next to the Debug button. Debug As -> Clonk scenario
			[[File:Eclipse_Debug_Debug_as_menu.png]]
	* Open the Debug perspective		* Open the Debug perspective
	* Open some script file and set a breakpoint inside a function (e.g. StartJump in the Clonk script)		* Open some script file and set a breakpoint inside a function (e.g. StartJump in the Clonk script. Right now, only the shortcut for breakpoints is supported (Strg+Shift+B)
			[[File:Eclipse_Debug_Open_script.png]]
			[[File:Eclipse_Debug_Set_breakpoint.png]]
	* Trigger that function in the game		* Trigger that function in the game
	* Engine should pause and allow you to single-step the script inside Eclipse (shortcuts for single step/step over can be found in the Run menu and changed in the preferences)		* Engine should pause and allow you to single-step the script inside Eclipse (shortcuts for single step/step over can be found in the Run menu and changed in the preferences)
			[[File:Eclipse_Debug_Stopped.png]]

Mortimer at 21:45, 24 February 2010

2010-02-24T21:45:27Z

← Older revision		Revision as of 21:45, 24 February 2010
Line 1:		Line 1:
	== Setup Steps ==		== Setup Steps ==
	* Download ~~Eclipse~~ [http://eclipse.org/downloads/ Eclipse] (Classic or for Java Developers)		* Download [http://eclipse.org/downloads/ Eclipse] (Classic or for Java Developers)
	* Add http://www.maltworld.de/clonk/c4dt/update to the Update Sites list (Help -> Install New Software)		* Add http://www.maltworld.de/clonk/c4dt/update to the Update Sites list (Help -> Install New Software)
	* Select the added Update Site and install Clonk Development Tools		* Select the added Update Site and install Clonk Development Tools

Mortimer at 21:45, 24 February 2010

2010-02-24T21:45:08Z

← Older revision		Revision as of 21:45, 24 February 2010
Line 1:		Line 1:
	~~This place will soon be filled with an explanation on how to use the debug branch of openclonk in conjuction with this~~ [http://www.~~clonkforge~~.~~net~~/~~projects~~.~~php?pr=944]Eclipse plugin~~ to single-step ~~through c4script code.~~		== Setup Steps ==
			* Download Eclipse [http://eclipse.org/downloads/ Eclipse] (Classic or for Java Developers)
			* Add http://www.maltworld.de/clonk/c4dt/update to the Update Sites list (Help -> Install New Software)
			* Select the added Update Site and install Clonk Development Tools
			* After restarting Eclipse as recommended you can open the Clonk perspective by adding the Add Perspective Button at the top-right of the window
			* Right-click into the Project Explorer and open the New Clonk Project wizard
			* In the wizard, uncheck Use default location and supply the path of the planet folder in the OC repository. Set the project name to OpenClonk (name doesn't really matter)
			* Set Open Clonk as engine
			* After finishing the wizard you should see the contents of the planet folder
			* In Window->Preferences->Clonk some files need to be supplied for scenario launching to work properly. Set the game path to the path of the planet folder. C4group and engine paths should then be filled out automatically
			* Now select any scenario and press the small black arrow next to the Debug button. Debug As -> Clonk scenario
			* Open the Debug perspective
			* Open some script file and set a breakpoint inside a function (e.g. StartJump in the Clonk script)
			* Trigger that function in the game
			* Engine should pause and allow you to single-step the script inside Eclipse (shortcuts for single step/step over can be found in the Run menu and changed in the preferences)

Mortimer: Created page with 'This place will soon be filled with an explanation on how to use the debug branch of openclonk in conjuction with this [http://www.clonkforge.net/projects.php?pr=944]Eclipse plug…'

2010-02-19T15:27:00Z

Created page with 'This place will soon be filled with an explanation on how to use the debug branch of openclonk in conjuction with this [http://www.clonkforge.net/projects.php?pr=944]Eclipse plug…'

New page

This place will soon be filled with an explanation on how to use the debug branch of openclonk in conjuction with this [http://www.clonkforge.net/projects.php?pr=944]Eclipse plugin to single-step through c4script code.