Troubleshooting (PGE Project development)

Here are described most frequently troubles are can appear at you.

Can't build project from Qt Creator

That means some of dependencies are not built and even not copied into the binary folder. Before you can open any of project files, you must build the project by using a build scripts. After that you can freely build project in Qt Creator as you want.

Debug build contains no debug symbols

That usually happens because are both debug and release configs was applied and release has removed debug symbols. The fix is very simple:

• 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:

CONFIG-=release

• Then rebuild the project, debug symbols are must appear

"File is truncated" while building

Because this may happen offten, in the _Misc/dev_scripts you will find the clearEmpties.sh and clearEmpties.bat scripts are will remove all those empty files and then you can retry to build 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 make files, and then you can retry to configure build again.

Troubles with submodules after update

There are can appear when some of folders was on the repository and then turned into the submodule. When you trying to pull the fresh changes and then you trying to fetch submodules, but you getting the error that can't write submodule because folder is busy. Since recent moment the build script now has the action to automatically repair all submodules are failing to be cloned because of any factors.

On Linux and macOS

./build.sh repair-submodules

On Windows

build.bat repair-submodules