欢迎大家加入开源鸿蒙跨平台开发者社区，一起共建开源鸿蒙跨平台生态。

---

在医疗健康领域，在线诊疗正成为连接医患的重要桥梁。今天我们将深入分析一个基于 React Native 开发的在线诊疗应用，探讨其技术实现细节以及在鸿蒙系统上的跨端适配策略。

结合 TypeScript 提供类型

该应用采用了 React Native 作为核心框架，结合 TypeScript 提供类型安全保障。从代码结构来看，项目遵循了 React 函数式组件的设计范式，充分利用了 Hooks 进行状态管理。

const OnlineConsultationApp: React.FC = () => {
  const [doctors] = useState<Doctor[]>([...]);
  const [patients] = useState<Patient[]>([...]);
  const [selectedDoctor, setSelectedDoctor] = useState<string | null>(null);
  const [selectedPatient, setSelectedPatient] = useState<string | null>(null);
  const [message, setMessage] = useState('');
  const [isModalVisible, setIsModalVisible] = useState(false);
  const [modalContent, setModalContent] = useState('');
  // ...
};

这种函数式组件的写法不仅代码更简洁，而且在性能上也有优势。通过多个 useState 钩子，开发者可以独立管理不同的状态，如医生列表、患者列表、选中的医生和患者、消息内容以及模态框状态等。这种状态管理方式对于在线诊疗应用来说非常合适，因为各个状态之间存在明确的业务逻辑关系，通过局部状态管理即可满足需求。

项目使用 TypeScript 定义了清晰的数据结构

项目使用 TypeScript 定义了清晰的数据结构，例如 Doctor 和 Patient 类型：

type Doctor = {
  id: string;
  name: string;
  specialty: string;
  experience: string;
  rating: number;
  available: boolean;
};

type Patient = {
  id: string;
  name: string;
  age: number;
  gender: string;
  condition: string;
};

这种类型定义为代码提供了良好的可维护性和类型检查，避免了运行时错误。在跨端开发中，类型系统的重要性更加凸显，因为不同平台的类型处理可能存在差异，TypeScript 可以帮助开发者在编译时就发现潜在问题。

应用采用了 Flexbox 布局系统

应用采用了 Flexbox 布局系统，结合 Dimensions API 实现响应式设计：

const { width, height } = Dimensions.get('window');

这种方式确保了应用在不同屏幕尺寸的设备上都能良好显示。特别值得注意的是，代码中使用了 ScrollView 组件来处理内容滚动，对于医生列表、患者列表和消息输入等可能超出屏幕高度的内容，这种处理方式非常合适。

跨端适配策略

从代码中可以看出，开发者采用了一套通用的组件和 API，这些都是 React Native 提供的跨平台解决方案：

• 使用 SafeAreaView 确保内容不会被设备刘海或底部安全区域遮挡
• 使用 TouchableOpacity 实现跨平台的点击效果
• 使用 Alert 实现跨平台的弹窗提示
• 使用 Modal 实现跨平台的模态框
• 使用 TextInput 实现跨平台的文本输入

这些组件在 iOS、Android 和鸿蒙系统上都能正常工作，体现了 React Native 的 “Write Once, Run Anywhere” 理念。

---

医生和患者

应用实现了医生和患者的选择功能：

const handleSelectDoctor = (doctorId: string) => {
  setSelectedDoctor(doctorId);
  Alert.alert('选择医生', '您已选择该医生进行诊疗');
};

const handleSelectPatient = (patientId: string) => {
  setSelectedPatient(patientId);
  Alert.alert('选择患者', '您已选择该患者进行诊疗');
};

通过这种方式，用户可以分别选择医生和患者，为后续的诊疗做准备。选择操作通过 Alert 弹窗提供反馈，确保用户了解操作结果。

消息发送

应用实现了消息发送功能：

const handleSendMessage = () => {
  if (message.trim()) {
    Alert.alert('消息发送', '您的消息已发送给医生');
    setMessage('');
  } else {
    Alert.alert('提示', '请输入消息内容');
  }
};

这种设计使得用户可以方便地与医生进行文字交流，提升了用户体验。消息发送前会进行非空验证，确保用户不会发送空消息。

诊疗开始

应用实现了诊疗开始功能，会检查是否已经选择了医生和患者：

const handleStartConsultation = () => {
  if (selectedDoctor && selectedPatient) {
    Alert.alert('开始诊疗', '诊疗已开始，请等待医生回应');
  } else {
    Alert.alert('提示', '请先选择医生和患者');
  }
};

这种验证方式确保了用户不会因为未选择医生或患者而导致诊疗失败，提升了用户体验。

模态框功能

应用使用 Modal 组件实现了模态框功能：

const openModal = (content: string) => {
  setModalContent(content);
  setIsModalVisible(true);
};

const closeModal = () => {
  setIsModalVisible(false);
};

这种方式可以在不离开当前页面的情况下展示额外信息，提升了用户体验。

应用通过样式和图标为用户提供了清晰的视觉反馈：

• 使用不同的图标来区分医生和患者
• 使用颜色和状态指示来标识医生的在线状态
• 使用选中样式来标识用户的选择
• 使用 Alert 弹窗来确认用户的操作

这种设计使得用户可以直观地了解应用的状态和操作结果，提升了用户体验。

---

组件

在鸿蒙系统上，React Native 应用需要考虑组件的兼容性。从代码来看，开发者使用的都是 React Native 核心组件，这些组件在鸿蒙系统上都有对应的实现。例如：

