触动精灵脚本编辑器(以下简称 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 的工程路径,否则会出现工程下文件取消关联的问题。
授权、网络、Key,这三件事任意一件不对,连不上设备。 账号不通用触动账号与开发者平台账号不通用,需要在触动精灵手机客户端单独注册。购买的账号无法在开发者平台绑定。 每个开发者账号会免费赠送一个 Access Key,最多可连接 5 个设备(5 个免费接口)。 两者相互独立Access Key 只代表允许连接触动、搭建中控;触动本身仍必须有授权才能连接成功。不要把 Access Key 当成触动授权。 IDE 连接触动精灵及积木编程默认需要局域网:设备和电脑连同一个路由器,且两者 IP 前三段相同才算同一局域网。 设备 IP 可在「触动精灵 → 更多 / 我的账号 → 设备信息」中查看。 跨网络时广域网环境(例如模拟器)需要开启网桥或使用蒲公英再试,详见 docs/4967#title-6。 积木编程仅支持 v3.0.4 及其以上版本 IDE,连接方法见 docs/4967#title-12。 连上了却提示未授权专业版 / 标准版 / 个人版已购买授权,但连接时显示未授权或局域网通讯异常,处理办法见 docs/8906。
02 使用前必读
2.1 授权相关
客户端
连接 IDE 的授权要求
iOS 标准版 / 专业版 / 个人版
需购买触动授权(触动商城或客户端内购买)。试用状态无法连接 IDE。
安卓标准版 / iOS 个人版
需登录账号并有 VIP 授权。可在开发者平台个人中心绑定触动账号以获赠 VIP 授权(开发者账号需通过实名验证)
2.2 Access Key 与触动授权的区别
2.3 网络要求
下载地址:www.touchsprite.com/download。注意区分 Windows 版本与 Mac 版本。 如还没有开发者平台账号,请到开发者平台注册。登录后才能连接设备、截图、运行代码。 免费 Key 最多连接 5 台设备。连接超过 5 台后,新设备将无法连接。
03 下载与登录
3.1 下载
3.2 登录
3.3 设备数超限
推荐方案使用蒲公英进行连接,详见这篇教程。这是官方推荐的首选方式。 以雷电 / 夜神模拟器为例:打开模拟器 → 设置 → 网络设置 → 开启网络桥连 → IP 设置选 DHCP → 安装驱动 → 保存设置 → 重启模拟器。之后输入模拟器显示的 IP,即可连接 IDE 及抓色器。 建议同时打开推荐智控和 IDE 同时打开,否则 IDE 可能获取不到设备列表。
04 连接设备
4.1 局域网连接
4.2 广域网连接
模拟器怎么开网桥
4.3 连接触动智控
点击【新建工程】→ 输入工程名称 → 选择产品线 → 【确定】,工程列表中即会显示新工程。IDE 会根据所选产品线生成对应的工程图标。 点击【文件】→【导入工程】→ 选择需要导入的工程文件夹 →【确定】,即可把旧版 IDE 工程导入到新版工程列表中。 选择工程 → 鼠标右键 →【导入文件到工程】→ 选择文件 →【打开】。IDE 会按文件格式自动归类: 连接触动后,选中工程 → 鼠标右键 →「发送工程到设备」,工程下所有文件会按目录发送到设备对应位置: 如果只想发单个文件:选中文件 → 鼠标右键 →「发送当前文件到设备」,落点规则与上表相同。 仅支持 v3.0.1 及其以上版本 IDE。 具体函数调用方式见 require 调用子文件夹下文件。 删除线的含义工程中带删除线的文件表示已取消关联:文件仍在工程中不会被删除,但工程打包和发送到设备时会被忽略。 想恢复关联,选中已取消关联的文件 → 鼠标右键 →【关联】。 升级后文件全部失效?从 v3.0.0 升级到 v3.0.1 及其以上版本后,所有工程下的文件会被设置为取消关联状态。请选中工程 → 鼠标右键 →【全部关联】重新关联。
05 工程管理
5.1 新建工程
5.2 导入工程
5.3 导入文件到工程
文件类型
自动归入目录
lua 文件
源码
txt、png、jpg 等
资源
so、tsl 等
插件
5.4 发送文件到设备
工程目录
设备端落点
源码
触动脚本目录(
lua 文件夹)
资源
触动资源目录(
res 文件夹)
插件
触动插件目录
5.5 调用子文件夹下的文件
5.6 关联与取消关联
操作
方式
版本
单个文件 关联 / 取消关联
选中文件 → 鼠标右键 →【关联】/【取消关联】
—
批量 全部关联 / 全部取消关联
选中工程、源码、资源、插件或子文件夹 → 鼠标右键
v3.0.1+
截图的前提是已连接设备成功。 按下 想取第 11 ~ 20 个点的坐标和颜色,需要用 三条细节 裁剪出的图片添加到工程、发送到设备后,即可用找图函数找图。 显示错位的小问题当屏幕缩放比例超过 100% 且图片有滚动条时,长按方向键移动可能导致左侧显示位置与右侧放大镜位置不符,属已知现象。
06 截图与取色
6.1 截图
ALT + TAB 可在编辑器与抓色器界面之间切换。截图默认快捷键:CTRL + SHIFT + S。6.2 取色快捷键
操作
快捷键
说明
取色
Ctrl + 鼠标左键—
取色
回车—
取色
数字 0 ~ 91 ~ 9 对应右侧序号的颜色,0 对应第 10 号
Ctrl + 鼠标左键 或 回车。6.3 取色面板各按钮
编号
功能
说明
1
坐标输入框
点击输入框,输入坐标并回车,会显示该坐标对应的颜色
2
重新取色
在图一拾取坐标后切到图二,点击「重新取色」会沿用同一坐标在图二对应位置取色,用于对比多张图同一像素点的颜色差异
3
选择范围
点击按钮后,用鼠标左键滑动选择查找范围;也可在按钮下方的输入框自定义范围
4
找色起始点
可选左上角、右上角、左下角、右下角
5
代码格式
共有六种预设,自定义格式见 docs/4967#title-18
6
找色方向
设置找色方向
7
测试
连接设备后点击,结果会显示在日志窗口
8
坐标颜色
坐标颜色列表,点击【删除】可移除不需要的颜色及坐标
6.4 剪切(v3.1.1 及以上)
支持范围仅支持 v3.0.4 及其以上版本 IDE,且仅支持触动精灵安卓标准版与积木编程,需要开启无障碍开关。 截图方向为横屏时,该按钮会置灰,请切换到竖屏再试。 怎么判断无障碍开好了打开无障碍开关后,如果正常跳转到触动或积木,说明开关生效;反之说明异常。请重启无障碍开关、重启触动或积木,仍不行则重启手机。 连接成功后点击【控件节点】即可获取屏幕控件;也可在 IDE 中编辑代码,控制脚本的运行与停止。
07 控件节点
7.1 连接积木编程
7.2 连接触动精灵
7.3 获取控件与运行脚本
支持跨文件断点在 仅支持 v3.0.7 及其以上版本 IDE。快捷键见第 12 章。
08 断点调试与书签
8.1 断点调试(仅支持触动)
require 引入的文件中同样可以加断点。例如 A 文件调用 B 文件,可在 A、B 两个文件同时加断点;在 A 文件中点击【开始调试】,两个文件的断点都会生效。8.2 书签
在【文件】→【设置】中可配置以下项目: 在【文件】→【更换 Access Key】中,可切换当前登录账号下的 Access Key。
09 设置项
设置项
版本要求
是否自动保存代码
—
运行脚本时是否自动发送工程文件
—
设置工程及打包路径
—
是否自动换行
—
截图是否自动保存、设置截图自动保存路径
—
设备列表排序方式(设备 / IP)
v3.0.1+
设置自定义代码格式
v3.0.1+
主题选择
v3.0.1+
清空 Key 绑定设备
v3.0.4+
9.1 更换 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 的前两个参数
仅能用于前缀或后缀
模拟器连接的限制v3.0 版 IDE 连接模拟器暂不支持 ADB,仅支持开启网桥或使用蒲公英,详见连接安卓模拟器。 另外:使用蒲公英后,IDE 的设备日志将无法显示 nLog 返回值。
11 连不上怎么办
11.1 触动精灵无法连接 IDE
11.2 其他常见问题
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 + R12.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 + EF4
代码分析(第二组)
Alt + Shift + EShift + F4
折叠 / 展开(对光标所在行生效)
Alt + F2Alt + F2
全部展开
Alt + Shift + 0Command + Option + Shift + 0
全部折叠
Alt + 0Command + Option + 0
查找下一个
Ctrl + KCommand + G
查找上一个
Ctrl + Shift + KCommand + Shift + G
选择或查找下一个
Alt + KCtrl + G
选择或查找上一个
Alt + Shift + KCtrl + Shift + G
向上选中
Ctrl + Shift + HomeCommand + Shift + Home / Up
跳到第一行
Ctrl + HomeCommand + Home / Up
向上选中全部内容
Shift + UpShift + Up / Ctrl + Shift + P
跳到最后一行
Ctrl + Shift + EndCommand + Shift + End / Down
向下选中全部内容
Ctrl + EndCommand + End / Down
向下逐行选中
Shift + DownShift + Down / Ctrl + Shift + N
向左逐字选中内容
Ctrl + Shift + LeftOption + Shift + Left
向左全选内容 / 跳到行最左侧
Alt + Shift + LeftCommand + Shift + Left / Ctrl + Shift + A
向右逐字选中内容
Ctrl + Shift + RightOption + Shift + Right
向右全选内容
Alt + Shift + RightCommand + Shift + Right / Shift + End / Ctrl + Shift + E
跳到所在行最右侧
Alt + Right / EndCommand + Right / End / Ctrl + E
向下翻页并选中内容
Shift + PageDown无
向上翻页并选中内容
Shift + PageUp无
向下滚动
Ctrl + Down无
向上滚动
Ctrl + Up无
在括号内左右移动
Ctrl + \ / Ctrl + PCommand + \
在括号内向右全选内容
Ctrl + Shift + \ / Ctrl + Shift + PCommand + Shift + \
全选括号中的内容
Ctrl + Shift + MCtrl + Shift + M
删除此行内容
Ctrl + DCommand + D
向下重复复制
Ctrl + Shift + D 或 Alt + Shift + Down
Command + Shift + D 或 Command + Option + Down
向上重复复制
Alt + Shift + UpCommand + Option + Up
向上修改数字
Ctrl + Shift + UpAlt + Shift + Up
向下修改数字
Ctrl + Shift + DownAlt + Shift + Down
向上移动所在行
Alt + UpOption + Up
向下移动所在行
Alt + DownOption + Down
向左删除所在行全部内容
Alt + BackspaceCommand + Backspace
向左移动
Shift + Tab 或 Ctrl + [
Shift + Tab 或 Ctrl + [
向右移动
Ctrl + ]Ctrl + ]
向右移动文字
Alt + Shift + XCtrl + T
将大写字母转成小写
Ctrl + Shift + UCtrl + Shift + U12.5 Windows 新旧版本快捷键对照
功能
新版
旧版
查找下一个
Ctrl + KF3
查找上一个
Ctrl + Shift + KShift + F3
选中并查找下一个
Alt + KCtrl + F3
选中并查找上一个
Alt + Shift + KCtrl + Shift + F3
替换
Ctrl + HCtrl + R
定位到行
Ctrl + LCtrl + G
编译
F10F7
增加 / 删除书签
Ctrl + BCtrl + F2
跳转到上一个书签
Alt + Shift + PF2
跳转到下一个书签
Alt + Shift + NShift + F2
添加 / 删除断点
Ctrl + RCtrl + F9
跳转上一个断点
Alt + Shift + MShift + F9
跳转下一个断点
Alt + Shift + BF9
运行当前文件
F7Alt + W
远程运行工程
F6F10
停止运行 / 调试
F9Shift + F5
开始调试
F5Ctrl + Shift + D
代码分析
Alt + EShift + F7
快速复制当前行(向下)
Ctrl + Shift + DCtrl + D
删除当前行
Ctrl + DAlt + D
折叠
Alt + 0F12
取消折叠
Alt + Shift + 0F12
注释 / 取消注释
Ctrl + /Ctrl + U
截图
Ctrl + Shift + SCtrl + Shift + Q
新手必读,包含最全面的脚本开发常识、视频教程与开发工具:docs/4945。 showUI 弹不出、点击没反应、滑动失效等问题,有可能是安装了冲突插件导致:docs/536。
13 附录
13.1 触动精灵脚本开发指南
13.2 已知与触动精灵冲突的插件