# @geastack/core 中文文档

规范地址：https://npmcn.com/package/%40geastack/core/

版本：0\.1\.50
npm 元数据更新时间：2026-11-12T02:18:53.241Z
中文译文更新时间：2026-11-16T01:30:00.987Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40geastack/core
原文对照：https://npmcn.com/package/%40geastack/core/?lang=original
项目主页：https://github.com/geastack/core#readme
源码仓库：https://github.com/geastack/core

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

- 包体积（解压后）：877 kB，97 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19
- 运行依赖：10 个
- 首次发布：2026-09-20T03:20:53.920Z
- 最新版本发布：2026-11-12T02:18:52.803Z
- 近 30 天下载量：2782（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：51（近 12 个月 51 个）

## 中文简介

GeaStack app API,反应头,运行时源,以及类型声明.

## 安装

```sh
npm install @geastack/core
```

也可以使用：`pnpm add @geastack/core`、`yarn add @geastack/core`、`bun add @geastack/core`

## README

# @ geastack/ core (简体中文)

GeaStack API:Gea JSX元素的申报类型, 样式和事件、 TypeScript 运行时帮助器和 C++ 框架 运行时每个本地目标都会编译入.

```sh
npm install @geastack/core
```

## 如何使用

Apps 导入类型和运行时间模块 :

```tsx
import type { Style } from "@geastack/core";
import { View, Text } from "@geastack/engine";
```

套件中的其他一切都被工具所消耗,而不是应用代码所消耗. 这个 `gea` CLI 和每个目标的构建脚本解析 `@geastack/core` 从 应用程序 `node_modules`,读取其源代码以了解哪些框架源 并包含要编译的根并运行它的构建驱动程序,该驱动程序将应用程序捆绑 与 Vite 一起编译 `geatsc` 和 Gea 插件,并交出所排放的 C++到目标.

## 组件启动

使用 `@geastack/core` 用于针对本地 GeaStack 主机的应用程序. `Component` 是组件基础; `ReactiveComponent` 制造自己的田地 反应,和 `Store` 拥有共同的反应状态。 网络目标提供 匹配浏览器运行时间。 直接使用 `@geajs/core` 属于 Gea 网络 框架,而不是本地申请合同.

开始装入数据或绘图 `onAfterRender()`。组件的 `el` 设定 在这钩子跑之前 场面初始化和构造器初始化状态; 需要制成帆布的代码属于钩子.

```tsx
import { ReactiveComponent } from "@geastack/core";

class Counter extends ReactiveComponent {
  count = 0;
  onAfterRender(): void {
    this.count = 1;
  }
  template(): JSX.Element {
    return <div>{this.count}</div>;
  }
}
```

编译器/运行时间回归应使用通用语言或框架案例. 报告编译器问题 `geastack/compiler`,主机 API 和应用程序运行时间 问题 `geastack/core`,苹果渲染/装入 `geastack/apple`网络 目标整合 `geastack/simulator`1\. 捐款应包括: 复制和特定目标验证。 生命周期和代表性 需要改变,以保留共有部分和本地类型的合同.

## 本地 WebSocket 连接头

`@geastack/core` 0.1.41和1个 `@geastack/host` 1.1.16 增加可选第三项 ESP32 本地主机上连接头的 WebSocket 构建器参数 :

```ts
const socket = new WebSocket("wss://api.openai.com/v1/live/sessions", "", {
  headers: [
    { name: "Authorization", value: `Bearer ${process.env.OPENAI_API_KEY}` },
  ],
});
```

当服务需要无记名认证时使用这些配对版本或更新版本 在 WebSocket 握手。 页眉名称和值在 连接开始 。 浏览器 WebSockets 中没有此本地选项 .

## 文件支持的本地资产

原生应用程序可以将图像和烤制的字体图集保存在一个挂载的音量上取而代之 在可执行文件。 通过应用程序列表选择 :

```json
{
  "gea": {
    "embeddedAssets": {
      "storage": { "type": "file", "directory": "/nand" }
    }
  }
}
```

发电机发送内容地址 `.bin` 有效载荷和a `.assets.json` 在每个生成的 C++ 源旁显示部署 。 复制每个 `local` 文件 联合国 `remote` 路径,例如 `gea devctl push`在启动应用程序之前. 目标必须登记挂载提供者;ESP32目标也需要外部BSS 启用 。 运行时间读取并验证整个捆绑一次成为永久 RAM缓冲器. 渲染时图像和字体检查使用这些缓冲器, 没有文件 I/O. 丢失、截断或腐败的捆绑被拒,直到下一个过程 开始 在需要硬软件回滚时保留旧的已处理内容的文件. 没有此选项的应用程序继续将其资产嵌入可执行文件 .

## 物理按钮