• View 对应鸿蒙的 Component
• Text 对应鸿蒙的 Text
• ScrollView 对应鸿蒙的 ListContainer
• Modal 对应鸿蒙的 Dialog
• TouchableOpacity 对应鸿蒙的 Button
• TextInput 对应鸿蒙的 TextInput

性能

鸿蒙系统对应用性能有较高要求，特别是在内存使用和启动速度方面。该应用的实现方式有利于在鸿蒙系统上获得良好的性能：

• 使用函数式组件减少了内存占用
• 使用多个 useState 钩子进行细粒度的状态管理
• 避免了复杂的计算和不必要的渲染
• 使用 TouchableOpacity 替代 Button，减少了视图层级

原生能力

虽然代码中没有直接调用原生能力，但在实际的鸿蒙适配中，可能需要通过 React Native 的 Native Modules 机制来调用鸿蒙的特有 API。例如，当需要实现真正的音视频通话功能时，可能需要调用鸿蒙的多媒体 API。

资源

代码中使用了 Base64 编码的图标：

const ICONS_BASE64 = {
  doctor: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  patient: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  chat: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  appointment: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
};

这种方式的优点是减少了网络请求，提高了应用的加载速度。对于小型图标来说，Base64 编码是一种非常有效的优化策略，特别是在跨端开发中，可以避免不同平台对图片资源的处理差异。

---

模块化

应用采用了清晰的模块化设计：

• 状态管理与 UI 渲染分离
• 数据结构与业务逻辑分离
• 样式与组件分离

这种设计使得代码结构清晰，易于维护和扩展。例如，当需要添加新的医生或患者时，只需要修改对应的数据数组即可，不需要修改 UI 渲染逻辑。

类型

TypeScript 的使用为代码提供了类型安全保障，减少了运行时错误的可能性。特别是在跨端开发中，类型系统可以帮助开发者发现不同平台之间的潜在差异。

样式

应用使用了 StyleSheet.create 来管理样式，这种方式的优点是：

• 提高了样式的复用性
• 减少了运行时的样式计算
• 使代码更加清晰易读

应用的代码组织合理，逻辑清晰：

• 首先定义了必要的类型和数据
• 然后实现了组件的状态管理
• 接着实现了事件处理函数
• 最后实现了 UI 渲染

这种组织方式使得代码易于阅读和理解，便于后续的维护和扩展。

通过对这个在线诊疗应用的技术分析，我们可以看到 React Native 在跨端开发中的优势：

• 开发效率高：使用 JavaScript/TypeScript 开发，代码量少，开发周期短
• 跨平台兼容性好：一套代码可以在 iOS、Android 和鸿蒙系统上运行
• 性能表现优秀：通过原生组件渲染，性能接近原生应用
• 生态系统成熟：拥有丰富的第三方库和工具
• 用户体验良好：可以构建出与原生应用相媲美的界面和交互

在鸿蒙系统逐渐普及的背景下，React Native 作为一种跨端解决方案，具有广阔的应用前景。开发者可以通过学习和掌握 React Native，快速构建支持多平台的医疗应用，提高开发效率和代码复用率。

同时，我们也可以看到，React Native 在构建具有复杂业务逻辑的应用时表现出色，例如这个在线诊疗应用。通过简单的状态管理和组件组合，开发者可以实现完整的诊疗流程，为用户提供便捷的在线医疗服务。

---

在线诊疗是医疗数字化转型的核心场景，聚焦“医生选择-患者匹配-消息交互-诊疗启动”的全流程远程医疗服务逻辑，既要保证医患信息匹配的准确性、消息交互的实时性，又需兼顾多端交互体验的一致性与诊疗流程的规范性。本文基于这套 React Native 在线诊疗应用代码，从架构设计、核心业务逻辑、鸿蒙跨端适配三个维度，系统解读在线诊疗场景的跨端开发逻辑与技术要点，重点剖析 React Native 与鸿蒙系统的适配底层逻辑和落地实践方案，尤其针对医生/患者选择、消息输入发送、诊疗启动等核心交互的跨端实现进行深度拆解。

一、证医生选择、患者匹配、消息发送

该在线诊疗应用基于 React Native 函数式组件 + TypeScript 强类型架构构建，核心依赖 React Native 原生基础组件（SafeAreaView、ScrollView、TouchableOpacity、TextInput、Modal 等）与 Hooks 状态管理，未引入第三方 UI 框架或复杂状态管理库。这种极简架构是在线诊疗这类“强流程驱动、轻实时通信”场景实现鸿蒙跨端的核心优势——轻量意味着适配成本更低，且能最大程度保证多端诊疗流程逻辑的一致性，尤其适合医生/患者选择、消息输入、诊疗启动确认等核心逻辑的跨端复用。

从跨端技术底层逻辑来看，React Native 以“JS 桥接层（JS Bridge）”为核心实现跨端能力：前端编写的 JSX 组件与诊疗流程逻辑，通过桥接层映射为不同平台的原生组件，iOS 端映射为 UIKit 体系、Android 端映射为 View 体系，而鸿蒙（HarmonyOS）端则通过 React Native for HarmonyOS 适配层，完成 React Native 组件/API 与鸿蒙 ArkUI 组件/API 的双向映射。该应用的代码结构完全遵循跨端开发规范：无平台专属硬编码、状态管理基于 React 原生 Hooks、样式采用跨端通用的 Flex 布局，从根源上消除了鸿蒙适配的技术壁垒，同时保证医生选择、患者匹配、消息发送等核心诊疗流程逻辑在多端的一致性。

