pandemonium_engine_docs/development/cpp/configuring_an_ide/kdevelop.rst

88 lines
3.1 KiB
ReStructuredText

.. _doc_configuring_an_ide_kdevelop:
KDevelop
========
`KDevelop <https://www.kdevelop.org>`_ is a free, open source IDE for all desktop platforms.
Importing the project
---------------------
- From the KDevelop's main screen select **Open Project**.
.. figure:: img/kdevelop_newproject.png
:figclass: figure-w480
:align: center
KDevelop's main screen.
- Navigate to the Godot root folder and select it.
- On the next screen, choose **Custom Build System** for the **Project Manager**.
.. figure:: img/kdevelop_custombuild.png
:figclass: figure-w480
:align: center
- After the project has been imported, open the project configuration by right-clicking
on it in the **Projects** panel and selecting **Open Configuration..** option.
.. figure:: img/kdevelop_openconfig.png
:figclass: figure-w480
:align: center
- Under **Language Support** open the **Includes/Imports** tab and add the following paths:
.. code-block:: none
. // A dot, to indicate the root of the Godot project
core/
core/os/
core/math/
drivers/
platform/<your_platform>/ // Replace <your_platform> with a folder
corresponding to your current platform
.. figure:: img/kdevelop_addincludes.png
:figclass: figure-w480
:align: center
- Apply the changes.
- Under **Custom Build System** add a new build configuration with the following settings:
+-----------------+------------------------------------------------------------------------------+
| Build Directory | *blank* |
+-----------------+------------------------------------------------------------------------------+
| Enable | **True** |
+-----------------+------------------------------------------------------------------------------+
| Executable | **scons** |
+-----------------+------------------------------------------------------------------------------+
| Arguments | See :ref:`doc_introduction_to_the_buildsystem` for a full list of arguments. |
+-----------------+------------------------------------------------------------------------------+
.. figure:: img/kdevelop_buildconfig.png
:figclass: figure-w480
:align: center
- Apply the changes and close the configuration window.
Debugging the project
---------------------
- Select **Run > Configure Launches...** from the top menu.
.. figure:: img/kdevelop_configlaunches.png
:figclass: figure-w480
:align: center
- Click **Add** to create a new launch configuration.
- Select **Executable** option and specify the path to your executable located in
the ``<Godot root directory>/bin`` folder. The name depends on your build configuration,
e.g. ``godot.x11.tools.64`` for 64-bit X11 platform with ``tools`` enabled.
.. figure:: img/kdevelop_configlaunches2.png
:figclass: figure-w480
:align: center
If you run into any issues, ask for help in one of
`Godot's community channels <https://godotengine.org/community>`__.