字節(jié)跳動(dòng)開(kāi)發(fā)者工具M(jìn)ac版是基于macos系統(tǒng)的專(zhuān)為小程序打造的開(kāi)發(fā)者工具，現(xiàn)在已經(jīng)更名為抖音開(kāi)發(fā)工具，這款軟件能夠幫助用戶(hù)開(kāi)發(fā)頭條小程序，為用戶(hù)提供了調(diào)試工具，代碼編輯，代碼檢測(cè)等工具，有需要的朋友可以下載使用。

使用方法

新建項(xiàng)目

當(dāng)滿(mǎn)足：

已擁有一個(gè)字節(jié)跳動(dòng)小程序的 AppID；

所登錄的賬號(hào)是該 AppID 所對(duì)應(yīng)小程序的開(kāi)發(fā)者。

可以選擇窗口中央的「創(chuàng)建一個(gè)頭條小程序」，或點(diǎn)擊右下角的「新建」按鈕，新建工程。

選擇項(xiàng)目類(lèi)型：小程序或小游戲（一旦選擇無(wú)法更改）。

選擇一個(gè)空目錄，作為工程目錄。當(dāng)選擇空目錄時(shí)，可以選擇是否在該目錄下生成一個(gè)簡(jiǎn)單的項(xiàng)目。

appId 需要在公眾平臺(tái)管理后臺(tái)獲取。

主界面

圖中所示分別為：工具欄、模擬器、編輯器、調(diào)試器四大部分。

窗口菜單欄

小程序：可以查看開(kāi)發(fā)者工具版本號(hào)

項(xiàng)目：支持打開(kāi)「開(kāi)發(fā)者工具」本身的調(diào)試器

編輯：可以查看編輯相關(guān)的操作和快捷鍵

工具欄

編譯：編譯當(dāng)前的小程序項(xiàng)目

刷新頁(yè)面：刷新當(dāng)前頁(yè)面

清除緩存：可以清除文件緩存、數(shù)據(jù)緩存、登錄狀態(tài)和授權(quán)數(shù)據(jù)

上傳：填入 app 版本號(hào)及更新日志，上傳小程序應(yīng)用內(nèi)容到服務(wù)器

預(yù)覽：生成二維碼，預(yù)覽已上傳版本

詳情：展示當(dāng)前小程序的 appid、user_id、本地目錄、文件系統(tǒng)、基礎(chǔ)版本與編譯版本，并可以設(shè)置校驗(yàn) TLS 版本以及 HTTPS 證書(shū)

點(diǎn)擊「模擬器」、「編輯器」、「調(diào)試器」三個(gè)按鈕可以隱藏/顯示相應(yīng)的模塊，界面中至少有一個(gè)模塊被顯示。

模擬器

模擬器模擬頭條小程序在客戶(hù)端真實(shí)的邏輯表現(xiàn)，對(duì)于絕大部分的 API 均能夠在模擬器上呈現(xiàn)出正確的狀態(tài)。開(kāi)發(fā)者可以選擇不同的設(shè)備，調(diào)試小程序在不同尺寸機(jī)型上的適配問(wèn)題。

編輯器

編輯器模塊內(nèi)可以對(duì)當(dāng)前項(xiàng)目進(jìn)行代碼編寫(xiě)和文件的添加、刪除以及重命名等基本操作。

文件格式：因 iOS 下僅支持 UTF8 編碼格式，最新版本的開(kāi)發(fā)者工具會(huì)在上傳代碼時(shí)候?qū)Υa文件做一次編碼格式校驗(yàn)。

文件支持：工具目前提供了 5 種文件的編輯：ttml、ttss、js、json 以及圖片文件的預(yù)覽。

文件操作：可以通過(guò)在目錄樹(shù)上右鍵，選擇新建 Page，將自動(dòng)生成頁(yè)面所需要的 ttml、ttss、js、json，及在 app.json 的 pages 字段，添加需要新建的頁(yè)面的路徑，將會(huì)自動(dòng)生成該頁(yè)面所需要的文件，兩種方式新建頁(yè)面。