---

1. 在线诊疗

应用通过 TypeScript 接口分别定义了 Doctor（医生）、Patient（患者）两类核心数据类型，字段设计精准匹配在线诊疗的全流程数据需求：Doctor 涵盖医生ID、姓名、专科、从业经验、评分、在线状态，Patient 包含患者ID、姓名、年龄、性别、基础病情。这种强类型+场景化的数据模型设计，在跨端场景下保证了数据结构的一致性——鸿蒙端适配层可直接解析 TypeScript 类型定义，与 ArkTS 中的数据模型形成精准映射，避免多端数据格式不一致导致的医患信息匹配错误、医生在线状态展示异常等核心问题，尤其在医生专科匹配患者病情、医生在线状态判断等关键诊疗信息的传递与展示上，保证了跨端的数据准确性。

2. Hooks 状态管理

应用采用 React 内置的 useState Hook 实现多维度状态管理，核心状态均具备跨端复用的特性：

• 基础数据状态（doctors/patients）采用只读设计，适配层会自动将其映射为鸿蒙的 @State 响应式状态，医生/患者列表的展示逻辑无需任何修改即可复用；若在生产环境中需要实现数据实时更新（如医生在线状态动态切换、患者病情更新），仅需扩展对应的 set 方法即可，该方法在鸿蒙端会被适配层转换为 ArkTS 的状态更新逻辑，保证多端数据响应的一致性，尤其是医生在线状态从“离线”到“在线”的动态变更这类核心场景，可无缝适配鸿蒙的状态响应机制；
• 选择状态（selectedDoctor/selectedPatient）维护用户选择的医生与患者，其更新逻辑为基础状态操作，鸿蒙端适配层会将其映射为 ArkTS 的 @State 状态更新，选中医生/患者的高亮样式、诊疗启动前的校验逻辑跨端一致，保证诊疗流程的交互统一性；
• 交互状态（message/isModalVisible/modalContent）维护消息输入内容、弹窗显隐与内容，其更新逻辑为纯 JS 状态操作，鸿蒙端适配层会将 TextInput 的输入状态、Modal 的显示状态分别映射为 ArkUI 的输入框状态、弹窗显隐状态，消息输入、弹窗展示的逻辑跨端统一；
• 生产环境中若需扩展状态管理维度（如诊疗会话状态、消息发送状态、诊疗历史记录），仅需新增 useState 状态即可，核心状态管理逻辑无需适配鸿蒙端，仅需保证状态更新遵循 React 响应式规则，适配层会自动完成与 ArkTS 状态的映射。

---

1. 样式

应用通过 StyleSheet.create 封装所有样式规则，核心样式设计完全遵循跨端兼容原则，适配鸿蒙系统无明显改造成本，且针对在线诊疗场景的样式特性做了深度优化：

• Flex 布局的跨端统一：从医生/患者卡片的“图标+信息+状态”横向分布、消息输入框与发送按钮的垂直布局，到诊疗启动按钮的居中布局，全量采用 Flex 布局体系。Flex 作为 W3C 标准布局方案，在鸿蒙端可被适配层直接解析为 ArkUI 的 Flex 布局，无需重构任何布局逻辑，仅需保证样式属性命名与 React Native 规范一致，尤其在医生/患者选择卡片、消息输入区域、诊疗启动按钮等核心交互区域的布局上，Flex 布局的跨端一致性表现突出；
• 在线诊疗专属样式的跨端适配：
  • 选中医生/患者的高亮边框样式（borderWidth: 2 + borderColor: '#0284c7'）在鸿蒙端会被适配层转换为 ArkUI 的 borderWidth: 2vp + borderColor: '#0284c7'，选中状态的视觉标识跨端统一，无论是医生还是患者卡片，选中状态的边框样式在鸿蒙端均可精准还原；
  • 消息输入框的样式（背景色 #f0f9ff、圆角 12、最小高度 80、textAlignVertical: 'top'）为跨端通用属性，鸿蒙端适配层会将尺寸单位转换为 vp，且 textAlignVertical: 'top' 会被映射为 ArkUI 的 textAlign: TextAlign.Top，保证消息输入时文本从顶部开始排版，符合用户输入长文本（如症状描述）的使用习惯，跨端体验一致；
  • 发送按钮的圆角样式（borderRadius: 20）为胶囊型按钮设计，鸿蒙端可直接解析该属性，按钮的视觉形态与点击反馈跨端统一；
  • 诊疗启动按钮的样式（背景色 #0284c7、圆角 12、居中对齐）为通用样式属性，鸿蒙端可直接解析，按钮的点击反馈与视觉效果跨端统一；
  • 弹窗的半透明背景样式（backgroundColor: 'rgba(0, 0, 0, 0.5)'）为通用样式属性，鸿蒙端可直接解析，弹窗遮罩的视觉效果跨端一致，且弹窗内容的宽度（80%）在鸿蒙端会被适配层转换为基于设备宽度的百分比布局，适配不同尺寸的鸿蒙设备；
• 屏幕适配的跨端实现：通过 Dimensions.get('window') 获取设备宽高（虽未直接使用，但为扩展适配预留了基础），该 API 在鸿蒙端已完成原生映射，可直接用于不同尺寸鸿蒙设备（手机、平板）的自适应布局，例如平板端可将消息输入框宽度调整为“90%”，仅需基于设备宽度动态计算样式值，核心布局逻辑无需修改；
• 阴影与层级的跨端兼容：同时使用 shadow 系列属性（iOS 适配）与 elevation 属性（Android/鸿蒙适配），鸿蒙系统对 elevation 属性的支持与 Android 端完全兼容，无需额外调整，在医生/患者卡片、消息输入区域、诊疗启动区域等组件的视觉层级上，多端表现统一，符合医疗应用“清晰、层级分明”的视觉设计原则；
• 安全区域适配：通过 SafeAreaView 处理刘海屏、全面屏的安全区域适配，该组件在鸿蒙端已完成适配，可直接映射为 ArkUI 的 SafeArea 组件，保证头部诊疗标题区域在不同鸿蒙设备上的展示完整性，避免标题被遮挡。

---

（1）医生/患者

医生/患者选择组件是在线诊疗流程的入口，核心适配逻辑如下：

• 医生/患者卡片的 Flex 横向布局（flexDirection: 'row' + alignItems: 'center'）在鸿蒙端会被适配层转换为 ArkUI 的 flexDirection: FlexDirection.Row + alignItems: ItemAlign.Center，布局结构无需重构，保证“图标+诊疗信息+在线状态（仅医生）”的横向排列在鸿蒙端与其他端完全一致；
• 选中医生/患者的高亮边框样式（selectedCard）为条件样式渲染，基于 JS 状态判断（selectedDoctor === doctor.id/selectedPatient === patient.id）实现，鸿蒙端可直接执行，选中状态的视觉标识跨端一致，便于用户清晰识别已选择的医患信息；
• 医生在线状态的展示逻辑（doctor.available ? '🟢 在线' : '🔴 离线'）为纯 JS 条件判断，鸿蒙端直接执行，状态文本与图标（字符型）的展示效果跨端统一，无需额外适配图片资源；
• 医生/患者卡片的点击逻辑（handleSelectDoctor/handleSelectPatient）包含状态更新与弹窗提示，该逻辑为纯 JS 实现，鸿蒙端直接执行，选择后的反馈提示（Alert.alert）会被适配层转换为鸿蒙的 AlertDialog 组件，提示内容与交互逻辑跨端一致。

（2）消息输入与发送

消息输入与发送组件是在线诊疗的核心交互环节，核心适配逻辑如下：

• 消息输入框（TextInput）的核心属性（multiline/placeholder/value/onChangeText）在鸿蒙端会被适配层转换为 ArkUI 的 TextInput 组件对应属性，其中 multiline={true} 会被转换为 multiline: true，placeholder 会被映射为 hint，输入框的多行输入、占位符展示、内容双向绑定等核心功能跨端一致，保证用户可输入长文本描述症状或问题；
• 发送按钮的点击逻辑（handleSendMessage）包含输入内容校验（message.trim()）、弹窗反馈、输入框清空，该逻辑为纯 JS 实现，鸿蒙端直接执行：校验规则保证空消息无法发送，弹窗反馈使用跨端兼容的 Alert.alert API（映射为鸿蒙 AlertDialog），输入框清空（setMessage('')）会同步更新 ArkTS 状态，核心交互逻辑跨端统一；
• 消息输入框的样式适配（minHeight: 80/textAlignVertical: 'top'）在鸿蒙端会被转换为 minHeight: 80vp/textAlign: TextAlign.Top，保证输入框有足够高度容纳长文本，且文本从顶部开始排版，符合用户输入习惯。

（3）诊疗启动

诊疗启动组件是在线诊疗流程的收尾环节，核心适配逻辑如下：

• 诊疗启动按钮的居中布局（alignItems: 'center'）在鸿蒙端会被适配层转换为 ArkUI 的 alignItems: ItemAlign.Center，按钮位置跨端统一，符合用户视觉焦点习惯；
• 启动诊疗的点击逻辑（handleStartConsultation）包含完整的医患信息校验（selectedDoctor && selectedPatient），该逻辑为纯 JS 条件判断，鸿蒙端直接执行：校验通过则提示“诊疗已开始”，未通过则提示“请先选择医生和患者”，校验规则与反馈逻辑跨端一致，保证诊疗流程的规范性；
• 校验结果的弹窗提示使用跨端兼容的 Alert.alert API，鸿蒙端适配层会处理弹窗的转换，提示内容的拼接逻辑为纯 JS 字符串操作，鸿蒙端直接执行，反馈信息的准确性与格式跨端一致。

（4）Modal 弹窗

Modal 弹窗组件为扩展诊疗详情展示预留了能力，核心适配逻辑如下：

• Modal 组件的核心属性（animationType/transparent/visible/onRequestClose）在鸿蒙端会被适配层转换为 ArkUI 的 Dialog 组件对应属性，其中 animationType="slide" 会被转换为鸿蒙的滑动动画（animation: SlideAnimation），transparent={true} 会被转换为鸿蒙的透明背景（backgroundColor: Color.Transparent），弹窗的显隐逻辑与动画效果跨端一致；
• 弹窗关闭按钮的点击逻辑（closeModal）为纯 JS 状态更新操作，鸿蒙端适配层会同步更新 ArkTS 状态，弹窗关闭的交互逻辑跨端一致，且 onRequestClose 回调会被映射为鸿蒙弹窗的返回键关闭逻辑，符合鸿蒙的系统交互规范，尤其适配鸿蒙设备的物理返回键操作。

