鸿蒙 Next 纯血版实战：如何复用你现有的 TypeScript 工具库？（拒绝重复造轮子）

标签：#HarmonyOS #ArkTS #TypeScript #前端工程化 #OHPM #效率工具

😲 前言：前端资产的“第二春”

在鸿蒙 Next 生态中，ArkTS是唯一官方推荐的开发语言。
虽然它为了极致性能（AOT 编译）加了很多限制（比如禁止运行时的any随意转换），但它依然保留了 TypeScript 的核心语法。

这意味着，你不再需要像 Android 那样重写DateUtils.java，也不需要像 iOS 那样重写StringHelper.swift。
你只需要把以前写过的utils.ts拿来，稍微清洗一下，就能直接跑在鸿蒙手机上。

🏗️ 一、架构逻辑：NPM 生态的平移

鸿蒙拥有自己的包管理器OHPM (Open Harmony Package Manager)。它不仅支持鸿蒙原生的.har包，还兼容标准的 npm 包机制。

库复用流程图 (Mermaid):

📦 二、实战 1：直接安装 NPM 第三方库

假设你想处理时间。在 Web 端我们常用dayjs。在鸿蒙里，你完全不需要自己写时间格式化函数。

1. 安装

在 DevEco Studio 的终端（Terminal）中运行：

ohpminstalldayjs

注意：这里用的是ohpm，不是npm，但它会去 npm 仓库拉取代码。

2. 核心代码

在你的.ets页面中直接使用：

// Home.etsimportdayjsfrom'dayjs';// 就像在 Vue/React 里一样！@Entry@Componentstruct Home{@StatetimeStr:string='';aboutToAppear(){// 完美运行，无缝迁移this.timeStr=dayjs().format('YYYY-MM-DD HH:mm:ss');}build(){Column(){Text(`当前时间:${this.timeStr}`).fontSize(30)}}}

结论：只要是不依赖浏览器 DOM（如window、document）和 Node.js 特有 API（如fs、process）的纯逻辑库（如lodash,mathjs,crypto-js），绝大多数都能直接用！

🛠️ 二、实战 2：复用你自己的 TS 源码 (Adapter 模式)

鸿蒙的.ets文件（ArkUI 组件）对类型检查非常严格，不支持某些动态特性（如any的隐式推断）。
如果你的旧代码里充满了any，直接复制到.ets里会报一堆红线。

最佳实践：使用.ts文件作为“隔离层”。

场景：你有一个祖传的`EncryptUtils.ts`(加密工具)

1. 旧代码 (LegacyCode.ts)

// 这是一个普通的 TS 文件，可能包含一些 ArkTS 不喜欢的动态写法exportfunctioncomplexAlgorithm(data:any):string{// 假设这里有很多动态操作return"加密数据:"+JSON.stringify(data);}

2. 鸿蒙项目结构
不要直接把逻辑写在.ets里，而是新建一个.ts文件。

ets/ ├── utils/ │ └── EncryptAdapter.ts <-- 纯 TS 文件，限制较少 └── pages/ └── Index.ets <-- UI 文件，限制严格

3. 适配层 (EncryptAdapter.ts)

// 在 .ts 文件中，ArkTS 的检查相对宽松import{complexAlgorithm}from'./LegacyCode';// 在这里处理类型转换，对外暴露干净的接口exportfunctionsafeEncrypt(msg:string):string{returncomplexAlgorithm(msg);}

4. UI 调用 (Index.ets)

import{safeEncrypt}from'../utils/EncryptAdapter';@Entry@Componentstruct Index{build(){Button('加密').onClick(()=>{// UI 层只调用干净的接口constres=safeEncrypt("Hello Harmony");console.info(res);})}}