目錄樹(shù)：可以查看當(dāng)前項(xiàng)目的目錄結(jié)構(gòu)。

調(diào)試器

調(diào)試工具分為 6 大功能模塊：Bxml、Console、Sources、Network、Application、Performance

自定義編譯條件

編譯條件會(huì)讀取 project.config.json 中的 condition 字段下的相關(guān)配置，方便導(dǎo)入編譯條件。

點(diǎn)擊工具欄的普通編譯處，在下拉列表中，點(diǎn)擊添加編譯模式，會(huì)彈出填寫(xiě)編譯條件窗口，添加自己的定制化的編譯條件。

在彈出的窗口中，添加模式名稱(chēng)，啟動(dòng)頁(yè)面，啟動(dòng)參數(shù)以及進(jìn)入場(chǎng)景幾個(gè)字段，點(diǎn)擊確認(rèn)，生成新的編譯條件。

上傳提審

點(diǎn)擊工具欄的"上傳"按鈕，填寫(xiě)版本號(hào)（版本號(hào)不能重復(fù)，需在上一個(gè)版本號(hào)上加 1）, 填寫(xiě)更新日志，點(diǎn)擊確認(rèn)上傳至開(kāi)發(fā)者平臺(tái)。

上傳完成后，進(jìn)入開(kāi)發(fā)者平臺(tái)=》發(fā)布頁(yè)面進(jìn)行提審

Bxml panel

Bxml panel 用于幫助開(kāi)發(fā)者開(kāi)發(fā) ttml 轉(zhuǎn)化后的界面。在這里可以看到真實(shí)的頁(yè)面結(jié)構(gòu)以及結(jié)構(gòu)對(duì)應(yīng)的 ttss 屬性，同時(shí)可以通過(guò)修改對(duì)應(yīng) ttss 屬性，在模擬器中實(shí)時(shí)看到修改的情況（僅為實(shí)時(shí)預(yù)覽，無(wú)法保存到文件）。通過(guò)調(diào)試模塊左上角的選擇器，還可以快速定位頁(yè)面中組件對(duì)應(yīng)的 ttml 代碼。

Console panel

開(kāi)發(fā)者可以在此調(diào)試代碼。

Sources panel

Sources panel 用于顯示當(dāng)前項(xiàng)目的腳本文件，同瀏覽器開(kāi)發(fā)不同，小程序框架會(huì)對(duì)腳本文件進(jìn)行編譯的工作，所以在 Sources panel 中開(kāi)發(fā)者看到的文件是經(jīng)過(guò)處理之后的腳本文件，開(kāi)發(fā)者的代碼都會(huì)被包裹在 define 函數(shù)中，并且對(duì)于 Page 代碼，在尾部會(huì)有 require 的主動(dòng)調(diào)用。

Network panel

Network Panel 用于觀察和顯示 request 和 socket 的請(qǐng)求情況。

AppData panel

AppData panel 用于展示以及修改當(dāng)前 page 的 data 屬性

Storage panel

可以查看 Storage 存儲(chǔ)情況。

常見(jiàn)問(wèn)題

解決字節(jié)跳動(dòng)開(kāi)發(fā)者工具安裝無(wú)法打開(kāi)問(wèn)題

下載字節(jié)跳動(dòng)開(kāi)發(fā)者工具 下載之后 點(diǎn)擊安裝 默認(rèn)安裝到

C:\Users\你的電腦名稱(chēng)\AppData\Local\Programs\bytedanceide

目錄下 但是點(diǎn)擊打開(kāi) 彈窗報(bào)紅色錯(cuò)誤如下圖：

解決方法：

C:\Users\你的電腦名稱(chēng)\AppData\Roaming 目錄下新建 bytedanceide 文件夾

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

