字节跳动开发者工具

抖音开发者工具（原字节跳动开发者工具）是字节跳动官方为小程序开发者打造的 PC 端开发利器，集小程序开发、代码调试、效果预览、上传等功能于一体，助力开发者更高效开展小程序开发工作。

经由该工具开发的小程序，可上线抖音、头条、头条极速版三端。和 APP 相比，小程序开发周期短、开发成本低，能让更多开发者轻松且快速参与开发、实现快速上线与起量。广大开发者以字节小程序为载体，依托其丰富基础能力完成服务搭建，在字节跳动各 App 精准匹配用户需求，为全球 15 亿用户提供优质服务的同时，也推动自身业务实现流量与转化升级。

此外，软件有着十分全面的讲解，对新手开发者很友好，能帮助用户快速开发小程序，且操作简单，有编程基础的用户极易上手。感兴趣的朋友不妨下载体验！

1、清除缓存：可以清除文件缓存、数据缓存、登录状态和授权数据

2、刷新页面：刷新当前页面

3、预览：生成二维码，预览已上传版本

4、编译：编译当前的小程序项目

5、详情：展示当前小程序的 appid、user_id、本地目录、文件系统、基础版本与编译版本，并可以设置校验 TLS 版本以及 HTTPS 证书

6、上传：填入 app 版本号及更新日志，上传小程序应用内容到服务器

字节跳动开发者工具使用教程

1、登录页

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

2、新建项目

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

选择项目类型：小程序或小游戏（一旦选择无法更改）。

选择一个空目录，作为工程目录。当选择空目录时，可以选择是否在该目录下生成一个简单的项目。

AppID 需要在公众平台管理后台获取 或者直接使用测试号（测试号只支持预览调试，不支持上传）

3、主界面

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

4、窗口菜单栏

目前工具自带快捷键

Command + B（Windows: Ctrl + B）：主动触发编译

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

5、工具栏

编译：编译当前的小程序项目

刷新页面：刷新当前页面

清除缓存：可以清除文件缓存、数据缓存、登录状态和授权数据

上传：填入 app 版本号及更新日志，上传小程序应用内容到服务器

预览：生成二维码，预览已上传版本

详情：展示当前小程序的 appid、user_id、本地目录、文件系统、基础版本与编译版本，并可以设置校验 TLS 版本以及 HTTPS 证书

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

6、模拟器

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

7、编辑器

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

文件支持：工具目前提供了 5 种文件的编辑：ttml、ttss、js、json 以及图片文件的预览。

文件操作：在 app.json 的 pages 字段，添加需要新建的页面的路径，将会自动生成该页面所需要的文件。

8、调试器

调试工具分为 6 大功能模块：Bxml、Console、Sources、Network、Application、Performance

9、自定义编译条件

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

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

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

10、上传提审

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

上传完成后，进入开发者平台，在发布页面进行提审版本号建议说明

版本号建议说明

小程序版本号规范：主版本号.子版本号 [.修正版本号]；英文对照：Major_Version_Number.Minor_Version_Number[.Revision_Number]；示例：1.4.1

项目初版本时，版本号可以为 0.1.0 或 1.0.0

当项目在进行了局部修改或 bug 修正时，主版本号和子版本号都不变，修正版本号加 1

当项目在原有的基础上增加了部分功能时，主版本号不变，子版本号加 1，修正版本号复位为 0

当项目在进行了重大修改或局部修正累积较多，而导致项目整体发生全局变化时，主版本号加 1

如更新时版本号未进行修改，则无法成功提审

常见问题

解决字节跳动开发者工具安装无法打开问题

下载字节跳动开发者工具 下载之后 点击安装 默认安装到

C:\Users\你的电脑名称\AppData\Local\Programs\bytedanceide

目录下 但是点击打开 弹窗报红色错误如下图：

解决方法：

C:\Users\你的电脑名称\AppData\Roaming 目录下新建 bytedanceide 文件夹

然后 bytedanceide 文件夹下面新建 tmadevtool 文件夹

然后 tmadevtool 文件夹下面新建一个名为 projectInfo 的无后缀的文件

就这么轻松解决啦

重新打开字节跳动开发者工具 一切正常

更新日志

v4.4.6版本

新增：基础库升级，默认版本为 3.83.0.8，最新版本为 3.88.0.1

新增：菜单栏【工具】-【清理软件缓存】按钮可清理开发者工具运行期间产生的软件缓存

新增：Unity 小游戏 Wasm 分包支持 debug 版本方便还原错误堆栈，查看详情

修复：Unity 小游戏 Wasm 分包工具若干问题

修复：修复模拟器若干反馈问题