SETUP.md

   1
   2 If you want to start help developing ownCloud please follow the [contribution guidelines][0] and observe these instructions:
   3
   4 ### 1. Fork and download android/develop repository:
   5
   6 NOTE: You must have git in your environment path variable to perform the next operations.
   7
   8 * Navigate to https://github.com/owncloud/android, click fork.
   9 * Clone your new repo: "git clone git@github.com:YOURGITHUBNAME/android.git"
  10 * Move to the project folder with "cd android"
  11 * Checkout remote develop branch: "git checkout -b develop remotes/origin/develop"
  12 * Pull changes from your develop branch: "git pull origin develop"
  13 * Make official ownCloud repo known as upstream: "git remote add upstream git@github.com:owncloud/android.git"
  14 * Make sure to get the latest changes from official android/develop branch: "git pull upstream develop"
  15
  16 At this point you can continue using different tools to build the project. Section 2, 3 and 4 describe some of the existing alternatives.
  17
  18 ### 2. Building with Ant:
  19
  20 NOTE: You must have the Android SDK 'tools/', and 'platforms-tools/' folders in your environment path variable.
  21
  22 * Complete the setup of project properties and resolve pending dependencies running "setup_env.bat" or "./setup_env.sh" .
  23 * Run "ant clean" .
  24 * Run "ant debug" to generate a debuggable version of the ownCkoud app.
  25
  26 ### 3. Building with console/maven:
  27
  28 NOTE: You must have mvn in your environment path
  29
  30 * Download/install Android plugin for Maven, then build ownCloud with mvn:
  31 * "cd .."
  32 * "git clone https://github.com/mosabua/maven-android-sdk-deployer.git"
  33 * "cd maven-android-sdk-deployer"
  34 * "mvn -pl com.simpligility.android.sdk-deployer:android-17 -am install"
  35 * "cd ../android"
  36 * Now you can create APK using "mvn package"
  37
  38 ### 4. Building with Eclipse:
  39
  40 NOTE: You must have the Android SDK 'tools/', and 'platforms-tools/' folders in your environment path variable.
  41
  42 * Complete the setup of project properties and resolve pending dependencies running "setup_env.bat" or "./setup_env.sh" .
  43 * Open Eclipse and create new "Android Project from Existing Code". Choose android/actionbarsherlock/library as root.
  44 * Clean project and compile.
  45 * If any error appear, check the project properties; in the 'Android' section, API Level should be greater or equal than 14.
  46 * Make sure android/actionbarsherlock/library/bin/library.jar was created.
  47 * Create a new "Android Project from Existing Code". Choose android/oc_framework/library as root.
  48 * Clean project and compile.
  49 * If any error appear, check the project properties; in the 'Android' section, API Level should be 19 or greater.
  50 * Make sure android/oc_framework/bin/classes.jar was created.
  51 * Import ownCloud Android project.
  52 * Clean project and compile.
  53 * If any error appears, check the project properties; in the 'Android' section:
  54   - API Level should be 19 or greater.
  55   - Two library projects should appear referred in the bottom square: actionbarsherlock/library and oc_framework. Add them if needed.
  56 * After those actions you should be good to go. HAVE FUN!
  57
  58 NOTE: Even though API level is set to 19, APK also runs on older devices because in AndroidManifest.xml minSdkVersion is set to 8.
  59
  60 ### 5. Create pull request:
  61
  62 NOTE: You must sign the [Contributor Agreement][1] before your changes can be accepted!
  63
  64 * Commit your changes locally: "git commit -a"
  65 * Push your changes to your Github repo: "git push"
  66 * Browse to https://github.com/YOURGITHUBNAME/android/pulls and issue pull request
  67 * Click "Edit" and set "base:develop"
  68 * Again, click "Edit" and set "compare:develop"
  69 * Enter description and send pull request.
  70
  71
  72 [0]: https://github.com/owncloud/android/blob/master/CONTRIBUTING.md
  73 [1]: http://owncloud.org/about/contributor-agreement/