使用 MagicScript CLI 构建 Magic Leap 应用：快速上手指南

作者：科采通 标签：Magic Leap、JavaScript、MagicScript、AR开发、WebXR

随着 AR/MR 技术的发展，Magic Leap 作为一款先进的头戴式显示设备，越来越多地被应用于教育、医疗、工业等场景中。除了原生 C++/Unreal/Unity 等开发方式，Magic Leap 还提供了面向前端开发者的 MagicScript 开发框架，让你可以使用 JavaScript 构建原生 AR 应用。

本文将介绍如何使用 magic-script-cli 快速搭建并构建一个 Magic Leap 应用项目。

Magic Leap

一、什么是 MagicScript？

MagicScript 是 Magic Leap 官方推出的一套基于 JavaScript 的 AR 开发框架，运行于设备端的 Lumin Runtime 上。它让 Web 开发者无需学习 C++ 或 Unreal，就可以使用熟悉的 JS + Node.js 工具链，构建沉浸式体验应用。

MagicScript 提供了对空间定位、3D 渲染、手势输入等功能的封装，并通过 Typings 支持 TypeScript 提示。

二、准备开发环境

在开始之前，请确保你已经具备以下环境：

• Node.js ≥ 12
• NPM ≥ 6
• Magic Leap Lumin SDK（可通过 Magic Leap 开发者中心获取）
• 已连接的 Magic Leap 1 设备（或模拟器）

三、安装开发工具

1. 安装 magic-script-cli

npm install -g magic-script-cli

这是用于初始化、构建 Magic Leap 项目的命令行工具。

2. 安装 MagicScript Typings（可选）

用于增强 TypeScript 类型支持：

npm install --save-dev magic-script-typings

四、初始化第一个 MagicScript 项目

执行以下命令初始化一个新项目：

magic-script init

你将依次回答以下问题：

 What is the name of your application? my-typ
? What is the app ID of your application? org.magicscript.typ
? In which folder do you want to save this project? my-typ
? Do you want a Landscape App? Yes

然后进入项目目录：

cd my-typ

五、构建项目

构建你的 Magic Leap 应用：

magic-script build

构建完成后，将在 ./dist 目录生成 .mpk 安装包，类似于 Android 中的 .apk 文件。

六、部署到设备

使用 Magic Leap 的 mladb 工具将构建好的应用部署到设备：

mladb install ./dist/app.mpk
mladb launch com.your.app.id

确保你已开启设备的开发者模式，并连接至开发主机。

七、参考资源

• MagicScript 官网：https://www.magicscript.org
• Typings GitHub 项目：https://github.com/magic-script/magic-script-typings
• NPM CLI 工具：https://www.npmjs.com/package/magic-script-cli

八、总结

MagicScript 提供了一个轻量、灵活且熟悉的方式，让前端开发者能快速切入 Magic Leap AR 应用开发。通过本文介绍的 magic-script-cli 工具，你可以轻松实现项目创建、构建和部署的全流程。

对于熟悉 Web 技术栈的开发者而言，MagicScript 是一条非常友好的入门路径。如果你有 Vue、React 或 Three.js 背景，更可以尝试将这些前端生态整合进 Magic Leap 的开发中，构建更强大的交互式 AR 应用