棋盘按钮将应用作为关键事件,以按钮命名 :

```tsx
<div onKeyDown={e => { if (e.code === 'Boot') openMenu() }}
     onKeyUp={e => { if (e.code === 'Power') confirm() }} />
```

`e.code` 是 PascalCase 中的丝屏名称(`'Boot'`, (中文(简体) ), `'Power'`) (中文(简体) ). `e.key` 财务报告和审定财务报表 `e.keyCode` 是按钮的默认密钥别名( BOOT 是 `Escape`27和PWR是: `Enter`13 在Waveshare S3板上),所以只处理密钥的应用程序仍然 每个板子都有工作. `Buttons` 列出董事会在任何媒体前掌握的情况:

```ts
import { Buttons } from '@geastack/core'
for (let i = 0; i < Buttons.count(); i++) console.log(Buttons.code(i), Buttons.key(i))
Buttons.pressed('Boot') // held right now?
Buttons.pin(0)           // its GPIO, or -1 for a PMU power key
```

按钮被宣布为JSON. 董事会将自己的名单列在 `buttons`,在其 `targets.json` 条目,其构成的董事会定义,或 `boards.json`数字 :

```json
"buttons": [
  { "code": "Boot",  "pin": 0,  "activeLevel": 0, "key": "Escape" },
  { "code": "Power", "source": "pmu", "key": "Enter" }
]
```

应用程序在其名称中添加、更改或删除按钮 `package.json`每张 董事会`gea.targets.esp32.buttons`或为一个 (单位:千美元)`gea.targets.esp32.boards.<id>.buttons`) (中文(简体) ). 例如,对按钮使用此选项 接通了头针 :

```json
"gea": { "targets": { "esp32": {
  "buttons": [
    { "code": "Fire", "pin": 14, "activeLevel": 0, "key": "Enter" },
    { "code": "Power", "remove": true }
  ]
} } }
```

`pin` 是GPIO的号码. `activeLevel` 指针在按钮时读取的级别 被持有( 默认 0); 活动下键得到内部拉出, a 活动高一,拉倒. `key` 按钮所在的网络密钥名称 用于,也设定 `keyCode`; 给 `keyCode` 仅用于普通字以外的密钥 设置. `"source": "pmu"` 是 AXP2101 电源键。 建筑检查每一个条目和 命名错误的字段.

GPIO按钮被中断驱动:一个任务解开每个边缘. 按钮是 只有在记录上显示 `"poll": true`,例如,一个针 打断了别的东西 AXP2101 电源密钥在板上投票 离开 PMU 的 IRQ 指针不连接,因为它没有中断等待。 A 类 RESET键是芯片的启用行,没有软件能看到.

按下键加入命令的硬件键队列,帧循环已经排出. 他们 透出UI树的气泡,并聚焦和 `preventDefault` 用于任何密钥. `code` 财务报告和审定财务报表 `key` 在事件上是简单的本土字符串,所以没有被框框.

## 数字针: `Gpio` 财务报告和审定财务报表 `Digital`

二行行行并取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取. 使用您喜欢的任意一种;它们是两个TS 前端通过一个本地后端( u)`host/gpio.h`, (中文(简体) ), `host/gpio.cpp`)和行为 同样的方式在下面.

-   `Gpio` 是 GeaStack 类: 字符串选项,布尔级别,以及一个 `onChange(value)` 调用.
-   `Digital` 是带有Moddable模式编号的ECMA-419 Digital IO类. 为另一个ECMA-419主机编写的代码运行不变.

```ts
import { Digital, Gpio } from '@geastack/core'

// Gpio
const led = new Gpio(2, { mode: 'output' })
const key = new Gpio(14, {
  pull: 'up',
  onChange: (high) => led.write(!high), // pressed pulls the pin low
})

// ECMA-419 Digital
const button = new Digital({
  pin: 15,
  mode: Digital.InputPullUp,
  edge: Digital.Rising | Digital.Falling,
  onReadable() {
    console.log(this.read()) // `this` is the Digital
  },
})
```

### 默认中断

带有回调的输入被中断驱动. 针的边缘打断了 除了标出钉子 回调在启动时运行在应用线索上 下个框架:待决微任务之后,在 `requestAnimationFrame` 召回电话。 因此,它在同一框架内作出改变。 几个 一个框架的边缘发出一个呼叫。 回调读取级别为 时刻,所以它总是看到 针现在在哪里.

投票,通过 `poll: <milliseconds>`,比如说,一个吵吵的行你 宁可抽取样本 也不要打断 投票还覆盖一个平台或针头 没有边缘中断; 这样的指针每帧读取一次.

```ts
new Gpio(14, { pull: 'up', onChange, poll: 20 })
new Digital({ pin: 15, mode: Digital.Input, edge: Digital.Falling, onReadable, poll: 20 })
```

