https://github.com/saantiaguilera/android-api-resources-on-demand
[DEPRECATED] Reduce the size of APKs by making the resources dynamic and downloading them on demand
https://github.com/saantiaguilera/android-api-resources-on-demand
android android-library demand fresco resources
Last synced: about 2 months ago
JSON representation
[DEPRECATED] Reduce the size of APKs by making the resources dynamic and downloading them on demand
- Host: GitHub
- URL: https://github.com/saantiaguilera/android-api-resources-on-demand
- Owner: saantiaguilera
- Created: 2016-08-25T15:01:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-06-08T22:37:48.000Z (almost 8 years ago)
- Last Synced: 2025-01-27T13:11:09.510Z (4 months ago)
- Topics: android, android-library, demand, fresco, resources
- Language: Java
- Homepage:
- Size: 182 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Pomu
## DEPRECATED
This repository is no longer mantained. It has been moved and is currently mantained inside of [Mercadolibre](https://github.com/saantiaguilera/android-api-resources-on-demand)
The current version shown here is really old and has some known bugs, I advise you to dont use it the way it is (if you need something alike, feel free to contact me for questions)
## Loading resources on demand
This api targets problems around APK sizes, specifically having a lot of local resources in every density, which occupy space, but probably are used only at once place.
This will let you download resources on demand, without having to deal with more problems than solutions.
### Minimum Api Level: 11
### Download
In your module gradle file add
```Java
compile 'com.saantiaguilera:Pomu:1.0.3'
```
If its not found (because I have to wait for bintray to add it to jcenter) apply in the module gradle file:
```Java
repositories {
mavenCentral()
maven {
//Since bintray hasnt already publish it
url "http://dl.bintray.com/saantiaguilera/maven"
}
}
```
### Usage:
Initialize Pomu in your Application's onCreate().
Also, if your application targets API levels lower than 19, where Dalvik is the VM, its highly recommended to use Fresco for image loading.
```Java
//In your applications onCreate()
Pomu.initialize(this);
//If you use fresco.
Fresco.initialize(this);
//Optional
//If you plan on using custom configurations (like custom cache / network client)
Pipeline.getInstance().setConfigurations(configurations); //Or wherever you want, but to have a cohesive configuration across all resources its better here :)
//Or on initialization by doing
Pomu.initialize(this, configurations);
//Careful Pomu should only be initialized once.
```
For loading a resource just:
```Java
Pomu.create(context)
.url(urlToLoad)
.callback(ifYouWantCallbacks)
.into(yourImageView);
```
If you are using fresco, this is fully transparent and we will take care of it :)
For customizing fresco loadings, you can provide a
```Java
Pomu.create(context)
....
.controller(FrescoImageController.create(this)
.autoRotate(true)
.resize(400, 400)
.noCache()
.progressiveRendering(true)
// and stuff...
)...
```
If your server / host provides a format of images according to the density of screens
Kinda images are in the format of http://mylovelyhost.com/image-of-id-:id-in-density-:density_pixels
Eg. http://mylovelyhost.com/image-of-id-322345-in-density-400x400
You can give to Pomu a UrlDensityFormatter and have it do this for you instead of boilerplating:
```Java
UrlDensityFormatter formatter = new UrlDensityFormatter() {
@Override
public String from(@NonNull ScreenDensity density) {
switch (density) {
case MDPI:
return "400x400";
case XXXHDPI:
return "xhdpi";
case TV:
return "idk-what-the-server-expects-in-the-url-for-a-tv";
default:
return "200x200";
}
}
};
Pomu.create(context)
....
.url("http://mylovelyhost.com/image-of-id-234234-in-density-%s", formatter)
....
```
If you want to just download a image (or images) without displaying it. For example because your app at start should have always some resources, or because you want them prior to showing them to avoid user seeing the loading. You can do:
```Java
Pomu.create(context)
.url(oneUrlToDownload)
.url(another)
.url(oneMore)
.url(allTheOnesYouWant)
...
.get(); //Instead of into(imageView)
```
### Features:
- [x] Persistable resources once downloaded, to avoid high network traffic and bad ux for the user.
- [x] Fresco and native ImageView support (for memory issues in Dalvik systems Fresco was selected over Picasso)
- [x] Screen density images format support
- [x] Secure storage of resources (in app dir / mangle names)
- [x] Custom cache. By default it's a LRU cache up to 15 mb (maxDiskSize can also be tweaked if you still want to have LRU)
- [x] Getting resources on demand
- [x] Getting resources at any particular moment and caching them
- [x] Cache control (eviction can be done by user)
- [x] Status callbacks