开发
API
直播能力

小程序开发者工具

小程序开发者工具是面向小程序开发者推出的 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];

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

点击纠错
评价此篇文档