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


在企业人力资源管理体系中,加班打卡与时长核算是薪酬结算、考勤合规性管控的核心环节,其对时间计算的精准性、跨端数据一致性和统计逻辑稳定性有着严苛要求。鸿蒙系统的分布式全场景能力为企业办公应用的多终端部署提供了底层支撑,而React Native凭借“一次开发、多端运行”的技术特性,成为这类考勤应用跨端开发的核心技术底座。本文将从加班时长自动核算算法、数值型数据精度控制、UI交互适配到鸿蒙跨端兼容的底层实现,全方位拆解这款加班打卡应用的技术架构,剖析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;            // 字符串型职位,兼容前端工程师/市场专员等岗位描述
  scheduledEndTime: string;   // 字符串型规定下班时间,适配HH:MM格式的排班规则,作为加班起始参考
};

// 加班记录核心模型:整合时间区间与数值型时长,是应用的核心数据载体
type OvertimeRecord = {
  id: string;
  employeeId: string;
  date: string;                // 字符串型日期,兼容跨端日期格式(YYYY-MM-DD)
  startTime: string;           // 字符串型加班开始时间,适配HH:MM格式
  endTime: string;             // 字符串型加班结束时间,与开始时间形成完整时间区间
  overtimeHours: number;       // 数值型加班时长,保证时长计算的精度和跨端数值传递一致性
};

这些类型定义严格约束了企业加班打卡相关数据的格式和类型,在鸿蒙系统中,React Native的TypeScript编译器会对JS层与鸿蒙ArkTS层之间的数据交互进行严格校验。例如,overtimeHours采用数值类型(number),既满足时长核算的精准计算需求,又保证跨端数据解析的一致性,避免因鸿蒙ArkTS静态类型特性与JavaScript动态类型特性不兼容导致的时长计算错误;scheduledEndTime作为字符串类型,在跨端传递时会被强制校验为HH:MM格式,确保员工下班时间与加班起始点的精准匹配,符合企业加班管理“规则统一、核算精准”的核心要求。

React Hooks驱动的跨端加班时长核算

应用的核心业务逻辑(自动时长核算、手动添加加班记录、记录详情展示)均基于React Hooks(useStateuseEffect)实现,这种轻量级状态管理方式完美适配React Native的跨端生命周期模型,同时与鸿蒙组件生命周期深度融合,保障了核心加班核算规则的跨端稳定运行。

不可变更新

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

setOvertimeRecords([...overtimeRecords, newRecord]);

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

跨端时间计算

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

useEffect(() => {
  const interval = setInterval(() => {
    const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
    const startTime = randomEmployee.scheduledEndTime;
    const endTime = new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
    // 跨端兼容的时长核算算法:基于时间戳差值的小时转换
    const overtimeHours = (new Date(`1970-01-01T${endTime}`) - new Date(`1970-01-01T${startTime}`)) / (1000 * 60 * 60);
    if (overtimeHours > 0) {
      const newRecord: OvertimeRecord = {
        id: (overtimeRecords.length + 1).toString(),
        employeeId: randomEmployee.id,
        date: new Date().toISOString().split('T')[0], // 跨端兼容的日期格式化
        startTime,
        endTime,
        overtimeHours
      };
      setOvertimeRecords([...overtimeRecords, newRecord]);
    }
  }, 60000);

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

加班时长核算算法中,通过构造1970-01-01T前缀的时间字符串来创建Date对象,是跨端时间计算的核心技巧——该方式剥离了日期因素,仅保留时分维度的差值计算,完全基于ES6标准时间API实现,在鸿蒙系统中会被React Native框架转换为ArkTS的时间操作逻辑,保证不同鸿蒙设备上时长核算结果的一致性;将时间戳差值除以1000 * 60 * 60转换为小时数,是跨端通用的时间单位转换方式,避免因平台时间处理差异导致的时长计算错误;toLocaleTimeStringtoISOString是跨端通用的时间/日期格式化方法,在鸿蒙系统中会解析为标准的HH:MMYYYY-MM-DD格式,进一步保障核算基础数据的准确性。


handleAddOvertimeRecord函数是手动录入加班数据的核心入口,其内部的时长核算逻辑在鸿蒙系统中稳定运行的关键在于:首先校验所有必填字段的完整性,保证加班记录数据的合规性;其次采用与自动核算完全一致的时间戳差值算法,确保手动录入和自动核算的规则统一性;最后通过不可变更新模式(setOvertimeRecords([...overtimeRecords, newRecord]))更新状态,保证加班记录在鸿蒙分布式数据环境下的同步准确性,避免多端数据冲突。

应用的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,
  },
  addButton: {
    backgroundColor: '#0284c7', // 办公场景专属蓝色,适配记录添加确认按钮
    padding: 12,
    borderRadius: 8,
    alignItems: 'center',
  },
  input: {
    flex: 1,
    backgroundColor: '#f0f9ff', // 浅蓝主题,适配企业办公应用视觉规范
    borderRadius: 8,
    paddingHorizontal: 12,
    paddingVertical: 8,
    fontSize: 14,
    color: '#0c4a6e',
  }
});

