抖音開發(fā)者工具M(jìn)ac版是面向字節(jié)系小程序開發(fā)者推出的桌面端集成開發(fā)環(huán)境。IDE 支持小程序開發(fā)、調(diào)試、預(yù)覽、上傳等基本功能，并且集成開發(fā)者服務(wù)（包含智能客服等），支持在 Windows、Mac 平臺上運(yùn)行，旨在幫助開發(fā)者更高效地開發(fā)小程序。歡迎需要此款工具的朋友前來下載使用。

Mac arm64 （適用于 Apple 芯片）

注意事項

用戶在下載Mac軟件后打開使用的時候可能會遇到的常見的三種報錯：(出現(xiàn)報錯請大家務(wù)必一步一步耐心仔細(xì)看完下面的內(nèi)容?。?！)

XX軟件已損壞，無法打開，你應(yīng)該將它移到廢紙簍

打不開XX軟件，因為它來自身份不明的開發(fā)者

打不開XX軟件，因為Apple無法檢查其是否包含惡意軟件

當(dāng)你遇到上述問題的時候：

1、首先這樣設(shè)置試試：開啟任何來源

到這里一般情況下應(yīng)用都可以運(yùn)行了。

然而有的應(yīng)用開啟了任何來源還是不行，這是因為蘋果進(jìn)一步收縮了對未簽名應(yīng)用的權(quán)限，這時候就需要通過過“終端”執(zhí)行命令行代碼來繞過應(yīng)用簽名認(rèn)證。

2、執(zhí)行命令繞過蘋果的公證Gatekeeper：Mac打開應(yīng)用提示已損壞怎么辦 Mac安裝軟件時提示已損壞怎么辦

以上操作如果還不能解決，那就需要關(guān)閉SIP系統(tǒng)完整性保護(hù)才可以了。

3、關(guān)閉SIP系統(tǒng)完整性保護(hù)：Mac怎么關(guān)閉SIP系統(tǒng)完整性 Mac SIP怎么關(guān)閉

使用方法

新建項目

當(dāng)滿足：

已擁有一個字節(jié)跳動小程序的 AppID；

所登錄的賬號是該 AppID 所對應(yīng)小程序的開發(fā)者。

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

選擇項目類型：小程序或小游戲（一旦選擇無法更改）。

選擇一個空目錄，作為工程目錄。當(dāng)選擇空目錄時，可以選擇是否在該目錄下生成一個簡單的項目。

appId 需要在公眾平臺管理后臺獲取。

主界面

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

窗口菜單欄

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

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

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

工具欄

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

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

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

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

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

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

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

模擬器

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

編輯器

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

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

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

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

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

調(diào)試器

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

自定義編譯條件

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

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

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

上傳提審

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

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

Bxml panel

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

Console panel

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

Sources panel

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

Network panel

Network Panel 用于觀察和顯示 request 和 socket 的請求情況。

AppData panel

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

Storage panel

可以查看 Storage 存儲情況。

常見問題

解決字節(jié)跳動開發(fā)者工具安裝無法打開問題

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

C:\Users\你的電腦名稱\AppData\Local\Programs\bytedanceide

目錄下 但是點(diǎn)擊打開 彈窗報紅色錯誤如下圖：

解決方法：

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

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

然后 tmadevtool 文件夾下面新建一個名為 projectInfo 的無后綴的文件

就這么輕松解決啦

重新打開字節(jié)跳動開發(fā)者工具 一切正常！?。?/p>

更新日志

V4.4.5（2025-09-11）
新增：基礎(chǔ)庫升級，默認(rèn)版本為 3.81.0.8，最新版本為 3.85.0.1
優(yōu)化：AI 助手支持大倉庫文件召回增強(qiáng)能力，優(yōu)化 AI 智能調(diào)整文件召回效果
優(yōu)化：優(yōu)化 Unity 小游戲 Wasm 分包界面體驗
修復(fù)：修復(fù)模擬器若干反饋問題

4.4.3（2025-07-30）
新增：小程序支持 Less / Sass 樣式語法，查看詳情
新增：Unity 小游戲 Wasm 分包支持線上收集能力，查看詳情
新增：小游戲支持游戲站數(shù)據(jù)開放接口 tt.getGameClubData
新增：小游戲授權(quán)接口增加 scope.groupTag tt.authorize
優(yōu)化：優(yōu)化抖音云面板交互展示
修復(fù)：服務(wù)商模式下使用插件提示無權(quán)限問題