概述

#

ClipboardData constructortext 参数不再可为空。提供 nulltext 参数的代码必须迁移为提供空字符串 ''

背景

#

为支持多种剪贴板数据变体,ClipboardData 构造函数现在要求至少提供一种数据变体。

此前,平台处理 null 的方式不一致。现在,该行为在所有平台都是一致的。如果您对底层细节感兴趣,请参阅 PR 122446

变更说明

#

ClipboardData constructortext 参数不再可为空。

迁移指南

#

要重置文本剪贴板,请使用空字符串 '' 而不是 null

迁移前的代码

dart
void resetClipboard() {
  Clipboard.setData(ClipboardData(text: null));
}

迁移后的代码

dart
void resetClipboard() {
  Clipboard.setData(ClipboardData(text: ''));
}

时间线

#

生效版本: 3.10.0-9.0.pre
稳定版本:3.10.0

参考资料

#

API 文档

相关 PR