gotev/android-upload-service

Easily upload files (Multipart/Binary/FTP out of the box) in the background with progress notification. Support for persistent upload requests, customizations and custom plugins.

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.alexbbb:android-upload-service:4.9.4'
	}

	dependencies {
		implementation("com.github.alexbbb:android-upload-service:4.9.4")
	}

	<dependency>
	    <groupId>com.github.alexbbb</groupId>
	    <artifactId>android-upload-service</artifactId>
	    <version>4.9.4</version>
	</dependency>


                            
    libraryDependencies += "com.github.alexbbb" % "android-upload-service" % "4.9.4"


                            
    :dependencies [[com.github.alexbbb/android-upload-service "4.9.4"]]

Readme

<p align="center"> <img src="uploadservice-logo.png"><br> 10 years! Since 2013 </p>

Maven Central

Screencasts from the example app included in this repository:

compose-upload upload

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.

Features <a name="features"></a>

Android 5.0 (API 21) to Android 14 (API 34) support.
- Android 13 Note, for apps targeting API 33 or newer:
  - Due to new behavior changes, you are required to request POST_NOTIFICATIONS permission at runtime in your app or else the upload progress won't be shown. To see an example, please look at the BaseActivity in the examples/app folder.
- Android 12 Note, for apps targeting API 31 or newer:
  - What's supported: uploads initiated while the app is in foreground, with progress indication notification
  - What's NOT supported: uploads started while the app is in the background or uploads without progress indication notification. This is due to the Service limitations imposed by Google, which requires all background services to display a notification to the user. Current architecture cannot support this. For support of those use-cases, WorkManager is the only option.
100% Kotlin and fully interoperable with Java
upload files to a server with FTP, HTTP multipart/form-data or Binary 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) and OkHttp 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

Powered by Android Upload Service <a name="powered"></a>

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.

Credits <a name="credits"></a>

Created my free logo at LogoMakr.com

License <a name="license"></a>

Copyright (C) 2013-2023 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.