@ geastack/ core (简体中文)
GeaStack API:Gea JSX元素的申报类型, 样式和事件、 TypeScript 运行时帮助器和 C++ 框架 运行时每个本地目标都会编译入.
npm install @geastack/core
如何使用
Apps 导入类型和运行时间模块 :
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 设定
在这钩子跑之前 场面初始化和构造器初始化状态;
需要制成帆布的代码属于钩子.
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/simulator1. 捐款应包括:
复制和特定目标验证。 生命周期和代表性
需要改变,以保留共有部分和本地类型的合同.
本地 WebSocket 连接头
@geastack/core 0.1.41和1个 @geastack/host 1.1.16 增加可选第三项
ESP32 本地主机上连接头的 WebSocket 构建器参数 :
const socket = new WebSocket("wss://api.openai.com/v1/live/sessions", "", {
headers: [
{ name: "Authorization", value: `Bearer ${process.env.OPENAI_API_KEY}` },
],
});
当服务需要无记名认证时使用这些配对版本或更新版本 在 WebSocket 握手。 页眉名称和值在 连接开始 。 浏览器 WebSockets 中没有此本地选项 .
文件支持的本地资产
原生应用程序可以将图像和烤制的字体图集保存在一个挂载的音量上取而代之 在可执行文件。 通过应用程序列表选择 :
{
"gea": {
"embeddedAssets": {
"storage": { "type": "file", "directory": "/nand" }
}
}
}
发电机发送内容地址 .bin 有效载荷和a .assets.json
在每个生成的 C++ 源旁显示部署 。 复制每个 local 文件
联合国 remote 路径,例如 gea devctl push在启动应用程序之前.
目标必须登记挂载提供者;ESP32目标也需要外部BSS
启用 。 运行时间读取并验证整个捆绑一次成为永久
RAM缓冲器. 渲染时图像和字体检查使用这些缓冲器, 没有文件
I/O. 丢失、截断或腐败的捆绑被拒,直到下一个过程
开始 在需要硬软件回滚时保留旧的已处理内容的文件.
没有此选项的应用程序继续将其资产嵌入可执行文件 .
物理按钮
棋盘按钮将应用作为关键事件,以按钮命名 :
<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 是 Escape27和PWR是:
Enter13 在Waveshare S3板上),所以只处理密钥的应用程序仍然
每个板子都有工作. Buttons 列出董事会在任何媒体前掌握的情况:
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数字 :
"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) (中文(简体) ). 例如,对按钮使用此选项
接通了头针 :
"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主机编写的代码运行不变.
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>,比如说,一个吵吵的行你
宁可抽取样本 也不要打断 投票还覆盖一个平台或针头
没有边缘中断; 这样的指针每帧读取一次.
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。 。 。 .