触动精灵 3.0 IDE 脚本编辑器使用手册

rourou • 发表于 2018-09-03 19:01:41 • 更新于 2026-10-30 16:00:50 • 0回复

触动精灵脚本编辑器(以下简称 IDE)是电脑端的集成开发工具,覆盖脚本编辑、工程管理、函数补全、语法高亮、脚本检错、打包、远程导入与调试、日志输出。本手册以 v3.0 及以上版本为准。


01 简介与 v3.0 变化

IDE 为脚本开发者提供完整的工作流:脚本编辑、工程管理、函数补全、关键字高亮、函数库高亮、脚本检错、工程打包、远程导入、远程运行、远程调试、日志输出。

1.1 v3.0 版本的关键变化

功能 说明
内置取色器 已集成到 IDE 中,需连接设备后点击取色。取色面板的「自定义格式」需在【文件】-【设置】中配置,详见 docs/4967#title-18
文件关联机制 工程中显示删除线的文件表示未关联到工程,发送工程时不会发到设备。右键点击工程 →「全部关联」即可恢复
断点调试 需要在代码开头先加断点,详见 docs/4967#title-13

从旧版迁移的坑如果有旧版 IDE 的工程文件,请点击【文件】-【导入工程】,选择工程文件夹,把旧工程导入到新版 IDE 的工程列表中。

不要直接把 v3.0 版 IDE 的工程目录设置为旧版 IDE 的工程路径,否则会出现工程下文件取消关联的问题。


02 使用前必读

授权、网络、Key,这三件事任意一件不对,连不上设备。

2.1 授权相关

客户端 连接 IDE 的授权要求
iOS 标准版 / 专业版 / 个人版 需购买触动授权(触动商城或客户端内购买)。试用状态无法连接 IDE。
安卓标准版 / iOS 个人版 需登录账号并有 VIP 授权。可在开发者平台个人中心绑定触动账号以获赠 VIP 授权(开发者账号需通过实名验证)

账号不通用触动账号与开发者平台账号不通用,需要在触动精灵手机客户端单独注册。购买的账号无法在开发者平台绑定。


触动精灵 3.0 IDE 脚本编辑器使用手册

开发者平台绑定触动账号的位置

2.2 Access Key 与触动授权的区别

每个开发者账号会免费赠送一个 Access Key,最多可连接 5 个设备(5 个免费接口)。

两者相互独立Access Key 只代表允许连接触动、搭建中控;触动本身仍必须有授权才能连接成功。不要把 Access Key 当成触动授权。

2.3 网络要求

IDE 连接触动精灵及积木编程默认需要局域网:设备和电脑连同一个路由器,且两者 IP 前三段相同才算同一局域网。

设备 IP 可在「触动精灵 → 更多 / 我的账号 → 设备信息」中查看。

跨网络时广域网环境(例如模拟器)需要开启网桥或使用蒲公英再试,详见 docs/4967#title-6。

积木编程仅支持 v3.0.4 及其以上版本 IDE,连接方法见 docs/4967#title-12。

连上了却提示未授权专业版 / 标准版 / 个人版已购买授权,但连接时显示未授权或局域网通讯异常,处理办法见 docs/8906。


03 下载与登录

3.1 下载

下载地址:www.touchsprite.com/download。注意区分 Windows 版本与 Mac 版本。

3.2 登录

  1. 点击右上角的【登录】按钮。
  2. 输入开发者平台账号、密码。
  3. 选择需要使用的 Access Key。
  4. 点击【确定】。

如还没有开发者平台账号,请到开发者平台注册。登录后才能连接设备、截图、运行代码。

3.3 设备数超限

免费 Key 最多连接 5 台设备。连接超过 5 台后,新设备将无法连接。

  1. 登录 account.touchsprite.com/access-key,点击【设备】→【清空设备】。
  2. 或使用 v3.0.5 及其以上版本 IDE 内置的功能:点击【文件】→【设备】→【清空 Key 绑定设备】。


04 连接设备


触动精灵 3.0 IDE 脚本编辑器使用手册

「连接设备」面板

4.1 局域网连接

  1. 确认设备与电脑处于同一局域网。
  2. 点击「连接设备」。
  3. IDE 自动扫描网段,选择对应 IP 连接;也可手动输入设备 IP。

4.2 广域网连接

推荐方案使用蒲公英进行连接,详见这篇教程。这是官方推荐的首选方式。

模拟器怎么开网桥