其中,elevation属性在鸿蒙系统中会被解析为原生阴影层级,borderRadius适配鸿蒙圆角渲染规则,保证UI视觉效果的跨端一致性;添加记录按钮采用企业办公场景专属的蓝色(#0284c7),既符合企业办公应用视觉规范,又适配鸿蒙系统色彩体系,提升操作的辨识度;浅蓝主题(#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;
  scheduledEndTime: string;
};

// 加班记录类型
type OvertimeRecord = {
  id: string;
  employeeId: string;
  date: string;
  startTime: string;
  endTime: string;
  overtimeHours: number;
};

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

副作用处理

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

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

// 其他状态定义...

特别值得注意的是,应用通过 useEffect 实现了加班时长的自动计算机制:

// 自动计算加班时长
useEffect(() => {
  const interval = setInterval(() => {
    const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
    const startTime = randomEmployee.scheduledEndTime;
    const endTime = new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
    const overtimeHours = (new Date(`1970-01-01T${endTime}`) - new Date(`1970-01-01T${startTime}`)) / (1000 * 60 * 60);
    if (overtimeHours > 0) {
      const newRecord: OvertimeRecord = {
        id: (overtimeRecords.length + 1).toString(),
        employeeId: randomEmployee.id,
        date: new Date().toISOString().split('T')[0],
        startTime,
        endTime,
        overtimeHours
      };
      setOvertimeRecords([...overtimeRecords, newRecord]);
    }
  }, 60000);

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

这种基于时间间隔的自动计算机制,模拟了真实场景中员工加班的过程,为考勤管理提供了自动化的技术支持。同时,通过 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 方法,确保在不同平台上的日期时间处理一致性
  8. 数学计算:使用标准的时间差计算和数学运算,确保加班时长计算在不同平台上的一致性

员工管理与选择

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

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

加班记录添加

应用提供了加班记录的添加功能,用户可以输入日期和加班时间范围,系统会自动计算加班时长:

const handleAddOvertimeRecord = () => {
  if (newOvertimeRecord.date && newOvertimeRecord.startTime && newOvertimeRecord.endTime && selectedEmployee) {
    const overtimeHours = (new Date(`1970-01-01T${newOvertimeRecord.endTime}`) - new Date(`1970-01-01T${newOvertimeRecord.startTime}`)) / (1000 * 60 * 60);
    const newRecord: OvertimeRecord = {
      id: (overtimeRecords.length + 1).toString(),
      employeeId: selectedEmployee,
      date: newOvertimeRecord.date,
      startTime: newOvertimeRecord.startTime,
      endTime: newOvertimeRecord.endTime,
      overtimeHours
    };
    setOvertimeRecords([...overtimeRecords, newRecord]);
    setNewOvertimeRecord({ date: '', startTime: '', endTime: '' });
    Alert.alert('添加成功', '新的加班记录已添加');
  } else {
    Alert.alert('提示', '请选择员工并填写完整的加班信息');
  }
};

加班时长自动计算

应用实现了加班时长的自动计算功能,通过计算加班结束时间和开始时间的差值,得出加班时长:

const overtimeHours = (new Date(`1970-01-01T${endTime}`) - new Date(`1970-01-01T${startTime}`)) / (1000 * 60 * 60);

记录查看功能

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

const handleViewRecord = (recordId: string) => {
  const record = overtimeRecords.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.startTime}\n结束时间: ${record.endTime}\n加班时长: ${record.overtimeHours}小时`);
    setIsModalVisible(true);
  }
};

自动加班检测与记录

应用通过定时任务自动检测员工是否加班,并计算加班时长,模拟了真实的加班场景。


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

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

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

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

  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 = {
  overtime: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  clock: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
  calendar: '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;
  scheduledEndTime: string;
};

// 加班记录类型
type OvertimeRecord = {
  id: string;
  employeeId: string;
  date: string;
  startTime: string;
  endTime: string;
  overtimeHours: number;
};

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

  const [overtimeRecords, setOvertimeRecords] = useState<OvertimeRecord[]>([
    {
      id: '1',
      employeeId: '1',
      date: '2023-12-01',
      startTime: '18:00',
      endTime: '20:00',
      overtimeHours: 2
    }
  ]);

  const [selectedEmployee, setSelectedEmployee] = useState<string | null>(null);
  const [newOvertimeRecord, setNewOvertimeRecord] = useState({
    date: '',
    startTime: '',
    endTime: ''
  });
  const [isModalVisible, setIsModalVisible] = useState(false);
  const [modalContent, setModalContent] = useState('');

  // 自动计算加班时长
  useEffect(() => {
    const interval = setInterval(() => {
      const randomEmployee = employees[Math.floor(Math.random() * employees.length)];
      const startTime = randomEmployee.scheduledEndTime;
      const endTime = new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
      const overtimeHours = (new Date(`1970-01-01T${endTime}`) - new Date(`1970-01-01T${startTime}`)) / (1000 * 60 * 60);
      if (overtimeHours > 0) {
        const newRecord: OvertimeRecord = {
          id: (overtimeRecords.length + 1).toString(),
          employeeId: randomEmployee.id,
          date: new Date().toISOString().split('T')[0],
          startTime,
          endTime,
          overtimeHours
        };
        setOvertimeRecords([...overtimeRecords, newRecord]);
      }
    }, 60000);

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

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

  const handleAddOvertimeRecord = () => {
    if (newOvertimeRecord.date && newOvertimeRecord.startTime && newOvertimeRecord.endTime && selectedEmployee) {
      const overtimeHours = (new Date(`1970-01-01T${newOvertimeRecord.endTime}`) - new Date(`1970-01-01T${newOvertimeRecord.startTime}`)) / (1000 * 60 * 60);
      const newRecord: OvertimeRecord = {
        id: (overtimeRecords.length + 1).toString(),
        employeeId: selectedEmployee,
        date: newOvertimeRecord.date,
        startTime: newOvertimeRecord.startTime,
        endTime: newOvertimeRecord.endTime,
        overtimeHours
      };
      setOvertimeRecords([...overtimeRecords, newRecord]);
      setNewOvertimeRecord({ date: '', startTime: '', endTime: '' });
      Alert.alert('添加成功', '新的加班记录已添加');
    } else {
      Alert.alert('提示', '请选择员工并填写完整的加班信息');
    }
  };

  const handleViewRecord = (recordId: string) => {
    const record = overtimeRecords.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.startTime}\n结束时间: ${record.endTime}\n加班时长: ${record.overtimeHours}小时`);
      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}>员工在下班后继续打卡,系统自动计算加班时长并记录</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>
                <Text style={styles.cardDescription}>规定下班时间: {employee.scheduledEndTime}</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={newOvertimeRecord.date}
              onChangeText={(text) => setNewOvertimeRecord({ ...newOvertimeRecord, date: text })}
            />
            <TextInput
              style={styles.input}
              placeholder="开始时间 (HH:MM)"
              value={newOvertimeRecord.startTime}
              onChangeText={(text) => setNewOvertimeRecord({ ...newOvertimeRecord, startTime: text })}
            />
          </View>
          <View style={styles.inputRow}>
            <TextInput
              style={styles.input}
              placeholder="结束时间 (HH:MM)"
              value={newOvertimeRecord.endTime}
              onChangeText={(text) => setNewOvertimeRecord({ ...newOvertimeRecord, endTime: text })}
            />
          </View>
          <TouchableOpacity 
            style={styles.addButton}
            onPress={handleAddOvertimeRecord}
          >
            <Text style={styles.addText}>添加加班记录</Text>
          </TouchableOpacity>
        </View>

        {/* 加班记录 */}
        <View style={styles.section}>
          <Text style={styles.sectionTitle}>加班记录</Text>
          {overtimeRecords.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.startTime}</Text>
                <Text style={styles.cardDescription}>结束时间: {record.endTime}</Text>
                <Text style={styles.cardDescription}>加班时长: {record.overtimeHours}小时</Text>
              </View>
            </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',
  },
  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',
  },
});


请添加图片描述


打包

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

在这里插入图片描述

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

在这里插入图片描述

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

请添加图片描述
本文介绍了基于React Native开发的跨平台加班打卡应用如何适配鸿蒙系统。应用采用"通用抽象层+平台适配层"架构,通过TypeScript强类型数据模型确保跨端数据一致性,利用React Hooks实现加班时长自动核算和状态管理。核心算法采用时间戳差值计算,保证鸿蒙多设备间的时长核算准确性。样式系统通过StyleSheet统一管理,适配鸿蒙ArkUI布局特性。该方案充分发挥了React Native"一次开发、多端运行"的优势,同时深度适配鸿蒙分布式能力,满足企业考勤管理对数据精准性和跨端一致性的严苛要求。

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

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