Troubleshooting (PGE Project development)

This page describes the most frequent troubles that may arise.

Can't build project from Qt Creator
This means that some of the dependencies are not built and may not even be copied into the binary folder. Before you can open any project files, you must build the project by using a build script. After doing so, you can freely build projects in Qt Creator.

Debug build contains no debug symbols
This usually happens because both debug and release configs were applied and the release has removed debug symbols. The fix is very simple: CONFIG-=release
 * In the Qt Creator open the "Projects" tab.
 * Find the building configuration and choose the "Debug" configuration.
 * Expand the "qmake" step configuration and add the next line:
 * Then rebuild the project. Debug symbols are should appear.

"File is truncated" while building
Because this may happen often, in the _Misc/dev_scripts you will find the clearEmpties.sh and clearEmpties.bat scripts which will remove all those empty files and then you can try to build the project again.

No rule to make ***.o
This error usually happens because makefiles are invalid or broken. Try to use clean_make.sh or clean_make.bat scripts in the repository root to remove all makefiles, and then you can try to configure the build again.

Troubles with submodules after update
This error may appear when some folder were in the repository and then turned into submodules. You can get this error when you try to pull the fresh changes and then try to fetch the submodules but the submodule cannot be written to as the folder is busy. The build script has been updated and now automatically repairs any submodules failing to be cloned.

On Linux and macOS:

On Windows: