什么是 Cordova

Apache Cordova 是一个开源的移动开发框架，允许开发者使用标准的 Web 技术（HTML5、CSS3 和 JavaScript）来开发跨平台移动应用。Cordova 学习曲线平缓，可直接将现有Web应用迁移到鸿蒙平台，只需少量适配工作，它本质上是一个 “浏览器外壳”，把你的网页代码包起来，变成一个可以安装在手机上的应用。

什么是 hcordova

hcordova 基于 cordova-openharmony 开发，旨在通过 Web 技术（HTML5、CSS3、JavaScript）快速构建支持 Android、iOS、HarmonyOS三平台的原生移动应用。Cordova 框架将 Web 代码封装为原生应用容器，实现 “一次开发，多端部署”，同时支持调用设备原生能力（如相机、定位、存储等），兼顾开发效率与原生体验。

环境准备

• 基础依赖（必装）
  • Node.js：v16.0.0 及以上（推荐 v18 LTS 版本）安装后验证：

  node -v  # 查看 Node 版本
  npm -v   # 查看 npm 版本
  

  • Git：用于版本控制与依赖拉取
• 平台专属依赖（按需安装）
  • HarmonyOS平台：
    • DevEco下载地址：https://developer.huawei.com
    • 命令化工具下载地址：https://developer.huawei.com

使用 hcordova 开发第一个鸿蒙应用

第一步： 安装 hcordova CLI

npm install -g hcordova
hcordova -v  # 输出 hcordova 版本（如 1.0.0）即表示成功

第二步：创建项目

# 语法：cordova create <项目目录> <应用包名> <应用名称>
hcordova create MyApp com.example.MyApp MyHarmonyApp
cd MyApp # 进入项目目录

第三步：添加鸿蒙平台

hcordova platform add harmonyos

查看已添加平台

hcordova platform ls
# 输出示例：Installed platforms: 
HarmonyOS (installed)

第四步：项目运行

项目构建成功后，在 MytApp 根目录会生成一个 harmonyos 文件夹，使用 DevEco 打开进行开发和调试。