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


在企业数字化管理的大趋势下,员工考勤打卡类应用需要兼顾时间记录的精准性、数据管理的稳定性以及多终端的适配能力。鸿蒙系统的分布式全场景架构为企业办公应用的跨端部署提供了核心支撑,而React Native则凭借“一次开发、多端运行”的技术特性,成为这类办公应用跨端开发的最优解。本文将从数据模型设计、核心考勤逻辑实现、UI适配到鸿蒙跨端兼容的底层逻辑,全方位拆解这款上班打卡应用的技术架构,剖析React Native与鸿蒙生态融合的关键技术要点。

React Native与鸿蒙

这款上班打卡应用的核心架构遵循React Native的“通用抽象层+平台适配层”设计理念,所有核心功能均基于React Native的通用API(ViewTextInputModalTouchableOpacity)和Hooks体系构建,未引入任何平台专属代码,这是实现鸿蒙跨端兼容的核心前提。

从底层适配逻辑来看,React Native for HarmonyOS框架会将React Native的通用组件无缝映射为鸿蒙ArkUI的原生组件:TouchableOpacity对应鸿蒙的Button原生组件,保留点击反馈的同时适配鸿蒙的交互规范,尤其适合签到、签退这类需要明确操作反馈的办公场景;TextInput映射为鸿蒙的TextInput原生控件,保证签到日期、时间等文本输入在鸿蒙设备上的响应速度和输入体验,避免因平台输入组件差异导致的考勤数据录入错误;Modal组件转换为鸿蒙的Dialog原生模态框,适配鸿蒙系统的弹窗交互逻辑,用于展示考勤记录详情,保证办公数据展示的完整性;Alert则调用鸿蒙的系统级弹窗能力,确保签到/签退成功、信息填写不全等提示的原生展示效果。

此外,应用通过Dimensions.get('window')获取设备屏幕尺寸,该API在鸿蒙系统中会被React Native框架适配为鸿蒙的getWindowSize原生能力,能够精准获取不同形态鸿蒙设备(手机、平板、智慧屏)的屏幕参数——例如在鸿蒙平板上展示完整的考勤记录列表,在手机上则呈现精简的签到打卡界面,在智慧屏上适配企业前台的大屏考勤展示需求,完美契合企业办公多终端考勤的业务场景。

强类型数据模型:

上班打卡应用的核心是考勤数据的精准性和业务逻辑的严谨性,代码中通过TypeScript构建了多层级的强类型数据模型,从员工档案到签到记录,形成了闭环的企业考勤数据体系,既规避了前端开发中的类型错误,又在跨端编译阶段拦截了数据格式偏差,适配鸿蒙ArkTS的静态类型特性。

// 员工档案模型:整合基础身份信息与组织架构信息,适配企业考勤的人员管理需求
type Employee = {
  id: string;
  name: string;
  department: string;   // 字符串型部门,适配技术部/市场部等企业组织架构
  position: string;      // 字符串型职位,兼容前端工程师/市场专员等岗位描述
};

// 签到记录核心模型:整合考勤核心数据,是应用的核心数据载体
type CheckInRecord = {
  id: string;
  employeeId: string;
  date: string;          // 字符串型日期,兼容跨端日期格式(YYYY-MM-DD)
  checkInTime: string;   // 字符串型上班时间,适配HH:MM格式的时间记录
  checkOutTime: string | null; // 可空字符串型下班时间,适配"未签退/已签退"两种状态
};

这些类型定义严格约束了企业考勤相关数据的格式和类型,在鸿蒙系统中,React Native的TypeScript编译器会对JS层与鸿蒙ArkTS层之间的数据交互进行严格校验。例如,checkOutTime(下班时间)采用可空字符串类型,既满足“未签退”的空值场景,又保证了已签退状态下时间数据的精准传递,符合企业考勤管理的业务规范;employeeId作为字符串类型,在跨端传递时会被强制校验,避免因鸿蒙ArkTS的静态类型特性与JavaScript动态类型特性不兼容导致的考勤记录归属错误,保障企业考勤数据的准确性。

核心业务逻辑:

应用的核心业务逻辑(员工签到、自动记录考勤、签退更新)均基于React Hooks(useStateuseEffect)实现,这种轻量级的状态管理方式完美适配React Native的跨端生命周期模型,同时与鸿蒙组件的生命周期深度融合,保障了核心考勤逻辑的跨端稳定运行。

