|
Get started with 4.x |
---|---|
|
Get the demo APK |
Still using 3.x ? | It's not maintained or supported. You may have security issues and problems with newer Androids. Switch to 4.x |
|
Not working? Keep calm and follow the troubleshooting procedure |
|
Wiki Read this to discover all the possibilities |
|
Find this library useful? Consider sponsoring its development by pressing the Sponsor button on the top right of this page. |
|
Contributing |
|
Features |
|
Who is using Upload Service |
|
Credits |
|
License |
Screencasts from the example app included in this repository:
Features
- Android 5.0 (API 21) to Android 11 (API 30) support
- 100% Kotlin and fully interoperable with Java
- upload files to a server with
FTP
,HTTP multipart/form-data
orBinary
data requests - upload requests can be serialized and executed later
- handle multiple concurrent uploads in the background, even if the device is idle (Doze mode)
- automatically retry failed uploads, with a configurable exponential backoff
- possiblity implement other upload protocols as plugins
- possibility to automatically delete uploaded files when the upload is successful
- show status in the Android Notification Center.
- change the underlying HTTP stack. Currently
HttpURLConnection
(the default) andOkHttp
are supported. You can also implement your own. - set library log level and provide custom logger implementation
- easily customize the notification with text, icons and actions for the different states
- Possibility to implement your own notification handler
- Lifecycle-Aware RequestObserver to monitor your uploads
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. You are safe launching upload requests from your fragments, activities and services without worrying about locking the thread in which you are. Check the wiki to learn how you can use it in your App.
You are also safe if your app is put in the background. All the uploads will continue to be executed also when your device is idle.
Bear in mind that if you kill your app, the service gets killed as well, as it's attached to your app's process and all the currently running uploads will be terminated abruptly.
Powered by Android Upload Service
Apps and libraries powered by this library. To be included in the following list, simply create an issue and provide the app name and a link.
- JIRA Cloud
- Quora
- crystal.io
- Vydia
- React Native Background Upload
- Background Upload Plugin for Cordova
- VoiSmart IP Communicator
- NativeScript Background HTTP
- Samajbook
- Codeaty
Credits
Created my free logo at LogoMakr.com
License
Copyright (C) 2013-2020 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.