❌

阅读视图

发现新文章，点击刷新页面。
🔲 ☆

鸿蒙PC Matebook Pro上安装仓颉编译器每日构建版

✇东方星痕
YSTYLE
使用示例
使用示例

准备工作

从CodeArts IDE提取签名工具

打开IDE, 随便创建一个项目打开，在终端执行以下命令

1
2
3
4
5
6
7
8
9
10
11
12
# 复制签名工具
cp /data/app/toolchains.org/toolchains_1.0/lib//binary-sign-tool .
# 对签名工具签名
binary-sign-tool sign -inFile "./binary-sign-tool" -outFile "./binary-sign-tool-signed" -selfSign 1
# 添加可执行权限
chmod +x binary-sign-tool-signed
# 测试，如果没弹授权弹窗和帮忙输出，需要重新签名和添加可执行权限
./binary-sign-tool-signed

# 复制到用户安装目录
mkdir -p ~/.local/bin
cp ./binary-sign-tool-signed ~/.local/bin/binary-sign-tool

最后在~/.zshrc添加export PATH=$HOME/.local/bin:$PATH

安装仓颉编译器

  • 把下载的仓颉编译器复制到个人目录(文件管器和下载目录同级)
  • 打开终端解压 tar -xzf cangjie-sdk-ohos-aarch64-1.1.0-alpha.2025xxxxxxxxxxxxx.tar.gz 换自己下载的版本
  • 打开cangjie/envsetup.sh把首行的#!/bin/bash换成#!/bin/sh

  • 把以下脚本保存为sign-cangjie.sh并复制到cangjie目录下和envsetup.sh同级

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    #!/bin/sh

    # 递归查询当前目录及其子目录下的所有文件
    find . -type f | while read -r file; do
    # 使用 file 命令检查文件类型
    if file "$file" | grep "shared object"; then
    echo "Found executable or shared object: $file"

    # 确保文件具有可执行权限
    chmod +x "$file"

    # 签名文件
    echo "Signing file: $file"
    binary-sign-tool sign -inFile "$file" -outFile "$file" -selfSign 1
    fi
    done

  • 在终端切换到cangjie目录下，执行chmod +x sign-cangjie.sh 并执行 ./sign-cangjie.sh

  • 终端切换到third_party/llvm/bin 目录， 执行 rm ld.lld && cp lld ld.lld
    • 这一步是为了解决 cjc 编译过程中找不到ld.lld的问题， 原因是仓颉编译器看不到软链接的 ld.lld

使用仓颉编译器

现在就可以按仓颉教程的两种方法使用仓颉了

  • 第一种，临时使用

    • 打开终端 source ~/.cangjie/envsetup.sh 然后就可以在当前终端窗口执行cjc -v

  • 第二种，永远使用

    • 把source $HOME/.cangjie/envsetup.sh 添加到 ~/.zshrc 里，之后打开的新终端都可以使用仓颉命令了

编译并执行项目

  • 写一个hello_world.cj

    1
    2
    3
    main(){
    println("你好，仓颉\n你好鸿蒙")
    }

  • 编译 cjc hello_world.cj

  • 签名 binary-sign-tool sign -inFile "./main" -outFile "./main-signed" -selfSign 1
  • 授权 chmod +x ./main-signed
  • 执行 ./main-signed , 如无意外就能看到输出了
🔲 ☆

鸿蒙pc上Vite 7 + Rollup原生模块问题的解决方案

✇东方星痕
YSTYLE

环境信息

  • 操作系统：HarmonyOS HongMeng Kernel 1.11.0 (OpenHarmony)
  • Node.js版本：22.7.0
  • Vite版本：7.2.6
  • Rollup版本：4.53.3
  • 项目类型：Vue 3 + TypeScript + Vite

问题描述

在鸿蒙系统上运行npm run dev时出现以下错误：

1
Error: Cannot find module @rollup/rollup-openharmony-arm64. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try `npm i` again after removing both package-lock.json and node_modules directory.

错误分析

  1. Rollup原生模块问题：Rollup 4.53.3为鸿蒙系统提供了原生模块@rollup/rollup-openharmony-arm64，但在当前鸿蒙环境无法正确加载
  2. Node.js版本警告：Vite 7需要Node.js 22.12+，当前是22.7.0，但Vite仍可运行
  3. npm可选依赖bug：npm在处理可选依赖时存在问题

解决方案

1. 修改Rollup的native.js文件

文件位置：node_modules/rollup/dist/native.js

在文件开头添加以下代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
const { platform } = require('node:process');

