Setup working environment

Setup your working environment for contributing.

• install Android Studio (version 0.6.1 or higher required)
• Make sure git is on your PATH
  • Windows: http://blog.countableset.ch/2012/06/07/adding-git-to-windows-7-path/
  • Linux:
  • OSX: http://www.cyberciti.biz/faq/appleosx-bash-unix-change-set-path-environment-variable/
• MANDATORY: set this git setting: "git config --global push.default simple" !!
• optional: restart Android Studio
• clone the repository with command line or Github app
• open as a project in Android Studio (not import!)
• wait until Gradle has finished configuration (approx. 1 minute)
• to constantly ignore some configuration files changed by Android Studio run :gitSkipWorktreeForIntellijConfigFiles from your Gradle Tool Window

Next Steps

• read and understand git flow (original post by Vincent Driessen, Tutorial by Atlassian)
• browse issues to fix from our JIRA Backlog
• members: move the ticket to 'in development'
• members: create a branch with [name schema](name schema)
• write good, tested code and ensure that gradle:check has no warnings
• format, optimize imports and rearrange your code with Android Studio
• create a pull request on Github
• members: move the ticket on JIRA to 'done'

Possible Errors+Solutions

• Wrong Build-tool Version: Install Version 19.1.0 in Tools->Android->SDK Manager
• No Access to SDK-Manager: Create a new Project, open there the SDK-Manager and Update the Build-tools
• Everything in SDK-Manager is installed, but Gradle says it is missing?: you have more than one SDK-Manager installed. Check $PROJECT_DIR/local.properties which one is used
• Cant Update Build-tools on Windows: run Android Studio as Administrator
• "Exception: null: null": Update Android Studio to Version 0.6.1 or higher
• Can't create Emulator Device: Spaces in Emulator name?
• In command line: "gradle not found"? Maybe Gradle is not installed. Then you should use ./gradlew assembleDebug or gradlew.bat assembleDebug instead

Notes

• egit (Eclipse extension for git) will ignore some git settings and will make trouble with line endings!
• You should have following path variables defined:
  • JAVA_HOME
  • ANDROID_HOME
  • and your git location in PATH

Contact

If you want to talk to someone on our team you can find us via IRC on freenode in #catrobat or #catrobatdev
Or if you don't have an IRC client simple use the web-irc from freenode: here