---

1. 医患选择

handleSelectDoctor/handleSelectPatient 函数是在线诊疗流程的基础逻辑，实现了“选择操作-状态更新-反馈提示”的全流程，核心适配逻辑如下：

• 状态更新逻辑（setSelectedDoctor/setSelectedPatient）为基础的 React Hooks 状态操作，鸿蒙端适配层会将其映射为 ArkTS 的 @State 状态更新，选中的医患 ID 会同步到鸿蒙端的状态中，保证后续诊疗启动校验逻辑能获取到正确的选择结果；
• 反馈提示逻辑（Alert.alert）使用 React Native 跨端兼容的弹窗 API，鸿蒙端适配层会将其转换为鸿蒙的 AlertDialog 组件，提示标题与内容为固定字符串，跨端展示与交互逻辑完全一致，无需额外调整。

2. 消息发送

handleSendMessage 函数是在线诊疗的核心交互逻辑，实现了“输入校验-反馈提示-输入清空”的全流程，核心适配逻辑如下：

• 输入内容校验逻辑（if (message.trim())）为纯 JS 字符串操作，鸿蒙端直接执行，保证只有非空消息才能发送，避免无效交互，校验规则跨端一致；
• 发送成功的反馈逻辑（Alert.alert('消息发送', '您的消息已发送给医生')）使用跨端兼容的弹窗 API，鸿蒙端适配层会处理弹窗的转换，提示内容为固定字符串，跨端展示效果一致；
• 输入框清空逻辑（setMessage('')）为基础状态操作，鸿蒙端适配层会同步更新 ArkTS 状态，输入框内容会被清空，保证用户发送消息后可重新输入，交互逻辑跨端统一；
• 生产环境中若需对接真实的即时通信接口（如 WebSocket），扩展逻辑（建立连接、发送消息、接收回复）为纯 JS 网络操作，鸿蒙端可直接复用，核心校验与反馈逻辑无需修改，仅需封装鸿蒙的网络权限申请逻辑即可。

3. 诊疗启动

handleStartConsultation 函数是在线诊疗流程的核心控制逻辑，实现了“医患信息校验-诊疗启动/提示”的全流程，核心适配逻辑如下：

• 医患信息校验逻辑（if (selectedDoctor && selectedPatient)）为纯 JS 逻辑判断，鸿蒙端直接执行，保证只有同时选择医生和患者后才能启动诊疗，校验规则跨端一致，符合在线诊疗的流程规范；
• 校验结果的反馈逻辑使用跨端兼容的 Alert.alert API，鸿蒙端适配层会处理弹窗的转换，提示内容的拼接逻辑为纯 JS 字符串操作，鸿蒙端直接执行，反馈信息的准确性与用户体验跨端一致；
• 生产环境中若需对接真实的诊疗启动接口，扩展逻辑（调用后端接口创建诊疗会话）为纯 JS 网络请求逻辑，鸿蒙端可直接复用，核心校验与反馈逻辑无需修改，仅需适配鸿蒙的网络权限即可。

---

应用使用的核心 API 均为 React Native 跨端兼容 API，在鸿蒙端可无缝适配：

• 数组 API：map/find 等数组方法为 JS 原生 API，鸿蒙端通过 JS 引擎直接执行，无需适配，保证医生/患者列表的渲染、医患信息查找等核心逻辑的跨端一致性；
• 字符串 API：trim()/字符串拼接/换行符（\n）等操作为 JS 原生 API，鸿蒙端直接执行，保证消息输入校验、弹窗内容拼接等核心逻辑的跨端一致性；
• 输入框 API：TextInput 的 multiline/placeholder/onChangeText 等属性已被适配层封装为鸿蒙 TextInput 的对应属性，输入交互逻辑跨端统一；
• 弹窗 API：Alert.alert/Modal 已被适配层封装为鸿蒙的 AlertDialog/Dialog 组件，交互逻辑完全复用，在医患选择反馈、消息发送提示、诊疗启动提示等核心场景中，弹窗的展示与操作逻辑多端统一；
• 样式 API：StyleSheet.create 封装的样式规则，适配层会转换为 ArkUI 的样式对象，通用样式属性（flex/padding/margin/borderRadius/backgroundColor）无需修改，仅需调整部分平台专属样式（如阴影）以符合鸿蒙规范。

---

该在线诊疗应用作为远程医疗服务核心模块，适配鸿蒙系统的成本极低，核心适配思路与技术要点如下：

1. 组件层

React Native for HarmonyOS 已完成对该应用所有核心组件的适配：View/Text/TouchableOpacity/ScrollView/SafeAreaView/TextInput/Modal 等组件均可直接映射为鸿蒙的 ArkUI 组件，无需替换组件类型或重构布局结构。对于在线诊疗可能扩展的功能（如实时音视频诊疗、诊疗记录保存、处方开具），可通过 React Native 原生模块（Native Module）封装鸿蒙的原生能力：

• 实时音视频诊疗：封装鸿蒙的音视频通话 API，实现医生与患者的实时视频沟通，核心通话触发逻辑可复用现有代码，仅需对接鸿蒙的音视频接口；
• 诊疗记录保存：封装鸿蒙的 Preferences 或数据库 API，实现诊疗会话记录的本地存储，核心存储逻辑可复用现有代码，仅需适配鸿蒙的存储规范；
• 处方开具：封装鸿蒙的 PDF 生成 API，实现电子处方的生成与下载，核心处方信息拼接逻辑无需修改，仅需适配鸿蒙的文件操作接口。

