-
Notifications
You must be signed in to change notification settings - Fork 2
Building the GUI
Wiki > The GUI > Getting started > Building the GUI
Before building and running the GUI please make sure you have followed the steps from here: First time installing and building (Windows). In particular make sure Git and genie_python are installed.
We have a book which should serve as a reasonable introduction to the Eclipse RCP platform: 'Eclipse Rich Client Platform' by McAffer, Lemieux and Aniszczyk. There is also a basic introduction at http://www.vogella.com/tutorials/EclipseRCP/article.html.
Create a directory for where you want your IBEX GUI to reside (e.g. C:\Instrument\Dev). From an appropriate Git console (e.g. Git Bash) navigate to your directory and run:
git clone https://github.com/ISISComputingGroup/ibex_gui.git
If you are working on the IBEX GUI please use the IBEX Eclipse editor, which is available, within ISIS, via a zip file at \\isis\inst$\Kits$\CompGroup\ICP\Developer Tools, simply unzip the the file to your chosen location for Eclipse and use the provided workspace. You can choose to download Eclipse directly from http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/mars1, but you will need to alter settings to get the correct defaults for formatting.
These are the steps needed to run the GUI via Eclipse:
- Start Eclipse IDE and select the workspace and use "Browse" to create and select a new workspace folder (example name: ibex_workspace)
- From the menu bar choose: File->Import->General->Existing Projects into Workspace. Choose "Select root directory" and browse to where the IBEX code was cloned to, Eclipse should automatically select everything so click "Finish" to add them to the project
- Expand the target platform folder (labelled as
uk.ac.stfc.isis.ibex.targetplatform), double click on the target file and choose "Set as Target Platform". This may take some time as parts of CS-Studio and DAWN are downloaded. It may also be required to update the Locations in use should some packages appear to be missing. - To run the application from within Eclipse: open "ibex.product" from the
uk.ac.stfc.isis.ibex.client.productfolder, select "Launch an Eclipse application"
Important Note: you will need JDK 1.8 or higher installed to launch the IBEX GUI succesfully. You may be able to use JDK 1.7, but you wil need to change the JDK compliance level in Eclipse from 1.8 -> 1.7, else the GUI will not launch.
If you see a “Plugin execution not covered by lifecycle configuration” error, you will need to go into eclipse preferences and ignore this category of error.
- From the command line, navigate to the build directory in the IBEX code
- Run the build.bat file
- Wait for a few minutes while it builds
- After the build finishes it can be found in
\base\uk.ac.stfc.isis.ibex.client.product\target\products\
If the GUI loads up but items are the wrong size, you may need to change your display resolution and/or font scaling factor. The exact settings that you need vary from computer to computer.