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


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

Changed name of Eclipse project for repo root and updated instructions to now use the hierarchical view of the project explorer.

Legend:

Unmodified
Added
Removed
Modified

  • Be a CIVL developer

    v63 v64  
    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 "Check out as a project with the name specified:" and choose a name. We will use `CIVL_REPO` as our choice.
     46  1. Select the option "Check out as a project with the name specified:" and set the name to be `CIVL`.
    4747  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.
     48  1. Once completed, you should see a new project in your workspace titled `CIVL`. Right-click it and select "Import...". An Import window should appear.
    4949  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.
     50  1. In the next window, select "Select root directory:" and set it to be the path to the `CIVL` directory in your workspace.
    5151  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:
    5252    * `dev.civl.abc`
    … …  
    5757  1. Select these 5 projects and then press "Finish".
    5858  1. The window should disappear and the 5 projects you selected should appear in the Package Explorer window.\\\\
    59 1. 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". \\\\
     591. To properly work with these new projects, you must change to using the Project Explorer window rather than the Package Explorer window.
     60  1. Close out of the Package Explorer window and then select "Window > Show View > Project Explorer".
     61  1. Click the three vertical dots at the top right of the Project Explorer window and select "Projects Presentation > Hierarchical".
     62  1. Again, click the three vertical dots again and this time select "Package Presentation > Hierarchical". \\\\
    63631. 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:
    6464  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.
    … …  
    78781. 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.
    7979  1. Create two new environment variables:
    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).
     80    * `ECLIPSE_WORKSPACE` should be the absolute path to your Eclipse workspace.
    8181    * `VSL_DEPS` should be the path to your `vsl-X.XX` dependencies folder.
    8282  1. Somewhere on your system, create a plain text file named `civl` and copy-paste the following:
    8383    {{{
    8484#!/bin/sh
    85 java -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 $@
     85java -cp $ECLIPSE_WORKSPACE/CIVL/mods/dev.civl.com -p $ECLIPSE_WORKSPACE/CIVL/mods/dev.civl.abc:$ECLIPSE_WORKSPACE/CIVL/mods/dev.civl.gmc:$ECLIPSE_WORKSPACE/CIVL/mods/dev.civl.mc:$ECLIPSE_WORKSPACE/CIVL/mods/dev.civl.sarl:$VSL_DEPS/mods/antlr3:$VSL_DEPS/mods/antlr4 -m dev.civl.mc/dev.civl.mc.CIVL $@
    8686    }}}
    8787  1. You must make it executable. You can use the command `chmod ugo+x civl`.