awarmhug / doodle Goto Github PK

中文文档

Doodle is an efficient image loader (Android platform).

Doodle's API design refers to Picasso and Glide, so if you have used a similar image loader, it's easy to get start. Compared to Picasso, Doodle's implementation has more detail (cache design, life cycle, task scheduling, GIF support, decoding etc.); Compared to Glide, Doodle's implementation is more lightweight (400+ methods, 104K aar).

dependencies {
    implementation 'com.horizon.doodle:doodle:1.1.2'
}

Simple case, just set path and target：

Doodle.load(url).into(bottomIv)

You can also set more parameters：

Doodle.load(url)
        .placeholder(R.color.colorAccent)
        .diskCacheStrategy(DiskCacheStrategy.SOURCE)
        .into(bottomIv)

Doodle has a default configuration in the Config class, You can define your own configuration by putting parameters to Config.

Doodle.config()
        .setDiskCacheCapacity(256L shl 20)
        .setGifDecoder(gifDecoder)

Doodle implements a lifecycle mechanism. When the Activity is destroyed, cancel the request refer to the Activity/Fragemtn; Dynamically change the priority when the Activity/Fragment switch visible/invisible.

If the current page is Activity and the target is ImageView, no more code is required. Because Doodle has implemented monitoring of Activity lifecycle, If you haven't set host of Request( by calling host(Any), which is a method of Request), Doodle will automatically extract the activity associated with the ImageView as the host.

For observering Fragment's life cycle, you need to call Doodle.notifyEvent() in callback of Fragment, like onDestroy(). Doodle haven't implemented observering life cycle of Fragment, for considering to inject two lines of code outside is more effective.

public abstract class BaseFragment extends Fragment {
    @Override
    public void setUserVisibleHint(boolean isVisibleToUser) {
        super.setUserVisibleHint(isVisibleToUser);
        Doodle.notifyEvent(this, isVisibleToUser ? LifeEvent.SHOW : LifeEvent.HIDE);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        Doodle.notifyEvent(this, LifeEvent.DESTROY);
    }
}

And set the Fragment to Request:

Doodle.load(url)
		.host(fragment)
		.into(bottomIv)

https://www.jianshu.com/p/3df395d8a6bc

See the LICENSE file for license rights and limitations.