Flutter Image.network缓存逻辑
图片缓存的主要类及方法
- Image : network, _resolveImage, _updateSourceStream, _replaceImage, build;
- ImageStream: addListener, setCompleter
- ImageProvider: resolve, createStream, resolveStreamForKey;
子类: NetworkImage, ScrollAwareImageProvider, ResizeImage - ImageCache: putIfAbsent;
工作原理
- 由Image调用ImageProvider来创建ImageStream;
- ImageStream负责图片的下载;
- ImageProvider创建组装ImageStream,来通过ImageCache来处理缓存;
- Image监听ImageStream,来更新widget;
工作流程
- Image.network: 创建ImageProvider(NetworkImage)
如果cacheHeight或cacheWidth不为空会创建ResizeImage来代理NetworkImage的工作,这里不具体展开; - Image._resolveImage: didChangeDependencies/didUpdateWidget/reassemble会调用此方法,可以视为后面步骤的入口
- 创建ScrollAwareImageProvider来代理上一步创建的ImageProvider的工作;
- ImageProvider.resolve创建ImageStream;
- Image._updateSourceStream: 为新建的ImageStream添加监听ImageStream.addListener,此监听会对图片的下载过程做出相应处理,并最终调用setState;
- ImageProvider.resolve:
- 通过ImageProvider.createStream创建一个ImageStream;
- 添加成功和失败的回调,其中成功会调用ImageProvider.resolveStreamForKey;
- ImageProvider.resolveStreamForKey:
- ScrollAwareImageProvider.resolveStreamForKey: 通过重写此方法防止快速滑动导致的无用加载
- 完成判断:如果stream是否已经添加过completer(已经执行过一次resolveStreamForKey)或图片已经缓存完成,则继续执行ImageProvider.resolveStreamForKey;
- 移除判断:如果widget上下文已经被移出树,则直接return,此处判断优先级低于‘完成判断’是为了更新LRU;
- 快速滑动判断:如果当前是在快速滑动(Scrollable.recommendDeferredLoadingForContext),则在下一帧(SchedulerBinding.instance!.scheduleFrameCallback)递归调用当前方法,直到在其他判断中结束;
- 如果前面的判断没有拦截,则调用ImageProvider.resolveStreamForKey;
- ImageProvider.resolveStreamForKey
- 如果ImageStream没有设置过completer,则调用ImageProvider.load创建;
- 调用ImageCache.putIfAbsent,将上面创建或原有的completer二次处理;
- 将最终的completer设置给ImageStream;ImageCache.putIfAbsent;
- ScrollAwareImageProvider.resolveStreamForKey: 通过重写此方法防止快速滑动导致的无用加载
- ImageCache.putIfAbsent:
- 从_pendingImages中获取completer,返回此completer;
- 从_cache中获取completer,并将此completer对应的image移动到_cache头部(更新LRU,后面更新LRU的方式与此相同),返回此completer;
- 从_liveImages中获取_LiveImage,调用_touch(更新LRU,并重新计算size),将_LiveImage封装为completer并返回;
- 如果前面没有获取到任何结果,则返回方法参数传递的completer;
- NetworkImage.load(ImageProvider.load的实现)
- 创建MultiFrameImageStreamCompleter;