自动化脚本的执行方式灵活多样既支持从云端拉取在线脚本也支持直接运行存放在手机本地的 JavaScript 文件。在实际开发与调试过程中出于网络环境受限、脚本调试需要或隐私安全等考虑开发者往往更倾向于执行本地、离线的自动化脚本。本文将基于冰狐智能辅助的官方 API详细梳理在冰狐平台中执行本地、离线自动化脚本的两种核心方法并探讨其适用场景与注意事项。一、核心 API 概述冰狐智能辅助提供了两个用于脚本调用的核心函数setDefaultScript与callScript。这两个函数均支持本地脚本的执行但在工作机制和使用场景上存在显著差异。理解两者的区别是正确选用 API 的前提。二、方法一使用setDefaultScript设置默认脚本setDefaultScript函数的作用是设置一个“默认脚本”。一旦调用该函数进行设置其效果是永久有效的除非开发者重新调用该函数并传入新的脚本路径或传入空字符串来取消默认脚本的设置。2.1 函数原型与参数该函数接受一个字符串参数即脚本的路径。根据官方文档路径支持以下几种形式APK 资源内的脚本使用asset:前缀例如asset:xx.js。这种方式适用于将脚本随 APK 打包发布供内置脚本调用。相对路径脚本直接传入文件名例如xx.js。相对路径的基准目录通常是应用的私有存储目录或脚本根目录。在线脚本直接传入脚本名不带路径前缀例如xx。此时平台会尝试从冰狐服务器拉取该脚本。绝对路径脚本传入完整的文件系统路径例如/sdcard/xx.js。这是执行本地离线脚本最直接的方式。2.2 适用场景setDefaultScript适用于需要全局替换当前自动化任务入口的场景。例如在脚本开发过程中开发者可能希望临时切换到另一个本地版本来调试特定功能而不必修改每次调用的代码。设置默认脚本后平台后续的自动化执行入口将自动指向该脚本直到被重新设置或取消。2.3 使用示例function main() { // 设置绝对路径下的本地脚本为默认脚本 setDefaultScript(/sdcard/my_script.js); // 此后平台将默认执行 /sdcard/my_script.js }需要注意的是该函数仅负责“设置”默认脚本并不会立即执行该脚本。实际的执行时机取决于平台后续的自动化调度逻辑。三、方法二使用callScript直接调用脚本与setDefaultScript的“设置”语义不同callScript函数的作用是立即调用指定的脚本。这是执行本地离线脚本更常用、更直接的方式。3.1 函数原型与参数callScript的函数签名如下callScript(scriptName, params...)scriptName必填字符串类型指定要调用的脚本名称。同样支持多种路径格式APK 资源文件asset:temp.js本地 JS 文件/sdcard/temp.js在线脚本直接传入脚本名如testparams...选填可变参数任意数量。这些参数会直接透传给被调用脚本的main函数。3.2 同步执行与线程模型官方文档明确指出callScript是同步调用它会执行移动端脚本中的main函数并返回该函数的返回值。这意味着调用callScript的线程会被阻塞直到被调用的脚本执行完毕。重要限制由于callScript不会创建独立的线程而是直接在当前线程中执行因此不能在 UI 线程主线程中使用否则可能导致界面卡顿甚至 ANRApplication Not Responding。官方文档建议在 UI 相关代码中应使用runTask来替代。3.3 参数传递与返回值callScript支持将任意数量的参数传递给目标脚本。目标脚本的main函数需要按顺序接收这些参数调用端代码// 调用本地脚本并传递两个参数 callScript(/sdcard/test.js, 12, abc);被调用的本地脚本test.jsfunction main(id, name) { // id: 12, name: abc console.log(id: id name: name); return name id; // 返回值将作为 callScript 的返回值 }如上所示callScript的返回值即为目标脚本main函数的返回值。这使得callScript不仅可以执行脚本还可以实现脚本间的数据交换。四、两种方法的对比与选型建议维度setDefaultScriptcallScript语义设置默认脚本全局生效立即执行指定脚本执行时机设置后由平台调度触发调用时立即执行线程模型取决于平台调度同步执行阻塞当前线程参数传递不支持动态传参支持任意数量参数透传返回值无直接返回值返回目标脚本main函数的返回值适用场景全局替换自动化入口按需调用特定脚本、脚本间协作在实际开发中如果只是临时执行某个本地脚本进行测试或功能调用应优先选择callScript因为它更灵活、支持参数传递且能获取返回值。而setDefaultScript更适合需要持久化改变自动化任务入口的场景例如在应用启动时根据配置动态决定加载哪个脚本作为主任务。五、本地脚本路径的注意事项在执行本地离线脚本时路径的正确性至关重要。根据官方文档的说明以下三种本地脚本路径是受支持的asset:前缀指向打包在 APK 中的资源文件。这种方式适合将核心脚本与 APP 一起分发无需额外从外部加载。绝对路径如/sdcard/xxx.js指向手机存储中的具体文件。这是执行外部离线脚本最通用的方式。相对路径如xxx.js其基准目录通常为应用的私有存储目录或脚本工作目录具体行为可能取决于平台实现。对于存放在手机外部存储如/sdcard/的脚本需要确保应用已获取相应的存储读取权限否则文件访问可能失败。六、总结冰狐智能辅助平台通过setDefaultScript和callScript两个核心 API为开发者提供了灵活且完备的本地、离线脚本执行能力。setDefaultScript适用于全局默认脚本的设置而callScript则更适合按需调用、参数传递和脚本间协作的场景。理解两者的工作机制、线程模型和适用边界有助于开发者在编写自动化脚本时做出正确的技术选型从而构建更稳定、高效的自动化解决方案。在实际项目中建议优先使用callScript配合绝对路径来执行本地离线脚本并注意避免在 UI 线程中调用以防止界面阻塞。同时合理利用参数传递和返回值机制可以实现脚本模块化提升代码的复用性和可维护性。
自动化脚本的执行方式灵活多样既支持从云端拉取在线脚本也支持直接运行存放在手机本地的 JavaScript 文件。在实际开发与调试过程中出于网络环境受限、脚本调试需要或隐私安全等考虑开发者往往更倾向于执行本地、离线的自动化脚本。本文将基于冰狐智能辅助的官方 API详细梳理在冰狐平台中执行本地、离线自动化脚本的两种核心方法并探讨其适用场景与注意事项。一、核心 API 概述冰狐智能辅助提供了两个用于脚本调用的核心函数setDefaultScript与callScript。这两个函数均支持本地脚本的执行但在工作机制和使用场景上存在显著差异。理解两者的区别是正确选用 API 的前提。二、方法一使用setDefaultScript设置默认脚本setDefaultScript函数的作用是设置一个“默认脚本”。一旦调用该函数进行设置其效果是永久有效的除非开发者重新调用该函数并传入新的脚本路径或传入空字符串来取消默认脚本的设置。2.1 函数原型与参数该函数接受一个字符串参数即脚本的路径。根据官方文档路径支持以下几种形式APK 资源内的脚本使用asset:前缀例如asset:xx.js。这种方式适用于将脚本随 APK 打包发布供内置脚本调用。相对路径脚本直接传入文件名例如xx.js。相对路径的基准目录通常是应用的私有存储目录或脚本根目录。在线脚本直接传入脚本名不带路径前缀例如xx。此时平台会尝试从冰狐服务器拉取该脚本。绝对路径脚本传入完整的文件系统路径例如/sdcard/xx.js。这是执行本地离线脚本最直接的方式。2.2 适用场景setDefaultScript适用于需要全局替换当前自动化任务入口的场景。例如在脚本开发过程中开发者可能希望临时切换到另一个本地版本来调试特定功能而不必修改每次调用的代码。设置默认脚本后平台后续的自动化执行入口将自动指向该脚本直到被重新设置或取消。2.3 使用示例function main() { // 设置绝对路径下的本地脚本为默认脚本 setDefaultScript(/sdcard/my_script.js); // 此后平台将默认执行 /sdcard/my_script.js }需要注意的是该函数仅负责“设置”默认脚本并不会立即执行该脚本。实际的执行时机取决于平台后续的自动化调度逻辑。三、方法二使用callScript直接调用脚本与setDefaultScript的“设置”语义不同callScript函数的作用是立即调用指定的脚本。这是执行本地离线脚本更常用、更直接的方式。3.1 函数原型与参数callScript的函数签名如下callScript(scriptName, params...)scriptName必填字符串类型指定要调用的脚本名称。同样支持多种路径格式APK 资源文件asset:temp.js本地 JS 文件/sdcard/temp.js在线脚本直接传入脚本名如testparams...选填可变参数任意数量。这些参数会直接透传给被调用脚本的main函数。3.2 同步执行与线程模型官方文档明确指出callScript是同步调用它会执行移动端脚本中的main函数并返回该函数的返回值。这意味着调用callScript的线程会被阻塞直到被调用的脚本执行完毕。重要限制由于callScript不会创建独立的线程而是直接在当前线程中执行因此不能在 UI 线程主线程中使用否则可能导致界面卡顿甚至 ANRApplication Not Responding。官方文档建议在 UI 相关代码中应使用runTask来替代。3.3 参数传递与返回值callScript支持将任意数量的参数传递给目标脚本。目标脚本的main函数需要按顺序接收这些参数调用端代码// 调用本地脚本并传递两个参数 callScript(/sdcard/test.js, 12, abc);被调用的本地脚本test.jsfunction main(id, name) { // id: 12, name: abc console.log(id: id name: name); return name id; // 返回值将作为 callScript 的返回值 }如上所示callScript的返回值即为目标脚本main函数的返回值。这使得callScript不仅可以执行脚本还可以实现脚本间的数据交换。四、两种方法的对比与选型建议维度setDefaultScriptcallScript语义设置默认脚本全局生效立即执行指定脚本执行时机设置后由平台调度触发调用时立即执行线程模型取决于平台调度同步执行阻塞当前线程参数传递不支持动态传参支持任意数量参数透传返回值无直接返回值返回目标脚本main函数的返回值适用场景全局替换自动化入口按需调用特定脚本、脚本间协作在实际开发中如果只是临时执行某个本地脚本进行测试或功能调用应优先选择callScript因为它更灵活、支持参数传递且能获取返回值。而setDefaultScript更适合需要持久化改变自动化任务入口的场景例如在应用启动时根据配置动态决定加载哪个脚本作为主任务。五、本地脚本路径的注意事项在执行本地离线脚本时路径的正确性至关重要。根据官方文档的说明以下三种本地脚本路径是受支持的asset:前缀指向打包在 APK 中的资源文件。这种方式适合将核心脚本与 APP 一起分发无需额外从外部加载。绝对路径如/sdcard/xxx.js指向手机存储中的具体文件。这是执行外部离线脚本最通用的方式。相对路径如xxx.js其基准目录通常为应用的私有存储目录或脚本工作目录具体行为可能取决于平台实现。对于存放在手机外部存储如/sdcard/的脚本需要确保应用已获取相应的存储读取权限否则文件访问可能失败。六、总结冰狐智能辅助平台通过setDefaultScript和callScript两个核心 API为开发者提供了灵活且完备的本地、离线脚本执行能力。setDefaultScript适用于全局默认脚本的设置而callScript则更适合按需调用、参数传递和脚本间协作的场景。理解两者的工作机制、线程模型和适用边界有助于开发者在编写自动化脚本时做出正确的技术选型从而构建更稳定、高效的自动化解决方案。在实际项目中建议优先使用callScript配合绝对路径来执行本地离线脚本并注意避免在 UI 线程中调用以防止界面阻塞。同时合理利用参数传递和返回值机制可以实现脚本模块化提升代码的复用性和可维护性。