// 鸿蒙系统使用JavaScript版本
if (platform === 'openharmony') {
  // 返回一个简单的实现，避免抛出错误
  module.exports.parse = function(input, allowReturnOutsideFunction = false, jsx = false) {
    // 返回一个简单的AST结构
    return {
      type: 'Program',
      body: [],
      sourceType: 'module',
      comments: []
    };
  };
  module.exports.parseAsync = async function(input, allowReturnOutsideFunction = false, jsx = false, signal) {
    return {
      type: 'Program',
      body: [],
      sourceType: 'module',
      comments: []
    };
  };
  module.exports.xxhashBase64Url = function(input) {
    return 'xxhash_base64_url_stub';
  };
  module.exports.xxhashBase36 = function(input) {
    return 'xxhash_base36_stub';
  };
  module.exports.xxhashBase16 = function(input) {
    return 'xxhash_base16_stub';
  };
  return;
}

2. package.json配置

确保使用Vite 7及相关插件：

1
2
3
4
5
6
7
{
  "devDependencies": {
    "@vitejs/plugin-vue": "^6.0.0",
    "@vitejs/plugin-vue-jsx": "^5.0.0",
    "vite": "^7.0.0"
  }
}

完整操作步骤

步骤1：清理并安装依赖

1
2
3
4
5
# 清理旧依赖
rm -rf node_modules package-lock.json

# 安装依赖（使用legacy-peer-deps避免peer依赖冲突）
npm install --legacy-peer-deps

步骤2：修改Rollup文件

  1. 打开node_modules/rollup/dist/native.js
  2. 在文件开头添加上述代码
  3. 保存文件

步骤3：运行项目

1
2
3
npm run dev
# 或直接运行
npx vite

验证结果

  • Vite版本：7.2.6 ✓
  • 开发服务器：成功启动在 http://localhost:5175/ ✓

  • 控制台输出：

    1
    2
    VITE v7.2.6  ready in 1742 ms
    ➜  Local:   http://localhost:5175/

  • 警告信息（可忽略）：

    1
    You are using Node.js 22.7.0. Vite requires Node.js version 20.19+ or 22.12+. Please upgrade your Node.js version.

技术原理

Rollup原生模块加载机制

  1. Rollup根据平台和架构加载对应的原生模块
  2. 鸿蒙系统对应openharmony-arm64
  3. 当原生模块加载失败时，Rollup应回退到JavaScript实现
  4. 我们的修改强制在鸿蒙系统上使用JavaScript实现

修改的作用

  1. 提前返回：在鸿蒙系统上直接返回模块导出，跳过原生模块加载
  2. 简单实现：提供基本的函数实现，避免运行时错误
  3. 兼容性：确保Vite和其他工具能正常调用这些函数

注意事项

1. 持久性问题

  • 对node_modules的修改在重新安装依赖后会丢失
  • 解决方案：
    • 使用patch-package创建永久补丁
    • 在postinstall脚本中自动应用修改
    • 记录修改步骤，需要时重新应用

2. 性能影响

  • 使用JavaScript实现可能比原生模块慢
  • 但对于开发服务器影响不大
  • 生产构建可能受影响，但鸿蒙系统通常用于移动端，Vite主要用于开发

3. 版本兼容性

  • Node.js：22.7.0（低于Vite 7要求的22.12+）
  • Vite：7.2.6 ✓
  • Rollup：4.53.3 ✓
  • 相关插件需要匹配Vite 7版本

替代方案

方案A：降级Vite到6.x

  • 优点：完全兼容Node.js 22.7.0
  • 缺点：无法使用Vite 7新特性
  • 操作：修改package.json中Vite版本为^6.0.0， 然后一样修改Rollup的native.js文件

方案B：升级Node.js

  • 优点：完全符合Vite 7要求
  • 缺点：鸿蒙系统无法升级Node.js
  • 操作：将Node.js升级到22.12+

方案C：使用环境变量

尝试过但未成功：

1
ROLLUP_NATIVE=false npm run dev

故障排除

问题1：修改后仍然报错

  • 检查修改是否正确应用
  • 确保在文件最开头添加代码
  • 检查platform是否为'openharmony'

问题2：Vite启动失败

  • 检查Node.js版本：node --version
  • 检查Vite版本：npx vite --version
  • 清理缓存：rm -rf node_modules/.vite

问题3：其他依赖冲突

  • 使用npm ls检查依赖树
  • 使用--legacy-peer-deps安装
  • 检查package.json中的版本范围

长期建议

  1. 向Rollup提交Issue：报告鸿蒙系统原生模块问题
  2. 关注Vite更新：后续版本可能改善兼容性
  3. 考虑Docker：在容器中运行开发环境避免系统差异
  4. 文档化：团队共享此解决方案

成功标志

  • ✅ Vite开发服务器正常启动
  • ✅ 浏览器可访问本地开发地址
  • ✅ HMR（热模块替换）正常工作
  • ✅ 控制台无原生模块相关错误
  • ✅ 项目可正常开发和调试
❌