状态设计

应用通过useState管理核心数据状态,采用“不可变更新”的方式修改状态,避免了引用类型数据在跨端环境下的共享冲突。例如,添加新的签到记录时,通过解构赋值创建新数组副本:

setCheckInRecords([...checkInRecords, newRecord]);

这种不可变更新策略在鸿蒙系统中尤为关键——鸿蒙的分布式数据管理要求数据副本的一致性,不可变更新保证了每次状态变更都会生成新的数据源,避免了多端数据同步时的冲突问题,确保考勤记录在鸿蒙多设备间的同步准确性,符合企业考勤数据“一人一记录”的核心要求。

自动考勤记录逻辑:

应用通过useEffect实现每分钟一次的自动考勤记录生成,这一核心逻辑在鸿蒙系统中稳定运行的核心在于:setInterval/clearInterval是React Native封装的通用定时器API,已适配鸿蒙的任务调度机制;useEffect的返回清理函数对应鸿蒙组件的onDestroy生命周期,确保定时器在组件卸载时被销毁,避免鸿蒙设备的内存泄漏。

useEffect(() => {
  const interval = setInterval(() => {
    const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
    const newRecord: CheckInRecord = {
      id: (checkInRecords.length + 1).toString(),
      employeeId: randomEmployee.id,
      date: new Date().toISOString().split('T')[0], // 跨端兼容的日期格式化
      checkInTime: new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }), // 跨端兼容的时间格式化
      checkOutTime: null
    };
    setCheckInRecords([...checkInRecords, newRecord]);
  }, 60000);

  return () => clearInterval(interval); // 适配鸿蒙组件销毁生命周期
}, [employees, checkInRecords]);

自动记录逻辑中使用的new Date().toISOString().split('T')[0]toLocaleTimeString是跨端兼容的日期/时间格式化方式,在鸿蒙系统中会被解析为标准的YYYY-MM-DDHH:MM格式,保证了考勤时间在不同鸿蒙设备上的展示一致性;数组map/find等方法是ES6通用API,在鸿蒙系统中会被React Native框架转换为ArkTS的数组操作逻辑,避免了因平台API差异导致的考勤记录生成错误,符合企业考勤管理的连续性要求。

签退状态更新逻辑:

handleCheckOut函数中对签退时间的更新是核心业务逻辑,该逻辑在鸿蒙系统中能够稳定运行的关键在于对象解构赋值的跨端一致性——React Native的对象操作在鸿蒙系统中会被精准映射为ArkTS的对象操作,确保签退时间的更新逻辑无偏差,避免因平台类型转换导致的考勤记录错误,保障企业考勤数据的真实性。


应用的UI层基于React Native的StyleSheet统一管理样式,既保证了鸿蒙系统中的原生渲染效果,又兼顾了上班打卡应用对数据展示清晰性、操作安全性的特殊要求。

样式系统

StyleSheet将CSS样式抽象为跨平台的样式对象,核心样式属性(flexborderRadiuspaddingelevation)在鸿蒙系统中会被精准转换为ArkUI的布局属性。例如:

const styles = StyleSheet.create({
  section: {
    backgroundColor: '#ffffff',
    marginHorizontal: 16,
    borderRadius: 12,
    padding: 16,
    // 阴影跨端适配:elevation适配鸿蒙/Android,shadow系列适配iOS
    elevation: 2,
    shadowColor: '#000',
    shadowOffset: { width: 0, height: 2 },
    shadowOpacity: 0.1,
    shadowRadius: 4,
  },
  checkOutButton: {
    backgroundColor: '#10b981', // 办公场景专属绿色,适配签退确认按钮
    paddingHorizontal: 12,
    paddingVertical: 6,
    borderRadius: 8,
  },
  input: {
    flex: 1,
    backgroundColor: '#f0f9ff', // 浅蓝主题,适配企业办公应用视觉规范
    borderRadius: 8,
    paddingHorizontal: 12,
    paddingVertical: 8,
    fontSize: 14,
    color: '#0c4a6e',
  }
});

