Changes for page Debugging WOLips

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -40,101 +40,23 @@
40	40	I chose ,,/WOLipsDebugging
41	41	[[image:Workspace.png]],,
42	42
43		-=== Import woenvironment ===
	43	+=== Import woenvironment ===
44	44
45		-Start off by importing the woenvironment project. From the File menu, select Import
46		-[[image:ImportMenu.png]]
47		-Click the disclosure triangle for General and select Existing Projects into Workspace
48		-[[image:ExistingProject.png]]
49		-Click Next button.
50		-Ensure that "Select root directory" is selected and click Browse
51		-Browse to the folder where you checked out the woproject source code above and select woenvironment.
52		-[[image:woenvironmentCheckout.png]]
53		-Eclipse should scan the folder and notice one project in the folder called woenvironment.
54		-**It's important that you don't have 'Copy the project into your workspace' selected.**
55		-[[image:woenvironmentProject.png]]
56		-Click Finish.
57		-
58		-Once Eclipse has finished building the project, there should be no errors! If that's not the case, then you need to back up and make sure that you've followed all the steps above.
59		-
60	60	=== Import wolips projects into your workspace ===
61	61
62		-Repeat the steps above and import all the wolips projects except for 3!
63		-**EntityModler, eomodeldoc and org.objectstyle.wolips.eomodeler.factories
64		-Are special projects which require special setup and caffination before touching.**
65		-
66		-The import of wolips should look like this:
67		-[[image:wolipsImport.png]]
68		-
69		-And Eclipse should identify a whole bunch of projects.
70		-**Make sure that you deselect the 3 special cases noted above**
71		-The list of projects should look something like this:
72		-[[image:wolipsProjects.png]]
73		-
74		-Click Finish and the projects should all be imported.
75		-
76		-{{note}}
77		-
78		-When I did this I got the following error message.
79		-I have no idea what this means...
80		-!ResourceErrorMessage.png!
81		-
82		-{{/note}}
83		-
84		-Once Eclipse finishes building the projects there are going to be a whole bunch of build errors. Don't Panic. Most of them will resolve themselves after the next steps.
85		-
86	86	=== Import wolips plugins ===
87	87
88		-In the same way as above, import the core plugins from wolips/core/plugins. Something like this:
89		-[[image:corePluginImport.png]]
90		-[[image:corePluginProjects.png]]
91		-
92	92	=== Import 3rd party plugins ===
93	93
94		-Finally, import the third party plugins from wolips/3rdparty/plugin. Something like this:
95		-[[image:thirdPartyProjects.png]]
96		-[[image:thridPartyImport.png]]
97		-
98	98	=== Close special projects ===
99	99
100		-In case you missed the notices above, close these projects.
101		-
102	102	* EntityModeler
103	103	* eomodeldoc
104	104	* org.objectstyle.wolips.eomodeler.factories
105		-(Note: Working on these projects is beyond the scope of what I needed to do. Sorry.)
106	106
107	107	=== Close projects which require additional resources to compile ===
108	108
109		-These projects require additional resources to compile. As I didn't need them, I just closed them.
110		-
111		-* org.objectstyle.wolips.apple.mavenintegration
112	112	* org.objectstyle.wolips.groovy.ui
113	113	* org.objectstyle.wolips.jprofiler.launching
114	114
115	115	== The run configuration setup ==
116		-
117		-At this point, you should have a long list of packages which should all be compiling.
118		-If that's not the case, please document additional steps here, making special note of your setup.
119		-
120		-Getting on with the configuration to be able to test the software which is now compiling.
121		-From the Run menu, select "Debug Configurations ..."
122		-[[image:debugConfiguration.png]]
123		-
124		-Select "Eclipse Application" from the list on the left
125		-and then click the "New" button at the top.
126		-[[image:newLaunchConfiguration.png]]
127		-This creates a new launch configuration which you can customize as you like.
128		-By default it's called 'New//configuration'. For this session, I named it DebugEclipse//
129		-
130		-My preference is to explicitly set the workspace for testing however I'm sure the default will be fine if you like it.
131		-I chose: {{workspace_loc}}{{/workspace_loc}}/../WOLipsDebuggingWorkspace
132		-My setup looked something like below however there are lots of configuration options which I didn't need to explore:
133		-[[image:debugConfigured.png]]
134		-
135		-== Launch the debug version ==
136		-
137		-Click the Debug button in the debug configuration window to launch the test version.
138		-This will be a clean version of Eclipse with the workspace which you set and any other settings.
139		-By default, all of the plugins are loaded and ready for testing!
140		-And now, you should be running inside the debug version of Eclipse with all the wolips bits to play with!