2. 跨端统一

该应用当前的列表渲染采用基础 map 方法，在生产环境中若医生/患者数据量较大（如医生超过20名、患者超过10名），可替换为 React Native 的 FlatList 高性能列表组件——FlatList 在鸿蒙端已完成深度适配，支持虚拟化列表渲染，其核心属性（data/renderItem/keyExtractor）与 React Native 端完全一致，仅需少量调整即可适配鸿蒙端的性能优化策略，保证列表的滚动性能，尤其适合医疗平台的海量医生资源展示场景。

3. 在线诊疗样式

鸿蒙系统有自身的设计规范，在适配时可通过条件编译实现差异化样式，既保证遵循鸿蒙设计规范，又能最大程度复用现有代码：

// 鸿蒙端在线诊疗样式差异化适配示例
import { Platform } from 'react-native';
const isHarmonyOS = Platform.OS === 'harmony';

const cardStyle = {
  ...styles.card,
  backgroundColor: isHarmonyOS ? '#e0f7fa' : '#f0f9ff',
  borderRadius: isHarmonyOS ? 14 : 12,
  padding: isHarmonyOS ? 14 : 16,
  // 鸿蒙端发送/诊疗按钮样式适配
  sendButton: {
    ...styles.sendButton,
    backgroundColor: isHarmonyOS ? '#0369a1' : '#0284c7'
  },
  consultationButton: {
    ...styles.consultationButton,
    backgroundColor: isHarmonyOS ? '#0369a1' : '#0284c7'
  }
};

这种轻量级的差异化适配，既能保证符合鸿蒙的设计规范，又能保留现有代码的完整性，尤其在医生/患者卡片、消息发送按钮、诊疗启动按钮等核心交互组件的样式适配中，效果显著。

该 React Native 在线诊疗应用实现了医生选择、患者匹配、消息发送、诊疗启动等核心远程医疗服务功能，代码结构符合跨端开发规范，可低成本适配鸿蒙系统。针对生产环境落地，可做以下优化：

1. 实时通信能力扩展：引入 WebSocket 或 React Native 即时通信 SDK，替换当前的模拟消息发送逻辑，实现医生与患者的实时消息交互，鸿蒙端兼容 WebSocket 协议，可直接复用通信逻辑，同时封装鸿蒙的后台保活逻辑，保证消息推送的实时性；
2. 状态持久化与同步：引入 AsyncStorage（或鸿蒙原生 Preferences）实现已选择的医患信息、未发送的消息草稿等数据的本地缓存，用户下次打开应用可恢复选择状态与消息草稿，鸿蒙端适配时仅需封装原生存储 API，核心缓存逻辑无需重构；
3. 网络层封装：接入 Axios 实现与在线诊疗后端接口的对接，替换本地硬编码的测试数据为真实的医生/患者数据请求，鸿蒙端兼容 HTTP/HTTPS 请求，可直接复用请求逻辑，保证医患信息的实时性与准确性，同时封装鸿蒙的网络权限申请逻辑，适配鸿蒙的权限管理体系；
4. 错误边界处理：添加 React Error Boundary 捕获运行时错误（如列表渲染异常、消息发送失败），避免应用崩溃，鸿蒙端可通过适配层将错误信息同步到原生错误日志系统，便于在线诊疗应用的线上问题排查，同时保证诊疗流程异常时的用户友好提示；
5. 鸿蒙原生能力扩展：通过 React Native 原生模块封装鸿蒙的快捷服务、卡片能力，将“常用医生列表”封装为鸿蒙桌面卡片，用户无需打开应用即可快速选择医生启动诊疗，核心选择逻辑可完全复用现有代码。

---

真实演示案例代码：

// App.tsx
import React, { useState } from 'react';
import { SafeAreaView, View, Text, StyleSheet, TouchableOpacity, ScrollView, Dimensions, Alert, TextInput, Modal } from 'react-native';

// Base64 图标库
const ICONS_BASE64 = {
  doctor: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  patient: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  chat: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  appointment: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
};

const { width, height } = Dimensions.get('window');

// 医生类型
type Doctor = {
  id: string;
  name: string;
  specialty: string;
  experience: string;
  rating: number;
  available: boolean;
};

// 患者类型
type Patient = {
  id: string;
  name: string;
  age: number;
  gender: string;
  condition: string;
};

