XXTStudio 使用手册

XXTouch XXTStudio

XXTStudio 属于 ZeroBrane Studio 扩展 XXTouch 脚本制作的工具，所有的方法使用 XXTouch OpenAPI 来实现，完全遵守 wxLua 标准。

使用部分

界面操作以及快捷键

• 扫描设备

  1. 可以使用菜单栏中 设备 后点击 扫描。
  2. 可以使用工具栏中 扫描。
  3. 可以直接双击 设备 表中 设备列表 标签。
     

• 运行脚本

  1. 可以使用菜单栏中 项目 后点击 运行。
  2. 可以使用工具栏中 运行，或使用快捷键 F6 运行脚本。
  3. 可以使用工具栏中 停止，或使用快捷键 Shift+F6 停止脚本。

• 调试脚本

  1. 可以使用菜单栏中 项目后点击 开始调试此项目。
  2. 可以使用工具栏中 运行，或使用快捷键 F5 运行脚本。
  3. 可以使用工具栏中 终止目前运行着的进程。或使用快捷键 Shift+F5 停止调试。

抓色器快捷键

• 截图快捷键 F8。
• 当鼠标处于取色框内时可使用非数字键盘1、2、3、4、5、6、7、8、9、0进行取色，遵循老版本取色器规则。

储存路径以及注意事项

XXTStudio储存路径：我的文档/XXTStudio/
脚本储存路径为：我的文档/XXTStudio/project/
打包成功与打包临时文件：我的文档/XXTStudio/release/
设备端文件临时存放文件夹：我的文档/XXTStudio/temp/

此处 “我的文档” 可能在不同设备下目录位置不同，这里特指 Windows 系统的 我的文档 或者 Mac 系统的用户 文档。

操作流程

问题汇总

USB 连接电脑后扫描不到设备怎么办？

• XXTStudio 并不支持 USB 方式连接设备，需要设备连接到无线局域网（WiFi）。

XXTStudio 扫描不到设备怎么办？

• 确保 iOS 设备与运行着 XXTStudio 设备在同一个局域网。
• iOS 设备中 XXTouch 已开启 远程访问。
• 防火墙规则放行 XXTStudio 或关闭防火墙。
• 设备端网络代理或 VPN 处于关闭状态。
• 设备处于屏幕解锁状态。

为什么 启动、停止、调试、加密 等按钮均为灰色？

• 未连接设备的情况下无法使用这些功能。
• 扫描到设备后，可双击列表中的设备名以连接到指定设备。

代码自动联想功能失效怎么办？

• 软件路径调整成纯英文路径。

“nLog” 函数打印不出日志怎么办？

• 请调整防火墙（放行 XXTStudio 或关闭防火墙）。

写好的脚本储存路径在哪里？

• 我的文档/XXTStudio/project/

是否支持独立脚本进行运行、加密？

• 现最新版已支持独立脚本的操作，需确保脚本文件不在所打开的项目路径下。
• 调试脚本功能不支持因无法确保 iOS 设备与运行着 XXTStudio 的设备间文件的完整性，无法确定文档结构环境差异。

打包过程中提示我内存超过了限制大小怎么办？

• XXTStudio 打包脚本使用的脚本结构进行输出包装好的“lua”文件后进行加密编译的，当打包内的文件过大（理论大于10MB都有可能触发）。
• 如有需要较大的文件加载请使用 http.download 方法进行服务器下载。

使用偏好

• 软件基于 ZeroBrane Studio 进行扩展，支持大部分自带功能。（编辑 > 首选项 > 设置：系统）
• 软件自带部分配置遵循常用日常使用规范，个人可根据自己需求进行调整
• ZeroBrane Studio 文档
  
  • 一般偏好
  • 编辑的喜好
  • 编辑键盘快捷键
  • 样式和配色方案
  • 配置

抓色器扩展

• 扩展模块储存路径：\packages\picker
• 可使用任意.lua文件储存至此目录下进行加载（如：test.lua）

