Skip to content

VSCode 开发 ​

介绍如何在 VS Code 中用 DeekeScript Pro 扩展连接手机、同步工程、执行任务脚本与热更新。尚未安装 VS Code、扩展或手机端 Pro,请先阅读 快速开始。入口文件说明见 认识 Pro。

扩展名称

扩展市场另有名为 DeekeScript 的插件,与 DeekeScript Pro 不同。开发 Pro 项目请安装 DeekeScript Pro(扩展 ID:DeekeScript.deekescript-pro),并在扩展面板禁用标准版 DeekeScript。两款同时启用时,编辑器右上角都会出现操作图标,容易点错、造成混淆。

page.js 不是任务脚本,只在打开对应页面时加载,不要对它点「仅当前文件执行」。

从哪里点命令 ​

两种入口,推荐第二种。

命令面板 ​

「查看」→「命令面板」→ 搜索 DeekeScript Pro:

编辑器右上角 ​

打开 deekeScript.json,或任意 page.js / 任务 JS,用右上角图标:


连接手机 ​

点「连接手机」,填手机局域网 IP,等到连接成功:


手机和电脑必须同一局域网,电脑 VPN 关掉。IP 在手机端 Pro 首页可以看到。

打开控制台 ​

同步日志、console.log、报错都在这里看:

项目同步 ​

「项目同步」把整个工程拷到手机,包括入口文件、页面、组件、公共模块和任务脚本:

同步后,手机点 运行(安卓图标右侧):

有界面的工程会进入 homePage。只改任务脚本时,可以只同步当前文件再执行,不必刷新页面。

热更新 ​

正在看的那一页,保存对应的 page.json / page.js(或该页已嵌入的自定义组件)并同步后,手机会自动换成新界面。

JSON 或 JS 写坏了会保留更新前的界面。错误(含文件和行列)出现在 VSCode 控制台和手机日志,改好再保存才会替换。第一次进入某个页面仍要点运行。

执行任务脚本 ​

打开任意任务 JS,点「仅当前文件执行」。没有 pages/、不打开 homePage 也可以:

有界面时,按钮里应调用 Engines.executeScript,不要把任务写在 JSON 的 action 里。

同步并点运行后,在手机上点底栏、按钮、列表,走的是 page.js 里的 onTap 和生命周期。

停止脚本 ​

死循环或不想再跑时,用「停止所有脚本」:

手机上也可以:开发器里连点两次悬浮窗,或展开项目菜单停止。

代码提示(API 智能提示) ​

当工程根目录存在 deekeScript.json 时,DeekeScript Pro 扩展会自动:

  1. 生成 .vscode/deekeScriptPro.d.ts(Pro API 类型声明,含参数与返回值说明)。
  2. 配置 jsconfig.json,启用 JavaScript 类型检查。

之后在 .js 文件里编写脚本时,可获得补全、悬停文档、签名帮助与类型诊断。文档链接指向本站(script.deeke.cn)。

编写界面工程时,page.js 里的 Page({})、component.js 里的 Component({}) 也会提示生命周期、事件回调,以及 this.setData、this.navigate、this.triggerEvent 等方法。

命令说明 ​

命令做什么
DeekeScript Pro:连接手机建立与手机端 Pro 的 WebSocket 连接
DeekeScript Pro:关闭连接断开连接
DeekeScript Pro:重置重连状态连接异常后清除重连计数
DeekeScript Pro:项目同步同步整个工程
DeekeScript Pro:文件同步只同步当前打开的文件
DeekeScript Pro:仅当前文件执行执行当前打开的任务 JS,不依赖界面
DeekeScript Pro:项目执行运行整个 DeekeScript 工程
DeekeScript Pro:停止所有脚本停掉手机上正在跑的脚本
DeekeScript Pro:显示状态查看连接与同步状态

接下来 ​

做界面见 界面开发 · 概述;交给模型生成、调试与修复见 AI 驱动开发。