# @glassly/engine 中文文档

规范地址：https://npmcn.com/package/%40glassly/engine/

版本：0\.4\.3
npm 元数据更新时间：2026-11-17T06:21:32.373Z
中文译文更新时间：2026-11-17T06:22:39.999Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40glassly/engine
原文对照：https://npmcn.com/package/%40glassly/engine/?lang=original
项目主页：https://github.com/tetramo-labs/glassly/tree/dev/mobile/modules/engine#readme
源码仓库：https://github.com/tetramo-labs/glassly

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9.2 MB，1388 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：13 个
- peer 依赖：expo \>=55\.0\.0，axios \*，react \*，zustand \*，expo-audio \>=55\.0\.0，expo-device \>=55\.0\.0，@types/react \*，expo-battery \>=55\.0\.0，react-native \*，expo-calendar \>=55\.0\.0，expo-location \>=55\.0\.0，expo-clipboard \>=55\.0\.0，expo-constants \>=55\.0\.0，expo-file-system \>=55\.0\.0，react-native-svg \*，react-native-udp \*，expo-modules-core \>=55\.0\.0，expo-task-manager \>=55\.0\.0，react-native-mmkv \*，expo-notifications \>=55\.0\.0，react-native-share \*，react-native-localize \*，react-native-worklets \>=0\.7\.4 \<1，expo-image-manipulator \>=55\.0\.0，react-native-blob-util \*，react-native-executorch \>=0\.11\.0 \<0\.12，react-native-reanimated \>=4\.2\.1 \<5，react-native-ble-manager \*，react-native-permissions \*，react-native-wifi-reborn \*，react-native-zip-archive 9\.5\.3，react-native-nitro-modules \*，@dr\.pogodin/react-native-fs \*，react-native-nitro-bg-timer \*，@craftzdog/react-native-buffer \*，react-native-safe-area-context \*，@react-native-community/netinfo \*
- 首次发布：2026-08-23T23:30:35.737Z
- 最新版本发布：2026-11-17T06:21:32.140Z
- 近 30 天下载量：54768（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：559（近 12 个月 559 个）

## 中文简介

Glassly Engine——微型应用程序注册、WebView桥和微型应用程序商店

## 安装

```sh
npm install @glassly/engine
```

也可以使用：`pnpm add @glassly/engine`、`yarn add @glassly/engine`、`bun add @glassly/engine`

## README

# @ glassly/ engine (英语)

Glassly Engine – 开机小程序库.

## 安装

```sh
npm install @glassly/engine
```

> **同伴软件包 :** 发动机的 `@glassly/*` 相对依赖关系( e)`crust`, (中文(简体) ), `cloud-client`, (中文(简体) ), `cloud-protocol`, (中文(简体) ), `miniapp`必须可供您使用 软件包管理器。 直到每个端点发布到 npm, 消耗引擎 由这个 monorepo 的工作空间( 如 OEM app 的例子) .

> **模块格式 :** 已公布的切入点目标 **原生反应 / 地铁** 消费者 `react-native` 出口条件)。 正在装入 `@glassly/engine` 从平原节点( R)`require`/ESM)不支持在0.1.x- 页:1 `default` 条件的构建产出是无延伸进口的无害环境管理和 无法在节点装货机下解决.

## 入境点

该软件包暴露其引擎入口和一个被支持的蓝牙 SDK 外观( 宣告于 `package.json` `exports`, (中文(简体) ), 与 `react-native` 条件指向 `src/` 所以,地铁,TSC和笑话 解析活字类型脚本源 :

-   **`@glassly/engine`** (主要项目, `src/index.ts`——OEM表面: `engine` 命名空间( n)`configure`编号 :`start`编号 :`stop` + 输入域外观, , 合同/读取模型类型,以及主机 UI 的纯助手 (单位:千美元)`decideReconnect`, (中文(简体) ), `deriveDisplayState`,则 `useApps`\- 式的钩子, OTA政策常数,硬件能力表, `BgTimer`) (中文(简体) ). 判决规则: 读取模型、命令、纯函数和类型为主; 任意 突变运行时态或显示商店/服务不是.
-   **`@glassly/engine/ota`** (单位:千美元)`src/react/index.ts`)——完整的"门特拉活"OTA 控制器加上其库存全屏幕渲染器. `useMentraLiveOta` 拥有 检查、热点或Wi-Fi安装、APK/MTK/BES进度、重启、重试和最后 核查行为. `MentraLiveOtaFlow` 做同样的公共钩子.
-   **`@glassly/engine/bluetooth-sdk`** (单位:千美元)`src/bluetooth-sdk/index.ts`()—— 完全公用蓝牙SDK表面,不带包装再出口,所以 具有与 `@glassly/bluetooth-sdk`。获得支持者 SDK 软件 `react`, (中文(简体) ), `types`, (中文(简体) ), `photo-receiver`, (中文(简体) ), `ota-transport`,以及 `debug` 子路径被镜像 沿着这条路走 SDK的车 `internal` 进入点是故意不暴露的.

