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


Ignore:
Timestamp:
03/09/23 08:19:34 (3 years ago)
Author:
Alex Wilton
Comment:

Added simple instructions for setting up WSL on Windows

Legend:

Unmodified
Added
Removed
Modified

  • Be a CIVL developer

    v64 v65  
    2121 We recommend using the Eclipse IDE to write CIVL code.  Remember to set your Java code formatter as "built-in 2.1" in your Eclipse.
    2222
     23== Notes for Windows Users ==
     24CIVL is not currently supported on Windows. However, it is easy to use CIVL and set up an Eclipse development environment on Windows using WSL. With Windows 11 or with Windows 10 21H2 (or newer), you can easily install WSL2 and run Linux GUI applications from it.
     25
     26If you want to develop CIVL using a Windows machine, you should install WSL2 using the following instructions and then follow the remaining instructions of this page in the Linux partition managed by WSL.
     27
     281. Open up powershell and execute the command `wsl --install`
     291. Restart your computer.
     301. Open up WSL (you can search for it now on the windows start menu). Pick a username and password to use when it asks.
     311. Execute `sudo apt update`
     321. Execute `sudo apt upgrade`
     331. Execute `sudo apt install openjdk-17-jre-headless`
     341. To get all packages required for displaying GUIs, it is easiest to install a simple GUI application like gedit which will obtain all of the necessary packages for you. Execute `sudo apt install gedit -y`.
     351. Test gedit out by running `gedit`. A separate GUI window for gedit should appear. This means you are now set up to run GUI Linux applications from WSL.
     36
     37You can now follow the rest of the instructions on this page. Note that when downloading files, you may need to move them to somewhere on your Linux partition before running them (like the Eclipse installer for example). This can easily be done with the regular Windows file explorer.
     38
     39As a reminder, all the instructions on this page are to be done with respect to your Linux partition created by WSL. So for example, if an instruction says that something needs to go on your `PATH`, this means that it should be on your Linux `PATH` not the Windows `PATH`.
     40
    2341== How to set up CIVL in Eclipse ==
    24421. If your version of Java is older than 17 (the version number in the first line printed by the command `java --version` is what version you have) then install the latest version of Java here: [https://www.oracle.com/java/technologies/downloads/] \\\\
    … …  
    2846  1. Unzip the `.tgz` so that you end up with a folder with a name of the form `vsl-X.XX`.
    2947  1. Pick somewhere in your filesystem to move this folder. A good choice is `/opt`. Note that you may need to use `sudo`. \\\\
    30 1. Install Eclipse IDE for Java Developers from here: [https://www.eclipse.org/downloads/packages/installer] \\\\
     481. Install Eclipse IDE for Java Developers using the install found here: [https://www.eclipse.org/downloads/packages/installer] \\\\
    31491. Install Subversive for Eclipse using these instructions (paying attention to our notes below): [https://www.eclipse.org/subversive/installation-instructions.php]
    3250  * ''Phase 1 notes:''