Changes between Version 62 and Version 63 of Be a CIVL developer


Ignore:
Timestamp:
03/07/23 15:14:52 (3 years ago)
Author:
Alex Wilton
Comment:

Updated instructions to reflect changes to Eclipse structure.

Legend:

Unmodified
Added
Removed
Modified
  • Be a CIVL developer

    v62 v63  
    4444  1. Press the "Browse..." button next to the URL. In the window that pops up, expand the "civl" folder and select "trunk". Press OK. The pop-up window should disappear and the URL should now say `svn://vsl.cis.udel.edu/civl/trunk`.
    4545  1. Press "Finish". A "Check Out As" window should appear.
    46   1. Select the option "Find projects in the children of the selected resource".
    47   1. Press "Finish". The window should change (after about 5 seconds) and display a list of 5 items. Ensure the option "Check out as a projects into workspace" at the top is selected. Also ensure  that each of the 5 items in the list are checked.
    48   1. Press "Finish". The window should disappear and you should see a small progress bar in the bottom left corner of Eclipse. This shows its progress in checking out each of the 5 new projects that Eclipse is creating. Eventually the progress bar should be complete and you should see 5 new projects in your workspace (probably marked with warnings and errors) titled:
     46  1. Select the option "Check out as a project with the name specified:" and choose a name. We will use `CIVL_REPO` as our choice.
     47  1. Press "Finish". The window should disappear and you should see a small progress bar in the bottom left corner of Eclipse. This shows its progress in checking out the repo into your workspace.
     48  1. Once completed, you should see a new project in your workspace titled `CIVL_REPO` (or whatever name you chose for the project). Right-click it and select "Import...". An Import window should appear.
     49  1. Select "General > Existing Projects into Workspace" and then press "Next".
     50  1. In the next window, select "Select root directory:" and set it to be the path to the `CIVL_REPO` directory in your workspace.
     51  1. Next, uncheck the option "Copy projects into workspace" and check the option "Search for nested projects". In the "Projects:" list of the window there should be 5 new projects that appear titled:
    4952    * `dev.civl.abc`
    5053    * `dev.civl.com`
    5154    * `dev.civl.gmc`
    5255    * `dev.civl.mc`
    53     * `dev.civl.sarl` \\\\
    54 1. You probably will want to change the package presentation to the hierarchical view since it makes navigating the code much easier. Click the three vertical dots at the top right of the Package Explorer window (where your projects are) and then press "Package Presentation > Hierarchical". \\\\
     56    * `dev.civl.sarl`
     57  1. Select these 5 projects and then press "Finish".
     58  1. The window should disappear and the 5 projects you selected should appear in the Package Explorer window.\\\\
     591. You probably will want to change to using the Project Explorer window rather than the Package Explorer window.
     60  1. To do this close out of the Package Explorer window and then select "Window > Show View > Project Explorer". If you do not see all of your projects in this window at first this probably just means your project view is hierarchical.
     61  1. Click the three vertical dots at the top right of the Project Explorer window (where your projects are) and select "Projects Presentation > Flat". You should now see all your projects.
     62  1. For convenience, you probably do want packages to be presented hierarchically. Click the three vertical dots again and select "Package Presentation > Hierarchical". \\\\
    55631. Open up the file `dev.civl.com/build_default.properties`. If the value of `root` does not match the absolute path to the VSL dependencies folder, `vsl-X.XX`, that you downloaded earlier then perform the following nested instructions:
    5664  1. Close `build_default.properties` and then make a copy of it (still in `dev.civl.com`) called `build.properties`. Do not delete `build_default.properties` since this is tracked by SVN.
     
    70781. We will create a script that will sit on your `PATH` that will allow you to conveniently run `CIVL` from the `.class` files built in Eclipse.
    7179  1. Create two new environment variables:
    72     * `ECLIPSE_WORKSPACE` should be the path to your Eclipse workspace folder.
     80    * `CIVL_ECLIPSE_PROJECT` should be the absolute path to your CIVL Eclipse project (which we chose to name `CIVL_REPO` but you may have named differently).
    7381    * `VSL_DEPS` should be the path to your `vsl-X.XX` dependencies folder.
    7482  1. Somewhere on your system, create a plain text file named `civl` and copy-paste the following:
    7583    {{{
    7684#!/bin/sh
    77 java -cp $ECLIPSE_WORKSPACE/dev.civl.com -p $ECLIPSE_WORKSPACE/dev.civl.abc:$ECLIPSE_WORKSPACE/dev.civl.gmc:$ECLIPSE_WORKSPACE/dev.civl.mc:$ECLIPSE_WORKSPACE/dev.civl.sarl:$VSL_DEPS/mods/antlr3:$VSL_DEPS/mods/antlr4 -m dev.civl.mc/dev.civl.mc.CIVL $@
     85java -cp $CIVL_ECLIPSE_PROJECT/mods/dev.civl.com -p $CIVL_ECLIPSE_PROJECT/mods/dev.civl.abc:$CIVL_ECLIPSE_PROJECT/mods/dev.civl.gmc:$CIVL_ECLIPSE_PROJECT/mods/dev.civl.mc:$CIVL_ECLIPSE_PROJECT/mods/dev.civl.sarl:$VSL_DEPS/mods/antlr3:$VSL_DEPS/mods/antlr4 -m dev.civl.mc/dev.civl.mc.CIVL $@
    7886    }}}
    7987  1. You must make it executable. You can use the command `chmod ugo+x civl`.