文档开发者中心
我的
|

React Native

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广东
全部评论
最多点赞
最新发布
最早发布
赞
1楼回复于2026-03-31 01:15 来自浙江
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
RN鸿蒙化过程中,ListView引用异常
一、背景:
二、ListView 是什么?
三、ListView 的基本使用方式
四、问题根因
五、解决方案
六、总结
了解社区公约,与您携手共创和谐专业的开发者社区。