Wiki source code of Debugging WOLips
Version 98.1 by mark_ritchie on 2009/09/08 19:20
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
77.1 | 1 | {{note title="Under Construction"}} |
| 2 | |||
| 3 | This page is currently under construction by Mark Ritchie! | ||
| 4 | |||
| 5 | {{/note}} | ||
| 6 | |||
| |
73.1 | 7 | = Debugging WOLips as the master does! = |
| |
37.1 | 8 | |
| |
73.1 | 9 | These instructions is intended for the developer who wants to compile and run WOLips source for the purpose of debugging or other exploration. Thanks very much to Mike Schrag for the guidance to get this setup and working! |
| |
34.1 | 10 | |
| |
73.1 | 11 | == Overview of what's going on == |
| |
69.1 | 12 | |
| |
73.1 | 13 | We're going to check out the latest source for WOLips, build it and arrange for Eclipse to launch is a debug mode to test it out. It's very handy that Eclipse has a built in ability to launch itself in debug mode and load the local versions of the plugins. If you read the old and out dated instructions floating about that talk about building an entire release and installing them into a new copy of Eclipse then you're going to like this method a whole lot better! ;-) |
| 14 | |||
| |
34.1 | 15 | == The setup == |
| 16 | |||
| |
73.1 | 17 | When I did this and wrote these notes, I was using: |
| |
34.1 | 18 | |
| 19 | * Mac OS X 10.5.7 | ||
| 20 | * Java 1.5.0//19// | ||
| 21 | * Eclipse 3.4.2 (eclipse-SDK-3.4.2-macosx-carbon.tar.gz) | ||
| 22 | |||
| 23 | == Checking out the source code == | ||
| 24 | |||
| |
73.1 | 25 | **A note for the impatient - don't try to checkout the source right into Eclipse. The files aren't structured in a way that allows this to work. I know because I tried to do it that way first!** ;-) |
| 26 | |||
| |
34.1 | 27 | === Check out the source code into a local folder === |
| 28 | |||
| |
73.1 | 29 | You're checking out a local copy of the code from the source repository. Next, we're going to selectively import (but **not** copy) parts of that code into Eclipse. I'm using command line subversion to check out the lastest version however feel free to use a different tool or different version, as you like. |
| |
34.1 | 30 | |
| |
73.1 | 31 | svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk/woproject ,,/woproject,, |
| |
34.1 | 32 | |
| |
73.1 | 33 | Note that I've checked out the source code into my home folder. It doesn't matter where you put the source code as long as you can find it in the steps below. |
| 34 | |||
| |
34.1 | 35 | === Create a new eclipse workspace === |
| 36 | |||
| |
73.1 | 37 | Launch a clean copy of Eclipse with no plugings installed. Strictly speaking, probably not necessary however these are the steps which I took. |
| |
34.1 | 38 | |
| |
73.1 | 39 | Create a new Workspace |
| 40 | I chose ,,/WOLipsDebugging | ||
| 41 | [[image:Workspace.png]],, | ||
| 42 | |||
| 43 | === Import woenvironment === | ||
| 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 | |||
| |
97.1 | 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. |
| |
73.1 | 59 | |
| |
34.1 | 60 | === Import wolips projects into your workspace === |
| 61 | |||
| |
97.1 | 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 | |||
| |
34.1 | 84 | === Import wolips plugins === |
| 85 | |||
| 86 | === Import 3rd party plugins === | ||
| 87 | |||
| 88 | === Close special projects === | ||
| 89 | |||
| 90 | * EntityModeler | ||
| 91 | * eomodeldoc | ||
| 92 | * org.objectstyle.wolips.eomodeler.factories | ||
| 93 | |||
| 94 | === Close projects which require additional resources to compile === | ||
| 95 | |||
| 96 | * org.objectstyle.wolips.groovy.ui | ||
| 97 | * org.objectstyle.wolips.jprofiler.launching | ||
| 98 | |||
| |
69.1 | 99 | == The run configuration setup == |