抖音开发工具 for Mac v4.3.3 苹果电脑版

字节跳动开发者工具Mac版是基于macos系统的专为小程序打造的开发者工具，现在已经更名为抖音开发工具，这款软件能够帮助用户开发头条小程序，为用户提供了调试工具，代码编辑，代码检测等工具，有需要的朋友可以下载使用。

使用方法

新建项目

当满足：

已拥有一个字节跳动小程序的 AppID；

所登录的账号是该 AppID 所对应小程序的开发者。

可以选择窗口中央的「创建一个头条小程序」，或点击右下角的「新建」按钮，新建工程。

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

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

appId 需要在公众平台管理后台获取。

主界面

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

窗口菜单栏

小程序：可以查看开发者工具版本号

项目：支持打开「开发者工具」本身的调试器

编辑：可以查看编辑相关的操作和快捷键

工具栏

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

刷新页面：刷新当前页面

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

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

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

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

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

模拟器

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

编辑器

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

文件格式：因 iOS 下仅支持 UTF8 编码格式，最新版本的开发者工具会在上传代码时候对代码文件做一次编码格式校验。

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

文件操作：可以通过在目录树上右键，选择新建 Page，将自动生成页面所需要的 ttml、ttss、js、json，及在 app.json 的 pages 字段，添加需要新建的页面的路径，将会自动生成该页面所需要的文件，两种方式新建页面。

目录树：可以查看当前项目的目录结构。

调试器

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

自定义编译条件

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

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

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

上传提审

点击工具栏的"上传"按钮，填写版本号（版本号不能重复，需在上一个版本号上加 1）, 填写更新日志，点击确认上传至开发者平台。

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

Bxml panel

Bxml 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 存储情况。

常见问题

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

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

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

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

解决方法：

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

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

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

就这么轻松解决啦

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

更新日志

V4.3.3（2024-12-12）​
​新增：小游戏支持 AI 助手，支持快速解答开发者问题、代码解释/优化、错误信息修正​
​新增：小程序支持动态引用小程序行业插件，查看详情​
​优化：多网卡用户在局域网快速调试/预览选择 IP 后，下次会自动选中​
​优化：编辑器 AI 助手悬浮窗显示位置优化，不遮挡代码​
​优化：优化开发者工具内存占用​
​修复：修复局域网预览模式下代开发小程序 ext.json 不生效的问题​
​修复：修复点击编译模式空白区域不生效的问题​

​​4.3.2（2024-11-25）​
​新增：Unity 小游戏 支持 WebGL Wasm 分包工具，查看详情​
​新增：小程序编辑器支持代码 AI 智能补全能力，查看详情​
​新增：模拟器支持更多机型，包含 OPPO、vivo、小米等​
​新增：小游戏模拟器工具栏支持停止运行模拟器功能​
​新增：小游戏模拟器支持开放数据域​
​优化：增强 AI 助手 UI 生成后的导出功能，支持创建页面、组件，导入已有页面，查看详情​
​修复：控制台中错误堆栈信息的展示​

4.3.1（2024-10-24）​
•​新增：对 IDE 消息通知列表的 UI 进行了优化，新增支持消息按类别分类展示​
•​新增：移除了对旧版直播互动小玩法的支持，并添加了直播互动工具开发入口​
•​优化：改进了模拟器中部分 JSAPI 和组件的表现，以确保与真机一致，包括button组件的open-type等功能如chooseAddress、getAnalysisInfo、makePhoneCall​
•​优化：增强了 AI 助手的 UI 生成功能，现支持从图片及 Figma 文件直接生成 UI 代码​
•​优化：升级编辑器的默认配置，新增支持 TTML / TTSS 文件的右键格式化功能​
•​修复：解决了 AI 助手在 UI 代码导出时偶发的失败问题​

​4.3.0（2024-09-23）​
•​新增：Unity 小游戏支持模拟器预览，​
•​新增：AI 助手内嵌至编辑器右侧，支持多种命令，更便捷使用 AI 指令​
•​新增：支持小游戏使用不同测试通道上传，​
•​新增：支持新建时选择后端服务（抖音云），自动开通抖音云​
•​新增：小程序工程分析支持分析安全维度​
•​新增：支持直播互动工具开发，​
•​优化：人工客服入口移动至 AI 助手中，并优化交互体验​

4.2.9（2024-08-30）​

•​优化：优化构成分析面板 UI，支持搜索和导出能力​

优化：优化 AI 助手，支持命令选择，新增生成 UI ，操作 IDE 功能​

优化：优化“工程分析”工具小程序启动阶段性能 UI，新增部分性能检测项，​

优化：优化 Trace 面板指标展示和事件搜索能力，新增部分性能检测项，​

修复：修复 Trace 面板火焰图偶现时间展示异常问题​

修复：修复 tt.getLocation 偶现获取地址异常问题​

抖音开发者工具 4.1.6 及之后版本不再支持 Window 10 之前的 Windows 操作系统，请升级操作系统或者使用 4.1.5 版本​
4.2.8（2024-08-07）​
新增：Unity 小游戏支持添加启动参数和场景值进行预览调试，查看详情​
优化：AI 助手支持流式返回答案，更快获得结果​
修复：视频&插屏广告在模拟器中 destroy 调用报错问题​
修复：模拟器触发 tt.relaunch 导致偶现编辑器无法正常输入问题​
修复：模拟器网络请求 header 中的user-agent 移除尾部单引号​
修复：偶现模拟器一直加载中问题​
修复：模拟器中小程序 canvas 使用异常问题（基础库 3.34.0.2 及以上）

4.2.7（2024-07-17）
新增：小程序新增工程分析辅助工具，支持性能、稳定性等动态检测，
新增：小程序支持打包可忽略配置，
新增：支持 Unity 小游戏扫码预览调试功能，
新增：支持「录制回放自动化测试」实验性功能。
优化：Lite 模式下支持使用快捷键 (Windows: Ctrl+R, Mac: Cmd+R) 刷新模拟器
修复：修复编译不等待编译前自定义命令执行完成问题
修复：修复 pnpm 软链导致的 npm 构建路径异