以雷电 / 夜神模拟器为例:打开模拟器 → 设置 → 网络设置 → 开启网络桥连 → IP 设置选 DHCP → 安装驱动 → 保存设置 → 重启模拟器。之后输入模拟器显示的 IP,即可连接 IDE 及抓色器。


触动精灵 3.0 IDE 脚本编辑器使用手册

模拟器网络桥连设置

4.3 连接触动智控

  1. 必须登录与触动智控相同的账号,并且已在智控购买套餐授权,否则无法连接设备。
  2. 安卓设备需开启开发者模式,并用数据线连接到电脑。
  3. 点击「连接设备」→ 选择 USB 连接 → 点击设备名 → 点击「连接」。

建议同时打开推荐智控和 IDE 同时打开,否则 IDE 可能获取不到设备列表。


触动精灵 3.0 IDE 脚本编辑器使用手册

USB 连接触动智控


05 工程管理

5.1 新建工程

点击【新建工程】→ 输入工程名称 → 选择产品线 → 【确定】,工程列表中即会显示新工程。IDE 会根据所选产品线生成对应的工程图标。


触动精灵 3.0 IDE 脚本编辑器使用手册

新建工程

触动精灵 3.0 IDE 脚本编辑器使用手册

不同产品线对应的工程图标

5.2 导入工程

点击【文件】→【导入工程】→ 选择需要导入的工程文件夹 →【确定】,即可把旧版 IDE 工程导入到新版工程列表中。


触动精灵 3.0 IDE 脚本编辑器使用手册

导入旧版工程

5.3 导入文件到工程

选择工程 → 鼠标右键 →【导入文件到工程】→ 选择文件 →【打开】。IDE 会按文件格式自动归类:

文件类型 自动归入目录
lua 文件 源码
txt、png、jpg 等 资源
so、tsl 等 插件

触动精灵 3.0 IDE 脚本编辑器使用手册

右键菜单中的「导入文件到工程」

5.4 发送文件到设备

连接触动后,选中工程 → 鼠标右键 →「发送工程到设备」,工程下所有文件会按目录发送到设备对应位置:

工程目录 设备端落点
源码 触动脚本目录(lua 文件夹)
资源 触动资源目录(res 文件夹)
插件 触动插件目录

如果只想发单个文件:选中文件 → 鼠标右键 →「发送当前文件到设备」,落点规则与上表相同。

5.5 调用子文件夹下的文件

仅支持 v3.0.1 及其以上版本 IDE。

  1. 在工程文件夹(工程右键 →「显示位置」)下手动创建文件夹。
  2. 把需要调用的文件放进该文件夹。
  3. 鼠标右键点击【刷新】。
  4. 选中添加的文件或子文件夹 → 鼠标右键 →【全部关联】。
  5. 把工程发送到设备即可。

具体函数调用方式见 require 调用子文件夹下文件。

5.6 关联与取消关联

删除线的含义工程中带删除线的文件表示已取消关联:文件仍在工程中不会被删除,但工程打包和发送到设备时会被忽略。

操作 方式 版本
单个文件 关联 / 取消关联 选中文件 → 鼠标右键 →【关联】/【取消关联】 —
批量 全部关联 / 全部取消关联 选中工程、源码、资源、插件或子文件夹 → 鼠标右键 v3.0.1+

想恢复关联,选中已取消关联的文件 → 鼠标右键 →【关联】。


触动精灵 3.0 IDE 脚本编辑器使用手册

取消关联后文件名显示删除线

升级后文件全部失效?从 v3.0.0 升级到 v3.0.1 及其以上版本后,所有工程下的文件会被设置为取消关联状态。请选中工程 → 鼠标右键 →【全部关联】重新关联。


06 截图与取色

截图的前提是已连接设备成功。

6.1 截图

  1. 点击顶部【取色】按钮,跳转到抓色器界面。
  2. 点击【截图】即可截取当前界面图片。

按下 ALT + TAB 可在编辑器与抓色器界面之间切换。截图默认快捷键:CTRL + SHIFT + S。

6.2 取色快捷键

操作 快捷键 说明
取色 Ctrl + 鼠标左键 —
取色 回车 —
取色 数字 0 ~ 9 1 ~ 9 对应右侧序号的颜色,0 对应第 10 号

想取第 11 ~ 20 个点的坐标和颜色,需要用 Ctrl + 鼠标左键 或 回车。

6.3 取色面板各按钮


触动精灵 3.0 IDE 脚本编辑器使用手册

