语言运行时嵌入式物联网编译器【免费下载链接】jerryscriptUltra-lightweight JavaScript engine for the Internet of Things.项目地址https://gitcode.com/gh_mirrors/je/jerryscript点击查看免费下载本文以 docs/07.DEBUGGER.md 为主线系统讲解 JerryScript 远程调试器的整体架构、构建与启动方式、命令行工具用法以及宿主应用中可用的全部调试器 C-API 与扩展传输层实现。读完本文你将掌握如何在 IoT 设备上为 JerryScript 启用 WebSocket/串口调试服务、如何用 Python 客户端控制执行流程以及如何在自己的应用程序中嵌入调试支持。调试器架构Server 与 Client 的双组件模型JerryScript 提供一套远程调试器remote debugger用于调试运行在设备上的 JavaScript 程序。整套系统由两个主要组件构成服务端Server内置于 JerryScript 二进制/库中随目标应用运行在设备端客户端Client独立的调试器应用运行在开发机等资源更充裕的系统上。当前仓库内置一个基于 Python 的调试器客户端位于 jerry-debugger 子目录入口脚本为 jerry-debugger/jerry_client.py。该客户端实现了完整的交互式命令行界面可展示客户端与服务端之间的通信协议细节因此既可以直接用于调试也可以作为参考实现被集成开发环境IDE复用。jerry-debugger/README.md 中列出了官方提供的三类调试工具仓库内的jerry_client.py控制台客户端、IoT.js Code以及 JerryScript 调试器 Chrome Web 工具。协议版本核心头文件 jerry-core/include/jerryscript-debugger.h 中定义了JERRY_DEBUGGER_VERSION (9)客户端与服务端通过该版本号协商协议兼容性。可插拔的传输层设计通信协议的传输层transport layer是可插拔的。目前仓库以 JerryScript 扩展jerry-ext的形式提供了一套基于 WebSocket 的实现通过 TCP/IP 网络传输调试消息源码见 jerry-ext/debugger/debugger-ws.c。此外仓库还实现了Raw Packet 传输jerryx_debugger_rp_create ()见 jerry-ext/debugger/debugger-rp.c串口Serial传输jerryx_debugger_serial_create (const char *config)见 jerry-ext/debugger/debugger-serial.cTCP 传输jerryx_debugger_tcp_create (uint16_t port)见 jerry-ext/debugger/debugger-tcp.c。从源码结构看只要实现对应的传输接口任何可靠的流式stream或数据报datagram协议都可以用来承载调试消息这为连接 UART、蓝牙、CAN 等物理通道提供了扩展空间。构建调试器服务端要让目标二进制包含调试器支持必须显式开启该特性。在仓库根目录执行构建脚本时传入--jerry-debuggeron例如python tools/build.py --jerry-debuggeron未开启该选项时调试器相关代码不会编入产物这也解释了为什么 jerry-main/arguments/options.c 中的check_feature逻辑会在特性被禁用时输出Ignoring ... option because this feature is disabled!的警告。启动与连接调试服务端命令行参数JerryScript 桌面主程序jerry-main/main-desktop.c解析命令行参数并在引擎初始化后启动调试服务。以下是文档给出的三个核心参数参数作用--start-debug-server启动调试服务端等待客户端连接--debugger-wait-source启动后等待客户端下发源代码--log-level 2提升日志级别以看到Waiting for client connection提示信息组合使用示例./build/bin/jerry --start-debug-server --debugger-wait-source --log-level 2除文档列出的参数外jerry-main/arguments/options.c 还定义了以下可选参数便于针对不同物理链路定制调试通道参数默认值说明--debug-port NUM5001调试服务端口--debug-channel [websocket\|rawpacket]websocket调试消息编码通道--debug-protocol PROTOCOLtcp底层传输协议tcp或serial--serial-config OPTIONS_STRING/dev/ttyS0,115200,8,N,1串口配置设备、波特率、数据位、校验、停止位这些参数最终在 jerry-main/main-desktop.c 的main_init_debugger中按“协议→通道”两级组合完成初始化先按debug_protocol选择 TCP 或串口传输再按debug_channel叠加 WebSocket 或 Raw Packet 编码层最后统一交给jerryx_debugger_after_connect挂接引擎。客户端连接方式Python 客户端通过命令行指定服务端地址进行连接python jerry-debugger/jerry_client.py IP地址:端口若服务端与客户端运行在同一台机器上地址可写为localhost:5001即默认参数见 jerry-debugger/jerry_client_main.py 中的parser.add_argument(address, ...)定义。连接时序要求客户端必须在 JavaScript 应用运行之前连上服务端对于多文件场景Python 客户端还支持在引擎初始化完成后立即动态挂接on-the-fly attachment。调试信息的内存策略JerryScript 本身不保留调试信息例如每个可能断点位置对应的行号索引。这些信息由资源更充裕的客户端负责存储——客户端在收到调试信息后自行缓存而 JerryScript 在把调试信息传给客户端后立即释放以节省设备端宝贵的内存。因此调试能力如断点行号解析实际由客户端侧的数据维护能力决定。断点行为与 help 命令连接建立后执行流程受调试器控制。调试器总是停在第一个可能的断点位置效果等同于执行了stop命令——这允许你在真正有意义的代码执行开始之前先插入断点。客户端支持的所有命令可用help命令查询。仓库自带测试用例 tests/debugger 目录下的.cmd/.expected/.js三件套如 do_break.cmd覆盖了 break、continue、next、step、backtrace、scope、variables、eval、throw、restart 等交互场景可作为命令用法的直接参考。在宿主应用中集成调试支持当使用扩展提供的 WebSocket 传输层时宿主应用在调用jerry_init ()之后通过如下方式启用调试器并阻塞等待客户端连接jerryx_debugger_after_connect (jerryx_debugger_tcp_create (debug_port) jerryx_debugger_ws_create ());jerryx_debugger_tcp_create (debug_port)创建指定端口的 TCP 服务jerryx_debugger_ws_create ()在 TCP 之上叠加 WebSocket 消息编码jerryx_debugger_after_connect (success)挂接调试器并等待连接参数为前述调用的逻辑与结果。自定义传输层可以按相同模式实现并初始化。当前扩展还提供jerryx_debugger_rp_create ()Raw Packet 传输层jerryx_debugger_serial_create (const char* config)串口协议config形如/dev/ttyS0,115200,8,N,1。上述接口均在扩展头文件 jerry-ext/include/jerryscript-ext/debugger.h 中声明。源代码名的传递传递给jerry_parse ()的源名称source name会被客户端用于标识源代码来源通常就是文件名。调试信息与断点位置的对应关系依赖该名称因此宿主在解析脚本时应传入有意义的文件名而非空串。JerryScript 调试器 C-API 接口本节按 docs/07.DEBUGGER.md 的 API 参考框架完整介绍调试器类型与全部 6 个引擎级函数。这些函数由核心头文件 jerry-core/include/jerryscript-debugger.h 声明示例代码需同时包含#include jerryscript.h #include jerryscript-ext/debugger.h类型jerry_debugger_wait_for_source_callback_t概要该回调函数由jerry_debugger_wait_for_client_source在成功收到一段源代码时调用。原型typedef jerry_value_t (*jerry_debugger_wait_for_source_callback_t) (const jerry_char_t *source_name_p, size_t source_name_size, const jerry_char_t *source_p, size_t source_size, void *user_p);参数source_name_p- 源代码的源名称通常为文件名source_name_size- 源名称的字节大小source_p- 源代码字符数据source_size- 源代码大小user_p- 透传给jerry_debugger_wait_for_client_source的自定义指针回调的返回值会被jerry_debugger_wait_for_client_source原样回传存入其return_value输出参数。类型jerry_debugger_wait_for_source_status_t该枚举定义在 jerry-core/include/jerryscript-debugger.h 中是jerry_debugger_wait_for_client_source的返回值类型枚举值含义JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED源代码接收失败如连接中断JERRY_DEBUGGER_SOURCE_RECEIVED已成功收到一段源代码JERRY_DEBUGGER_SOURCE_END收到“无更多源代码”的信号JERRY_DEBUGGER_CONTEXT_RESET_RECEIVED收到客户端发来的上下文重置context reset请求其中SOURCE_END与CONTEXT_RESET_RECEIVED正是文档所描述的“客户端可能请求上下文重置或通知无更多源码”两类带外通知。jerry_debugger_is_connected概要返回当前是否已有远程调试器客户端连接。原型bool jerry_debugger_is_connected (void);示例#include stdio.h #include jerryscript.h #include jerryscript-ext/debugger.h int main (void) { jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); if (jerry_debugger_is_connected ()) { printf (A remote debugger client is connected.); } jerry_cleanup (); }jerry_debugger_stop概要若远程调试器已连接且引擎当前未停在断点上则在下一个可用断点处停止执行。无论该断点是否启用引擎都会停住。原型void jerry_debugger_stop (void)示例#include jerryscript.h #include jerryscript-ext/debugger.h int main (void) { jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); jerry_debugger_stop (); jerry_cleanup (); }参见jerry_debugger_continuejerry_debugger_continue概要若引擎本会在下一个可用断点处停下此函数可取消该停靠效果引擎仍会在已启用的断点处停止。该函数实质上是jerry_debugger_stop ()调用或客户端发出的 stop 请求的“反向操作”。原型void jerry_debugger_continue (void)示例#include jerryscript.h #include jerryscript-ext/debugger.h int main (void) { jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); jerry_debugger_continue (); jerry_cleanup (); }参见jerry_debugger_stopjerry_debugger_stop_at_breakpoint概要启用或禁用“在断点处停止”。当停止被禁用时所有断点包括用户启用的断点都会被忽略从而实现 ECMAScript 代码的“隐藏执行”hidden execution——例如宿主希望不受调试器干扰地运行一段内部逻辑。原型void jerry_debugger_stop_at_breakpoint (bool enable_stop_at_breakpoint)参数enable_stop_at_breakpoint- 传true启用断点停靠传false禁用示例#include jerryscript.h #include jerryscript-ext/debugger.h int main (void) { jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); jerry_debugger_stop_at_breakpoint (true); // Protected execution of JavaScript code. const jerry_char_t script[] 42; jerry_eval (script, sizeof (script) - 1, JERRY_PARSE_NO_OPTS); jerry_debugger_stop_at_breakpoint (false); jerry_cleanup (); }jerry_debugger_wait_for_client_source概要请求客户端提供下一段源代码函数会一直等待直到整段源码接收完毕。作为回复客户端可能请求上下文重置或通知没有更多源码这些通知通过函数返回值回传。原型jerry_debugger_wait_for_source_status_t jerry_debugger_wait_for_client_source (jerry_debugger_wait_for_source_callback_t callback_p, void *user_p, jerry_value_t *return_value)示例完整的“接收源码→解析→运行→处理重置”循环#include jerryscript.h #include jerryscript-ext/debugger.h /** * Runs the source code received by jerry_debugger_wait_for_client_source. */ static jerry_value_t wait_for_source_callback (const jerry_char_t *source_name_p, /** source name */ size_t source_name_size, /** size of source name */ const jerry_char_t *source_p, /** source code */ size_t source_size, /** source code size */ void *user_p /** user pointer */) { (void) user_p; jerry_parse_options_t parse_options; parse_options.options JERRY_PARSE_HAS_SOURCE_NAME; parse_options.source_name jerry_string ((const jerry_char_t *) source_name_p, (jerry_size_t) source_name_size, JERRY_ENCODING_UTF8); jerry_value_t ret_val jerry_parse (source_p, source_size, parse_options); jerry_value_free (parse_options.source_name); if (!jerry_value_is_exception (ret_val)) { jerry_value_t func_val ret_val; ret_val jerry_run (func_val); jerry_value_free (func_val); } return ret_val; } /* wait_for_source_callback */ int main (void) { jerry_debugger_wait_for_source_status_t receive_status; do { /* Create a new JerryScript instance when a context reset is * received. Applications usually registers their core bindings * here as well (e.g. print, setTimeout). */ jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); do { jerry_value_t run_result; receive_status jerry_debugger_wait_for_client_source (wait_for_source_callback, NULL, run_result); jerry_value_free (run_result); } while (receive_status JERRY_DEBUGGER_SOURCE_RECEIVED); jerry_cleanup (); } while (receive_status JERRY_DEBUGGER_CONTEXT_RESET_RECEIVED); if (receive_status JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED) { // Handle the failure (e.g. display an error). } return 0; }实现佐证桌面主程序在--debugger-wait-source模式下以完全相同的方式循环调用该函数见 jerry-main/main-desktop.cSOURCE_RECEIVE_FAILED直接报错退出SOURCE_END结束循环CONTEXT_RESET_RECEIVED则执行jerry_cleanup ()后goto restart重新初始化引擎。该示例同时演示了如何把客户端传来的源名称通过JERRY_PARSE_HAS_SOURCE_NAME选项传给jerry_parse ()与文档前述“source name 用于标识源代码来源”的说明相印证。jerry_debugger_send_output概要将程序的输出发送给调试器客户端例如替代print的输出通道便于在调试界面中统一展示。原型void jerry_debugger_send_output (const jerry_char_t *buffer, jerry_size_t str_size)示例#include jerryscript.h #include jerryscript-ext/debugger.h int main (void) { jerry_init (JERRY_INIT_EMPTY); jerryx_debugger_after_connect (jerryx_debugger_tcp_create (5001) jerryx_debugger_ws_create ()); jerry_char_t my_output[] Hey, this should be sent too!; jerry_size_t my_output_size sizeof (my_output); jerry_debugger_send_output (my_output, my_output_size); jerry_cleanup (); }快速上手从构建到断点调试综合以上内容一次完整的调试会话可按下述步骤复现构建带调试器的二进制python tools/build.py --jerry-debuggeron启动服务端./build/bin/jerry --start-debug-server --debugger-wait-source --log-level 2等待Waiting for client connection日志出现连接客户端python jerry-debugger/jerry_client.py localhost:5001下发源码并调试在客户端中使用break设置断点、continue/next/step控制执行、backtrace/scope检视状态、eval求值表达式全程可随时用help查询命令--client-source参数可一次携带多个源码文件配合--debugger-wait-source实现多文件动态挂接。延伸阅读调试器协议与命令的测试基线tests/debuggerdo_*.cmd命令脚本与do_*.expected期望输出一一对应传输层扩展实现jerry-ext/debuggerdebugger-tcp.c、debugger-ws.c、debugger-rp.c、debugger-serial.c、debugger-common.c调试器核心状态机与等待逻辑jerry-core/debugger/debugger.c 与 jerry-core/debugger/debugger.h官方调试器工具清单jerry-debugger/README.md。赞分享语言运行时嵌入式物联网编译器【免费下载链接】jerryscriptUltra-lightweight JavaScript engine for the Internet of Things.项目地址https://gitcode.com/gh_mirrors/je/jerryscript点击查看免费下载相关推荐JerryScript 调试器传输接口Debugger Transport Interface完全解析JerryScript 调试器传输接口Debugger Transport Interface完全解析 JerryScript 是为物联网IoT场景设计语言运行时嵌入式物联网编译器Pomerium项目远程调试指南从构建到调试全解析Pomerium项目远程调试指南从构建到调试全解析 前言 在现代微服务架构中身份认证和访问控制网关扮演着至关重要的角色。Pomerium作为一款开源的零信任后端API网关认证鉴权零信任PageSpy API终极指南从零配置到高级远程调试的完整教程PageSpy API终极指南从零配置到高级远程调试的完整教程 PageSpy是一款轻量级跨平台远程调试工具通过直观的API接口让开发者轻松实现应用监控、问前端开发工具调试器上一篇为什么你的洛雪音乐总是播放失败3步解决音源配置难题下一篇MobaXterm中文版一体化远程管理终端的技术架构与实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考