vlab
The virtual laboratory
Developer Getting Started Guide
Note: our current version has been developed using QT 5.12.3
OSX
You will need to have Xcode Command Line Tools and Qt5 installed. If you do not have Xcode, get it via Terminal with the command:
xcode-select -install
This should install the command line tools only and not the IDE. Then install Qt: https://doc.qt.io/qt-5/gettingstarted.html
To compile vlab, go to the source directory and run:
./configure.sh -A 64 -M 10.13 # 10.13 is High Sierra, substitute as appropriate
./compile_all.sh
After compiling, to make an application bundle, change to the ./Distribution directory and run:
./make-standalone-bundle.sh
The script will create a vlab-5-******.dmg file.
Ubuntu
The supported version of Ubuntu is listed in install_ubuntu_reqs.sh
, though
other versions may also work. This may require first running: sudo add-apt-repository universe
sudo ./install_ubuntu_reqs.sh
./configure.sh
./compile_all.sh
Fedora
A legacy version of Fedora is listed in install_fedora_reqs.sh
.
Newer versions were not tested.
Configure script auto-detection seems spotty on Fedora, so you may need to be explicit about being 64-bit, using the -A flag.
sudo ./install_fedora_reqs.sh
./configure.sh -A 64
./compile_all.sh
Windows, using Windows Subsystem for Linux (WSL)
On Windows 10 (build 19041 and higher) or Windows 11, you will need to install WSL 2 and a Linux distribution. You can install both at the same time using the Windows Command Prompt (in administator mode):
wsl --install
giving you Ubuntu as the default distribution. Then follow the instructions for compiling vlab for Ubuntu given above.
Version Numbering
The build number and date are stored in two files:
libs/misc/version.cpp
: there are functionsversion_major
,version_minor
,version_minor_minor
,build_number
, andbuild_date_string
which return the current values.Lstudio/Lstudio.rc
: theVS_VERSION_INFO
block has the version/build number four times: under keysFILEVERSION
andPRODUCTVERSION
, then again a few lines later as the argument toVALUE "FileVersion"
andVALUE "ProductVersion"
.
Contact
The home page for vlab is: http://www.algorithmicbotany.org/virtual_laboratory/