Flutter Image.network缓存逻辑

图片缓存的主要类及方法

1. Image : network, _resolveImage, _updateSourceStream, _replaceImage, build；
2. ImageStream: addListener, setCompleter
3. ImageProvider: resolve, createStream, resolveStreamForKey；
   子类: NetworkImage, ScrollAwareImageProvider, ResizeImage
4. ImageCache: putIfAbsent;

工作原理

1. 由Image调用ImageProvider来创建ImageStream；
2. ImageStream负责图片的下载；
3. ImageProvider创建组装ImageStream，来通过ImageCache来处理缓存；
4. Image监听ImageStream，来更新widget；

工作流程

1. Image.network: 创建ImageProvider(NetworkImage)
   如果cacheHeight或cacheWidth不为空会创建ResizeImage来代理NetworkImage的工作，这里不具体展开；
2. Image._resolveImage: didChangeDependencies/didUpdateWidget/reassemble会调用此方法，可以视为后面步骤的入口
   • 创建ScrollAwareImageProvider来代理上一步创建的ImageProvider的工作；
   • ImageProvider.resolve创建ImageStream;
   • Image._updateSourceStream: 为新建的ImageStream添加监听ImageStream.addListener，此监听会对图片的下载过程做出相应处理，并最终调用setState；
3. ImageProvider.resolve:
   • 通过ImageProvider.createStream创建一个ImageStream；
   • 添加成功和失败的回调，其中成功会调用ImageProvider.resolveStreamForKey；
4. 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;
5. ImageCache.putIfAbsent:
   • 从_pendingImages中获取completer，返回此completer；
   • 从_cache中获取completer，并将此completer对应的image移动到_cache头部（更新LRU，后面更新LRU的方式与此相同），返回此completer；
   • 从_liveImages中获取_LiveImage，调用_touch（更新LRU，并重新计算size），将_LiveImage封装为completer并返回；
   • 如果前面没有获取到任何结果，则返回方法参数传递的completer；
6. NetworkImage.load(ImageProvider.load的实现)
   • 创建MultiFrameImageStreamCompleter；