| 141 | |
| 142 | |
| 143 | |
| 144 | == Helper bash scripts == |
| 145 | |
| 146 | KDE's Jenkins-based CI system mainly makes use of these two python scripts: |
| 147 | {{{ |
| 148 | tools/prepare-environment.py |
| 149 | tools/perform-build.py |
| 150 | }}} |
| 151 | |
| 152 | For qt5 they've above been used in order to show the workflow. But in daily use it is more practical to consider some helper bash scripts which ease all actions needed to run project builds on an OSX/CI system for which there's not yet the Jenkins integration available. |
| 153 | |
| 154 | The various projects on the CI system have to be handled by replacing "PROJECT" with the project name of the corresponding framework or application: |
| 155 | {{{ |
| 156 | $ python2.7 tools/prepare-environment.py --project PROJECT --branchGroup kf5-qt5 --platform darwin-mavericks --sources ~/WC/KDECI-build/PROJECT |
| 157 | ... |
| 158 | $ (cd ~/WC/KDECI-build/PROJECT; git checkout jenkins) |
| 159 | ... |
| 160 | $ python2.7 tools/perform-build.py --project PROJECT --branchGroup kf5-qt5 --platform darwin-mavericks --sources ~/WC/KDECI-build/PROJECT |
| 161 | ... |
| 162 | }}} |
| 163 | or alternatively by using [https://projects.kde.org/projects/playground/sdk/macports-kde/repository/revisions/master/show/contrib/scripts/KDECI helper bash scripts from our MacPorts/KDE git repository] |
| 164 | {{{ |
| 165 | $ ./prepare.sh PROJECT |
| 166 | ... |
| 167 | $ ./build.sh PROJECT |
| 168 | ... |
| 169 | }}} |
| 170 | where {{{prepare.sh}}} takes care of creating the build directory if it is not yet existing as well as checks out the branch 'jenkins'. Alternatively one can combine these steps using: |
| 171 | {{{ |
| 172 | $ ./install.sh PROJECT |
| 173 | }}} |
262 | | The various frameworks have to be handled by replacing "PROJECT" with the framework's project name: |
263 | | {{{ |
264 | | $ python2.7 tools/prepare-environment.py --project PROJECT --branchGroup kf5-qt5 --platform darwin-mavericks --sources ~/WC/KDECI-build/PROJECT |
265 | | ... |
266 | | $ (cd ~/WC/KDECI-build/PROJECT; git checkout jenkins) |
267 | | ... |
268 | | $ python2.7 tools/perform-build.py --project PROJECT --branchGroup kf5-qt5 --platform darwin-mavericks --sources ~/WC/KDECI-build/PROJECT |
269 | | ... |
270 | | }}} |
271 | | or alternatively by using [https://projects.kde.org/projects/playground/sdk/macports-kde/repository/revisions/master/show/contrib/scripts/KDECI scripts from our MacPorts/KDE git repository] |
272 | | {{{ |
273 | | $ ./prepare.sh PROJECT |
274 | | ... |
275 | | $ ./build.sh PROJECT |
276 | | ... |
277 | | }}} |
278 | | where {{{prepare.sh}}} takes care of creating the build directory if it is not yet existing as well as checks out the branch 'jenkins'. This is only needed when building a project manually, otherwise it gets one by the jenkins slave. Alternatively one can combine both of these steps using: |
279 | | {{{ |
280 | | $ ./install.sh PROJECT |
281 | | }}} |
282 | | |
283 | | All frameworks of a specific tier can be build as a whole using |
| 295 | Specific frameworks can be installed using {{{install.sh}}} , but one can also build all frameworks of a specific tier as a whole using |