然后 tmadevtool 文件夾下面新建一個(gè)名為 projectInfo 的無(wú)后綴的文件

就這么輕松解決啦

重新打開(kāi)字節(jié)跳動(dòng)開(kāi)發(fā)者工具 一切正常?。?！

更新日志

4.4.1（2025-06-17）
新增：小程序 AI 智能調(diào)整模式支持歷史對(duì)話(huà)管理、自定義規(guī)則、指定上下文功能，查看詳情
新增：小游戲支持通過(guò) 【調(diào)試器】-【Mock】面板模擬設(shè)置 tt.requestGamePayment, tt.openAwemeCustomerService 接口 success / fail 回調(diào)的返回結(jié)果
優(yōu)化：小游戲優(yōu)化 wasm 分包界面體驗(yàn)
修復(fù)：小程序 AI 智能調(diào)整模式選擇重復(fù)圖片無(wú)反應(yīng)問(wèn)題

4.4.0（2025-05-23）
新增：小程序支持 AI 助手智能調(diào)整模式，可以使用自然語(yǔ)言 / 設(shè)計(jì)圖快速生成和調(diào)整應(yīng)用，查看詳情
新增：小程序模擬器支持 iPad 設(shè)備類(lèi)型，并支持模擬在 iPad 中的 UI 適配效果。支持在模擬器工具箱中點(diǎn)擊“旋轉(zhuǎn)”查看 iPad 在橫豎屏下的適配效果（注意：“旋轉(zhuǎn)”暫不支持其他設(shè)備類(lèi)型）。
新增：小程序調(diào)試器 Mock 面板支持 tt.sign, tt.getOrderPayment 接口 success/fail 回調(diào)模擬。
新增：新建工程頁(yè)面支持模板預(yù)覽。

V4.3.8（2025-04-10）
新增：基礎(chǔ)庫(kù)升級(jí)，最新版本為 3.66.0.1，默認(rèn)版本為 3.63.0.4
修復(fù)：修復(fù)模擬器中 web-view 組件丟失 origin header 問(wèn)題
修復(fù)：修復(fù)預(yù)覽&真機(jī)調(diào)試場(chǎng)景下小程序引用插件預(yù)覽失敗問(wèn)題

V4.3.6（2025-02-28）
新增：編譯模式支持搜索功能
優(yōu)化：支持更多階段（預(yù)覽前、上傳前等）自定義處理命令
優(yōu)化：加快局域網(wǎng)預(yù)覽調(diào)試速度
優(yōu)化：Unity 取消上傳成功的版本不能夠重新上傳的限制，上傳時(shí)填寫(xiě)版本需要大于線(xiàn)上、提審、灰度版本

V4.3.5（2025-01-23）
新增：小游戲支持預(yù)覽、發(fā)布上傳開(kāi)啟“高性能+模式”， 查看詳情
新增：小游戲支持代碼深度防護(hù)，查看詳情
修復(fù)：修復(fù)小游戲代碼片段無(wú)法正常使用開(kāi)放數(shù)據(jù)域的問(wèn)題
修復(fù)：修復(fù)部分 Windows 設(shè)備打開(kāi)工程出現(xiàn)卡頓的問(wèn)題
修復(fù)：修復(fù) Scroll-View 內(nèi)部元素移除時(shí)，調(diào)試器 Elements 元素殘留問(wèn)題

4.3.4（2025-01-08）
新增：Unity 小游戲支持性能測(cè)試工具，
新增：支持本地調(diào)試、部署抖音云函數(shù)服務(wù)，
新增：小游戲模擬器支持更多設(shè)備能力的模擬（包括麥克風(fēng)、攝像頭、錄音、錄屏等）
優(yōu)化：小游戲支持引入 .ico、.cur 文件類(lèi)型
修復(fù)：修復(fù) AI 助手無(wú)法渲染表格的問(wèn)題