return {
    name = "例子",
    description = "完全是为了展示效果",
    settings = {
        {"滑块", 1, {1, 10}},       -- 滑块     {key, default, {min, max}}
        {"复选框", true},           -- 复选框   {key, default}
        {"文本框", "Are You OK?"},  -- 文本框   {key, default}
        {"下拉选项", "item1", {"item1", "item2", "item3"}, false},
        -- 下拉选项     {key, default, items, true}
        {"可编辑下拉", "item2", {"item1", "item2", "item3"}, true},
        -- 可编辑下拉   {key, default, items, true}
    },
    maker = function(poslist, set, img_hex, find_rect)
        --[[
            poslist:                table        点色列表
                {
                    x:              number        X轴坐标
                    y:              number        Y轴坐标
                    r:              number        红色[0-255]
                    g:              number        绿色[0-255]
                    b:              number        蓝色[0-255]
                    c:              string        颜色码十六进制(0xffffff)
                }
            set:                    table        配置列表
                {
                    ["滑块"]:        number        对应 滑块 中选择值或默认值
                    ["复选框"]:      boolean       对应 复选框 中选择值或默认值
                    ["下拉选项"]:    string        对应 下拉选项 中选择值或默认值
                    ["可编辑下拉"]:  string        对应 可编辑下拉 中选择值或默认值
                    ["文本框"]:      string        对应 文本框 中选择值或默认值
                }
            img_hex:                string        文本形式的图片十六进制数据(\xff\xff)
            find_rect:    table
                {
                    [1]                number        找图或找色框选范围(左上角X轴坐标)
                    [2]                number        找图或找色框选范围(左上角Y轴坐标)
                    [3]                number        找图或找色框选范围(右下角X轴坐标)
                    [4]                number        找图或找色框选范围(右下角Y轴坐标)
                }
        ]]
        return table.concat(
            {
                "点：" .. json.encode(poslist),
                "配置：" .. json.encode(set),
                "图像：" .. img_hex,
                "范围：" .. json.encode(find_rect),
            },
            "\r\n"
        )
    end,
}

代码片段扩展

• 扩展模块储存路径：\packages\snippets
• 可使用任意.lua文件储存至此目录下进行加载（如：test.lua）

return {    name = "父节点",
    description = [[描述内容]],
    {   name = "子节点",
        title = "标题内容",
        description = [[描述内容]],
        code = [[双击后插入的代码]]
    },
    {   name = "父节点2",
        {   name = "子节点2",
            title = "标题内容",
            description = [[描述内容]],
            code = [[双击后插入的代码]]
        },
    },
}

下载地址

• 请由https://www.xxtouch.com/xxtstudio进行下载

界面调整

自动关联

更新日志

1.19
* 文件树root显示项目名字
* 公用插件库（我的文档/XXTStudio/module）
* 多文件联合代码提示
* 语法错误提示更加显眼
* 修复 设备列表设备更换IP后 显示标题不改变

1.20
* 加快启动速度
* 增加取色器快捷键（1，2，3，4，5，6，7，8，9，0 快捷键取色）
* 同步过程中增加弹出提示框以查阅进度

1.21
* 设备列表根据IP排序
* 提示信息会详细叙述解决方法
* 修补多网卡环境扫描设备异常的问题

1.22
* 修补空文件引起的无法启动的问题
* 编辑器支持多个实例启动
* 区分自动补全位数（函数表：2，个人特征字符：3）
* 提示信息补充

1.23
* 修补错误提示引发的编辑器崩溃

1.30
* 与 ZeroBrane Studio 官方同步至 1.70 版本

1.31
* 修补右键菜单中丢失按钮
* 修补快捷键失效
* 修正添加已存在设备IP更新的问题
* IP输入框支持host输入以及外网IP输入
* 加入更新判断（启动判断，帮助->更新XXTStudio）
* 加入代码片段扩展包

1.32
* 加强代码片段扩展包
* 修补抓色器位移后旋转后造成的问题