Skip to content
slspencer edited this page Jul 12, 2024 · 16 revisions

Return Home


Use Qt to build on your local PC

1. Install Qt

  • Download & run the Qt installer from https://www.qt.io/download-open-source.
  • During install, create an account and select the GPLv3+ license.
  • Install these modules
    • Qt v 5.15.2
    • MSVC 2019 64-bit
    • Qt Creator
    • Qt Creator CDB Debugger Support
    • If on Windows, select Debugging Tools for Windows

2. Install an IDE if you don't have one

3. Build with Qt Creator

This example is for installing on Windows 10

  • Clone the develop branch from GitHub (https://github.com/fashionfreedom/seamly2d.

  • Run Qt Creator and open project Seamly2D (browse to your cloned Seamly2d repo and select the Seamly2D.pro file.)

  • In the left-hand menu, select the Project wrench icon to open Build Settings

    • Select the Manage Kits... button in upper left
      * Qt Versions tab - Select Desktop Qt 5.15.2 MSVC2019 64bit, set as Default, Apply
      * Compilers tab - Under C++ select Microsoft Visual C++ Compiler 16.11.32630.194 (amd64), Apply
      * Debuggers tab - Select C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe, Apply
      * Kits tab - * Select Desktop Qt 5.12.2 MSVC2019 64bit (default) * Check the Force UTF-8 MSVC compiler output box * Click OK
  • For the first build, in the Build top menu, select Run qmake then Build Seamly2D for all configurations

  • For subsequent builds, in the BUild top menu, select Rebuild Seamly2D

4. Test with Qt Creator

  • In the left-hand menu

    • Select Debug under the Desktop icon (looks like a TV)
    • Click the big green Run triangle with the bug icon
    • Seamly2D should open and you can begin testing your build
  • Test your build by creating or opening a pattern, creating and editing pattern pieces, and generating a layout.

  • If there are no problems, your branch is ready for a Pull Request.

5. Common Error messages

  • "msvc-version.conf loaded but QMAKE_MSC_VER isn't set"
    • Edit your C:\Qt\5.15.2\msvc2019_64\mkspecs\winrt-x64-msfc2019\qmake.conf Qt make configuration file
      • Add QMAKE_MSC_VER=1929 for MSVC 2019
      • You can read more here