鸿蒙平台运行Lua脚本
1. 目标
使用 rust 在移动端实现 Lua 脚本的运行。
2. 核心步骤
[Rust Host App]│├── [mLua VM] (通过 `mlua` 或 `rlua` 库嵌入)│ ├── 独立Lua状态（隔离执行）│ ├── 受限标准库（禁用危险函数）│ └── 内存/CPU限制│└── [Rust ↔ Lua 互操作]├── 导出Rust函数/结构体到Lua└── 从Lua回调Rust1. Android 和 iOS
-
mlua 对 这两端的实配较为成熟，rust 可自动识别交叉编译工具链
-
只需在 features 中打开
vendored配置即可
# Cargo.toml
[dependencies]
mlua = {version = "0.10.5", features = ["lua54", "vendored"]}2. Harmony
-
下载 Lua 源代码，本次使用的版本是 5.4.7
-
修改 Makefile 文件，一共两个
// Makefile
INSTALL_TOP?= /usr/local// src/Makefile
CC?= gcc -std=gnu99
RANLIB?= ranlib-
执行 make 进行编译
export INSTALL_TOP="$(pwd)/$OUTPUT_DIR"
export CC="$TOOLCHAIN/bin/aarch64-unknown-linux-ohos-clang"
export RANLIB="$TOOLCHAIN/bin/llvm-ranlib"make clean
make generic -j8
make install-
经过上述步骤会生成鸿蒙平台的 .a 库
3. 配置rust工程
-
引入 mlua，和安卓、iOS 不同，这里 features 要选择
module
mlua = { version = "0.10.5", features = ["lua54", "module"] }-
把 .a 文件 copy 到 libs 目录下，并编辑 build.rs
"aarch64-unknown-linux-ohos" => {println!("cargo:rustc-link-search=native=./libs/ohos/arm64-v8a");println!("cargo:rustc-link-lib=static=lua");napi_build_ohos::setup(); } -
编写 napi 方法
#[napi]
fn napi_pi(path: String) -> i64 {init_logger();hook_panic(Some(Box::new(PanicListener)));calculate_pi(path) as i64
}fn calculate_pi(path:String) -> u128 {let start = Instant::now();let script = std::fs::read_to_string(path + "/lua_scripts/pi.lua").expect("Failed to read pi.lua");let lua = Lua::new();// 加载Lua脚本lua.load(&script).exec().expect("Failed to load pi.lua");let test_pi: mlua::Function = lua.globals().get("testPi").expect("Failed to get testPi");let result:bool = test_pi.call((100)).expect("Failed to call pi.lua");start.elapsed().as_millis()
}4. 配置鸿蒙工程
-
把 lua 脚本 copy 到 raw 文件夹中，然后 copy 到沙盒目录
async copyRawFiles(node: string) {const resManager = getContext().resourceManager;const baseDir = `${getContext().getApplicationContext().filesDir}`;const queue = new Queue<string>();queue.add(node);while (queue.length > 0) {const currentNode = queue.pop();try {const bytes = resManager.getRawFileContentSync(currentNode);hilog.info(DOMAIN, 'testTag', `${bytes.length}`);const targetPath = `${baseDir}/${currentNode}`const fileStream = fs.createStreamSync(targetPath, "w+");fileStream.writeSync(bytes.buffer);fileStream.close();} catch (e) {hilog.info(DOMAIN, 'testTag', `${JSON.stringify(e)}`);const targetPath = `${baseDir}/${currentNode}`if (!fs.accessSync(targetPath)) {fs.mkdirSync(targetPath);}const fileList = resManager.getRawFileListSync(currentNode);fileList.forEach((it) => queue.add(`${currentNode}/${it}`));}}
}-
调用 rust napi 方法
import rust from 'liblogic_device_test.so';async executeLuaPi() {const baseDir = `${getContext().getApplicationContext().filesDir}`;let total = 0;for (let i = 0; i < 100; i++) {const time: number = rust.napiPi(`${baseDir}/lua`);total += time;}hilog.info(DOMAIN, 'testTag', `${total}`); }
3. 团队介绍
「三翼鸟数字化技术平台-智家APP平台」通过持续迭代演进移动端一站式接入平台为三翼鸟APP、智家APP等多个APP提供基础运行框架、系统通用能力API、日志、网络访问、页面路由、动态化框架、UI组件库等移动端开发通用基础设施；通过Z·ONE平台为三翼鸟子领域提供项目管理和技术实践支撑能力，完成从代码托管、CI/CD系统、业务发布、线上实时监控等Devops与工程效能基础设施搭建。