AndroidImageCache icon indicating copy to clipboard operation
AndroidImageCache copied to clipboard

LRU based Bitmap cache for Android. In Addition WebImageView for loading images from web resources.


This repository is no longer maintained. Issue reports and pull requests will not be attended.


AndroidImageCache

Android library which simplifies displaying, caching and managing a lifecycle of images fetched from the web. It provides asynchronous downloading, tasks cancelling and two level cache.

Purposes

Almost every Android application has ListView which contains row with images showed via ImageView. Making smooth application is what we always want to achieve. Processing bitmap (or worse jpg) each time a row is built decreases this smoothness.

Sample

You can play with this library using sample app. Checkout the code under /sample or play with the APK on your device.

How to use

Step 1. Instead of android.widget.ImageView use our pl.polidea.webimageview.WebImageView

<pl.polidea.webimageview.WebImageView
        android:id="@+id/id_sample"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

Step 2. Bind and set your image URL

WebImageView sampleWebImageView = (WebImageView) findViewById(R.id.id_sample);
sampleWebImageView.setImageURL("http://upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png");

Step 3. Check how it works!

Sample

Obtaining

###Maven###

<dependency>
      <groupId>pl.polidea</groupId>
      <artifactId>android-image-cache-library</artifactId>
      <version>2.0</version>
</dependency>

###Gradle###

compile 'pl.polidea:android-image-cache-library:2.0'

###JAR### Download from public Maven repository

Releases

  1. [LATEST] 2013-04-01 - v2.0 - Downloading tasks improvements, introducing Android NBS, migrating all tests to RoboSpock

How to build

Android New Build System

Not only this project is a handy android library. It's also a real-world working example of Android New Build System. Checkout how dependencies between modules are configured among build.gradle files and how the whole project is managed and build by NBS.

RoboSpock

Quality of this library is guarded by tests build in our Robospock library. You can find out how real Android library can be tested without on-device deployment using Spock and Robolectric glued together by Robospock.

Dependencies

The only tool you need is Gradle v1.3 or v1.4 (as of 02-04-2013, gradle v1.5 is not supported by NBS)

Build

Just run in project root: gradle clean build

Developed by

License

    Copyright 2013 Polidea sp. z o.o.
  
    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.