Flutter WeChat Assets Picker 图片选择器新照片不显示问题解析

问题背景

在使用 Flutter WeChat Assets Picker 这个图片选择器插件时，开发者可能会遇到一个典型问题：当升级 photo_manager 到 3.1.0 版本后，新拍摄的照片无法在选择器中显示，只能看到升级前已有的照片。这个问题会影响用户体验，导致用户无法选择最新的照片资源。

问题根源分析

这个问题的根本原因在于 photo_manager 3.1.0 版本引入了一个重要的 API 变更。新版本中，默认的过滤条件发生了变化，导致部分照片资源被意外过滤掉了。具体来说：

1. photo_manager 3.1.0 开始，默认会过滤掉 Live Photos（动态照片）
2. 如果没有显式设置过滤条件，系统会使用这个新的默认行为
3. 这种变化导致部分照片资源无法在选择器中显示

解决方案

要解决这个问题，开发者需要显式地配置过滤条件，覆盖 photo_manager 3.1.0 的默认行为。具体实现方式如下：

final List<AssetEntity>? assets = await AssetPicker.pickAssets(
  context,
  pickerConfig: AssetPickerConfig(
    filterOptions: PMFilter.defaultValue(),
  ),
);

通过这种方式，我们可以确保使用正确的过滤条件，避免新照片被意外过滤。

深入理解 PMFilter.defaultValue()

PMFilter.defaultValue() 实际上是 WeChat Assets Picker 提供的一个便捷方法，它会返回一个包含所有类型资源的默认过滤条件。这个方法内部已经处理好了与 photo_manager 版本的兼容性问题，开发者可以直接使用而不用担心底层实现细节。

最佳实践建议

1. 版本控制：在 pubspec.yaml 中明确指定 photo_manager 的版本，避免意外的自动升级
2. 显式配置：总是显式配置 filterOptions，而不是依赖默认行为
3. 测试验证：升级后要测试各种照片类型的显示情况，包括新拍摄的照片、Live Photos 等

总结

Flutter WeChat Assets Picker 与 photo_manager 的集成使用中，版本兼容性是需要特别注意的问题。通过理解底层原理和正确配置过滤条件，开发者可以确保图片选择器在各种环境下都能正常工作。记住，显式配置总是比隐式依赖更可靠，这也是 Flutter 开发中的一个重要原则。