字节跳动开发者工具

字节跳动官方专为小程序开发者打造了一款 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 版本号及更新日志，上传小程序应用内容。

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

- 详情：展示小程序信息，设置校验 TLS 版本及 HTTPS 证书。

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

6. 模拟器：

- 模拟头条小程序在客户端的真实逻辑表现，支持调试不同尺寸机型的适配问题。

7. 编辑器：

- 支持代码编写、文件添加、删除及重命名等基本操作，集成 Git、插件等功能。

- 文件支持：提供 ttml、ttss、js、json 文件编辑及图片文件预览。

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

8. 调试器：

- 调试工具分为 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你的电脑名称AppDataLocalProgramsbytedanceide 目录。

- 若点击打开时弹窗报红色错误，解决方法如下：

- 在 C:Users你的电脑名称AppDataRoaming 目录下新建 bytedanceide 文件夹。

- 在 bytedanceide 文件夹下新建 tmadevtool 文件夹。

- 在 tmadevtool 文件夹下新建一个名为 projectInfo 的无后缀文件。

- 重新打开字节跳动开发者工具，问题即可解决。