Flutter 控件CachedNetworkImage使用的坑

问题

通过参考Flutter 中文网的文档，按照要求进行集成接入，基本步骤：

• 在 YAML 中引用包：cached_network_image: ^0.6.2
• 参考文档写法，在自己的代码中加入以下部分
  body: new Center( child: new CachedNetworkImage( placeholder: new CircularProgressIndicator(), imageUrl:'', ), ),
  首先，placeholder 参数的定义方法一直报错，提示参数类型不正确，报错：
  
  最后找到原因，新版本的参数定义方法和 Flutter 中文网上的文档已经不一样了，应该使用新的写法：

placeholder:(context,url)=> CircularProgressIndicator(),

修改之后，代码显示正确了，但是在编译运行时又报错了：

Error: The argument type 'Null Function(StringBuffer)' can't be assigned to the parameter type 'Iterable Function()'.

'StringBuffer' is from 'dart:core'.
'Iterable' is from 'dart:core'.
'DiagnosticsNode' is from 'package:flutter/src/foundation/diagnostics.dart' ('file:///Users/xyz/flutter/packages/flutter/lib/src/foundation/diagnostics.dart').
Try changing the type of the parameter, or casting the argument to 'Iterable Function()'.
informationCollector: (StringBuffer information) {

参考 git 上提交的 bug，解释的倒是挺清楚，问题是没有提到 CachedNetworkImage 包什么时候能好。
Git 上的 issue
于是去找报错的源码，忽然在目录里看到，在我使用的版本之上还有两个版本目录：

在 YAML 里将导入的版本用 0.7.0 和 0.8.0 都试了一下，发现 0.8.0 版本是正确的，把两个版本的源码对比一下可以看到变化 ：
0.7 版本报错的方法代码，问题出在 informationCollector 那里：

@override
  ImageStreamCompleter load(CachedNetworkImageProvider key) {
    return new MultiFrameImageStreamCompleter(
        codec: _loadAsync(key),
        scale: key.scale,
        informationCollector: (StringBuffer information) {
          information.writeln('Image provider: $this');
          information.write('Image key: $key');
        });
  }

再看 0.8 版本的这里：

@override
  ImageStreamCompleter load(CachedNetworkImageProvider key) {
    return new MultiFrameImageStreamCompleter(
      codec: _loadAsync(key),
      scale: key.scale,
// TODO enable information collector on next stable release of flutter
//      informationCollector: () sync* {
//        yield DiagnosticsProperty<ImageProvider>(
//          'Image provider: $this \n Image key: $key',
//          this,
//          style: DiagnosticsTreeStyle.errorProperty,
//        );
//      },
    );
  }

产生问题的代码部分被注释了，现在终于可以看到运行的效果了。再去官方控件文档查看，https://pub.flutter-io.cn/packages/cached_network_image/install，已经升级到3.0.0，😿

总结

其实想说很多国内翻译过来的文档，有时都更新不及时，出现问题最好第一时间去官网查看源文档，最好养成看官方文档的习惯。