HarmonyOS鸿蒙Next中JS到ArkTs的适配

一、JS工程迁移核心步骤

1. 工程结构调整 在DevEco Studio中直接创建OpenHarmony工程（选择"Application > Empty Ability"模板），创建后：

   • 将原有JS文件放入工程目录的entry/src/main/js/下
   • 在build-profile.json5中确认以下配置：

   "buildOption": {
     "sourceType": "js" // 标识当前为JS工程
   }
   

2. 渐进式迁移方案

   • 混合开发模式： ArkTS可直接调用JS模块（无需桥接），示例：

     // ArkTS文件 (Index.ets)
     import { jsFunc } from './JsLib.js'; // 直接导入JS模块
     
     @Entry
     @Component
     struct Index {
       build() {
         Button("Call JS")
           .onClick(() => {
             jsFunc(); // 调用JS函数
           })
       }
     }
     

     // JsLib.js
     export function jsFunc() {
       console.info("JS function called");
     }
     

   • 分模块迁移： 按优先级逐个将JS文件重命名为.ets后缀，并在文件中：
     1. 添加类型注解（如let count: number = 0）
     2. 显式初始化类属性（ArkTS强制要求）：

     // 迁移前JS
     class Person {
       name; // 未初始化
     
     // 迁移后ArkTS
     class Person {
       name: string = ""; // 显式初始化
     

二、DevEco工程配置要点

1. 模块识别规则

   • 当目录中包含.js文件时，DevEco自动识别为JS工程
   • 当.ets文件占比超50%时，建议在build-profile.json5中切换为ArkTS工程：

   "buildOption": {
     "sourceType": "arkts"
   }
   

2. 文档迁移辅助 使用 ArkTSDoc 自动生成功能（菜单栏 > Tools > Generate ArkTSDoc）：

   • 支持对JS/TS/ETS文件批量生成文档
   • 要求注释格式：

   /**
    * 计算两数之和
    * @param {number} a - 参数1
    * @param {number} b - 参数2
    * @since 11
    */
   export function add(a, b) {
     return a + b;
   }
   

三、迁移最佳实践

1. 类型安全改造

   • 将JS的var/let替换为具体类型：

   // 改造前
   let age = 20;
   
   // 改造后
   let age: number = 20;
   

   • 使用联合类型处理可能为undefined的返回值：

   // JS原始代码
   function getName() {
     return this.name; 
   }
   
   // ArkTS适配
   getName(): string | undefined {
     return this.name;
   }
   

2. 异步处理标准化 将JS回调改为Promise或async/await：

   // 迁移后示例
   async function fetchData() {
     try {
       let data = await http.get("api/data");
     } catch (error) {
       console.error(error);
     }
   }
   

关键提醒：

• 当前DevEco Studio不提供纯JS工程模板，但支持在OpenHarmony工程中直接使用JS开发
• 当工程内同时存在.js和.ets文件时，编译链会自动处理混合编译
• 建议优先迁移核心业务模块，UI组件推荐使用ArkUI声明式语法重构

还是要用arkts，只是在arkts中可以调用ts。ts无法调用arkts

部分语法之类的不支持，具体参考下面建议

TS代码适配成ArkTS代码的建议