取色面板
编号 功能 说明
1 坐标输入框 点击输入框,输入坐标并回车,会显示该坐标对应的颜色
2 重新取色 在图一拾取坐标后切到图二,点击「重新取色」会沿用同一坐标在图二对应位置取色,用于对比多张图同一像素点的颜色差异
3 选择范围 点击按钮后,用鼠标左键滑动选择查找范围;也可在按钮下方的输入框自定义范围
4 找色起始点 可选左上角、右上角、左下角、右下角
5 代码格式 共有六种预设,自定义格式见 docs/4967#title-18
6 找色方向 设置找色方向
7 测试 连接设备后点击,结果会显示在日志窗口
8 坐标颜色 坐标颜色列表,点击【删除】可移除不需要的颜色及坐标

6.4 剪切(v3.1.1 及以上)

  1. 点击顶部「剪切」按钮。
  2. 按下鼠标左键,在图片上框选裁剪区域。
  3. 松开鼠标左键,即可裁剪出对应范围的图片。

三条细节

  • 裁剪图片时会禁用选择范围功能;反之使用选择范围时也会禁用剪切。
  • 选择区域超出图片范围或抓色器边界时,会按该区域自动裁剪。
  • 放大或缩小图片后裁剪,仍按原始尺寸裁剪。

裁剪出的图片添加到工程、发送到设备后,即可用找图函数找图。

显示错位的小问题当屏幕缩放比例超过 100% 且图片有滚动条时,长按方向键移动可能导致左侧显示位置与右侧放大镜位置不符,属已知现象。


07 控件节点

支持范围仅支持 v3.0.4 及其以上版本 IDE,且仅支持触动精灵安卓标准版与积木编程,需要开启无障碍开关。

截图方向为横屏时,该按钮会置灰,请切换到竖屏再试。

怎么判断无障碍开好了打开无障碍开关后,如果正常跳转到触动或积木,说明开关生效;反之说明异常。请重启无障碍开关、重启触动或积木,仍不行则重启手机。

7.1 连接积木编程

  1. 在设备上打开积木编程的无障碍开关(积木编程使用方式见 docs/9099)。
  2. 确认设备与电脑在同一局域网(不是局域网请用蒲公英,模拟器连接方法见这里)。
  3. 注意控件节点不支持横屏。
  4. 打开积木编程 →【我的】→【IP 端口】,显示的 IP 即为设备局域网 IP。
  5. 打开 IDE →【连接设备】→「产品类型」选「积木编程」→ 输入刚才的 IP →【连接】。

触动精灵 3.0 IDE 脚本编辑器使用手册

连接积木编程

7.2 连接触动精灵

  1. 在触动安卓标准版中,进入「我的账号」→「偏好设置」,开启无障碍开关。
  2. 确认设备与电脑在同一局域网(同上)。
  3. 「产品类型」选「触动精灵」,输入触动「我的账号」→「设备信息」中显示的 IP。
  4. 注意控件节点不支持横屏。

7.3 获取控件与运行脚本

连接成功后点击【控件节点】即可获取屏幕控件;也可在 IDE 中编辑代码,控制脚本的运行与停止。


触动精灵 3.0 IDE 脚本编辑器使用手册

控件节点面板

触动精灵 3.0 IDE 脚本编辑器使用手册

在 IDE 中运行脚本


08 断点调试与书签

8.1 断点调试(仅支持触动)

  1. 点击需要加断点那一行的左侧,出现一个红色圆点即表示断点已设置。
  2. 点击上方的【开始调试】。

触动精灵 3.0 IDE 脚本编辑器使用手册

断点与开始调试

支持跨文件断点在 require 引入的文件中同样可以加断点。例如 A 文件调用 B 文件,可在 A、B 两个文件同时加断点;在 A 文件中点击【开始调试】,两个文件的断点都会生效。

8.2 书签

仅支持 v3.0.7 及其以上版本 IDE。快捷键见第 12 章。


09 设置项

在【文件】→【设置】中可配置以下项目:

设置项 版本要求
是否自动保存代码 —
运行脚本时是否自动发送工程文件 —
设置工程及打包路径 —
是否自动换行 —
截图是否自动保存、设置截图自动保存路径 —
设备列表排序方式(设备 / IP) v3.0.1+
设置自定义代码格式 v3.0.1+
主题选择 v3.0.1+
清空 Key 绑定设备 v3.0.4+

触动精灵 3.0 IDE 脚本编辑器使用手册

设置界面

9.1 更换 Access Key

在【文件】→【更换 Access Key】中,可切换当前登录账号下的 Access Key。


触动精灵 3.0 IDE 脚本编辑器使用手册

更换 Access Key


10 自定义代码格式

取色面板「代码格式」选第六种自定义时,用下列占位符组成输出模板。

