Difference between revisions of "An exercise for new contributors"
(→Exercise) |
(updated the intruction for gcompris-qt) |
||
| Line 6: | Line 6: | ||
* Install GNU/Linux on your computer if you don't already have it. | * Install GNU/Linux on your computer if you don't already have it. | ||
| + | * Download and Install the lastest stable version of [http://qt-project.org/downloads QtCreator] for Android | ||
* Get the GCompris code from the Git version control system (or see bellow the GitHub option). | * Get the GCompris code from the Git version control system (or see bellow the GitHub option). | ||
| − | ** git clone | + | ** git clone git@github.com:bdoin/GCompris-qt.git |
| − | ** cd | + | ** cd GCompris-qt |
* Create a branch for your development | * Create a branch for your development | ||
** git checkout -b exercise | ** git checkout -b exercise | ||
| − | * | + | * Start QtCreator and open the project file GCompris.pro at the root of the source code |
| − | + | * Compile and run it. | |
| − | + | * Create a new activity using the supplied ''createit.sh'' script. For example, use your nick name as the activity name. | |
| − | * Create a new | + | ** cd src/activities |
| − | ** cd src | + | ** ./createit.sh 'my new activity' |
| − | ** ./createit.sh | + | * Compile GCompris again in Qt Creator, check you new activity is present |
| − | * Compile GCompris again | + | * Modify the activity to display an image, a rectangle and a text. |
| − | + | ** You can search for code examples in other activities and check the [http://qt-project.org/doc/qt-5/gettingstartedqml.html Qml getting started]. | |
| − | |||
| − | |||
| − | |||
| − | * Modify the activity to display an image | ||
| − | ** You can search for code examples in other activities and check the [http:// | ||
* Add an event to a graphical object so that clicking on it does something visual. | * Add an event to a graphical object so that clicking on it does something visual. | ||
| − | + | * Use git add and git commit to commit your changes locally. | |
| − | * Use git to commit your changes locally. | + | ** git add 'my new activity' |
| − | ** git add | ||
** git commit -a | ** git commit -a | ||
| − | |||
| − | |||
| − | |||
=== Publish your patch on GitHub === | === Publish your patch on GitHub === | ||
* Create an account on [https://github.com github] | * Create an account on [https://github.com github] | ||
| − | * Fork [ | + | * Fork [git@github.com:bdoin/GCompris-qt.git GCompris] |
** Look at these [http://help.github.com/fork-a-repo/ instructions] | ** Look at these [http://help.github.com/fork-a-repo/ instructions] | ||
* Code your activity | * Code your activity | ||
* Commit the code | * Commit the code | ||
| − | |||
| − | |||
* Push it | * Push it | ||
** git push | ** git push | ||
* On github send me a pull request | * On github send me a pull request | ||
Revision as of 18:19, 1 March 2014
Exercise
In order to help you practice in the GCompris framework, I propose you to make this little exercise.
Mandatory: GCompris development is done on a GNU/Linux distribution of your choice.
- Install GNU/Linux on your computer if you don't already have it.
- Download and Install the lastest stable version of QtCreator for Android
- Get the GCompris code from the Git version control system (or see bellow the GitHub option).
- git clone git@github.com:bdoin/GCompris-qt.git
- cd GCompris-qt
- Create a branch for your development
- git checkout -b exercise
- Start QtCreator and open the project file GCompris.pro at the root of the source code
- Compile and run it.
- Create a new activity using the supplied createit.sh script. For example, use your nick name as the activity name.
- cd src/activities
- ./createit.sh 'my new activity'
- Compile GCompris again in Qt Creator, check you new activity is present
- Modify the activity to display an image, a rectangle and a text.
- You can search for code examples in other activities and check the Qml getting started.
- Add an event to a graphical object so that clicking on it does something visual.
- Use git add and git commit to commit your changes locally.
- git add 'my new activity'
- git commit -a
Publish your patch on GitHub
- Create an account on github
- Fork [git@github.com:bdoin/GCompris-qt.git GCompris]
- Look at these instructions
- Code your activity
- Commit the code
- Push it
- git push
- On github send me a pull request