见 `cloud/docs/issues/020-glasses-status-boundary/integration-review.md` §D 对于被烧毁的计划.

这个模块拥有小应用程序逻辑和处理的部件,这些部件与 管理程序的其他部分: WebView 消息总线,内存运行 登记,和JS全球 我们注入每一个微型应用WebView.

目标是让所有小型应用逻辑 都随着时间而存在 今天的动作是 递增——只有自成一体的服务有所移动. 交叉 服务(LocalMiniappRuntime、MantleManager、作曲家安装管道) 住在楼下 `mobile/src/` 因为他们回到经理的店里 插头.

## 公众表面

```ts
import {engine, decideDevLaunchRoute} from "@glassly/engine"
import BluetoothSdk from "@glassly/engine/bluetooth-sdk"
```

-   `decideDevLaunchRoute` ——飞行前的dev URL's `miniapp.json` 决定 要挂载直播还是将用户带入离线屏幕.

### Mentra 活 OTA 流量

只使用蓝牙主机可以不配置或启动而使OTA流 经认证的云连接或微型应用程序运行时间 :

```tsx
import {MentraLiveOtaFlow} from "@glassly/engine/ota"
;<MentraLiveOtaFlow onFinished={() => setShowOta(false)} onOpenWifiSetup={() => setShowWifiSetup(true)} />
```

组件只开始眼镜状态和OTA预测. 一个东道主 已调用 `engine.start()` 应该通过 `initializeRuntime={false}`显示 在Mentra Live连接之后的流量。 主机必须提供 `onOpenWifiSetup`· ; 流只引用给无法提供OTA热点的老眼镜 运输.

需要不同页面的应用程序可以直接使同一控制器:

```tsx
import {useMentraLiveOta} from "@glassly/engine/ota"

const ota = useMentraLiveOta({onFinished, onOpenWifiSetup})
// Render ota.state.screen and invoke ota.install(), retryInstall(), finish(), etc.
```

打开 `up_to_date`,使用时 `ota.state.completedUpdate` 以区分已完成的 从独立检查中更新会话. `releaseTransition` 是可选释放 元数据,而不是一个完成标记.

只自定义演示文稿 。 发动机必须负责OTA订购, 热点中转 重启恢复 复试 核查 峡谷 库存和自定义集成指南 [更新 Mentra 直播](https://docs.glassly.com/bluetooth-sdk/software-update)。 。 。 .

释放的引擎包包含一个字面上不可变的OTA显示的URL和 SHA-256由协调放出CI生成. 现代眼镜显示选择 是开发者覆盖,主机-应用程序发布指针,然后是引擎发布指针。 没错 不从蓝牙 SDK 版本获取 URL 或掉入一个 眼镜报告或可变生产 URL。 未绑定的源建有OTA 禁用, 除非 Expo/ react 本地主机明确设置 `EXPO_PUBLIC_ASG_OTA_VERSION_URL`; 本地源主机使用蓝牙SDK 调试 `setOtaVersionUrl` 表面。 39号前的眼镜保留着各自的遗产 路径,因为这些客户端忽略了电话发送的 URL.

## 电话通知

`engine.phoneNotifications` 拥有每个主机的通知策略. 抓取(Android的收听器,或读取电话流的眼镜)永远不会 被它挡住了 演示每个活动有一个主人翁,从 `presentationOwner(hostActive)`数字 :

-   `viewer` ——引擎通知页,在相接的玻璃CFW眼镜上
-   `firmware` - 眼镜,其固件提出通知 (单位:千美元)`hasNativeNotifications`;在Android上,主持人将活动交给 `uploadToGlasses(event)`在iOS上,眼镜已经有它了
-   `host` ——主持人自己的名片和语音,而其表面(通知)运行
-   `none` - 通知被取消,或者没有东西给他们看

Miniapp转发不是演示文稿, 并且保持独立 .

四个设置驱动固件和查看器: `notifications_enabled`, (中文(简体) ), `notifications_popups`, (中文(简体) ), `notifications_popup_seconds` (0 = 主讲人 默认)和 `notifications_hold_during_apps`,加上共享 `notifications_blocklist` 和电话活动门 `notifications_ignore_while_active`。 。 。 . `PhoneNotificationsSync` 折叠成 一个 `GlassesNotificationConfig` 并把它通过蓝牙SDK 每一个变化和每一个连接; 纯映射生活在 `services/notifications/notificationPolicy.ts`。 。 。 . `captureAuthorization()` 告诉设置 UI 眼镜是否可以读取电话通知 (单位:千美元)`not_needed` - 电话捕获地点; `popupSecondsOptions()` 列出 延长连接固件接受时间.

`notifications_batch_seconds` (0=关闭)是观众独处的:从 一个应用程序一旦静了那么久 最多一分钟 在第一次通知之后,在一张摘要卡后面.

## 进口

内部 `mobile/modules/engine/src/`,使用时 **相对路径** (单位:千美元)`./services/...`, (中文(简体) ), `../utils/...`) (中文(简体) ). 移动应用程序 `@/*` 不在此配置别名—— 那里 此模块没有构建时路径重写 .