参数 功能 备注
#X# 取色列表中的 X 坐标 无
#Y# 取色列表中的 Y 坐标 无
#C# 颜色值 仅支持十六进制
#D# 精确度 无
#SP# 空格 无
#SX# 起始点(左上角)X 坐标 需选择区域,否则显示为 #SX#
#SY# 起始点(左上角)Y 坐标 需选择区域,否则显示为 #SY#
#EX# 终点(右下角)X 坐标 需选择区域,否则显示为 #EX#
#EY# 终点(右下角)Y 坐标 需选择区域,否则显示为 #EY#
#CR# 回车(\r) 无
#LF# 换行(\n) 无
#T# 制表符(\t) 无
#FMC# 输出 findMultiColorInRegionFuzzy 的前两个参数 仅能用于前缀或后缀

中缀参数会重复生成放在中缀的参数会按选取点数重复生成(选了几个点就重复几次),一般用于多点比色函数的参数;前缀和后缀用于固定不变的参数。


11 连不上怎么办

11.1 触动精灵无法连接 IDE

  1. 查授权:确认安装的是标准版 / 专业版,并且有触动授权。未授权时连接,IDE 输出区会提示「未授权,无法连接」。iOS 需购买触动授权(试用无法连接);安卓需登录账号并有 VIP 授权(可在开发者平台绑定触动安卓账号,该账号与开发者平台账号不通用,需在客户端单独注册)。
  2. 查网络:确认编辑器所在电脑与设备处于同一 WiFi / 局域网(不在同一局域网可用蒲公英),并确认能否 ping 通。
  3. 查开关:确认设备上的触动精灵服务开关与局域网广播开关均已开启。
  4. 查代理:确认电脑是否开启了 VPN 或其他代理服务,若有请关闭并取消代理。
  5. 重启服务:重启设备上的触动服务和广播开关。
  6. 重启路由器。

模拟器连接的限制v3.0 版 IDE 连接模拟器暂不支持 ADB,仅支持开启网桥或使用蒲公英,详见连接安卓模拟器。

另外:使用蒲公英后,IDE 的设备日志将无法显示 nLog 返回值。

11.2 其他常见问题

现象 处理方式
客户端有授权,连接 IDE 却显示未授权 docs/8906
连接设备列表显示为空 docs/8910(v3.0.1 及其以上版本已修复)
Mac 电脑无法打开 IDE docs/8889
退出已登录的开发者账号 docs/8837
安装 3.0 版本失败,提示「安装已终止」 docs/8881
取色后颜色列表显示为空 需先点击要取色的点,再用回车 / 数字键 / Ctrl + 鼠标左键取色;同时确认取色面板左上角图标已置灰


12 常用快捷键

12.1 文件与编辑

功能 快捷键
新建文件 Ctrl + N
打开文件 Ctrl + O
关闭当前文件(多个图片时需把鼠标移到图片上) Ctrl + W
保存 Ctrl + S
定位到行 Ctrl + L
代码折叠 Alt + 0
代码展开 Shift + Alt + 0
撤销 Ctrl + Z
重做 Ctrl + Y
查找 Ctrl + F
替换 Ctrl + H
注释 Ctrl + /
代码格式化(按 Lua 原生语法处理) Ctrl + J
自动缩进 Ctrl + I
放大字号 Ctrl + +
恢复原始字号 Ctrl + 0
缩小字号 Ctrl + -

12.2 调试、运行与工程

功能 快捷键
添加 / 删除断点 Ctrl + R
跳转上一个断点 Alt + Shift + M
跳转下一个断点 Alt + Shift + B
添加书签 Ctrl + B
跳转到上一个书签 Alt + Shift + P
跳转到下一个书签 Alt + Shift + N
连接设备 Alt + L
发送文件 Alt + S
远程运行工程 F6
远程运行当前文件 F7
暂停运行 F8
停止运行 F9
编译文件 F10
打包工程 F11
控件节点 Alt + R

12.3 截图与取色器

功能 快捷键
截图 Ctrl + Shift + S
打开 / 关闭取色器 Ctrl + Shift + R
打开 / 关闭输出面板 Ctrl + Shift + O
取色器鼠标指针移动 10 像素 Shift + 方向键(↑ ↓ ← →)
取色器鼠标指针移动 100 像素 Ctrl + 方向键(↑ ↓ ← →)
取色 Ctrl + 鼠标左键 / 0 ~ 9 / 回车
选取范围 Shift + 鼠标左键
放大图片 +
缩小图片 -

12.4 框架自带功能(Windows / Mac)