没有调试;调用时会读取关卡.

-   `Gpio` 两个边( 默认时为 `onChange` 报告 只有真正的变化,所以一个回放 回到它开始报告的地方 没什么.
-   当一个边缘报告 已经稳定在那个边缘的水平上 高额 `rising`,低为 `falling`。 。 。 .
-   `Digital` 电话 `onReadable` 每帧看到边缘一次,它要求 为,和 `this.read()` 给出关卡.

### `Gpio`

`new Gpio(pin, options?)` 如果无法打开,则打开指针并投出。 那个 芯片没有针头 已经打开的针头 或 目标没有GPIO.

| 选项 | 数值 | 默认 |
| --- | --- | --- |
| `mode` | `'input'`, (中文(简体) ), `'output'`, (中文(简体) ), `'openDrain'` | `'input'` |
| `pull` | `'none'`, (中文(简体) ), `'up'`, (中文(简体) ), `'down'`, (中文(简体) ), `'both'` (投入) | `'none'` |
| `edge` | `'none'`, (中文(简体) ), `'rising'`, (中文(简体) ), `'falling'`, (中文(简体) ), `'both'` | `'both'` 何时 `onChange` 被赋予,否则 `'none'` |
| `onChange` | `(value: boolean) => void` | 无 |
| `poll` | 毫秒 | 中断 |

方法:

-   `read()` 返回关卡;对于一个输出,它所驱动的关卡.
-   `write(value)` 驱动输出 。 它投出一个输入.
-   `close()` 释放出针头并打断它。 紧紧地从胸针的里面 允许自己召回.
-   `pin` 拿着接号.

旧的静态电话 `Gpio.configureOutput(pin)`, (中文(简体) ), `Gpio.configureInput(pin, pullUp)`, (中文(简体) ), `Gpio.write(pin, level)` 财务报告和审定财务报表 `Gpio.read(pin)` 还在工作。 他们回答 "这板是用布林来做而不是扔".

### `Digital` (ECMA-419)

`new Digital({ pin, mode, edge?, onReadable?, target?, format?, poll? })`。 。 。 .

-   **模式 :** `Digital.Input`, (中文(简体) ), `InputPullUp`, (中文(简体) ), `InputPullDown`, (中文(简体) ), `InputPullUpDown`, (中文(简体) ), `Output` 财务报告和审定财务报表 `OutputOpenDrain`。 。 。 .
-   **边缘 :** `Digital.Rising` 财务报告和审定财务报表 `Digital.Falling`两者都在一起. `edge` 必须使用 `onReadable`,而输出不需要边缘.
-   **方法:** `read()` 返回 0或1, `write(0 | 1)` 驱动输出,以及 `close()` 释放出针.
-   **`target`数字 :** 保持为 `this.target` 为召回。 它的类型来自 价值你通过,所以它保持本土.
-   **`format`数字 :** 仅限 `'number'` 被支持.
-   **`poll`数字 :** a GeaStack分机;见上文.

投弃选项 `RangeError`正如标准所说的 一个不可能是 打开的掷出 `Error`。 。 。 .

### 董事会按钮

棋盘声明为按钮的指针(见上文)也可以作为 输入,用于需要级别而非关键事件的应用程序. 针接住 按钮本身的设置和中断, 所以关键事件不断到达. `Buttons.pin(i)` 告诉你是哪个GPIO的按钮。 一个民意调查的按钮的指针是 民意调查 `Gpio`编号 :`Digital` 我也一样.

### 针头能用的地方

ESP32目标通过ESP-IDF驱动真接针,可同时打开最多32个接针. 在其他目标(桌面,移动,模拟器)上没有GPIO. 那边, `new Gpio()` 财务报告和审定财务报表 `new Digital()` 扔出,静态调用返回假。 一个 想要同时运行的应用程序会发现错误 .

## 相关软件包

-   `@geastack/engine` 使元素树, `@geastack/host` 供应 平台服务, `@geastack/elements` 添加非内相元素.
-   `@geastack/geatsc-plugin-gea` 这是 `geatsc` 后端为构建驱动程序负载 .
-   `@geastack/compiler` 实值 `geatsc` 自己来.

## 许可证

阿帕奇2.0 (英语). 见 `LICENSE`。 。 。 .

## 常见问题

### @geastack/core 是什么？

GeaStack app API,反应头,运行时源,以及类型声明\.

### 如何安装 @geastack/core？

在项目目录运行 npm install @geastack/core，或使用 pnpm add / yarn add / bun add。

### @geastack/core 支持 TypeScript 吗？

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

### @geastack/core 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @geastack/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @geastack/core 可以商用吗？

@geastack/core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @geastack/core 的下载量有多少？

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

### @geastack/core 还在维护吗？

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