## 测试

运行套房与 `bun run test` (出自本目录). 执行 `scripts/test.sh`,运行中 **每个测试文件在自己的包子进程中** - 这样做 不取而代之的是单曲 `bun test src`。 。 。 .

为什么:包子 `mock.module` 将一个全流程模块登记册与活性连接 ESM绑定,最后写取胜. 几间套房都嘲笑着同样的规格 (单位:千美元)`"@glassly/bluetooth-sdk/internal"` 一个人被嘲笑 `audioTestMocks.ts`, (中文(简体) ), `PhonePhotoCoordinator.test.ts`因此,在一个共同进程中 档案的嘲弄性打击 别人的和套房 独自通过失败在 合并运行。 每个文件进程都给每个套房一个孤立的登记册.

同样的规则适用于书面测试: `mock.module` 任意 指定您的套房需求, 但永远不要依赖一个安装的模拟器 _不同_ 测试文件——每个文件必须设置它导入的所有文件.

## 常见问题

### @glassly/engine 是什么？

Glassly Engine——微型应用程序注册、WebView桥和微型应用程序商店

### 如何安装 @glassly/engine？

在项目目录运行 npm install @glassly/engine，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：expo（\>=55\.0\.0）、axios（\*）、react（\*）、zustand（\*）、expo-audio（\>=55\.0\.0）、expo-device（\>=55\.0\.0）、@types/react（\*）、expo-battery（\>=55\.0\.0）、react-native（\*）、expo-calendar（\>=55\.0\.0）、expo-location（\>=55\.0\.0）、expo-clipboard（\>=55\.0\.0）、expo-constants（\>=55\.0\.0）、expo-file-system（\>=55\.0\.0）、react-native-svg（\*）、react-native-udp（\*）、expo-modules-core（\>=55\.0\.0）、expo-task-manager（\>=55\.0\.0）、react-native-mmkv（\*）、expo-notifications（\>=55\.0\.0）、react-native-share（\*）、react-native-localize（\*）、react-native-worklets（\>=0\.7\.4 \<1）、expo-image-manipulator（\>=55\.0\.0）、react-native-blob-util（\*）、react-native-executorch（\>=0\.11\.0 \<0\.12）、react-native-reanimated（\>=4\.2\.1 \<5）、react-native-ble-manager（\*）、react-native-permissions（\*）、react-native-wifi-reborn（\*）、react-native-zip-archive（9\.5\.3）、react-native-nitro-modules（\*）、@dr\.pogodin/react-native-fs（\*）、react-native-nitro-bg-timer（\*）、@craftzdog/react-native-buffer（\*）、react-native-safe-area-context（\*）、@react-native-community/netinfo（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @glassly/engine 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @glassly/engine 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @glassly/engine 可以商用吗？

@glassly/engine 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @glassly/engine 的下载量有多少？

根据 npm 官方下载统计，@glassly/engine 在 2026/10/17 – 2026/11/15 这 30 天内被下载 54,768 次，日均约 1,826 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @glassly/engine 还在维护吗？

最新版本 0\.4\.3 发布于 2026/11/17（今天）；至今共发布 559 个版本，其中过去 12 个月发布了 559 个；首次发布于 2026/08/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

