- 简介
- v3.0 版本 IDE 常用功能
- 注意事项(请先看这一条)
- 端口号说明
- v3.0 版本 IDE 新增功能
- 下载
- 登录
- 连接设备
- 导入工程
- 新建工程
- 调用子文件夹下的文件
- 注意
- 截图
- 获取控件
- 断点调试
- 书签
- 设置中的功能
- 触动精灵无法连接 IDE
- 其他常见问题
- 常用快捷键
- v1.2.3 版本 IDE 功能介绍
- 下载软件
- 视频教程
- 常见问题和注意事项
- 函数调用堆栈
- 使用说明
- 软件界面
- 视图操作
- 远程设备管理
- 远程设备文件管理
- 控制台操作说明
- 创建工程
- 连接设备
- 连接安卓模拟器
- USB 连接苹果手机(此方法不支持连接 v3.0 版本 IDE)
- 连接设备报错
- 远程调试
- 连接 IDE 显示连接成功但是显示 code:L 400 错误
- nLog 不输出日志
- 编辑器左侧栏不显示中文函数
- 打包失败
- 自定义界面
- 触动精灵脚本格式
- 常用快捷键
- 脚本编辑
- 附录
可以在右侧目录查看内容,Windows 系统电脑可以使用 CTRL+F 进行搜索内容,Mac 系统电脑可以使用 command+F 进行搜索内容。
简介
触动精灵脚本编辑器(以下简称编辑器)是触动精灵为广大脚本开发者提供的一个电脑端的集成开发工具,具有脚本编辑、工程管理、函数补全、关键字高亮、函数库高亮、脚本检错、工程打包、远程导入、远程运行、远程调试、日志输出等功能。
v3.0 版本 IDE 常用功能
已内置取色器功能,需要连接设备后点击截图。
取色面板代码格式中的自定义格式,需要在【文件】-【设置】中进行设置,具体操作详见 https://www.touchsprite.com/docs/4967#title-15。
工程中的文件显示删除线意味此文件未关联到工程,发送工程此文件不会发送到设备,可以点击工程鼠标右键 - 全部关联进行关联文件。
连接设备提示超过连接上限,可以点击左上角的【文件】-【清空 Key 绑定设备】-【确定】进行清空设备。
使用调试功能需要在代码开头增加断点,具体操作详见 https://www.touchsprite.com/docs/4967#title-13。
第一次使用 3.0 版本 IDE,如果有旧版 IDE 的工程文件,可以点击【文件】 - 【导入工程】选择工程文件夹,将旧版工程导入到新版 IDE 工程列表中,不要将 v3.0 版本 IDE 的工程目录直接设置为旧版 IDE 工程路径,否者会出现工程下文件取消关联的问题。
注意事项(请先看这一条)
v3.0 版本编辑器已不支持 print 函数,print 函数仅支持 v1.2.3 版本编辑器的调试(本地调试)功能,触动函数在 v1.2.3 版本编辑器不支持调试(本地调试),仅支持直接运行。
获取控件仅支持 v3.0 版本编辑器,不支持 v1.2.3 版本编辑器。
nLog 函数输出信息请在 v1.2.3 版本编辑器的日志输出面板,v3.0.0 及其以上版本编辑器的设备日志面板查看。
专业版/标准版已购买授权连接显示未授权或者局域网通讯异常,解决办法详见 https://www.touchsprite.com/docs/8906。
3.0 版本编辑器连接触动精灵/积木编程请选择局域网,连接智控设备请选择 USB 连接。
v3.0 版本 IDE 不支持使用 ADB 进行连接模拟器及不支持使用 USB 连接 iOS 设备,请开启网桥或者使用蒲公英进行连接,不支持在不连接触动的情况下直接在 IDE 运行代码。
IDE 连接触动精灵及积木编程需要是局域网(设备和电脑连接同一个路由器,设备和电脑 IP 前三段相同才是局域网,设备 IP 请在触动精灵 - 更多/我的账号 - 设备信息中查看),非局域网如模拟器请开启网桥或者使用蒲公英再试,具体操作详见 https://www.touchsprite.com/docs/4967#title-6。
积木编程仅支持 v3.0.4 及其以上版本 IDE,IDE 下载地址:https://www.touchsprite.com/download,具体连接方法详见 https://www.touchsprite.com/docs/4967#title-12。
如果 IDE 想连接触动一定要在设备上安装触动,安装教程详见:https://www.touchsprite.com/docs/685。
IDE 仅支持连接 iOS 标准版/专业版、安卓标准版、积木编程及触动智控,不支持连接其他产品。
安卓标准版需要登录账号并有 VIP 授权,可以在开发者平台的个人中心绑定触动安卓账号(绑定位置如下图)会自动赠送 VIP 授权(具体绑定位置如下图,开发者账号需要通过实名验证),注意触动安卓账号与开发者平台账号不通用,需要在触动精灵手机客户端单独注册或者在触动官网商城购买账号(购买账号无法在开发者平台绑定)。
iOS 标准版/专业版需要购买触动授权,可以在触动商城/客户端内置购买授权,试用状态无法连接 IDE。
Key 和触动授权区别
每个开发者账号会赠送一个免费的 Acess Key 可以最多连接 5 个设备(5 个免费的接口),此权限仅是可以进行连接触动及搭建中控,但是触动需要有授权才能连接成功,不要将 Acess Key 和触动授权混淆,它们是独立的。
端口号说明
如果使用的是触动端口号则默认为 50005,模拟器、真机、iOS 设备端口号都为 50005,非模拟器端口号。
如果使用的是积木编程(LuaBox)则端口号为 50007,模拟器、真机设备端口号都为 50007,非模拟器端口号,使用控件节点需要先连接到积木编程方能使用(此功能仅支持 v3.0.4 及其以上版本 IDE)。
v3.0 版本 IDE 新增功能
1.新增导入工程的功能(文件 - 导入工程)
2.新增工程文件取消关联、关联的功能(工程 - 选择文件 - 鼠标右键 -关联/取消关联)
3.新增自动保存代码的功能(文件 - 设置)
4.新增运行脚本自动发送工程文件的功能(文件 - 设置)
5.新增修改工程打包路径的功能(文件 - 设置)
6.新增抓色器截图自动保存路径的功能(文件 - 设置)
7.新增切换 Acess Key 的功能(文件 - 设置)
8.新增函数手册,可以实时查看最新版本开发文档
- 支持连接智控设备。
下载
注意区分 Windows 版本及 Mac 版本
点击下载内测版编辑器,内测版本可连接智控设备,不使用智控设备请使用正式版,具体操作详见下方的连接设备。
登录
点击右上角的【登录】按钮 - 输入开发者平台账号、密码 - 选择需要使用的 Acess Key - 点击【确定】,如果没有开发者平台账号、密码请在开发者平台进行注册。
登录后才能连接设备、截图、运行代码。
如果连接超过 5 台设备,连接新设备将无法连接。可以登录 https://account.touchsprite.com/access-key 点击【设备】-【清空设备】清空已连接的设备,目前 v3.0.5 及其以上版本 IDE 已内置此功能,请点击【文件】 - 【设备】 - 【清空 Key 绑定设备】清空已连接的设备。
连接设备
连接触动及积木编程请选择局域网,连接智控设备请选择 USB 连接。
点击【连接设备】按钮会显示和电脑在同一局域网下有客户端授权并且开启触动服务开关的的设备 IP 列表,双击需要连接的设备 IP 或者选择 IP 点击下方的【连接】按钮都可以连接到设备,点击【刷新】按钮可以刷新设备 IP 列表。
IDE 连接设备需要是局域网(设备和电脑连接同一个路由器,设备和电脑 IP 前三段相同才是局域网,设备 IP 请在触动精灵 - 更多/我的账号 - 设备信息中查看),非局域网模拟器请开启网桥或者使用蒲公英再试。
v3.0 版本 IDE 不支持使用 USB 进行连接 iOS 设备,仅支持局域网或者使用蒲公英进行连接。
连接模拟器请注意看以下内容
v3.0 版本 IDE 连接模拟器不支持 ADB 进行连接,仅支持开启网桥或者使用蒲公英进行连接,具体使用方法详如下,使用蒲公英后在 IDE 的设备日志将无法显示 nLog 返回值。
第一种方法:
使用蒲公英进行连接,请点击这里查看使用方法,推荐使用第一种方法进行连接。
第二种方法:
雷电/夜神模拟器设置局域网的方法: 打开模拟器后点击设置 ->点击网络设置->开启网络桥连->IP 设置选择 DHCP->安装驱动->点击保存设置->重启模拟器。
输入雷电模拟器显示的 IP 即可连接 IDE 及抓色器。
连接触动智控
必须登录与触动智控相同的账号并且在智控购买套餐授权后方能连接设备。
安装 WebDriverAgent 程序及购买套餐授权详见智控使用手册:https://www.touchsprite.com/docs/11114。
推荐智控和 IDE 同时打开,否则可能 IDE 无法获取到设备列表。
在手机端打开 WebDriverAgent 程序并且使用数据线与 Win 内测版编辑器连接。
点击下载内测版编辑器。
点击「连接设备」 - 选择 USB 连接 - 点击设备名 - 点击「连接」。
设置截图方向
在连接设备页面可以设置屏幕方向:竖屏、横屏。
导入工程
点击【文件】 - 【导入工程】 - 选择需要导入的工程文件夹 - 【确定】,可以将旧版 IDE 工程文件导入到新版工程列表中。
新建工程
点击【新建工程】 - 输入工程名称 - 【确定】,工程列表中会显示新创建的工程名称。
导入文件到工程
选择需要添加的工程 - 鼠标右键 - 【导入文件到工程】 - 选择需要添加的文件 - 【打开】,IDE 会按照文件格式将文件自动添加到源码(lua 文件)、资源(txt、png、jpg 文件等)、插件(so、tsl 文件等)目录下。
发送文件
连接触动后选择工程后鼠标右键点击发送工程到设备,可以将此工程下的所有文件按照添加的目录发送到设备对应的目录下,源码下的文件发送到触动脚本目录(lua 文件夹),资源下文件发送到触动资源目录(res 文件夹),插件目录下的文件发送到触动插件目录下。
选择需要发送的文件 - 鼠标右键 - 点击发送当前文件到设备,可以将文件发送到触动的指定目录,目录与发送工程到设备的目录相同。
调用子文件夹下的文件
仅支持v3.0.1及其以上版本
1.在工程文件夹(工程鼠标右键点击显示位置)下手动创建文件夹。
2.将需要调用的文件添加到创建的文件夹下。
3.鼠标右键点击【刷新】。
4.选择添加的文件或者子文件夹 - 鼠标右键点击【全部关联】。
5.将工程发送到设备即可。
具体函数调用方向详见 require 调用子文件夹下文件。
关联
选择工程下的文件 - 鼠标右键 - 【关联】/【取消关联】。
选择工程/源码、资源、插件、子文件夹 - 鼠标右键 - 【全部关联】/【全部取消关联】。(v3.0.1 及其以上版本支持)。
取消关联的功能是此文件在工程中不会被删除但是在工程打包及发送工程到设备将被忽略,不进行操作,取消关联后文件名称将增加删除线;如果想恢复为关联状态可以选择取消关联的文件 - 鼠标右键 - 【关联】。
注意
从 v3.0.0 版本升级到3.0.1及其以上版本后所有工程下的文件会设置为取消关联状态,可以选择工程 - 鼠标右键点击【全部关联】进行关联文件。
截图
连接设备成功后才能进行截图。
点击【截图】会截图当前页面的画面。
点击【取色】按钮会显示取色面板,再次点击【取色】则取色面板会隐藏。
取色快捷键
1.Ctrl + 鼠标左键
2.回车
3.数字 1 - 9
如果想取序号 10 - 20 点的坐标和颜色需要使用Ctrl+鼠标左键或者回车键。
取色面板其他按钮对应的功能
1.点击坐标输入框 - 输入坐标并回车会显示坐标对应的颜色。
2.刷新列表
功能为 打开图片一进行取色,打开图片二点击刷新列表并进行取色,再次再打开图片一,点击刷新列表,图片二取的坐标和颜色值会显示在图片一取色面板的坐标颜色列表中,意思是将多个图上取色的颜色值和坐标合并到一张图的取色面板上。
3.选择范围
点击【选择范围按钮】 - 鼠标左键滑动可以选择查找范围。
点击选择范围按钮下方的输入框可以自定义查找范围。
4.设置找色起始点:左上角、右上角、左下角、右下角。
5.选择代码格式共有六种,自定义代码格式详见 https://www.touchsprite.com/docs/4967#title-15。
6.设置找色方向。
7.点击【测试】按钮在日志窗口会显示已找到或者未找到。
8.坐标颜色列表,点击【删除】按钮可以删除不需要的颜色及坐标。
获取控件
此功能仅支持 v3.0.4 及其以上版本 IDE,仅支持触动精灵安卓标准版及积木编程并且需要开启无障碍开关。
连接积木编程
- 在设备上打开积木编程无障碍开关,积木编程使用方式详见 https://www.touchsprite.com/docs/9099。
- 设备和电脑需要在同一局域网下(不是局域网请使用蒲公英,模拟器连接方法请点击这里)。
- 连接设备端口号修改为 50007。
- 不支持横屏。
打开【积木编程】 - 点击【我的】- 【IP端口】后显示的 IP 即为在 IDE 点击【连接设备】后需要输入的 IP - 将端口号修改为 50007 - 点击【连接】。
连接触动
获取控件
连接成功后点击【控件节点】可以获取屏幕控件。
运行/停止脚本
连接成功后可以在 IDE 编辑代码,控制脚本运行/停止。
积木编程开发文档链接:https://luabox-book.touchsprite.com/
积木编程使用文档链接:https://www.touchsprite.com/docs/9099
断点调试
点击需要加断点行的左侧,点击后显示一个红色的圆心,点击上方的【开始调试】即可。
同时支持在 require 的文件中加断点,如 A 文件中调用 B 文件,可以在 A、B 两个文件中同时加断点,在 A 文件中点击【开始调试】,在 A、B 两个文件中的断点都会生效。
书签
仅支持 v3.0.7 及其以上版本 IDE。
设置中的功能
在【文件】 - 【设置】中可以设置以下功能
- 是否自动保存代码
- 运行脚本时是否自动发送工程文件
- 设置工程及打包路径
- 是否自动换行
- 截图是否自动保存、设置截图自动保存路径
- 设备列表排序方式(设备/IP)(v3.0.1 及其以上版本)
- 设置自定义代码格式(v3.0.1 及其以上版本)
- 主题选择(v3.0.1 及其以上版本)
- 清空 Key 绑定设备(v3.0.4 及其以上版本)
自定义代码格式
(#X#) 为取色列表中的 X 坐标,使用时请去掉 ()
(#Y#) 为 Y 坐标,使用时请去掉 ()
(#C#) 为颜色值,此处仅支持十六进制,使用时请去掉 ()
(#D#) 为精确度,使用时请去掉 ()
(#SP#) 为空格,使用时请去掉 ()
以下参数仅支持 v3.0.2 及其以上版本
(#SX#) 为设置的起始点(左上)的 X 坐标(Sx),使用时请去掉 (),使用此参数需要选择区域否则会显示为 #SX#
(#SY#) 为设置的起始点(左上)的 Y 坐标,使用时请去掉 (),使用此参数需要选择区域否则会显示为 #SY#
(#EX#) 为设置的终点(右下)的 X 坐标(EX),使用时请去掉 (),使用此参数需要选择区域否则会显示为 #EX#
(#EY#) 为设置的终点(右下)的 Y 坐标,使用时请去掉 (),使用此参数需要选择区域否则会显示为 #EY#
(#CR#) 为回车 (\r) (CR),使用时请去掉 ()
(#LF#) 为换行 (\n),使用时请去掉 ()
(#T#) 为制表符 (\t),使用时请去掉 ()
(#FMC#) 为输出 findMultiColorInRegionFuzzy 的前两个参数(此标签仅能用于前缀或者后缀)使用时请去掉 ()
注意事项
中缀的参数会重复生成(选取了几个点就会重复生成几次),一般适用于多点比色函数所使用的参数,前缀和后缀用于固定不变的参数
在【文件】 - 【更换 Access Key】中可以切换登录账号下的 Access Key。
触动精灵无法连接 IDE
- 检查是否安装的是标准版/专业版同时是否有触动授权(未授权连接 IDE 输出结果提示“未授权,无法连接”),iOS 需要购买触动授权(试用无法连接),安卓需要登录账号有 VIP 授权(无 VIP 授权可以在开发者平台绑定触动安卓账号,此账号与开发者平台账号不通用,需要在客户端重新注册)。
- 检查编辑器所在电脑和设备是否在同一 WiFi 网络下(如果未在同一局域网下可以使用蒲公英),是否能 ping 通
- 检查设备上的触动精灵服务和广播开关是否为开启状态
- 检查电脑上是否开启了 VPN 或其他代理服务,如果是,请关掉并去掉代理
- 重启设备上的触动服务和广播开关
- 重启路由器
v3.0 版本 IDE 连接模拟器暂不支持 ADB 进行连接,仅支持开启网桥或者使用蒲公英进行连接,具体使用方法详见此文档中的连接安卓模拟器,使用蒲公英后在IDE的设备日志将无法显示 nLog 返回值。
其他常见问题
客户端有授权连接 IDE 显示未授权详见 https://www.touchsprite.com/docs/8906
连接设备列表显示为空(v3.0.1及其以上版本已修复)详见 https://www.touchsprite.com/docs/8910
Mac 电脑无法打开 IDE 详见 https://www.touchsprite.com/docs/8889
退出已登录的开发者账号详见 https://www.touchsprite.com/docs/8837
安装 3.0 版本 IDE 无法安装成功显示安装已终止详见 https://www.touchsprite.com/docs/8881
取色后颜色列表显示为空:需要先点击需要取色的点再使用回车/数字键/Ctrl 加鼠标左键进行取色,需要取色面板左上角图标置灰。
常用快捷键
- 新建文件
Ctrl+N
- 打开文件
Ctrl+O
- 关闭当前文件
Ctrl+W
- 保存
Ctrl+S
- 定位到行(仅支持 v3.0.1 及其以上版本)
Ctrl+L
- 代码折叠(仅支持 v3.0.1 及其以上版本)
Alt+0
- 代码展开(仅支持 v3.0.1 及其以上版本)
Shift+Alt+0
- 撤销
Ctrl+Z
- 重做
Ctrl+Y
- 查找
Ctrl+F
- 替换
Ctrl+H
- 注释
Ctrl+/
- 代码格式化
Ctrl+J(按照 Lua 原生语法对代码进行格式化处理)
- 自动缩进(仅支持 v3.0.1 及其以上版本)
Ctrl+I
- 放大字号(仅支持 v3.0.1 及其以上版本)
CTRL++
- 恢复原始字号(仅支持 v3.0.1 及其以上版本)
CTRL+0
- 缩小字号(仅支持 v3.0.1 及其以上版本)
CTRL+-
- 连接设备
Alt+L
- 发送文件
Alt+S
- 远程运行工程
F6
- 远程运行当前文件
F7
- 暂停运行
F8
- 停止运行
F9
- 编译文件
F10
- 打包工程
F11
- 截图
Ctrl+Shift+S
- 控件节点
Alt+R
- 打开/关闭取色面板
Ctrl+Shift+R
- 打开/关闭输出面板
Ctrl+Shift+O
- 取色面板移动鼠标指针定位 10 个像素(仅支持 v3.0.1 及其以上版本)
Shift + 光标键(↑ ↓ ← →)
- 取色面板移动鼠标指针定位 100 个像素(仅支持 v3.0.1 及其以上版本)
Ctrl + 光标键(↑ ↓ ← →)
- 鼠标左键取色
Ctrl+鼠标左键
- 数字取色快捷键(仅支持 v3.0.1 及其以上版本)
0-9
- 回车键取色(仅支持 v3.0.1 及其以上版本)
回车键,坐标颜色列表为空时需要使用鼠标左键点击需要取色的点,再点击回车
- 选取范围(仅支持 v3.0.1 及其以上版本)
Shift+鼠标左键
- 添加书签
Ctrl+B
框架自带功能
功能 | Windowx 系统 | 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|Command-Shift-Up |
跳到第一行 | Ctrl-Home | Command-Home|Command-Up |
向上选中全部内容 | Shift-Up | Shift-Up|Ctrl-Shift-P |
跳到最后一行 | Ctrl-Shift-End | Command-Shift-End|Command-Shift-Down |
向下选中全部内容 | Ctrl-End | Command-End|Command-Down |
向下逐行选中 | Shift-Down | Shift-Down|Ctrl-Shift-N |
向左逐字选中内容 | Ctrl-Shift-Left | Option-Shift-Left |
向左全选内容 | Alt-Shift-Left | Command-Shift-Left|Ctrl-Shift-A |
跳到所在行最左侧 | 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 | Command-Shift-D |
向下重复复制 | Alt-Shift-Down | 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 | Shift-Tab |
向左移动 | Ctrl-[ | Ctrl-[ |
向右移动 | Ctrl-] | Ctrl-] |
向右移动文字 | Alt-Shift-X | Ctrl-T |
将大写字母转成小写 | Ctrl-Shift-U | Ctrl-Shift-U |
v1.2.3 版本 IDE 功能介绍
下载软件
下载地址:https://www.touchsprite.com/download
IDE 为绿色版本,解压即可,无需安装。
视频教程
常见问题和注意事项
http://v.youku.com/v_show/id_XMTgwNzY3NzAwNA==.html
函数调用堆栈
http://v.youku.com/v_show/id_XMTM0NDQ5MzM1Ng==.html
使用说明
Access Key
首次使用编辑器时,需要输入触动精灵 TS Remote API 的 Access Key,目的是保证编辑器和触动精灵客户端的连接更稳定。
Access Key 可在触动精灵开发者平台获取,注册成功后可在个人中心-> TS Remote API 中查看。
如何修改 key
在编辑器安装路径下找到 key.txt,替换文档中的内容即可。
软件界面
视图操作
>在主菜单中的视图菜单中可以对编辑器的一些窗口进行打开/关闭操作,包含 文件管理、工程、设备管理、函数列表、输出窗口等。
- 双击任意扩展窗口分页空白处可激活该窗口的移动/拆分功能,可利用此功能自行对各功能窗口进行合理摆放。
- 输出、本地控制台、日志输出,这三个窗口仅可以移动位置,不能进行拆分。
- 设备管理、函数列表窗口与工程窗口合并时关闭工程窗口将导致三个窗口一起关闭,初次使用请在视图菜单中将工程窗口置于开启状态。
函数视图中会显示当前打开的脚本文件中所有的函数列表
远程设备管理
在快捷视图的设备栏中我们可以对局域网中的远程设备进行管理、这也是文件发送和远程调试运行的必要前提。
- 在设备栏中的空白区域点击鼠标右键,在快捷菜单中选择搜索设备,所有在同一局域网中安装过触动精灵 iOS v2.1.7 或 Android v1.1.4 以上版本的设备将会出现在此窗口中。iOS设备以蓝色图标显示,安卓设备以绿色图标显示,如有设备没有正常出现在列表中可多次使用搜索设备功能进行搜索或者选择菜单中的添加设备,手动输入设备 IP 地址进行添加。
- 如遇不能添加设备的情况,可以在触动精灵更多界面中检查局域网广播开关是否开启、远程设备与电脑是否在同一个网段、是否打开了多个编辑器窗口导致端口占用、电脑中的防火墙是否关闭、系统中是否安装有虚拟网卡,这些因素都可能会导致添加设备失败。
- 通过选中设备栏中已添加的设备,并点击快捷工具栏中的连接设备按钮可建立电脑与移动设备之间的通讯,连接成功后可对此设备进行文件发送、远程运行、远程调试、重启、注销等操作。
远程设备文件管理
在快捷视图设备栏中,双击设备可查看远程设备的 TouchSprite
下的目录结构及文件,右键点击文件,在快捷菜单中选获取文件可将该文件获取到本地目录、点击删除文件可将远程设备上的该文件删除。
- 可操作的目录仅限于
TouchSprite\lua
TouchSprite\res
TouchSprite\log
TouchSprite\plugin
TouchSprite\config
。
控制台操作说明
- 右键菜单 - 清除输出窗口 清除当前窗口的输出日志
- 输出窗口 显示设备连接状态(成功与否)、脚本运行状态
-
日志输出 显示脚本运行远程日志(相关函数 nLog)
创建工程
创建工程会在工程目录创建一个工程文件夹,里面包含脚本主文件 main.lua、音频图片资源、其他工程文件等。
注意事项
触动精灵工程默认保存在[TS Studio程序目录]/workspace
下,启动程序后自动读取工程显示在左边的工程树中,可以通过文件菜单中设置工程路径改变此默认路径。
- 工程中的 main.lua 为脚本主文件,实际执行的脚本将最先加载此文件,不能删除和重命名。
- 在工程名上单击鼠标右键,可以对此工程进行的操作。
- 在工程中可以添加多个其他文件至工程中,系统将会对导入的文件进行自动分类,可导入工程的文件包含但不限于
*.lua
*.luac
*.png
*.jpg
*.bmp
*.so
*.dylib
*.txt
,so 库和 dylib 库将直接归入工程中的插件分类,除 lua 及 luac 以外的文件将直接归入工程中的资源分类。 - 在工程鼠标右键快捷菜单中可以对整个工程进行压缩打包,将会在你工程路径根目录中生成以工程名为文件名的 zip 包,此压缩包可直接用于上传开发者平台使用。
- 在工程鼠标右键快捷菜单中可以将整个工程发送至移动设备,系统将根据工程的分类将其包含的文件自动传送至移动设备对应目录中,需要注意的是,使用此功能需先连接设备。
连接设备
- 在设备面板中右键,搜索设备或使用 IP 添加设备(设备和电脑需要在同一个 WiFi 下且触动精灵服务开关及触动精灵局域网广播开关已打开)
- 当扫描不到设备的时候可以尝试通过IP直接添加
3. 连接到设备,查看输出面板中是否提示设备连接成功
连接安卓模拟器
注意:安卓需要登录账号并有 VIP 授权才能连接 IDE,可以在开发者平台的个人中心绑定触动安卓账号,赠送 VIP 授权,此账号与开发者平台账号不通用,需要在客户端重新注册。
第一种方法(推荐使用):
使用蒲公英进行连接,请点击这里查看使用方法,推荐使用第一种方法进行连接。
第二种方法(此方法不支持连接 v3.0 版本 IDE):
- 打开已安装了触动精灵安卓版的模拟器,请保证同时只有一个模拟器在运行,如果电脑已连接其他安卓设备请从电脑关闭。
- 在模拟器上运行触动精灵 (获取 root 权限) -> 打开服务 -> 打开局域网广播
- 下载附件 ADB 模拟器连接 IDE 3.0.zip
- 解压缩下载好的压缩文件,运行 连接编辑器.bat 可以连接模拟器
- 打开 IDE 的设备-> 右键点击新增设备-> 输入127.0.0.1 ->右键点击连接到设备。
- 连接成功后有提示文字,如果要查看 nLog 日志请运行 显示nLog日志.bat
注意事项
模拟器关闭后连接设置将失效,每次重启模拟器后需要重新设置连接。
第三种方法(此方法不支持连接 v3.0 版本 IDE):
以 mumu 模拟器为例(暂时不支持 v2.2.20 以上版本)
- 打开网易 mumu 模拟器
- 请确保同时只有一个模拟器在运行,如有其他安卓设备请从设备断开
- 下载 ADB_模拟器连接
- 开始中搜索 cmd
5. 打开 cmd 之后输入 cd+adb 所在目录地址后回车
6. 执行 adb 命令 adb connect 127.0.0.1:7555 再次回车连接模拟器
7. 再次运行连接 .bat 可连接模拟器
常用模拟器端口号
雷电模拟器 5555
夜神模拟器 62001 (暂时不支持 5 系统)
网易 mumu 模拟器 7555 (暂时不支持 v2.2.20 以上版本)
逍遥模拟器 21503
51 模拟器 10001
海马玩 26944(0.8.6)53001 (0.8.5)
蓝叠模拟器 2312
genymtion 5555
如果您是使用以上模拟器其中一个,连接编辑器时需注意端口号是否正确。
第四种方法(推荐使用)
雷电/夜神模拟器设置局域网的方法: 打开模拟器后点击设置 ->点击网络设置->开启网络桥连->IP 设置选择 DHCP->安装驱动->点击保存设置->重启模拟器。
输入雷电模拟器显示的 IP 即可连接 IDE 及抓色器。
USB 连接苹果手机(此方法不支持连接 v3.0 版本 IDE)
推荐使用蒲公英进行连接,请点击使用方法进行查看。
首先确保你的手机上已经安装了触动精灵 iOS 客户端,然后下载附件中的文件,按照教程进行设置即可。
附件下载 iOS 的触动 USB 端口监听.zip
使用方法:
将 iOS 设备用数据线与电脑连接,并确保电脑上已经安装 iTunes(可下载 iTools,只要能识别到手机即可)
- 解压附件,运行其中的
开始USB监听.bat
文件 - 如果窗口中出现
[INFO]Device connected:设备号
字样,代表监听成功。注意图中显示的设备号为 UDID,并不是触动精灵的设备号。 - 打开 IDE,在设备面板中输入
127.0.0.1
添加设备 - 右键选择连接设备,在输出面板中看到连接成功的提示就成功了
注意事项
如果运行监听文件一闪而过或者一直失败,请按照教程中的方法修改注册表。
连接设备报错
- 检查是否购买了触动授权,iOS 需要购买触动授权,安卓需要登录账号购买 VIP(此账号与开发者平台账号不通用需要在客户端单独注册)。
- 检查编辑器输入的 Access Key 是否正确(登录开发者平台在个人中心-> Access Key 中查看)
- 检查编辑器所在电脑和设备是否在同一 WiFi 网络下,是否能 ping 通
- 检查设备上的触动精灵服务和广播开关是否为开启状态
- 检查电脑上是否开启了 VPN 或其他代理服务,如果是,请关掉并去掉代理
- 重启设备上的触动服务和广播开关
- 重启路由器
- 删掉编辑器,从压缩包中重新解压到桌面或系统盘根目录
远程调试
- 在工程面板中右键
发送工程到设备
,会将当前工程文件夹下的脚本和资源文件都发送到设备 - 打开脚本主文件,点击菜单栏中的
开始/继续远程运行该文件
(Alt + R)
- 脚本中的 nLog 输出在左下方日志输出面板中
连接 IDE 显示连接成功但是显示 code:L 400 错误
如果连接 IDE 显示以下错误 请检查 iOS 设备是否购买触动授权,安卓设备是否登录账号并且购买了VIP。
IDE 和抓色器需要有授权才能连接,
iOS 可以在客户端内置购买或者在触动商城购买授权,试用状态无法连接IDE。
安卓可以在开发者平台的个人中心中绑定触动安卓账号,赠送 VIP 授权(此账号与开发者平台账号不通用,需要在客户端重新注册)。
如果购买授权后仍提示这个报错,请删除 IDE 安装目录下的 tsok 文件,重启下 IDE 及触动服务,重新连接试下。
nLog 不输出日志
- 打开电脑任务管理器,在进程中找到 lua.exe,关闭后再次运行脚本尝试
- 关闭电脑的防火墙再次尝试
- 如果开启了虚拟网卡,关闭后再次尝试
编辑器左侧栏不显示中文函数
在中文函数前面加任意英文字母即可。
工程打包
在工程视图中选中要打包的工程,在右键菜单中选择工程打包,会在工程文件夹同级目录下生成一个 zip 包。
工程文件夹下的脚本和资源文件都会包含在 zip 包中。
打包失败
如果遇到无论如何都打包不成功的情况,可备份工程文件、删除编辑器、重新解压再尝试。
注意事项
很多人使用绿色三角按钮的调试功能会提示需要触动精灵授权,在此提示,不建议大家使用这个功能,请使用后面带电脑标志的调试(需要先连接设备)。
- 如果设备和编辑器连接不成功,请尝试开关触动精灵服务、重启编辑器、重启路由,但是最重要的是,确保你的手机和电脑在同一个无线网下。
- 如果本地打开了 VPN 或其他代理工具,请关闭后再使用编辑器的脚本调试功能。
- 触动精灵 iOS 脚本路径为 /var/mobile/Media/TouchSprite/lua
- 触动精灵 Android 脚本路径为 /sdcard/TouchSprite/lua
自定义界面
打开编辑 - 首选项 - 用户配置 即可即时调整配色方案
自定义配色方案
打开编辑器目录下 cfg\tomorrow.lua
编辑 custom
表里的具体对应颜色,保存后在编辑 - 首选项 - 用户配置 选择 custom
方案即可
当前版本提供的配色方案:
Tomorrow
TomorrowContrast
TomorrowNight
TomorrowNightEighties
TomorrowNightBlue
TomorrowNightBright
Zenburn
Monokai
TouchSprite
Molokai
SolarizedDark
SolarizedLight
NotepadPlusPlus
SciTeLuaIDE
改变字体
打开触动精灵编辑器的配置文件 \cfg\user.lua,找到下面的文字(约 24 行)
editor.fontname = "Courier New"
将 "Courier New" 改成电脑系统已有的字体
例如改成
editor.fontname = "Arial"
保存后,重启编辑器就可以了
触动精灵脚本格式
二进制脚本 - TSP
- TSP 为触动精灵独有脚本格式,仅能被触动精灵识别,此格式由触动精灵开发者平台生成。
- 将你的脚本工程打包为 zip 格式,并上传至开发者平台,即可生成 TSP 格式的脚本。
- TSP 脚本为一个单独文件,里面包含了你的所有脚本文件,图片、音频、文本等资源及一些脚本基本信息。
- TSP 格式为加密格式,需联网验证,无法查看和修改脚本的源代码。
- TSP 运行时将会释放里面包含的资源文件,需要注意的是,在触动精灵iOS v2.2.0 以上版本中,图片资源每次运行都会释放至
/User/Media/TouchSprite/res/
目录,如目录中存在同名文件,将进行覆盖操作。
明文格式脚本 - lua
- 明文脚本一般以 lua 为扩展名,为文本格式,可以用任意文本编辑器打开编辑。
- 触动精灵中录制所产生的脚本即为明文脚本。
- 可将明文脚本文件在编辑器中打开进行编辑,并打包上传至开发者平台生成加密的二进制脚本。
常用快捷键
- 调试运行 F6
本地代码运行,不支持运行包含触动精灵扩展函数的代码 -
Alt + S
发送文件到设备,需先在左侧项目列表中选中需要发送的文件(支持 CTRL 多选),发送文件格式支持 lua、luac、txt,使用此功能前需要先连接设备 -
Alt + R
将当前脚本传至设备上并运行,使用此功能远程运行脚本不会出现运行提示框,此功能需先连接设备 -
F7
对当前代码进行二进制编译,生成的文件路径会在输出窗口提示 -
Shift + F7
代码检查,可检查是否有语法错误,可在输出栏直接双击错误提示跳转到对应行 -
F9
在当前光标行设置断点,在远程调试中使用 -
F10
单步运行跟踪,在远程调试中使用 -
Ctrl + Shift + D
开始/继续 远程调试,在远程调试中使用 -
Shift + F5
终止远程调试中的脚本运行 -
Ctrl + Shift + W
打开/关闭 监视窗口,用于远程调试 -
Ctrl + Shift + S
打开/关闭 调用堆栈窗口,用于远程调试
脚本编辑
- Ctrl + Shift + p
打开/关闭 文件管理窗口
-
F12
对整个代码进行折叠,再按一次取消折叠 -
Ctrl + I
一键自动缩进,可对当前代码进行智能缩进排版 -
Ctrl + D
快速复制当前行,以当前光标为准 -
Ctrl + C
快速复制当前行到剪贴板 -
Ctrl + V
黏贴剪贴板内容到光标位置 -
Ctrl + U
代码注释,对已经注释的代码使用会取消注释 -
Ctrl + B
打开快捷操作栏,可用来快速检索内容,如:直接输入字符可直接在整个项目目录搜索对应内容打开并显示在当前窗口 -
Ctrl + G
可通过输入行号快速跳转到指定行 -
Ctrl + F2
对光标所在行设置标签,用于不同行之间的快速跳转 -
F2
跳转至下一个标签行,需先设置标签 -
Shift + F2
跳转到上一个标签行,需先设置标签 -
Ctrl + F
搜索替换 -
Ctrl + F
在当前代码中搜索 -
Ctrl + Shift + F
在文件中进行搜索、支持多级子目录、支持搜索结果上下文显示,在搜索结果中双击可自动打开对应文件并跳转至对应行 -
Ctrl + "+"
对显示字体进行放大 -
Ctrl + "-"
对显示字体进行缩小 -
Ctrl + 0
还原字体大小为默认
附录
触动精灵脚本开发指南
新手必读,最全面的脚本开发必备常识、视频教程、开发工具:https://www.touchsprite.com/docs/4945
已知与触动精灵冲突的插件列表
showUI 不能弹出、点击没反应、滑动失效等问题有可能是由于安装了冲突插件引起的
https://www.touchsprite.com/docs/536