// 在线诊疗应用组件
const OnlineConsultationApp: React.FC = () => {
  const [doctors] = useState<Doctor[]>([
    {
      id: '1',
      name: '张医生',
      specialty: '内科',
      experience: '10年经验',
      rating: 4.8,
      available: true
    },
    {
      id: '2',
      name: '李医生',
      specialty: '儿科',
      experience: '8年经验',
      rating: 4.9,
      available: false
    },
    {
      id: '3',
      name: '王医生',
      specialty: '皮肤科',
      experience: '12年经验',
      rating: 4.7,
      available: true
    }
  ]);

  const [patients] = useState<Patient[]>([
    {
      id: '1',
      name: '李先生',
      age: 45,
      gender: '男',
      condition: '高血压'
    },
    {
      id: '2',
      name: '王女士',
      age: 32,
      gender: '女',
      condition: '糖尿病'
    }
  ]);

  const [selectedDoctor, setSelectedDoctor] = useState<string | null>(null);
  const [selectedPatient, setSelectedPatient] = useState<string | null>(null);
  const [message, setMessage] = useState('');
  const [isModalVisible, setIsModalVisible] = useState(false);
  const [modalContent, setModalContent] = useState('');

  const handleSelectDoctor = (doctorId: string) => {
    setSelectedDoctor(doctorId);
    Alert.alert('选择医生', '您已选择该医生进行诊疗');
  };

  const handleSelectPatient = (patientId: string) => {
    setSelectedPatient(patientId);
    Alert.alert('选择患者', '您已选择该患者进行诊疗');
  };

  const handleSendMessage = () => {
    if (message.trim()) {
      Alert.alert('消息发送', '您的消息已发送给医生');
      setMessage('');
    } else {
      Alert.alert('提示', '请输入消息内容');
    }
  };

  const handleStartConsultation = () => {
    if (selectedDoctor && selectedPatient) {
      Alert.alert('开始诊疗', '诊疗已开始，请等待医生回应');
    } else {
      Alert.alert('提示', '请先选择医生和患者');
    }
  };

  const openModal = (content: string) => {
    setModalContent(content);
    setIsModalVisible(true);
  };

  const closeModal = () => {
    setIsModalVisible(false);
  };

  return (
    <SafeAreaView style={styles.container}>
      {/* 头部 */}
      <View style={styles.header}>
        <Text style={styles.title}>在线诊疗</Text>
        <Text style={styles.subtitle}>实现“在家看病”，便捷高效</Text>
      </View>

      <ScrollView style={styles.content}>
        {/* 医生列表 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>选择医生</Text>
          {doctors.map(doctor => (
            <TouchableOpacity 
              key={doctor.id}
              style={[
                styles.card,
                selectedDoctor === doctor.id && styles.selectedCard
              ]}
              onPress={() => handleSelectDoctor(doctor.id)}
            >
              <Text style={styles.icon}>👨‍⚕️</Text>
              <View style={styles.cardInfo}>
                <Text style={styles.cardTitle}>{doctor.name}</Text>
                <Text style={styles.cardDescription}>{doctor.specialty}</Text>
                <Text style={styles.cardDescription}>{doctor.experience}</Text>
                <Text style={styles.cardDescription}>评分: {doctor.rating}</Text>
              </View>
              <Text style={styles.availability}>
                {doctor.available ? '🟢 在线' : '🔴 离线'}
              </Text>
            </TouchableOpacity>
          ))}
        </View>

        {/* 患者列表 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>选择患者</Text>
          {patients.map(patient => (
            <TouchableOpacity 
              key={patient.id}
              style={[
                styles.card,
                selectedPatient === patient.id && styles.selectedCard
              ]}
              onPress={() => handleSelectPatient(patient.id)}
            >
              <Text style={styles.icon}>👤</Text>
              <View style={styles.cardInfo}>
                <Text style={styles.cardTitle}>{patient.name}</Text>
                <Text style={styles.cardDescription}>年龄: {patient.age}</Text>
                <Text style={styles.cardDescription}>性别: {patient.gender}</Text>
                <Text style={styles.cardDescription}>病情: {patient.condition}</Text>
              </View>
            </TouchableOpacity>
          ))}
        </View>

        {/* 消息输入 */}
        <View style={styles.messageSection}>
          <Text style={styles.sectionTitle}>发送消息</Text>
          <View style={styles.messageInputContainer}>
            <TextInput
              style={styles.messageInput}
              placeholder="请输入您的症状或问题..."
              multiline
              value={message}
              onChangeText={setMessage}
            />
            <TouchableOpacity 
              style={styles.sendButton}
              onPress={handleSendMessage}
            >
              <Text style={styles.sendText}>发送</Text>
            </TouchableOpacity>
          </View>
        </View>

        {/* 开始诊疗 */}
        <View style={styles.consultationSection}>
          <TouchableOpacity 
            style={styles.consultationButton}
            onPress={handleStartConsultation}
          >
            <Text style={styles.consultationText}>开始诊疗</Text>
          </TouchableOpacity>
        </View>

        {/* 使用说明 */}
        <View style={styles.infoCard}>
          <Text style={styles.sectionTitle}>📘 使用说明</Text>
          <Text style={styles.infoText}>• 选择合适的医生和患者</Text>
          <Text style={styles.infoText}>• 输入症状或问题并发送</Text>
          <Text style={styles.infoText}>• 点击开始诊疗按钮</Text>
          <Text style={styles.infoText}>• 医生将在线为您提供诊疗服务</Text>
        </View>

        {/* 弹框内容 */}
        <Modal
          animationType="slide"
          transparent={true}
          visible={isModalVisible}
          onRequestClose={closeModal}
        >
          <View style={styles.modalContainer}>
            <View style={styles.modalContent}>
              <Text style={styles.modalTitle}>详细信息</Text>
              <Text style={styles.modalText}>{modalContent}</Text>
              <TouchableOpacity
                style={styles.closeButton}
                onPress={closeModal}
              >
                <Text style={styles.closeButtonText}>关闭</Text>
              </TouchableOpacity>
            </View>
          </View>
        </Modal>
      </ScrollView>
    </SafeAreaView>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: '#f0f9ff',
  },
  header: {
    flexDirection: 'column',
    padding: 16,
    backgroundColor: '#ffffff',
    borderBottomWidth: 1,
    borderBottomColor: '#bae6fd',
  },
  title: {
    fontSize: 20,
    fontWeight: 'bold',
    color: '#0c4a6e',
    marginBottom: 4,
  },
  subtitle: {
    fontSize: 14,
    color: '#0284c7',
  },
  content: {
    flex: 1,
    marginTop: 12,
  },
  section: {
    backgroundColor: '#ffffff',
    marginHorizontal: 16,
    marginBottom: 12,
    borderRadius: 12,
    padding: 16,
    elevation: 2,
    shadowColor: '#000',
    shadowOffset: { width: 0, height: 2 },
    shadowOpacity: 0.1,
    shadowRadius: 4,
  },
  sectionTitle: {
    fontSize: 16,
    fontWeight: '600',
    color: '#0c4a6e',
    marginBottom: 12,
  },
  card: {
    flexDirection: 'row',
    alignItems: 'center',
    backgroundColor: '#f0f9ff',
    borderRadius: 12,
    padding: 16,
    marginBottom: 12,
  },
  selectedCard: {
    borderWidth: 2,
    borderColor: '#0284c7',
  },
  icon: {
    fontSize: 28,
    marginRight: 12,
  },
  cardInfo: {
    flex: 1,
  },
  cardTitle: {
    fontSize: 16,
    fontWeight: '500',
    color: '#0c4a6e',
    marginBottom: 4,
  },
  cardDescription: {
    fontSize: 14,
    color: '#0284c7',
    marginBottom: 2,
  },
  availability: {
    fontSize: 14,
    color: '#0c4a6e',
    fontWeight: '500',
  },
  messageSection: {
    backgroundColor: '#ffffff',
    marginHorizontal: 16,
    marginBottom: 12,
    borderRadius: 12,
    padding: 16,
    elevation: 2,
    shadowColor: '#000',
    shadowOffset: { width: 0, height: 2 },
    shadowOpacity: 0.1,
    shadowRadius: 4,
  },
  messageInputContainer: {
    flexDirection: 'column',
  },
  messageInput: {
    backgroundColor: '#f0f9ff',
    borderRadius: 12,
    padding: 12,
    fontSize: 14,
    color: '#0c4a6e',
    minHeight: 80,
    textAlignVertical: 'top',
    marginBottom: 12,
  },
  sendButton: {
    backgroundColor: '#0284c7',
    paddingHorizontal: 20,
    paddingVertical: 10,
    borderRadius: 20,
    alignSelf: 'flex-end',
  },
  sendText: {
    color: '#ffffff',
    fontSize: 14,
    fontWeight: '500',
  },
  consultationSection: {
    backgroundColor: '#ffffff',
    marginHorizontal: 16,
    marginBottom: 12,
    borderRadius: 12,
    padding: 16,
    elevation: 2,
    shadowColor: '#000',
    shadowOffset: { width: 0, height: 2 },
    shadowOpacity: 0.1,
    shadowRadius: 4,
  },
  consultationButton: {
    backgroundColor: '#0284c7',
    padding: 16,
    borderRadius: 12,
    alignItems: 'center',
  },
  consultationText: {
    color: '#ffffff',
    fontSize: 16,
    fontWeight: '500',
  },
  infoCard: {
    backgroundColor: '#ffffff',
    marginHorizontal: 16,
    marginBottom: 80,
    borderRadius: 12,
    padding: 16,
    elevation: 2,
    shadowColor: '#000',
    shadowOffset: { width: 0, height: 2 },
    shadowOpacity: 0.1,
    shadowRadius: 4,
  },
  infoText: {
    fontSize: 14,
    color: '#64748b',
    lineHeight: 20,
    marginBottom: 4,
  },
  modalContainer: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: 'rgba(0, 0, 0, 0.5)',
  },
  modalContent: {
    width: '80%',
    backgroundColor: '#ffffff',
    borderRadius: 12,
    padding: 20,
    elevation: 5,
  },
  modalTitle: {
    fontSize: 18,
    fontWeight: 'bold',
    color: '#0c4a6e',
    marginBottom: 12,
    textAlign: 'center',
  },
  modalText: {
    fontSize: 14,
    color: '#0c4a6e',
    lineHeight: 20,
    marginBottom: 20,
  },
  closeButton: {
    backgroundColor: '#0284c7',
    padding: 10,
    borderRadius: 8,
    alignItems: 'center',
  },
  closeButtonText: {
    color: '#ffffff',
    fontSize: 14,
    fontWeight: '500',
  },
});

export default OnlineConsultationApp;

---

打包

接下来通过打包命令npn run harmony将reactNative的代码打包成为bundle，这样可以进行在开源鸿蒙OpenHarmony中进行使用。

打包之后再将打包后的鸿蒙OpenHarmony文件拷贝到鸿蒙的DevEco-Studio工程目录去：

最后运行效果图如下显示：

本文分析了一个基于React Native开发的在线诊疗应用，重点探讨了其技术实现和鸿蒙系统适配策略。应用采用TypeScript提供类型安全，使用函数式组件和Hooks进行状态管理，通过Flexbox布局实现响应式设计。文章详细介绍了跨端适配方案，包括通用组件使用、性能优化和原生能力调用等关键点。同时分析了应用的模块化设计、类型系统优势和样式管理方法，展示了如何通过清晰的代码组织实现医患交互功能。该案例为鸿蒙生态下的跨平台开发提供了实践参考。

欢迎大家加入开源鸿蒙跨平台开发者社区，一起共建开源鸿蒙跨平台生态。