[ Up: User Documentation ]

Please look at the Workspace website under sections such as System Requirements and or Developing Plugins to see the currently supported platforms and any additional specific utilities you may need to install.

System Requirements and Configuration

User System Requirements

A graphics card and driver supporting OpenGL 2.1 or later is required if you wish to make use of Workspace's 3D visualisation capabilities.
We strongly recommend you have a dedicated graphics card rather than rely on graphics capabilities offered by on-motherboard chips from Intel, etc.
If you do rely on integrated graphics (eg Intel), please ensure you are using the latest stable driver available.

Windows User System Requirements

The Windows packages are suitable for Windows 7, 8 and 10.
It is recommended that you uninstall the previous version of the software before installing the new version.
To install Workspace on Windows, simply run the installation executable and follow the on-screen prompts.

Mac User System Requirements

Workspace is currently supported on Mac OSX 10.13 (High Sierra), 10.12 (Sierra), 10.11 (El Capitan), 10.10 (Yosemite) and 10.9 (Mavericks).
To install, open the .dmg file, run the installation package inside and follow the on-screen prompts.
Workspace will then be accessible from within the Applications folder.

Linux User System Requirements

Our primary Linux target is Ubuntu although Workspace should work on other popular distributions such as Mint, Debian, Fedora or openSuse.
To install on Debian-based systems, ensure that you download the .deb installer package, double click the file and follow the on-screen prompts
Workspace will then be installed to the /opt/csiro.au/Workspace directory.
To install on RPM-based systems, use the command (sudo access may be required):

rpm -Ivh <workspace package name>.rpm

Developer System Requirements

Workspace plugins are able to be developed on any of its supported platforms and a set of detailed developer tutorials are provided inside the application's help system. Workspace uses CMake for cross-platform project generation so you will need to have CMake installed in addition to Workspace. Before getting started, make sure you have met the platform specific requirements listed below.

Note that as of Workspace 4.0, we only provide 64-bit Workspace binaries meaning any Workspace plugins or applications you build will also have to be 64-bit. If you need to deploy your Workspace plugin or application to a 32-bit environment, please contact our team.

Windows Developer System Requirements

To develop your own plugin on Windows you will need Visual Studio 2017 or Visual Studio 2019 installed on your machine. The free Community C++ edition is sufficient for doing this, but be aware that it has some commercial requirements.

You can obtain Visual Studio from Microsoft’s servers:

Visual Studio download page

You will also need to install a copy of CMake. When developing your project, it is recommended you launch CMake from the Workspace developer menu.

Mac DeveloperSystem Requirements

To develop your own plugin on OSX you will need the latest version of XCode installed on your machine, as well as the XCode command-line tools. You can access both of these from the apple developer downloads page (XCode itself can be installed through the app store). When considering which compiler to use, keep in mind that Workspace itself is built against the Clang compiler, and uses libstdc++ as its standard library.

You will also need to install a copy of CMake. When developing your project, it is recommended you launch CMake from the Workspace developer menu. When generating your project, you can select either the XCode generator or the Unix Makefiles generator. The Workspace team recommends the Qt Creator IDE for Unix Makefiles projects.

Linux Developer System Requirements

Linux plugin developers will need to have installed a suitable C++ compiler, such as GCC, which you will need to install via the package manager on your Linux distribution. Workspace itself is built with GCC under Linux.

Qt5 requires the libgl-dev package to be installed. If this is missing the CMake configure step will complain about failure to find Qt5Gui_GL_Library.

If you will be using the Workspace to create release packages, you will also need to ensure the rpmbuild command is available.