其中,elevation属性在鸿蒙系统中会被解析为原生的阴影层级,borderRadius适配鸿蒙的圆角渲染规则,保证了UI视觉效果的跨端一致性;签退按钮采用办公场景专属的绿色(#10b981),既符合企业办公应用的视觉规范,又适配鸿蒙系统的色彩体系,提升了签退操作的辨识度;浅蓝主题(#f0f9ff)的输入框背景色,降低了长时间录入考勤信息的视觉疲劳,适配企业考勤数据录入的核心场景。

交互组件

核心交互组件TouchableOpacity在鸿蒙系统中会被渲染为具备原生点击反馈的按钮,选中态的selectedCard样式(边框高亮)能够清晰标识当前选择的员工,符合企业考勤应用“操作可追溯、状态可识别”的核心要求。用于录入签到日期和时间的TextInput组件采用双列布局,适配考勤数据的多维度录入需求,在鸿蒙设备上保证了输入框的响应速度和输入体验。

Modal组件通过animationType="slide"实现滑动弹窗效果,在鸿蒙系统中适配为原生的滑动模态框,用于展示考勤记录详情,包括员工信息、签到/签退时间等核心办公数据,既保证了数据展示的完整性,又符合鸿蒙系统的交互规范,提升了企业考勤数据查看的安全性。


当前代码已实现基础的鸿蒙跨端兼容,在生产环境中,可针对鸿蒙系统的特性和上班打卡的业务需求进行深度优化,进一步提升应用的企业考勤服务能力:

1. 高性能列表渲染

应用中考勤记录列表采用ScrollView + map的方式渲染,在鸿蒙系统中面对大量企业考勤数据时可能出现卡顿。可替换为React Native的FlatList组件,该组件在鸿蒙系统中会适配ArkUI的List原生组件,实现按需渲染和组件复用,通过getItemLayout优化列表滚动性能,尤其适合展示企业员工月度/年度的考勤记录历史。

2. 鸿蒙原生

考勤时间的精准性是核心需求,可通过React Native的Native Module机制封装鸿蒙的TimeKit原生API,将考勤时间的获取逻辑下沉到鸿蒙原生层。例如,利用鸿蒙的系统级时间同步能力,确保签到/签退时间与企业服务器时间的一致性,替代前端简单的本地时间获取逻辑,提升考勤时间的精准度;同时利用鸿蒙的闹钟能力,为员工推送打卡提醒,提升企业考勤的及时性。

3. 分布式

基于鸿蒙的分布式数据管理能力,可通过React Native的跨端通信机制,实现考勤数据在多鸿蒙设备间的同步。例如,员工在手机上的签到记录,可实时同步到鸿蒙平板的人事端和智慧屏的企业前台端,人事专员可通过平板查看员工考勤情况,前台可通过智慧屏展示当日考勤统计,形成“员工-人事-企业前台”的闭环考勤管理。

这款基于React Native开发的上班打卡应用,通过强类型数据模型、React Hooks状态管理和通用UI组件设计,构建了具备完整鸿蒙跨端兼容能力的企业考勤应用架构,核心技术要点可总结为:

  • 通用API选型是实现鸿蒙兼容的基础,基于React Native通用组件构建核心逻辑,规避平台专属代码,保证了上班打卡UI和交互的跨端一致性;
  • TypeScript强类型约束不仅提升企业考勤数据的精准性,更适配鸿蒙ArkTS的静态类型特性,避免跨端数据交互中的类型错误,保障考勤记录展示的准确性;
  • React Hooks状态管理与鸿蒙组件生命周期深度融合,保障了自动考勤记录等周期性任务的跨端稳定运行;
  • 统一的StyleSheet样式系统实现了UI在鸿蒙设备上的原生渲染,兼顾上班打卡应用的数据展示清晰性和操作安全性。

在企业管理中,员工考勤是人力资源管理的重要组成部分。本文将深入剖析一个基于 React Native 构建的上班打卡应用,探讨其技术实现细节及鸿蒙跨端能力的应用。

技术选型

该应用采用了现代 React Native 函数式组件架构,通过 TypeScript 类型系统和 React Hooks 实现了一个功能完整的考勤管理系统。核心技术栈包括:

  • React Native:作为跨端开发框架,提供了统一的组件 API,确保应用在 iOS、Android 及鸿蒙平台上的一致性体验
  • TypeScript:通过严格的类型定义增强代码可维护性,明确了数据结构和组件接口
  • React Hooks:使用 useState 管理应用状态,useEffect 处理副作用逻辑,实现了声明式的状态管理
  • Base64 图标:采用 Base64 编码的图标资源,避免了不同平台资源格式的差异,提高了跨端兼容性
  • 响应式布局:使用 Dimensions API 获取屏幕尺寸,实现适配不同设备的响应式界面

数据模型

应用通过 TypeScript 接口定义了两个核心数据类型,构建了完整的考勤管理数据模型体系:

// 员工类型
type Employee = {
  id: string;
  name: string;
  department: string;
  position: string;
};

// 签到记录类型
type CheckInRecord = {
  id: string;
  employeeId: string;
  date: string;
  checkInTime: string;
  checkOutTime: string | null;
};

这种强类型设计不仅提高了代码可读性,也为鸿蒙跨端适配提供了清晰的数据契约,确保不同平台间数据传递的一致性。数据模型的设计充分考虑了考勤管理的核心要素,包含了员工信息、签到时间和签退时间等关键数据。

状态管理

应用使用 useState Hook 管理多个复杂状态,包括员工列表、签到记录、选中状态等:

const [employees] = useState<Employee[]>([
  {
    id: '1',
    name: '李先生',
    department: '技术部',
    position: '前端工程师'
  },
  {
    id: '2',
    name: '王女士',
    department: '市场部',
    position: '市场专员'
  }
]);

// 其他状态定义...

特别值得注意的是,应用通过 useEffect 实现了签到时间的自动记录机制:

// 自动记录签到时间
useEffect(() => {
  const interval = setInterval(() => {
    const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
    const newRecord: CheckInRecord = {
      id: (checkInRecords.length + 1).toString(),
      employeeId: randomEmployee.id,
      date: new Date().toISOString().split('T')[0],
      checkInTime: new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }),
      checkOutTime: null
    };
    setCheckInRecords([...checkInRecords, newRecord]);
  }, 60000);

  return () => clearInterval(interval);
}, [employees, checkInRecords]);

