/kf5-qt5/education/gcompris/HACKING

0001                         GCompris HACKING
0002
0003 Official repository
0004 -------------------
0005 The official repository requires a KDE developer account, we will ask regular
0006 contributors to get an account and work on the KDE repository.
0007
0008     https://invent.kde.org/education/gcompris
0009
0010 For new developers and those interested only in smaller contributions use the
0011 https://phabricator.kde.org/ or GitHub repository.
0012
0013
0014 Source code from GitHub
0015 -----------------------
0016 Checkout the source code by cloning it from GitHub
0017
0018     git clone git://github.com/gcompris/GCompris-qt.git
0019
0020 If you want to have a personal fork, in order to commit occasional patches,
0021 fork it on GitHub then clone your fork
0022
0023     git clone git@github.com:<username>/GCompris-qt.git
0024
0025 When asking for a pull request, create a new topic branch and commit your
0026 changes there then open a pull request to gcompris-qt repository on GitHub.
0027
0028 See GitHub's documentation for more information.
0029
0030     https://help.github.com/categories/collaborating/
0031
0032
0033 Dependencies
0034 ------------
0035 In order to be able to compile GCompris the following Qt5 dependencies need to
0036 be installed (version 5.12 minimum)
0037
0038     Qt 5 Development Defaults
0039     Qt 5 qmake
0040     Qt Creator
0041     Qt Linguist Tools
0042
0043     Qt Core
0044     Qt Graphical Effects QML Module
0045     Qt Gui
0046     Qt Multimedia
0047     Qt Multimedia QML Module
0048     Qt Network
0049     Qt Qml
0050     Qt Quick
0051     Qt Svg
0052
0053 CMake must be installed to compile GCompris:
0054
0055     sudo apt install cmake
0056
0057 Installing dependencies on a Debian based systems can be done like this:
0058
0059     sudo apt install libqt5svg5-dev \
0060                           qml-module-qtmultimedia \
0061                           qml-module-qtgraphicaleffects qt5-qmake qtcreator \
0062                           qtdeclarative5-dev qtdeclarative5-dev \
0063                           qtmultimedia5-dev qtquickcontrols2-5-dev qttools5-dev \
0064                           qttools5-dev-tools libqt5multimedia5-plugins \
0065                           qml-module-qtsensors libqt5quickparticles5 \
0066                           qml-module-qtquick2 qml-module-qtquick-particles2 \
0067                           libqt5sensors5-dev libqt5sensors5
0068
0069 To build for Android, Qt 5 AndroidExtras also needs to be installed.
0070
0071 If building from a .tar.gz or .zip source distribution the externals may
0072 need to be added.
0073
0074     cd GCompris-qt-*
0075     git clone https://github.com/qml-box2d/qml-box2d.git external/qml-box2d/
0076
0077
0078 Build
0079 -----
0080 Start QtCreator and select Open Project and open CMakeLists.txt in the
0081 gcompris-qt root directory. Follow the wizard instructions.
0082
0083 Use the buttons on the lower left side to build, run, and debug GCompris.
0084
0085 An alternative building process is to use cmake in command-line directly.
0086
0087     cd GCompris-qt-*
0088     mkdir build
0089     cd build
0090     cmake ..
0091     make
0092     ./bin/gcompris-qt
0093
0094 More Details
0095 ------------
0096 Go To this Link:
0097           https://gcompris.net/wiki/Qt_Quick_development_process