JSDebugger 变参调用指南从 NSArray.arrayWithObjects_ 到自定义方法的终极教程【免费下载链接】JSDebuggerJavaScript-Based Debugger For Inspecting Running State Of Your Application项目地址: https://gitcode.com/gh_mirrors/js/JSDebuggerJSDebugger 是一款基于 JavaScript 的运行时调试工具JavaScript-Based Debugger让你无需编写任何 JSExport 代码就能在任意时刻直接调用 Objective-C 方法、动态修改应用运行状态。本篇文章将聚焦其中最实用的能力之一——JSDebugger 变参调用从系统框架方法NSArray.arrayWithObjects_讲起一直到自定义变参方法的完整调用帮你一次吃透这套技巧。什么是变参调用为什么它很重要变参Variadic Argument指的是参数个数不固定的方法。在 Objective-C 中NSArray的arrayWithObjects:、NSLog等都是典型的变参方法。传统调试方式下想验证这类方法往往需要写临时代码、重新编译而有了 JSDebugger你可以在 JS 侧直接传任意数量的参数实时验证逻辑大大提升排查效率。 核心要点JSDebugger 支持以 NIL 终止nil-terminated的变参调用你只需要像写普通 JS 函数一样把参数罗列出来即可。第一步理解 JSDebugger 的方法名转换规则在开始调用之前先记住一个关键规则JSDebugger 会把 Objective-C 方法名中的所有冒号:转换成下划线_并将各段拼接为单一字符串。例如以下 OC 方法application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions在 JS 中对应的调用形式是application_didFinishLaunchingWithOptions_(application, launchOptions)这个规则对系统方法、自定义方法一视同仁掌握了它任何方法名你都能准确翻译。第二步实战调用 NSArray.arrayWithObjects_ 变参方法这是最经典的入门案例。在 JSDebugger 的 JS 运行环境中一行代码即可创建包含多个元素的数组var array NSArray.arrayWithObjects_(72, 2, 3);NSArray直接对应 OC 中的类arrayWithObjects_是arrayWithObjects:的 JS 形式后面的(72, 2, 3)就是你的变参列表数量完全自由。你还可以配合自定义方法验证结果例如在 demo 工程里调用ViewController.printNSArray_(array)控制台会直接打印出数组内容所见即所得。完整的可运行示例可以参考项目中的 demo.js里面覆盖了变参调用、属性设置、结构体、指针等多种场景。第三步调用你自己定义的变参方法变参调用不止用于系统类自定义方法同样支持。在 demo 工程的 ViewController.m 中定义了一个类方法 (void)test:(int)first,...NS_REQUIRES_NIL_TERMINATION { va_list list; va_start(list, first); int arg; while ((arg va_arg(list, int))) { NSLog(当前参数:%d, arg); } va_end(list); }注意两点方法声明必须以...NS_REQUIRES_NIL_TERMINATION结尾表示以 NIL 终止OC 侧使用标准的va_list/va_start/va_arg读取参数。然后在 JS 侧直接传入任意数量的参数调用即可ViewController.test_(1, 2, 4, 7);JSDebugger 会自动在参数末尾补上 NIL 终止符OC 侧的while循环就能正确遍历出所有传入的值。这正是无需手动定义 JSExport的典型体现。第四步变参调用背后的原理小白也能看懂你可能好奇JS 侧传入的变长参数是怎么精准落到 OC 方法里的简单来说JSDebugger 做了三件事方法桥接通过 JDMethodBridge 读取方法签名NSMethodSignature拿到每个参数的类型编码参数转换JS 侧的每个值都会被转换成对应的 C 类型变参部分复用参数列表的最后一个类型定义FFI 动态调用核心逻辑位于 JDFFIContext.m它使用ffi_prep_cif_var构建变参调用描述并在末尾自动追加一个 NULL 作为 NIL 终止符最终通过ffi_call完成真正的函数调用。整个流程对调用方完全透明你感知到的只是直接调用而已。如果你对底层感兴趣还可以顺藤摸瓜看看 JDMethod4JS.m那是 JS 函数回调到 OC 方法的入口。第五步注意事项与常见坑位✅必须 NIL 终止变参方法的 OC 声明要带...NS_REQUIRES_NIL_TERMINATION调用时末尾不要手动补 nilJSDebugger 会自动处理。✅Getter 要用方法调用JSDebugger 不支持view.backgroundColor;这种属性读取写法请使用view.backgroundColor();形式。✅参数数量校验框架内置了调用前检查PreCheck如果传参为undefined会直接终止本次调用避免把脏数据传入 OC。✅脚本错误会中断执行一旦某行 JS 抛异常整段脚本会停止求值建议先小范围验证再批量执行。第六步快速上手10 分钟跑通 Demo想立刻体验变参调用最快的方式是运行项目自带的 Demo获取源码git clone https://gitcode.com/gh_mirrors/js/JSDebugger打开JSDebuggerDemo.xcworkspace依赖通过 Podfile 管理运行 App 后打开 demo.js修改任意变参调用的参数并保存Command S观察 Xcode 控制台输出你会看到参数被实时打印——这就是 JSDebugger 的 Playground 文件监听机制JDLocalFileObserver在自动重载脚本。 进阶玩法把demo.js换成你自己的脚本文件用同样的监听方式接入你的业务 App即可在真机上实时调试无需反复编译。总结从NSArray.arrayWithObjects_到自定义的test_方法JSDebugger 的变参调用能力覆盖了系统方法与自定义方法两大场景配合方法名转换规则、NIL 终止约定与 Playground 热重载机制你完全可以把改代码→编译→运行的老流程升级为改 JS→保存→看结果的即时调试体验。还在等什么动手跑一遍 demo.js感受一下动态调试的魅力吧【免费下载链接】JSDebuggerJavaScript-Based Debugger For Inspecting Running State Of Your Application项目地址: https://gitcode.com/gh_mirrors/js/JSDebugger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 JSDebugger 变参调用指南：从 NSArray.arrayWithObjects_ 到自定义方法的终极教程
JSDebugger 变参调用指南从 NSArray.arrayWithObjects_ 到自定义方法的终极教程【免费下载链接】JSDebuggerJavaScript-Based Debugger For Inspecting Running State Of Your Application项目地址: https://gitcode.com/gh_mirrors/js/JSDebuggerJSDebugger 是一款基于 JavaScript 的运行时调试工具JavaScript-Based Debugger让你无需编写任何 JSExport 代码就能在任意时刻直接调用 Objective-C 方法、动态修改应用运行状态。本篇文章将聚焦其中最实用的能力之一——JSDebugger 变参调用从系统框架方法NSArray.arrayWithObjects_讲起一直到自定义变参方法的完整调用帮你一次吃透这套技巧。什么是变参调用为什么它很重要变参Variadic Argument指的是参数个数不固定的方法。在 Objective-C 中NSArray的arrayWithObjects:、NSLog等都是典型的变参方法。传统调试方式下想验证这类方法往往需要写临时代码、重新编译而有了 JSDebugger你可以在 JS 侧直接传任意数量的参数实时验证逻辑大大提升排查效率。 核心要点JSDebugger 支持以 NIL 终止nil-terminated的变参调用你只需要像写普通 JS 函数一样把参数罗列出来即可。第一步理解 JSDebugger 的方法名转换规则在开始调用之前先记住一个关键规则JSDebugger 会把 Objective-C 方法名中的所有冒号:转换成下划线_并将各段拼接为单一字符串。例如以下 OC 方法application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions在 JS 中对应的调用形式是application_didFinishLaunchingWithOptions_(application, launchOptions)这个规则对系统方法、自定义方法一视同仁掌握了它任何方法名你都能准确翻译。第二步实战调用 NSArray.arrayWithObjects_ 变参方法这是最经典的入门案例。在 JSDebugger 的 JS 运行环境中一行代码即可创建包含多个元素的数组var array NSArray.arrayWithObjects_(72, 2, 3);NSArray直接对应 OC 中的类arrayWithObjects_是arrayWithObjects:的 JS 形式后面的(72, 2, 3)就是你的变参列表数量完全自由。你还可以配合自定义方法验证结果例如在 demo 工程里调用ViewController.printNSArray_(array)控制台会直接打印出数组内容所见即所得。完整的可运行示例可以参考项目中的 demo.js里面覆盖了变参调用、属性设置、结构体、指针等多种场景。第三步调用你自己定义的变参方法变参调用不止用于系统类自定义方法同样支持。在 demo 工程的 ViewController.m 中定义了一个类方法 (void)test:(int)first,...NS_REQUIRES_NIL_TERMINATION { va_list list; va_start(list, first); int arg; while ((arg va_arg(list, int))) { NSLog(当前参数:%d, arg); } va_end(list); }注意两点方法声明必须以...NS_REQUIRES_NIL_TERMINATION结尾表示以 NIL 终止OC 侧使用标准的va_list/va_start/va_arg读取参数。然后在 JS 侧直接传入任意数量的参数调用即可ViewController.test_(1, 2, 4, 7);JSDebugger 会自动在参数末尾补上 NIL 终止符OC 侧的while循环就能正确遍历出所有传入的值。这正是无需手动定义 JSExport的典型体现。第四步变参调用背后的原理小白也能看懂你可能好奇JS 侧传入的变长参数是怎么精准落到 OC 方法里的简单来说JSDebugger 做了三件事方法桥接通过 JDMethodBridge 读取方法签名NSMethodSignature拿到每个参数的类型编码参数转换JS 侧的每个值都会被转换成对应的 C 类型变参部分复用参数列表的最后一个类型定义FFI 动态调用核心逻辑位于 JDFFIContext.m它使用ffi_prep_cif_var构建变参调用描述并在末尾自动追加一个 NULL 作为 NIL 终止符最终通过ffi_call完成真正的函数调用。整个流程对调用方完全透明你感知到的只是直接调用而已。如果你对底层感兴趣还可以顺藤摸瓜看看 JDMethod4JS.m那是 JS 函数回调到 OC 方法的入口。第五步注意事项与常见坑位✅必须 NIL 终止变参方法的 OC 声明要带...NS_REQUIRES_NIL_TERMINATION调用时末尾不要手动补 nilJSDebugger 会自动处理。✅Getter 要用方法调用JSDebugger 不支持view.backgroundColor;这种属性读取写法请使用view.backgroundColor();形式。✅参数数量校验框架内置了调用前检查PreCheck如果传参为undefined会直接终止本次调用避免把脏数据传入 OC。✅脚本错误会中断执行一旦某行 JS 抛异常整段脚本会停止求值建议先小范围验证再批量执行。第六步快速上手10 分钟跑通 Demo想立刻体验变参调用最快的方式是运行项目自带的 Demo获取源码git clone https://gitcode.com/gh_mirrors/js/JSDebugger打开JSDebuggerDemo.xcworkspace依赖通过 Podfile 管理运行 App 后打开 demo.js修改任意变参调用的参数并保存Command S观察 Xcode 控制台输出你会看到参数被实时打印——这就是 JSDebugger 的 Playground 文件监听机制JDLocalFileObserver在自动重载脚本。 进阶玩法把demo.js换成你自己的脚本文件用同样的监听方式接入你的业务 App即可在真机上实时调试无需反复编译。总结从NSArray.arrayWithObjects_到自定义的test_方法JSDebugger 的变参调用能力覆盖了系统方法与自定义方法两大场景配合方法名转换规则、NIL 终止约定与 Playground 热重载机制你完全可以把改代码→编译→运行的老流程升级为改 JS→保存→看结果的即时调试体验。还在等什么动手跑一遍 demo.js感受一下动态调试的魅力吧【免费下载链接】JSDebuggerJavaScript-Based Debugger For Inspecting Running State Of Your Application项目地址: https://gitcode.com/gh_mirrors/js/JSDebugger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考