Skip to content

Getting Started on Windows

Janaka Ranasinghesagara edited this page Jan 23, 2026 · 17 revisions

Getting the MieSimulatorGUI App from GitHub:

Windows Installer

Install

  • Download the latest "MieSimulatorGUI_vX_XX.exe" file.
  • Double-click the file to run the installer and follow the on-screen instructions to complete the installation.
  • To launch the application, click the desktop or Start Menu shortcut.

Uninstall

  • Find the Mie Simulator GUI in the installed programs list (Control Panel > Program and Features) and uninstall the application.

Windows Stand-alone package

  • Download and extract the latest "MieSimulatorGUI_vX_XX.zip" file to a directory of your choice.
  • To launch the application, open the folder and click "MieSimulatorGUI_vX_XX.exe".

Getting the MieSimulatorGUI Source Code from GitHub:

Downloading and Installing Prerequisites

  • Download the latest source code by navigating to the GitHub repository by clicking Code > Local > Download ZIP. Extract the files to a directory of your choice.
  • Go to the Qt download page and select the Qt 6 version that supports MinGW. (If you are currently using Microsoft Visual Studio C++, choose the Qt 6 version that corresponds to your Visual Studio version.)
  • Download and install Qt 6, including the recommended version of MinGW suggested by the Qt installer.

Building the Project

  • Launch Qt Creator and open the "MieSimulator.pro" file.
  • In the next window, select proper project kit and click Configure Project.
  • Select Build > Run qmake, and then select Build > Build Project "MieSimulatorGUI" or press Ctrl+B.

Running Tests and the Application

  • To run tests: Select Tools > Tests > Run All Tests.
  • To run the application: Select Build > Run or press Ctrl+R.

Building and Running Tests from the Command Line

  • Install Qt and corresponding mingw32.
  • Open Command Prompt (cmd).
  • From the root directory of the project (where MieSimulatorGUI.pro is located), run the following commands (These commands are based on Qt 6.2.4 and MinGW 11.2.0. Update the file paths to match your specific version and environment.):
mkdir build
cd build
C:\Qt\6.2.4\mingw_64/bin\qmake.exe ..\MieSimulatorGUI.pro
C:\Qt\Tools\mingw1120_64\bin\mingw32-make.exe qmake_all
.\test\release\MieSimulatorGUI_test.exe

Note:
- If you get any errors, check whether Qt and its debugger is working properly (Generate a sample Qt program and run).

Clone this wiki locally