功能 Windows Mac
代码分析 Alt + E F4
代码分析(第二组) Alt + Shift + E Shift + F4
折叠 / 展开(对光标所在行生效) Alt + F2 Alt + F2
全部展开 Alt + Shift + 0 Command + Option + Shift + 0
全部折叠 Alt + 0 Command + Option + 0
查找下一个 Ctrl + K Command + G
查找上一个 Ctrl + Shift + K Command + Shift + G
选择或查找下一个 Alt + K Ctrl + G
选择或查找上一个 Alt + Shift + K Ctrl + Shift + G
向上选中 Ctrl + Shift + Home Command + Shift + Home / Up
跳到第一行 Ctrl + Home Command + Home / Up
向上选中全部内容 Shift + Up Shift + Up / Ctrl + Shift + P
跳到最后一行 Ctrl + Shift + End Command + Shift + End / Down
向下选中全部内容 Ctrl + End Command + End / Down
向下逐行选中 Shift + Down Shift + Down / Ctrl + Shift + N
向左逐字选中内容 Ctrl + Shift + Left Option + Shift + Left
向左全选内容 / 跳到行最左侧 Alt + Shift + Left Command + Shift + Left / Ctrl + Shift + A
向右逐字选中内容 Ctrl + Shift + Right Option + Shift + Right
向右全选内容 Alt + Shift + Right Command + Shift + Right / Shift + End / Ctrl + Shift + E
跳到所在行最右侧 Alt + Right / End Command + Right / End / Ctrl + E
向下翻页并选中内容 Shift + PageDown 无
向上翻页并选中内容 Shift + PageUp 无
向下滚动 Ctrl + Down 无
向上滚动 Ctrl + Up 无
在括号内左右移动 Ctrl + \ / Ctrl + P Command + \
在括号内向右全选内容 Ctrl + Shift + \ / Ctrl + Shift + P Command + Shift + \
全选括号中的内容 Ctrl + Shift + M Ctrl + Shift + M
删除此行内容 Ctrl + D Command + D
向下重复复制 Ctrl + Shift + D 或 Alt + Shift + Down Command + Shift + D 或 Command + Option + Down
向上重复复制 Alt + Shift + Up Command + Option + Up
向上修改数字 Ctrl + Shift + Up Alt + Shift + Up
向下修改数字 Ctrl + Shift + Down Alt + Shift + Down
向上移动所在行 Alt + Up Option + Up
向下移动所在行 Alt + Down Option + Down
向左删除所在行全部内容 Alt + Backspace Command + Backspace
向左移动 Shift + Tab 或 Ctrl + [ Shift + Tab 或 Ctrl + [
向右移动 Ctrl + ] Ctrl + ]
向右移动文字 Alt + Shift + X Ctrl + T
将大写字母转成小写 Ctrl + Shift + U Ctrl + Shift + U

12.5 Windows 新旧版本快捷键对照

功能 新版 旧版
查找下一个 Ctrl + K F3
查找上一个 Ctrl + Shift + K Shift + F3
选中并查找下一个 Alt + K Ctrl + F3
选中并查找上一个 Alt + Shift + K Ctrl + Shift + F3
替换 Ctrl + H Ctrl + R
定位到行 Ctrl + L Ctrl + G
编译 F10 F7
增加 / 删除书签 Ctrl + B Ctrl + F2
跳转到上一个书签 Alt + Shift + P F2
跳转到下一个书签 Alt + Shift + N Shift + F2
添加 / 删除断点 Ctrl + R Ctrl + F9
跳转上一个断点 Alt + Shift + M Shift + F9
跳转下一个断点 Alt + Shift + B F9
运行当前文件 F7 Alt + W
远程运行工程 F6 F10
停止运行 / 调试 F9 Shift + F5
开始调试 F5 Ctrl + Shift + D
代码分析 Alt + E Shift + F7
快速复制当前行(向下) Ctrl + Shift + D Ctrl + D
删除当前行 Ctrl + D Alt + D
折叠 Alt + 0 F12
取消折叠 Alt + Shift + 0 F12
注释 / 取消注释 Ctrl + / Ctrl + U
截图 Ctrl + Shift + S Ctrl + Shift + Q


13 附录

13.1 触动精灵脚本开发指南

新手必读,包含最全面的脚本开发常识、视频教程与开发工具:docs/4945。

13.2 已知与触动精灵冲突的插件

showUI 弹不出、点击没反应、滑动失效等问题,有可能是安装了冲突插件导致:docs/536。

 

47 人觉得有帮助 有帮助