View source for 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:
<pre>
CONFIG-=release
</pre>
* Then rebuild the project, debug symbols are must appear

== 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 [https://github.com/WohlSoft/PGE-Project/commit/9099903fff05d7eb5075e40fbeb9856d01b6e797 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
<syntaxhighlight lang="bash">
./build.sh repair-submodules
</syntaxhighlight>

On Windows
<syntaxhighlight lang="winbatch">
build.bat repair-submodules
</syntaxhighlight>