RN项目鸿蒙化是遇到的ListView引用问题复盘
RN鸿蒙化过程中,ListView引用异常
一、背景:
青海人社通为2018年左右由长天科技开发完成的RN项目,在2024年时推出了鸿蒙应用版本,但由于退出的版本功能完备度较低,故而在今年时重新开发,将由原先RN项目进行鸿蒙化,完成全量应用开发。受限于时间影响人社通RN版本为0.59,内部涉及的长列表渲染为ListView实现。
二、ListView 是什么?
在 React Native 早期版本(0.60 之前),ListView 是官方提供的用于渲染长列表(如新闻流、商品列表、聊天记录)的核心组件。
它的作用与今天的 FlatList 类似:高效地渲染一个可滚动的、数据驱动的列表视图。
三、ListView 的基本使用方式
一个最基础的 ListView 示例通常如下:
import React, { Component } from 'react';
import { ListView, Text, View } from 'react-native';
export default class MyListView extends Component {
constructor(props) {
super(props);
const data = ['苹果', '香蕉', '橙子', '葡萄'];
const ds = new ListView.DataSource({
rowHasChanged: (r1, r2) => r1 !== r2,
});
this.state = {
dataSource: ds.cloneWithRows(data),
};
}
renderRow(rowData) {
return (
<View style={{ padding: 10 }}>
<Text>{rowData}</Text>
</View>
);
}
render() {
return (
<ListView
dataSource={this.state.dataSource}
renderRow={this.renderRow}
/>
);
}
}
四、问题根因
随着 RN 架构的演进,ListView 已经被标记为 deprecated(废弃),并由更高效的 FlatList 所取代。
LIstView弃用时间线
RN 0.43(2017年左右):开始标记 ListView 为 deprecated,官方引入 FlatList 和 SectionList。
RN 0.60+:ListView 仍然存在于旧版本的 RN 中,但已经完全不再维护。
RN 0.62 之后:React Native 主包中彻底移除了 ListView
五、解决方案
使用FlatList替换ListView
官方在 RN 0.43 版本后引入了 FlatList,它相当于对 ListView 的彻底重构。
主要改进点包括:
| 对比项 | ListView | FlatList |
|---|---|---|
| 数据源管理 | 手动维护 DataSource | 直接使用数组 |
| 性能 | React 层复用 | 原生级复用 |
| 加载机制 | 无分页支持 | 支持 onEndReached |
| 代码简洁度 | 较复杂 | 更加简单直观 |
| 状态更新 | 需 cloneWithRows | 自动根据数据变化渲染 |
FlatList 示例:
import React from 'react';
import { FlatList, Text, View } from 'react-native';
const data = ['苹果', '香蕉', '橙子', '葡萄'];
export default function MyFlatList() {
return (
<FlatList
data={data}
keyExtractor={(item, index) => index.toString()}
renderItem={({ item }) => (
<View style={{ padding: 10 }}>
<Text>{item}</Text>
</View>
)}
/>
);
}
六、总结
RN适配鸿蒙项目中要求0.72及以上的版本, 新版本的new ListView.DataSource这个API已经没了, 引用会造成空指针异常,导致应用白屏,需要全部迁移成性能更佳,官方更推荐的FlatList
1
浏览47 发布于2026-03-30 08:52广东
全部评论
最多点赞
最新发布
最早发布
写回答
所见即所得编辑器, editor1
工具栏
0/50000
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要发帖子
目录 收起
RN鸿蒙化过程中,ListView引用异常
一、背景:
二、ListView 是什么?
三、ListView 的基本使用方式
四、问题根因
五、解决方案
六、总结
了解社区公约,与您携手共创和谐专业的开发者社区。






































苏公安网备 32011402010933号