ImageLoaderFramework Documentation

Initialization must be performed in your Application class. You use ImageLoaderConfig.Builder to specify the loader type (via LoaderEnum) and the specific loader implementation (e.g., GlideImageLocader). You can also configure the memory cache size in bytes using .maxMemory().

// Initialization code in Application
ImageLoaderConfig config = new ImageLoaderConfig.Builder(LoaderEnum.GLIDE, new GlideImageLocader())
        .maxMemory(40 * 1024 * 1024L)  // Configure memory cache in Bytes
        .build();
ImageLoaderManager.getInstance().init(this, config);

To use the framework, add the core library and choose one of the underlying implementation libraries (Glide or Fresco) to your dependencies. You must include imageloader-framework, but you only need one of the implementation packages.

// Choose one of these two based on your needs
compile 'com.ladingwu.library:fresco:0.0.9'
compile 'com.ladingwu.library:glide:0.0.9'

// This is required
compile "com.ladingwu.library:imageloader-framework:0.0.9"

Since version 0.0.9, you can use a streamlined, chainable API to load images in a single step. This method is preferred for its conciseness and supports features like Gaussian blur, circular cropping, and placeholders.

ImageLoader.createImageOptions(img2, url)
        .blurImage(true)
        .blurValue(35)
        .isCircle()
        .placeholder(R.mipmap.ic_launcher)
        .build()
        .show();

The older API involves building an ImageLoaderOptions object and passing it to ImageLoaderManager.getInstance().showImage(options). This method is still supported for backward compatibility.

// Load rounded image
ImageLoaderOptions op = new ImageLoaderOptions.Builder(img1, url).imageRadiusDp(12).build();
ImageLoaderManager.getInstance().showImage(op);

// Advanced options
ImageLoaderOptions options = new ImageLoaderOptions.Builder(img2, url)
        .blurImage(true)             // Gaussian blur
        .blurValue(35)               // Blur intensity
        .isCircle()                  // Circular image
        .placeholder(R.mipmap.ic_launcher)
        .build();

// If using both Fresco and Glide, you can force a specific loader
ImageLoaderManager.getInstance().showImage(options, LoaderEnum.GLIDE);

You can monitor the loading progress of an image by attaching an OnLoaderProgressCallback to the options. This works with both the new fluent API and the legacy API.

// New API (0.0.9+)
ImageLoader.createImageOptions(img1, url)
    .setOnLoaderProgressCallback(new OnLoaderProgressCallback() {
        @Override
        public void onProgress(int progress) {
            Log.w("progress", "" + progress);
        }
    })
    .imageRadiusDp(12)
    .build()
    .show();

// Legacy API
ImageLoaderOptions op = new ImageLoaderOptions.Builder(img1, url)
    .setOnLoaderProgressCallback(new OnLoaderProgressCallback() {
        @Override
        public void onProgress(int progress) {
            Log.w("progress", "" + progress);
        }
    })
    .imageRadiusDp(12)
    .build();
ImageLoaderManager.getInstance().showImage(op);

The framework provides methods to pause and resume image loading via the ImageLoaderManager to optimize performance during specific lifecycle events or user interactions.

// Pause loading
void pause(Context context);

// Resume loading
void resume(Context context);