这种基于时间间隔的自动记录机制,模拟了真实场景中员工签到的过程,为考勤管理提供了自动化的技术支持。同时,通过 useEffect 的清理函数,确保了定时器在组件卸载时被正确清除,避免了内存泄漏。


在 React Native 鸿蒙跨端开发中,该应用体现了以下关键技术点:

  1. 组件兼容性:使用 React Native 核心组件(如 SafeAreaView、View、Text、TouchableOpacity、ScrollView、Modal 等),确保在鸿蒙系统上的兼容性
  2. 资源管理:通过 Base64 编码的图标资源,避免了不同平台资源格式的差异,提高了跨端部署的一致性
  3. 尺寸适配:使用 Dimensions API 获取屏幕尺寸,实现响应式布局,适应不同设备屏幕
  4. 状态管理:采用 React Hooks 进行状态管理,保持跨平台代码一致性
  5. 类型安全:TypeScript 类型定义确保了数据结构在不同平台间的一致性
  6. API 调用:使用 React Native 统一的 API 调用方式,如 Alert 组件,确保在鸿蒙平台上的正确显示
  7. 日期时间处理:使用 JavaScript 标准的 Date 对象和 toLocaleTimeString 方法,确保在不同平台上的日期时间处理一致性

员工管理与选择

应用实现了员工的选择功能,用户可以选择特定员工进行签到打卡:

const handleSelectEmployee = (employeeId: string) => {
  setSelectedEmployee(employeeId);
  Alert.alert('选择员工', '您已选择该员工进行上班打卡');
};

签到功能

应用提供了签到功能,员工可以记录上班时间:

const handleCheckIn = () => {
  if (newCheckIn.date && newCheckIn.checkInTime && selectedEmployee) {
    const newRecord: CheckInRecord = {
      id: (checkInRecords.length + 1).toString(),
      employeeId: selectedEmployee,
      date: newCheckIn.date,
      checkInTime: newCheckIn.checkInTime,
      checkOutTime: null
    };
    setCheckInRecords([...checkInRecords, newRecord]);
    setNewCheckIn({ date: '', checkInTime: '' });
    Alert.alert('签到成功', '新的上班打卡记录已添加');
  } else {
    Alert.alert('提示', '请选择员工并填写完整的签到信息');
  }
};

签退功能

应用实现了签退功能,员工可以记录下班时间:

const handleCheckOut = (recordId: string) => {
  const updatedRecords = checkInRecords.map(record =>
    record.id === recordId ? { ...record, checkOutTime: new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) } : record
  );
  setCheckInRecords(updatedRecords);
  Alert.alert('签退成功', '下班打卡记录已更新');
};

记录查看功能

应用提供了签到记录的查看功能,通过模态框展示详细信息:

const handleViewRecord = (recordId: string) => {
  const record = checkInRecords.find(r => r.id === recordId);
  if (record) {
    const employee = employees.find(e => e.id === record.employeeId);
    setModalContent(`员工: ${employee?.name}\n部门: ${employee?.department}\n职位: ${employee?.position}\n日期: ${record.date}\n上班时间: ${record.checkInTime}\n下班时间: ${record.checkOutTime || '未签退'}`);
    setIsModalVisible(true);
  }
};

自动签到记录

应用通过定时任务自动记录签到时间,模拟了真实的考勤场景。


应用的 UI 设计遵循了现代移动应用的设计原则,使用了以下组件和交互模式:

  • 安全区域:通过 SafeAreaView 确保内容显示在安全区域内,适应不同设备的屏幕刘海和底部指示条
  • 滚动视图:通过 ScrollView 实现内容的垂直滚动,适应不同长度的员工列表和签到记录
  • 卡片布局:使用 TouchableOpacity 和 View 组合实现卡片式列表项,提供清晰的视觉层次和交互反馈
  • 表单输入:通过 TextInput 组件实现签到信息的输入
  • 模态框:通过 Modal 组件展示详细信息,如签到记录详情
  • 交互反馈:使用 Alert 组件提供操作反馈和提示信息
  • 响应式设计:根据屏幕尺寸动态调整布局,确保在不同设备上的良好显示效果

  1. 跨端架构:基于 React Native 构建,实现了一次编码多平台运行的目标,特别关注了鸿蒙平台的适配
  2. 类型安全:全面使用 TypeScript 类型定义,提高代码质量和可维护性,确保考勤数据的准确性
  3. 自动化考勤:通过定时任务自动记录签到时间,提高了考勤管理的效率
  4. 实时时间处理:使用 toLocaleTimeString 方法获取实时时间,确保签到时间的准确性
  5. 状态管理:通过 React Hooks 实现了简洁的状态管理,提高了代码的可读性和可维护性
  6. 模块化设计:通过清晰的类型定义和函数划分,实现了代码的模块化,提高了可维护性
  7. 实时数据反馈:通过即时的 Alert 反馈,增强用户操作体验
  8. 数据结构设计:通过关联的数据结构,如签到记录关联员工,实现了复杂考勤数据的有效组织
  9. 灵活性:支持手动签到和自动签到两种方式,满足不同场景的需求

在实际应用中,还可以考虑以下性能优化策略:

  1. 状态管理优化:对于大型应用,可以考虑使用 Redux 或 Context API 进行全局状态管理,提高状态更新的效率
  2. 组件拆分:将大型组件拆分为更小的可复用组件,提高渲染性能和代码可维护性
  3. 数据缓存:对员工数据和签到记录进行本地缓存,减少重复计算和网络请求
  4. 动画性能:使用 React Native 的 Animated API 实现流畅的过渡动画,提升用户体验
  5. 内存管理:确保及时清理不再使用的状态和事件监听器,避免内存泄漏
  6. 网络优化:对于实际应用中的远程数据同步,实现合理的网络请求策略,如批量上传、增量同步等
  7. 计算优化:对于考勤数据的统计和分析,可以考虑使用 memoization 技术缓存计算结果
  8. 列表优化:对于长列表,使用 FlatList 组件替代 ScrollView,提高渲染性能

在开发过程中,可能面临的技术挑战及解决方案:

  1. 鸿蒙平台适配:通过使用 React Native 核心组件和统一的 API 调用方式,确保应用在鸿蒙平台上的兼容性
  2. 实时数据同步:在实际应用中,可以实现与后端服务器的实时数据同步,确保考勤数据的一致性
  3. 地理位置验证:可以集成地理位置验证,确保员工在指定地点进行签到
  4. 数据安全:实现考勤数据的加密存储和传输,保护企业数据安全
  5. 离线功能:实现基本的离线操作能力,确保在网络不稳定情况下的正常使用
  6. 性能优化:针对不同设备性能差异,实现自适应的性能优化策略,确保在中低端设备上的流畅运行
  7. 用户体验一致性:确保在不同平台上的用户体验一致,特别是交互方式和视觉效果
  8. 多语言支持:实现多语言支持,满足不同地区企业的需求

