Advanced topics

How to use self-signed certificates

For security reasons, the library doesn't accept self-signed certificates by default when using HTTPS connections, but you can enable them if you need it. Read this.

Retrying failed uploads

Android Upload Service tries its best to upload files. You can in fact set the maximum number of automatic upload retries before notifying an error, by calling the setMaxRetries on the upload request. Since network on mobile devices is unreliable and it may also happen that your server is not reachable when you try to upload something, it may happen that your files are not uploaded even after 100 automatic retries (which is a bad practice btw 😄). So, what I suggest you to do is to keep a reference to the uploadID and the upload request object somewhere in your code, so you can trigger upload again by calling the startUpload method on the request object when certain conditions (e.g. server is reachable again) are met. How to properly implement that behaviour for your specific scenario is up to you. If you can't figure it out how to do it and you need some further help, you're welcome, but that's called consulting 😃 .

Uploading only when a connection is available

If you want to start uploads or retry them based on the remote server's reachability status, Android Host Monitor may be useful to you in combination with this library.

Custom HTTP stack implementation

By default, the library uses the HttpURLConnection stack to perform uploads. However, starting from release 2.1+, you can use also OkHttp (check Setup wiki page) or provide your own implementation! All you need to do is implement HttpStack and HttpConnection interfaces. Refer to the default implementation for an example on how it's done. You can also see how to create a completely new project which provides a custom HTTP stack by looking at how the uploadservice-okhttp module is made.