☎️ The ownCloud Android Library
Clone or download
davigonz Merge pull request #195 from owncloud/feature/request_id
Use UUID v4 to represent request ids and log it
Latest commit 9526038 Oct 22, 2018
Permalink
Failed to load latest commit information.
.settings Fix eclipse project settings for Juno release 2 Jan 27, 2014
gradle/wrapper Fix merge dex error and delete redundant dependencies Apr 30, 2018
libs Update Jackrabbit-WebDAV version Sep 27, 2016
sample_client Include setup.xml for sample client Oct 2, 2018
src/com/owncloud/android/lib Use UUID v4 to represent request ids and log it Oct 10, 2018
test_client Update sample client to use new library Oct 2, 2018
.classpath Initial commit of ownCloud Android library Jan 20, 2014
.gitignore Include setup.xml for sample client Oct 2, 2018
.project Initial commit of ownCloud Android library Jan 20, 2014
.travis.yml Update emulator version Oct 18, 2017
AndroidManifest.xml Update minSdkVersion Apr 30, 2018
LICENSE.md Updated copyright Aug 2, 2016
README.md Removed reference to git branching model to avoid confussion Aug 7, 2015
ant.properties Update build version to Java 7 Apr 25, 2017
build.gradle Include dav4android via jitpack Sep 25, 2018
build.xml Updated build properties for Ant, for library and sample client Jan 21, 2014
custom_rules.xml Updated build properties for Ant, for library and sample client Jan 21, 2014
gradlew Added gradle support to the owncloud-android-library Nov 21, 2014
gradlew.bat Added gradle support to the owncloud-android-library Nov 21, 2014
pom.xml Update pom.xml Oct 12, 2014
project.properties - changed project.properties files. Aug 12, 2016
settings.gradle Include dav4android via jitpack Sep 25, 2018
wait_for_emulator.sh Reduced output while waiting for emulator starts Apr 22, 2014

README.md

ownCloud Android Library

Introduction

Using ownCloud Android library it will be the easiest way to communicate with ownCloud servers. Add this library in your project and integrate your application with ownCloud seamlessly.

Install Library

2.1. Information how to get the library

Get this code and compile it. In the repository it is not only the library project but also the example project “sample_client”; thanks to it you will learn how to use the library.

2.2. Add library to your project

There are different ways of adding this library to your code, then it is described one of them

Step 1. Compile the ownCloud Android Library Step 2. Define a dependency within your project. For that, access to Properties > Android > Library and click on add and select the ownCloud Android library

Branching strategy

The repository holds two main branches with an infinite lifetime:

  • stable
  • master

Branch origin/stable is considered the main branch where the source code of HEAD always reflects a production-ready state.

Branch origin/master is considered the main branch where the source code of HEAD always reflects a state with the latest delivered development changes for the next release.

When the source code in the master branch reaches a stable point and is ready to be released, all of the changes should be merged back into stable somehow and then tagged with a release number.

Other branches, some supporting branches are used to aid parallel development between team members, ease tracking of features, prepare for production releases and to assist in quickly fixing live production problems. Unlike the main branches, these branches always have a limited life time, since they will be removed eventually.

The different types of branches we may use are:

  • Branch perNewFeature
  • Branch releaseBranches

Both of them branch off from master and must merge back into master branch through a Pull Request in Github. Once the PR is approved and merged, the US branch may be deleted.

License

ownCloud Android Library is available under MIT license. See the file LICENSE.md with the full license text.

Third party libraries

ownCloud Android Library uses Apache JackRabbit, version 2.2.5. Copyright (C) 2004-2010 The Apache Software Foundation. Licensed under Apache License, Version 2.0.

Apache JackRabbit depends on Commons HTTPClient version 3.1 and SLF4j version 1.7.5; both included also. Copyright (C) 2004-2010 The Apache Software Foundation. Licensed under Apache License, Version 2.0.

Compatibility

ownCloud Android Library is valid for Android systems from version Android 2.2 (android:minSdkVersion="8" android:targetSdkVersion="19").

ownCloud Android library supports ownCloud server from version 4.5.