通过对这个上班打卡应用的技术解读,我们可以看到 React Native 在跨端开发中的强大能力。该应用不仅实现了完整的考勤管理功能,还展示了如何通过 TypeScript、React Hooks 等现代前端技术构建高质量的跨端应用。


真实演示案例代码:









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

// Base64 图标库
const ICONS_BASE64 = {
  clock: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  calendar: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  check: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  user: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
};

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

// 员工类型
type Employee = {
  id: string;
  name: string;
  department: string;
  position: string;
};

// 签到记录类型
type CheckInRecord = {
  id: string;
  employeeId: string;
  date: string;
  checkInTime: string;
  checkOutTime: string | null;
};

// 上班打卡应用组件
const WorkAttendanceApp: React.FC = () => {
  const [employees] = useState<Employee[]>([
    {
      id: '1',
      name: '李先生',
      department: '技术部',
      position: '前端工程师'
    },
    {
      id: '2',
      name: '王女士',
      department: '市场部',
      position: '市场专员'
    }
  ]);

  const [checkInRecords, setCheckInRecords] = useState<CheckInRecord[]>([
    {
      id: '1',
      employeeId: '1',
      date: '2023-12-01',
      checkInTime: '09:00',
      checkOutTime: '18:00'
    }
  ]);

  const [selectedEmployee, setSelectedEmployee] = useState<string | null>(null);
  const [newCheckIn, setNewCheckIn] = useState({
    date: '',
    checkInTime: ''
  });
  const [isModalVisible, setIsModalVisible] = useState(false);
  const [modalContent, setModalContent] = useState('');

  // 自动记录签到时间
  useEffect(() => {
    const interval = setInterval(() => {
      const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
      const newRecord: CheckInRecord = {
        id: (checkInRecords.length + 1).toString(),
        employeeId: randomEmployee.id,
        date: new Date().toISOString().split('T')[0],
        checkInTime: new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }),
        checkOutTime: null
      };
      setCheckInRecords([...checkInRecords, newRecord]);
    }, 60000);

    return () => clearInterval(interval);
  }, [employees, checkInRecords]);

  const handleSelectEmployee = (employeeId: string) => {
    setSelectedEmployee(employeeId);
    Alert.alert('选择员工', '您已选择该员工进行上班打卡');
  };

  const handleCheckIn = () => {
    if (newCheckIn.date && newCheckIn.checkInTime && selectedEmployee) {
      const newRecord: CheckInRecord = {
        id: (checkInRecords.length + 1).toString(),
        employeeId: selectedEmployee,
        date: newCheckIn.date,
        checkInTime: newCheckIn.checkInTime,
        checkOutTime: null
      };
      setCheckInRecords([...checkInRecords, newRecord]);
      setNewCheckIn({ date: '', checkInTime: '' });
      Alert.alert('签到成功', '新的上班打卡记录已添加');
    } else {
      Alert.alert('提示', '请选择员工并填写完整的签到信息');
    }
  };

  const handleCheckOut = (recordId: string) => {
    const updatedRecords = checkInRecords.map(record => 
      record.id === recordId ? { ...record, checkOutTime: new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) } : record
    );
    setCheckInRecords(updatedRecords);
    Alert.alert('签退成功', '下班打卡记录已更新');
  };

  const handleViewRecord = (recordId: string) => {
    const record = checkInRecords.find(r => r.id === recordId);
    if (record) {
      const employee = employees.find(e => e.id === record.employeeId);
      setModalContent(`员工: ${employee?.name}\n部门: ${employee?.department}\n职位: ${employee?.position}\n日期: ${record.date}\n上班时间: ${record.checkInTime}\n下班时间: ${record.checkOutTime || '未签退'}`);
      setIsModalVisible(true);
    }
  };

  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}>员工通过App进行上班时间的签到打卡,记录准确的到岗时间</Text>
      </View>

      <ScrollView style={styles.content}>
        {/* 员工列表 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>员工列表</Text>
          {employees.map(employee => (
            <TouchableOpacity 
              key={employee.id}
              style={[
                styles.card,
                selectedEmployee === employee.id && styles.selectedCard
              ]}
              onPress={() => handleSelectEmployee(employee.id)}
            >
              <Text style={styles.icon}>👤</Text>
              <View style={styles.cardInfo}>
                <Text style={styles.cardTitle}>{employee.name}</Text>
                <Text style={styles.cardDescription}>部门: {employee.department}</Text>
                <Text style={styles.cardDescription}>职位: {employee.position}</Text>
              </View>
            </TouchableOpacity>
          ))}
        </View>

        {/* 签到打卡 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>签到打卡</Text>
          <View style={styles.inputRow}>
            <TextInput
              style={styles.input}
              placeholder="签到日期 (YYYY-MM-DD)"
              value={newCheckIn.date}
              onChangeText={(text) => setNewCheckIn({ ...newCheckIn, date: text })}
            />
            <TextInput
              style={styles.input}
              placeholder="签到时间 (HH:MM)"
              value={newCheckIn.checkInTime}
              onChangeText={(text) => setNewCheckIn({ ...newCheckIn, checkInTime: text })}
            />
          </View>
          <TouchableOpacity 
            style={styles.addButton}
            onPress={handleCheckIn}
          >
            <Text style={styles.addText}>签到打卡</Text>
          </TouchableOpacity>
        </View>

        {/* 签到记录 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>签到记录</Text>
          {checkInRecords.map(record => (
            <TouchableOpacity 
              key={record.id}
              style={styles.recordCard}
              onPress={() => handleViewRecord(record.id)}
            >
              <Text style={styles.icon}></Text>
              <View style={styles.cardInfo}>
                <Text style={styles.cardTitle}>记录ID: {record.id}</Text>
                <Text style={styles.cardDescription}>日期: {record.date}</Text>
                <Text style={styles.cardDescription}>上班时间: {record.checkInTime}</Text>
                <Text style={styles.cardDescription}>下班时间: {record.checkOutTime || '未签退'}</Text>
              </View>
              {!record.checkOutTime && (
                <TouchableOpacity 
                  style={styles.checkOutButton}
                  onPress={() => handleCheckOut(record.id)}
                >
                  <Text style={styles.checkOutText}>签退</Text>
                </TouchableOpacity>
              )}
            </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',
  },
  recordCard: {
    flexDirection: 'row',
    alignItems: 'center',
    backgroundColor: '#f0f9ff',
    borderRadius: 12,
    padding: 16,
    marginBottom: 12,
  },
  icon: {
    fontSize: 28,
    marginRight: 12,
  },
  cardInfo: {
    flex: 1,
  },
  cardTitle: {
    fontSize: 16,
    fontWeight: '500',
    color: '#0c4a6e',
    marginBottom: 4,
  },
  cardDescription: {
    fontSize: 14,
    color: '#0284c7',
    marginBottom: 2,
  },
  inputRow: {
    flexDirection: 'row',
    justifyContent: 'space-between',
    marginBottom: 12,
  },
  input: {
    flex: 1,
    backgroundColor: '#f0f9ff',
    borderRadius: 8,
    paddingHorizontal: 12,
    paddingVertical: 8,
    fontSize: 14,
    color: '#0c4a6e',
    marginRight: 8,
  },
  addButton: {
    backgroundColor: '#0284c7',
    padding: 12,
    borderRadius: 8,
    alignItems: 'center',
  },
  addText: {
    color: '#ffffff',
    fontSize: 14,
    fontWeight: '500',
  },
  checkOutButton: {
    backgroundColor: '#10b981',
    paddingHorizontal: 12,
    paddingVertical: 6,
    borderRadius: 8,
  },
  checkOutText: {
    color: '#ffffff',
    fontSize: 12,
    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 WorkAttendanceApp;

请添加图片描述


打包

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

在这里插入图片描述

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

在这里插入图片描述

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

请添加图片描述
本文介绍了基于React Native开发的跨平台鸿蒙考勤应用的技术架构。应用采用React Native通用组件与TypeScript强类型数据模型,确保在鸿蒙系统上的兼容性。核心业务逻辑通过React Hooks实现状态管理,自动考勤记录采用跨端兼容的日期格式化方式,签退更新逻辑保障数据一致性。UI层使用StyleSheet统一管理样式,适配鸿蒙的原生渲染效果,满足企业考勤应用对数据展示和操作体验的要求。该架构充分发挥了React Native"一次开发、多端运行"的优势,实现了与鸿蒙生态的无缝融合。

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

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