@glassly/engine

中文文档
0.4.3发布于 2026/11/17MITTypeScriptCommonJS近 30 天下载 5.5万

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

中文使用文档
文档目录7 节
  1. 安装
  2. 入境点
  3. 公众表面
  4. Mentra 活 OTA 流量
  5. 电话通知
  6. 进口
  7. 测试

@ glassly/ engine (英语)

Glassly Engine – 开机小程序库.

安装

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/ 因为他们回到经理的店里 插头.

公众表面

import {engine, decideDevLaunchRoute} from "@glassly/engine"
import BluetoothSdk from "@glassly/engine/bluetooth-sdk"
  • decideDevLaunchRoute ——飞行前的dev URL's miniapp.json 决定 要挂载直播还是将用户带入离线屏幕.

Mentra 活 OTA 流量

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

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

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

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

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 直播。 。 。 .

释放的引擎包包含一个字面上不可变的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 共发布 559 个版本,首次发布于 2026/08/24;过去 12 个月发布了 559 个版本。

版本发布日期距今
0.4.3latest2026/11/17今天
0.4.3-beta.1211beta2026/11/17今天
0.4.3-dev.1207dev2026/11/17今天
0.4.3-dev.12062026/11/17今天
0.4.3-dev.12052026/11/17今天
0.4.3-dev.12002026/11/17今天

关于 @glassly/engine 的常见问题

@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 和提交记录判断。