Android Upload Service

Easily upload files in the background with automatic Android Notification Center progress indication.

Purpose

upload files to a server with HTTP multipart/form-data or binary requests
handle uploads in the background, even if the device is idle
automatically retry failed uploads, with an exponential backoff
possibility to automatically delete successfully uploaded files from the device
show status in the Android Notification Center.

At the core of the library there is a Service which handles multiple concurrent upload tasks in the background. It publishes broadcast intents to notify status. This way the logic is completely decoupled from the UI. Read further to learn how you can use it in your App.

Setup

Maven

<dependency>
  <groupId>net.gotev</groupId>
  <artifactId>uploadservice</artifactId>
  <version>2.0.1</version>
  <type>aar</type>
</dependency>

Gradle

dependencies {
    compile 'net.gotev:uploadservice:2.0.1@aar'
}

and do a project sync. Read this page if you're upgrading from a previous release and for setup troubleshooting.

Check the wiki for full setup instructions and examples to get up and running fast. If something isn't covered there, search in the issues. Your question could already have been answered in the past. There are also some checks you can do yourself to resolve common setup mistakes.

When you post a new issue regarding a possible bug in the library, make sure to add as many details as possible to be able to reproduce the error you encountered. Thank you :)

Apps powered by Android Upload Service

To be included in the following list, simply create an issue and provide the app name and a link.

Contribute

Do you have a new feature in mind?
Do you know how to improve existing docs or code?
Have you found a bug?

Contributions are welcome and encouraged! Just fork the project and then send a pull request. Be ready to discuss your code and design decisions :)

Do you like the project?

Put a star, spread the word and if you want to offer me a free beer,

License

Copyright (C) 2013-2016 Aleksandar Gotev

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

ccmjimmy/android-upload-service