Ant Design Mobile RN 中 Picker 组件 defaultValue 属性在 HarmonyOS 和 iOS 上的兼容性问题解析

问题概述

在 Ant Design Mobile RN 9.8.0 版本中，Picker 组件的 defaultValue 属性在 HarmonyOS 和 iOS 平台上存在兼容性问题。开发者设置 defaultValue 属性后，界面无法正确显示预设的默认值，而 Android 平台则表现正常。

问题表现

当开发者按照如下方式使用 Picker 组件时：

<Picker data={datas} defaultValue={['42', '4201', '420111']}>
    <List.Item arrow="horizontal">{'省市选择'}</List.Item>
</Picker>

在 HarmonyOS 和 iOS 平台上，Picker 不会显示预设的默认值（如上述代码中的省市数据），而是显示空白或第一个选项。这个问题在 Android 平台上则不会出现，能够正常显示预设的默认值。

技术背景

Picker 组件是移动端开发中常用的选择器控件，用于从一组选项中选择一个或多个值。defaultValue 属性是 React 组件中常见的属性，用于指定组件的初始值。在跨平台开发框架如 React Native 中，由于不同操作系统底层实现差异，有时会出现平台特定的兼容性问题。

问题原因分析

1. 平台差异：HarmonyOS 和 iOS 在实现 Picker 组件时可能有不同的内部机制，导致 defaultValue 属性的处理方式与 Android 不同。

2. 生命周期时机：可能在组件挂载时，defaultValue 的传递时机与平台渲染机制不匹配。

3. 数据格式要求：某些平台可能对 defaultValue 的数据格式有特殊要求，而当前实现未能完全兼容。

解决方案

该问题已在 Ant Design Mobile RN 5.3.0 版本中得到修复。开发者可以通过以下方式解决：

1. 升级版本：将项目依赖的 ant-design-mobile-rn 升级到 5.3.0 或更高版本。

2. 临时解决方案：如果暂时无法升级，可以考虑使用受控组件的方式，通过 state 管理 Picker 的值：

const [selectedValue, setSelectedValue] = useState(['42', '4201', '420111']);

<Picker
  data={datas}
  value={selectedValue}
  onChange={setSelectedValue}
>
  <List.Item arrow="horizontal">{'省市选择'}</List.Item>
</Picker>

最佳实践建议

1. 跨平台测试：在使用类似 Picker 这样的基础组件时，应在所有目标平台上进行充分测试。

2. 版本管理：定期更新组件库版本，以获取最新的 bug 修复和功能改进。

3. 错误处理：对于关键的选择器功能，建议添加适当的错误处理和默认值回退机制。

4. 文档查阅：在使用组件前详细阅读官方文档，了解各属性的平台兼容性说明。

总结

Picker 组件的 defaultValue 属性在 HarmonyOS 和 iOS 上的兼容性问题是一个典型的跨平台开发挑战。通过版本升级或采用受控组件模式可以有效解决这个问题。这也提醒开发者在跨平台开发中需要特别注意平台差异，建立完善的测试流程，确保应用在各平台上的表现一致。