开发文档 / 开始使用
适用环境随时查阅
开始前保留命令与字段英文拼写，便于对照源码和报错
术语速查 →先理解术语的用途，再看具体 API。教程保留接口字段、文件名和命令的英文拼写，方便对照错误信息与源码。
应用开发
| 名称 |
文中用语 |
用途与例子 |
| Host / Guest |
宿主系统 / 应用运行代码 |
Host 提供窗口、存储等服务，Guest 是包内应用代码；不是网络主机与访客账号 |
| SDK / DevKit |
开发接口 / 完整开发工具包 |
SDK 提供 C++ 类型与库；DevKit 还包含编译器、PXADB、模拟器等 |
| manifest |
应用清单 |
package.json 是源码清单；构建后的签名清单描述实际组件、权限、制品与兼容性 |
| artifact |
构建制品 |
某个组件的 Wasm 或指定 CPU 的 AOT 文件 |
| Wasm / AOT |
WebAssembly / 预编译代码 |
Wasm 描述可移植程序，AOT 把它预先编译为目标芯片代码 |
| ABI |
二进制接口约定 |
Core ABI 描述 Guest 与 Host 的接口；AOT 引擎 ABI 描述运行时文件格式，两者分别管理 |
| profile |
设备或显示配置 |
模拟器 Profile 描述屏幕、DPI、形状；商城 Profile 描述 Host 能力，二者不是同一配置文件 |
| dp / DPI |
逻辑尺寸 / 每英寸像素数 |
dp 用于布局，DPI 将其换算为显示像素；不要用窗口缩放冒充真实 DPI 适配 |
| safe area / insets |
安全区 / 安全边距 |
保证文字、按钮不落进圆角或不可触及的边缘；背景仍可画到边缘 |
| watch |
保存后自动重建 |
重建成功后重启 App，不保留应用运行内存 |
| provenance |
构建溯源记录 |
记录工具版本、锁定输入和产物摘要，用来重现问题 |
系统与硬件
| 名称 |
文中用语 |
用途 |
| renderer |
渲染器 |
将界面节点或绘制命令转换为像素 |
| provider |
服务实现 |
产品注册具体实现，让系统或 App 调用统一服务接口 |
| adapter |
适配层 |
在现有驱动或业务 API 与 PXA 接口之间做转换 |
| BSP / board port |
板级支持 / 板级接入接口 |
BSP 驱动实际硬件，board port 把显示和控制能力接给系统 |
| broker / dispatch |
请求路由 / 分发 |
将调用送往对应服务或处理函数 |
| framebuffer / backpressure |
帧缓冲 / 背压 |
前者保存像素；后者限制在途帧，避免排队造成显示延迟 |
| wall clock / monotonic clock |
系统日期时间 / 单调时钟 |
日期时间用于日历显示，单调时钟用于游戏计时与超时，避免校时影响时长 |
发布与验证
| 名称 |
文中用语 |
用途 |
| challenge |
一次性验证串 |
服务端生成随机字符串，发布者用私钥签名证明持有；不是任务或游戏“挑战” |
| proof of possession |
密钥持有证明 |
只上传公钥与验证串签名，私钥留在本机 |
| publisher / lineage |
发布者 / 密钥继承链 |
发布者签名包；继承链允许受控换钥，保持更新身份 |
| release sequence |
发布序号 |
递增整数用于防回滚，与展示版本号分别管理 |
| token / ticket |
授权令牌 / 下载票据 |
令牌授权特定上传；票据提供短时下载地址，都不应写入源码 |
| pending |
待审核 |
上传成功不等于公开上架，需完成对应审核 |
| CSRF token |
跨站请求防护令牌 |
后台表单提供，验证请求来自当前会话；与应用上传令牌不同 |
遇到报错时
保留原始英文报错、完整命令、pxa.lock、实际目标和设备版本。先确认错误属于编译、签名、兼容性、权限还是运行阶段，再看对应教程；不要通过删锁文件或关闭验证掩盖不匹配。