抖音小程序开发者工具

小程序开发者工具是面向小程序开发者推出的 PC 端开发者工具，支持小程序开发、调试、预览、上传等基本功能，并且集成开发者服务（包含智能客服等），支持在 Windows、Mac 多平台上运行，核心目标是为了帮助开发者更高效地开发小程序。

小程序开发者工具更新日志以及下载地址： 小程序开发者工具正式版 / 小游戏开发者工具正式版

登录页

使用手机验证或者邮箱登录扫码可登录小程序开发工具，可以在 https://microapp.bytedance.com/注册账号。

新建项目

可以选择窗口中央的「+」进行创建项目或者导入项目

• 选择项目类型：小程序或小游戏（一旦选择无法更改）。
• 选择一个空目录，作为工程目录。当选择空目录时，可以选择是否在该目录下生成一个简单的项目。
• AppID 需要在公众平台管理后台获取 或者直接使用测试号（测试号只支持预览调试，不支持上传）
  

主界面

图中所示分别为：工具栏、模拟器、编辑器、调试器四大部分。

窗口菜单栏

目前工具自带快捷键

• Command + B（Windows: Ctrl + B）：主动触发编译
• Command + R（Windows: Ctrl + R) ：焦点在编辑器时，触发模拟器刷新，焦点在其他位置时，触发整个工作区刷新

工具栏

• 编译：编译当前的小程序项目
• 刷新页面：刷新当前页面
• 清除缓存：可以清除文件缓存、数据缓存、登录状态和授权数据
• 上传：填入 app 版本号及更新日志，上传小程序应用内容到服务器
• 预览：生成二维码，预览已上传版本
• 详情：展示当前小程序的 appid、user_id、本地目录、文件系统、基础版本与编译版本，并可以设置校验 TLS 版本以及 HTTPS 证书

点击「模拟器」、「调试器」三个按钮可以隐藏/显示相应的模块，界面中至少有一个模块被显示。

模拟器

模拟器模拟头条小程序在客户端真实的逻辑表现，对于绝大部分的 API 均能够在模拟器上呈现出正确的状态。开发者可以选择不同的设备，调试小程序在不同尺寸机型上的适配问题。

编辑器

编辑器模块内可以对当前项目进行代码编写和文件的添加、删除以及重命名等基本操作，并集成了 Git、插件等功能。

• 文件支持：工具目前提供了 5 种文件的编辑：ttml、ttss、js、json 以及图片文件的预览。
• 文件操作：在 app.json 的 pages 字段，添加需要新建的页面的路径，将会自动生成该页面所需要的文件。

调试器

调试器包含如下功能模块：

Elements panel

Elements panel 用于帮助开发者开发 ttml 转化后的界面。在这里可以看到真实的页面结构以及结构对应的 ttss 属性，同时可以通过修改对应 ttss 属性，在模拟器中实时看到修改的情况（仅为实时预览，无法保存到文件）。通过调试模块左上角的选择器，还可以快速定位页面中组件对应的 ttml 代码。

Console panel

开发者可以在此调试代码。

Sources panel

Sources panel 用于显示当前项目的脚本文件，同浏览器开发不同，小程序框架会对脚本文件进行编译的工作，所以在 Sources panel 中开发者看到的文件是经过处理之后的脚本文件，开发者的代码都会被包裹在 define 函数中，并且对于 Page 代码，在尾部会有 require 的主动调用。

Network panel

Network Panel 用于观察和显示 request 和 socket 的请求情况。

AppData panel

AppData panel 用于展示以及修改当前 page 的 data 属性

Storage panel

可以查看 Storage 存储情况。

自定义编译条件

编译条件会读取 project.config.json 中的 condition 字段下的相关配置，方便导入编译条件。

点击工具栏的普通编译处，在下拉列表中，点击添加编译模式，会弹出填写编译条件窗口，添加自己的定制化的编译条件。

在弹出的窗口中，添加模式名称，启动页面，启动参数以及进入场景几个字段，点击确认，生成新的编译条件。

上传提审

点击工具栏的"上传"按钮，填写版本号, 填写更新日志，点击确认上传至开发者平台。

上传完成后，进入开发者平台，在发布页面进行提审。

版本号建议说明:

小程序版本号规范：主版本号.子版本号 [.修正版本号]；

英文对照：Major_Version_Number.Minor_Version_Number[.Revision_Number]；

可以参考 https://semver.org/lang/zh-CN/

示例：

• 1.4.1 项目初版本时，版本号可以为 0.1.0 或 1.0.0
• 当项目在进行了局部修改或 bug 修正时，主版本号和子版本号都不变，修正版本号加 1
• 当项目在原有的基础上增加了部分功能时，主版本号不变，子版本号加 1，修正版本号复位为 0
• 当项目在进行了重大修改或局部修正累积较多，而导致项目整体发生全局变化时，主版本号加 1 如更新时版本号未进行修改，则无法成功提审